you wish to enable additional Doxygen configuration options, which are described below.you wish to run multiple builders in a package.As Doxygen is the default builder for any package, it is only necessary to configure this option if: The "doxygen" builder will enable running Doxygen on a package. Here is an example from the roslib package, which performs both C++ and Python API documentation:įile_patterns: '*.c *.cpp *.h *.cc *.hh *.dox' "Python API")Įach builder may specify additional configuration keys. Name: (optional) name of documentation set (e.g. If you have multiple builders, you must specify this property to avoid builders writing to the same directory. Output_dir: (optional) name of sub-directory to write documentation to. The YAML configuration file should contain a list of dictionaries, where each dictionary has the following standard keys:īuilder: name of documentation builder ( doxygen, epydoc, or sphinx) section of the package.xml, but this behavior is old: If you wish to name it something else, you must place the following tag in the. In order to enable the rosdoc configuration file, simply have a rosdoc.yaml file in the root of your package. do advanced configuration of documentation buildsįor more details, please see one of these pages:.configure multiple documentation builds per package.use Epydoc or Sphinx instead of Doxygen.Rosdoc supports a YAML-based configuration file that lets you: #C builder wiki installYou may also need to install sphinx or epydoc for certain Python packages.Ĭreate rosdoc configuration files (to use Epydoc, Sphinx) Note that you need doxygen installed on your machine (e.g., sudo apt-get install doxygen). 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. #C builder wiki codeDoxygen 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. Automatically Generated Online Documentation on ros.org.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |