ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | ros @ Robotics Stack Exchange
Ask Your Question

How to document actionlib interface / Best practice for messages from .action files

asked 2011-12-13 21:15:40 -0600

AHornung gravatar image

updated 2012-06-21 04:34:09 -0600

joq gravatar image

I want to document the action interface in nao_driver which uses custom actions defined in nao_msgs. However, the messages themselves are generated from the .action files and this does not seem to happen when the wiki documentation is built. As a result, the message links in the node documentation point to nonexistent pages and there are no actions visible at nao_msgs in the MsgSrvDoc macro block. How should I document the interface? Is it considered "best practice" to check in the generated msgs from the .action files? I don't like the fact that this could cause a new checkin every time they are regenerated.

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2011-12-14 04:17:06 -0600

kwc gravatar image
  1. How should I document the interface?

See for the current 'best practice'. It's not great, but all that's possible now w/o someone writing a plugin for rosdoc to handle actions the same way we do with msg/srvs.

  1. Is it considered "best practice" to check in the generated msgs from the .action files?

You should never check in generated files.

If you wanted to get very clever, you could run rosdoc on your package against a built tree and save the msg docs and link to those, but that's still not an ideal solution to #1.

edit flag offensive delete link more


Well I actually looked at move_base which caused my confusion ;) If you look at the action messages, all the links to message definitions (e.g. are working.
AHornung gravatar image AHornung  ( 2011-12-16 07:20:44 -0600 )edit
Doesn't this mean that the msg files were checked in so rosdoc can generate the corresponding html?
AHornung gravatar image AHornung  ( 2011-12-16 07:22:53 -0600 )edit
I meant to run rosdoc locally and uploading the html files to a server
kwc gravatar image kwc  ( 2011-12-17 06:16:35 -0600 )edit

Question Tools


Asked: 2011-12-13 21:15:40 -0600

Seen: 804 times

Last updated: Dec 14 '11