MATLAB Spoken Here

January 3rd, 2012

Last week Jiro picked addcopyright for the File Exchange Pick of the Week. The pick looks like a helpful tool for adding copyright text to MATLAB program files, but while reading the post, I was reminded of the Help Report, which is part of MATLAB’s current folder reports.

The Help Report scans the .m files in the current folder and analyzes the text help at the top of the file. This is the text displayed in the Command Window, when you use the help command. The report is most useful if you want to create MathWorks-style help for your own code, but is still useful even if you use only a part of it.

One of the features the report has is the ability to flag a missing Copyright or update a Copyright line if it is out of date. It also checks for H1 text, examples, “see also”, and even scans class methods for help text.

To run the help report, go to the Actions “gear” in the current folder browser, and select Reports -> Help Report. This generates a HTML report of each file in the current folder and what help pieces are present. You can use the checkboxes at top to deselect the parts of help you don’t care about for your files.

By Michael Katz

Mike is a developer on the MATLAB Mobile team. When not describing himself in the third person, biking, homebrewing, or rooting for the home team, he's busy trying to make the world a better place for programming.

09:54 UTC | Posted in Current Directory | Permalink | No Comments »

You can follow any responses to this entry through the RSS 2.0 feed. You can skip to the end and leave a response. Pinging is currently not allowed.

Leave a Reply

<pre class="code">
a = magic(3);
sum(a)
</pre>

These postings are the author's and don't necessarily represent the opinions of MathWorks.