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

Documentation of stack not updating after being added to rosdistro/kinect.yaml

asked 2017-07-28 17:48:08 -0500

joaoquintas gravatar image

The problem: I followed the guidelines in Indexing Your ROS Repository for Documentation Generation and everything seemed to worked fine until the documentation page generation.

The stack: auction_mehtods_stack

The steps undertaken:

1) updated with the new stack for indexing.

2) The pull request was accepted.

3) The indexer job finished and status reported ok.

4) However, the documentation page for the corresponding stack in did not correctly update to include the new distro documentation.

The question: Did someone faced a similar problem, or have any suggestion on how to resolve this issue?

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2017-07-29 01:48:35 -0500

gvdhoorn gravatar image

updated 2017-07-29 02:30:45 -0500

I don't know why, but apparently the Doc job didn't find any packages in the repository you submitted:

03:42:12 No packages found in source space: /tmp/catkin_workspace/src
03:42:12 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
03:42:12 ~~  traversing 0 packages in topological order:
03:42:12 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If there are no packages, then there is no documentation to generate.

Edit: and I think I know why: stacks don't exist any more in ROS, and since Fuerte we've moved on to another build system (ie: Catkin). All the packages in the repository you submitted (joaoquintas/auction_methods_stack) are rosbuild packages (ie: the old build system, which uses manifest.xml files).

The buildfarm uses Catkin for all Doc jobs, and Catkin doesn't support rosbuild packages in this way.

So when the Doc job crawls your repository, it finds 0 packages -> no documentation generated -> nothing updated on the wiki.

You'll have to migrate your packages to Catkin. See the migration guide for how to do that. Be sure to check the catkin howto documentation when something is unclear.

edit flag offensive delete link more

Question Tools

1 follower


Asked: 2017-07-28 17:48:08 -0500

Seen: 207 times

Last updated: Jul 29 '17