| ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | ros @ Robotics Stack Exchange |
Hello, I have a wiki page for my messages and services but it doesn't work the "MsgSrvDoc" label when I used in a wiki page.
I based the structure of my package and the wiki page on common_msgs repo.
So, my question is, why is it not working in the wiki page I created?
Thanks.
Basically the MsgSrvDoc macro is naive and always try's to go reference the package and .msg from the latest ROS distribution, in this case Jade. Since your package is not released for anything but Hydro, it does not find the file needed to generate the documentation.
The easiest work around for this would be to release your package for Jade (and while you're at it Indigo). This doesn't take very much time and should fix your issue.
However, this is a pretty serious limitation of the macro, I would recommend you open an issue against our roswiki repository:
https://github.com/ros-infrastructure...
I won't guarantee that we'll get around to addressing it in the near future, but at least the limitation will be captured and maybe someone else (maybe even yourself) can contribute a better macro.
Thanks for your quick answer @William. I have written the issue on GitHub. It could be fine if at least the macro is compatible with the LTS version of ROS and the last one. Because in this moment, we don't have in mind migrate our code to Jade, if any, we would think to migrate to Indigo.
For the MsgSrvDoc macro to work you must submit your package to be documented by the buildfarm to generate the content. Without being in the documentation index the website cannot render your information.
tutorial on adding your repo for documentation indexing
For reference the referenced ticket
@William I have my packages registered for documentation in rosdistro repo, but only for the hydro version. Is it that right then?
No, you need the doc entry for the newer distro as well. It is not sufficient to have a doc entry for Hydro only with this wiki macro. If this wiki macro is improved it would be sufficient, but until them you'll need to register it for documentation for Jade as well.
Asked: 2015-06-11 08:30:21 -0600
Seen: 181 times
Last updated: Jun 15 '15
ROS Answers is licensed under Creative Commons Attribution 3.0 Content on this site is licensed under a Creative Commons Attribution Share Alike 3.0 license.
