JanKoWeb: Odborný SW - MATLAB: nápověda k vlastním funkcím a vygenerování help reportu

MATLAB: nápověda k vlastním funkcím a vygenerování help reportu

Formátování nápovědy:

function foo(x,y,z)
%FOO One-line description goes here
%
% foo(x,y,z)
%
% Multi-line paragraphs of descriptive text go here. It's fine for them to
% span lines. It's treated as preformatted text; help() and doc() will not
% re-wrap lines. In the editor, you can highlight paragraphs, right-click,
% and choose "Wrap selected comments" to re-flow the text.
%
% More detailed help is in the <a href="matlab: help foo>extended_help">extended help</a>.
% It's broken out like this so you can keep the main "help foo" text on 
% a single screen, and then break out obscure parts to separate sections.
%
% Examples:
% foo(1,2,3)
%
% See also:
% BAR
% SOMECLASS/SOMEMETHOD

disp(x+y+z);

function extended_help
%EXTENDED_HELP Some additional technical details and examples
%
% Here is where you would put additional examples, technical discussions,
% documentation on obscure features and options, and so on.

error('This is a placeholder function just for helptext');

Reference https://stackoverflow.com/questions/3840657/matlab-m-file-help-formatting.

Automatické vygenerování struktury

Pro automatické vytvoření struktury nápovědy jen z názvu funkce doporučuji

http://jankoweb.wz.cz/blog/odborny-sw/matlab-generator-napovedy-pro-funkce/.

Vygenerování help reportu

Když v okně Current Folder označíte více funkcí, můžete si k nim nechat z Vašich nápověd vygenerovat zprávu.

Generování helpu
Generování helpu
Okno správy helpu
Okno správy helpu
Rubrika Odborný SW | Tagy MATLAB, Formát, Help, Komentář | Čt 29.06.2017 | 817x

Náhodné články

Tento web jsem zakládal na střední, v roce 2008. Je zde hlavně archiv mé tvorby.

Aktuální věci publikuji kvůli úspoře času na Twitter.

Honza

"Bezpečí je většinou pověra. Ve skutečnosti neexistuje. Život je buď odvážné dobrodružství, nebo vůbec nic."

H. Kellerová