11/16/2023 0 Comments Doxygen python syntax![]() ![]() It's easiest if you point your Web browser to open doc/html/index.html. This will generate the documentation in doc. ![]() If specified, will generate a doxygen tagfile in this g GENERATE_TAGFILE, -generate_tagfile=GENERATE_TAGFILE Path to tag configuration file for Doxygen cross o OUTPUT_DIRECTORY The directory to write documentation to. h, -help show this help message and exit When you run the rosdoc_lite command, it will generate documentation into the 'doc' folder of the local directory. You can use rosdoc_lite to generate local copies of documentation. This functionality is mainly only of use to those maintaining documentation Web sites.Īpt-get install ros-$ROS_DISTRO-rosdoc-lite Rosdoc_lite contains some additional functionality for generating machine-readable documentation files, as well as msg/ srv documentation, that are used by the ros.org wiki system and elsewhere. It is frequently run on repositories that have rosinstall files listed in the rosdistro repository, with the resulting documentation linked to in the "Code API" link of many packages' on. Rosdoc_lite is used as part of an automated process for updating documentation on ros.org. For example, Doxygen will extract API details from all source files found in the package (see Doxygen for more). The documentation that is generated will depend on which tool is used, as each tool behaves differently. ![]() If you wish to use another tool, like Epydoc or Sphinx, you must use a rosdoc configuration file. Doxygen and Sphinx also provide additional tools for authoring documentation that is not tied to code API.īy default, rosdoc_lite will use Doxygen to generate the documentation for a package. In general, tools like Doxygen search all of the source code in a code tree for structured comments, and then use these comments as well as the API of the code to generate HTML files documenting the package. Rosdoc_lite makes a best effort at providing good default settings to these tools, and in some cases allows these settings to be customized further. Configuring your package to be documented by rosdoc_lite also has the additional benefit of allowing your package to be indexed for inclusion on the ROS wiki. We recommend trying rosdoc_lite instead of attempting to setup those tools manually, as it provides shortcuts for configuring those tools and can also import additional ROS information. It was built as a light-weight replacement to the rosdoc tool and uses the same rosdoc.yaml file format to assist in porting. Rosdoc_lite is a simple program that runs an external documentation tool, like Doxygen, Epydoc, or Sphinx, on a single ROS package.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |