In particular, you can use hyperlinks to invoke arbitrary Matlab commands, and point to other sections of helptext by having it invoke help(). You can use a limited form of hyperlinks in help. Method names are qualified I think names of methods in the same class as the current method can be unqualified.Įverything between the H1 line and "Examples:" is just a conventional formatting that I find readable help() doesn't treat it specially. Function names after "See also:" are all caps.I'm not sure which all cases work this one does for sure. The function name in the H1 line is all caps, regardless of actual capitalization of the function name in the signature.It needs to be just one line so it is properly picked up by contentsrpt(), which can autogenerate a Contents.m file from the helptext in your functions The first line after the function signature is called the "H1 line".% documentation on obscure features and options, and so on.Įrror('This is a placeholder function just for helptext') % Here is where you would put additional examples, technical discussions, %EXTENDED_HELP Some additional technical details and examples % a single screen, and then break out obscure parts to separate sections. % It's broken out like this so you can keep the main "help foo" text on % More detailed help is in the extended_help">extended help. % and choose "Wrap selected comments" to re-flow the text. In the editor, you can highlight paragraphs, right-click,
It's treated as preformatted text help() and doc() will not % Multi-line paragraphs of descriptive text go here. Here's the helptext formatting I've picked up on and found useful.
This describes both simple helptext and generating separate HTML help files. MATLAB > User's Guide > Desktop Tools and Development Environment > Customizing Help and Demos > Providing Your Own Help and Demos. Try this other section in the official documentation.
0 kommentar(er)
