Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
Note: These instructions apply for OpenSim versions 3.x

...

Install PackageDescription
 DoxygenPrimary installation to turn .h file files into html files. Can either download the installer or clone from github.
Latex generates rendered equations that are easier to read and interpret. Latex and dvips are installed through the protext | TeXStudio distribution (protext is very large ~2Gb). Protext installer can install a number of packages, the TeXstudio install puts latex and dvips on system path.
Ghostscript does some further rendering of pictures and text. Download and install the gs914w32.exe distro

...

  • The doxygen comments that appear in the html file for each class are generated from a classes header file. 
  • The best way to get oriented to doxygen is to review some examples. Some well documented classes include:
    • ModelComponent
    • MuscleCurveFunctionFactor
  • If you update the doxygen comments for a class, rebuild the "doxygen" target to check that there are no errors and your documentation appears as expected. 
  • The doxygen manual also provides information about the available commands and usage: http://www.stack.nl/~dimitri/doxygen/manual.html
  • Doxygen only generates documentation from .h files, not .cpp files.
  • Convention for figures: fig_CLASSNAME_FIGNAME