View License

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video

Highlights from
Generate a new function m-file, with documentation

4.0 | 1 rating Rate this file 12 Downloads (last 30 days) File Size: 3.11 KB File ID: #27225 Version: 1.1
image thumbnail

Generate a new function m-file, with documentation


Richie Cotton (view profile)


12 Apr 2010 (Updated )

This makes it really easy to document your functions in a standard format.

| Watch this File

File Information

Having your m-files documented in a standard way (or at all!) is very useful for sharing code between projects, and between people. The trouble is, clicking File -> New -> Function doesn't give you much to go on, and it is very easy to be lackadaisical about writing thorough and consistent documentation.

GenerateFunctionMFile() creates a new untitled m-file with placeholder documentation, and opens the file in the editor.

GenerateFunctionMFile(true), works as above but prompts you for the name of the function.

The layout includes $Author, $Date and $Revision tags, which are automatically completed for you. If you use CVS or SVN as your version control system, then checking in your file will automatically cause these fields to be updated.

Since typing is a lot of effort, also included is a function called "new", which is a wrapper for GenerateFunctionMFile(true), so all you need to do to create a new file with documentation is type new, and the function name. Easy!

Note: You'll probably want to play with the template of the created m-file to suit your own needs. (At the very least, you'll want to change the copyright line to that of your own company.)


Automatic Template For New Functions inspired this file.

This file inspired New File.

MATLAB release MATLAB 7.10 (R2010a)
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (1)
13 Apr 2010 David Legland

David Legland (view profile)

nice tool, but I personnaly prefere tedit (#8532), that I found easier to configure and to use.

12 Apr 2010 1.1

Acknowledged inspiration.

Contact us