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

Which repository URL is displayed in the ROS wiki?

asked 2013-01-29 09:20:39 -0600

updated 2013-01-29 09:24:12 -0600

In our tu-darmstadt-ros-pkg SVN repo we used to have a special branch for fuerte in the /branches/fuerte directory. A couple of weeks ago, we moved the fuerte branch back to /trunk and the former /trunk branch to /branches/electric. The tu-darmstadt-ros-pkg.rosinstall file in the rosdistro repository at GitHub and the repository information in the release repo at code.ros.org were updated accordingly.

For some reason the wiki pages on ros.org still show the old URL for fuerte for released stacks and packages, e.g. hector_quadrotor. The last release was done from /branches/fuerte. The Releases page displays the new, correct URL for the development branch in /trunk.

Which information source is used for the meta information of stacks and packages in the ROS wiki? Is there a difference for released and unreleased stacks? How can I force the indexer to update the information?

Edit: roslocate uri also shows the updated URL.

edit retag flag offensive close merge delete

Comments

2

I would love to see wiki documentation for all the places where source URLs need to be defined.

joq gravatar image joq  ( 2013-01-30 04:48:04 -0600 )edit

1 Answer

Sort by ยป oldest newest most voted
2

answered 2013-02-08 23:14:24 -0600

I think I found the answer by myself: For ROS electric and upwards, only the rosinstall files in the rosdistro repository at github (https://github.com/ros/rosdistro) are used by the rosdoc_lite indexer running on Willow Garage's build farm to decide which packages and stacks have to be documented and from which source URL and branch. rosdoc_lite also generates and uploads yaml files with meta information to http://www.ros.org/doc/distro/api, which in turn are parsed by the wiki macros PackageHeader, StackHeader and MsgSrvDoc to create the package/stack meta information on http://www.ros.org/wiki/. http://www.ros.org/doc/api is a symlink to the API documentation for the current ROS distro.

All this is pretty well documented at the wiki page of rosdoc_lite and in the "Get Involved" instructions on how to submit new repositories.

The confusion regarding our stacks from the tu-darmstadt-ros-pkg came from the fact that there have been two different rosinstall files present with inconsistent source URLs in the rosdistro/doc/furte folder, one for the whole repository created by ourselves, and others for each of the released stacks that have been copied over from the old documentation system during the migration to rosdoc_lite.

Please add comments or edit this post directly if I missed some details.

edit flag offensive delete link more

Question Tools

Stats

Asked: 2013-01-29 09:20:39 -0600

Seen: 296 times

Last updated: Feb 08 '13