Experimental parallel documentation plugin for catkin_tools
APACHE-2.0 License
This package is an experimental documentation-builder for ROS packages, similar to rosdoc_lite. It differs in the following ways:
catkin_tools
plugin, so it fits naturally into theUsing a virtualenv is recommended if using pip
. Alternatively, you can get a
system package for Ubuntu or Debian on my PPA (2022-03-17: PPA is broken/not updated for now).
pip install catkin_tools_document
mkdir -p catkin_ws/src && cd catkin_ws
rosinstall_generator ros_base --deps --tar --rosdistro noetic > src/.rosinstall
wstool up -t src
catkin document
Now open up catkin_ws/docs/index.html
in the browser of your choice.
# Upload to pypi
python setup.py sdist bdist_wheel
twine upload dist/*
# Upload to launchpad. Need to rebuild with signing as the built-in capability in stdeb
# isn't released yet, and I couldn't get dpkg-sig to work either for a post-build signature.
python setup.py --command-packages=stdeb.command sdist_dsc --upstream-version-suffix=focal --suite focal
cd deb_dist/*
dpkg-buildpackage -S
dput ppa:mikepurvis/catkin ../*_source.changes