Which tool are you using to create the documentation of your MATLAB codes?
148 views (last 30 days)
Show older comments
Aurelien Queffurust
on 10 Jan 2013
Commented: Nathan Ellingson
on 3 Sep 2021
I would like to know which documentation system you use to create the developer's guide or your MATLAB codes.
I already found 2 FEx utilities on this subject:
makehtmldoc to create easily HTML help pages from MATLAB codes.
Do you know other tools which can extract comments from your codes to generate documentation?
Thanks for your feedback
0 Comments
Accepted Answer
per isakson
on 10 Jan 2013
Edited: per isakson
on 10 Jan 2013
M2HTML: Documentation System for Matlab in HTML has been around and supported for a long time - long before the new OOP-system. It is definitely worth looking at.
The questions says that the documentation support of Matlab is not adequate for your needs.
2 Comments
More Answers (4)
Mark Mikofski
on 13 Dec 2017
Try Sphinx MATLAB domain, it's free and it automatically generates documents from your H1 comments if they are formatted using Sphinx markup. Disclaimer, I was the original author of the Sphinx MATLAB domain.
2 Comments
Brian Holmes
on 23 Aug 2020
The Sphinx MATLAB seems to be a promising choice. But its documentation and help is very poor, making it effectively useless.
Nathan Ellingson
on 3 Sep 2021
After reweiwing all the tools under this question, I settled on this one. Sphinx Matlab is a plugin to Sphinx so some Sphinx knowledge is required to use it. I found that the Sphinx Matlab documentation was excellent, while the Sphinx proper documentation was kind of hard to folow. However, I think this is expected with a project as complex and powerful as Sphinx.
If you have time to work with sphinx to make some really excellent custom documentation, I recommend using the Matlab plugin for sphinx. If you need documentation right now and don't have time to mess with it I recommend m2html (I think the brain template looks the best).
Pierre Ollfisch
on 23 Jul 2021
Edited: Pierre Ollfisch
on 24 Jul 2021
You could also try m2docgen. It generates HTML-websites based on your header comments and integrates them directly in the local MATLAB documentation. It works with '*.m' and '*.mlx' files of functions, classes and scripts. The sites can also be found by the search function, as the builddocsearchdb is also called in the process. I have attached an example of how the input and output looks for a class file.
Input:
Output:
Disclaimer: I am a developer of m2doc.
0 Comments
Ryan G
on 10 Jan 2013
MATLAB Report Generator has a lot of options for HTML reports. It's not free, but obviously it's designed well for the job.
1 Comment
Jiri Vass
on 10 May 2018
Can you please provide more details about using the MATLAB Report Generator for automatically generating the documentation of my Matlab code? I used the M2HTML already and it generates useful Matlab code documentation (e.g. dependency diagram, HTML to browse my functions), but if the MATLAB Report Generator provides even better functionality, I'd like to know about it.
See Also
Categories
Find more on Environment and Settings in Help Center and File Exchange
Products
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!