<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Generator" content="Microsoft Word 12 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Eitan,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">I like the new documentation pages. It seems to make documenting the various versions easier, and more importantly easier for users to access. Is there a
way to document an unstable or trunk version? I seem to remember a doxygen doc link to unstable, but I don’t know if that fits in the new scheme.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Shaun Edwards<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Senior Research Engineer<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Manufacturing System Department<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><a href="http://robotics.swri.org">http://robotics.swri.org</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><a href="http://rosindustrial.swri.org/">http://rosindustrial.swri.org/</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><a href="http://ros.swri.org/">http://ros.swri.org</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Southwest Research Institute<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">210-522-3277<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> ros-users-bounces@code.ros.org [mailto:ros-users-bounces@code.ros.org]
<b>On Behalf Of </b>Eitan Marder-Eppstein<br>
<b>Sent:</b> Friday, October 26, 2012 1:15 PM<br>
<b>To:</b> User discussions<br>
<b>Subject:</b> Re: [ros-users] New Documentation Generation and Indexing for ros.org<o:p></o:p></span></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">One more thing, my comment about the releases page applies to all Groovy catkin packages, but for the old stacks I can write some code to do the right (old) thing, just assuming the stack is a release unit. So, with a little extra code,
you won't have to change your rosinstall file. I'll work on building in support for that now. <o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">On Fri, Oct 26, 2012 at 11:06 AM, Eitan Marder-Eppstein <<a href="mailto:eitan@hidof.com" target="_blank">eitan@hidof.com</a>> wrote:<o:p></o:p></p>
<p class="MsoNormal">Hey all,<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">A few things:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">* The old wiki macros only ever displayed headers from the latest successful run of the indexer. They never displayed headers from different distros. So, there was actually no way to tell previously if documentation was broken for electric
or diamondback without clicking on something like the "Code API" link or going to the documentation directly. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">* Take the nao_driver package for example. The following page exists (<a href="http://ros.org/doc/api/nao_driver/" target="_blank">http://ros.org/doc/api/nao_driver/</a>), but the three distro specific pages do not (<a href="http://ros.org/doc/fuerte/api/nao_driver/" target="_blank">http://ros.org/doc/fuerte/api/nao_driver/</a>, <a href="http://ros.org/doc/electric/api/nao_driver/" target="_blank">http://ros.org/doc/electric/api/nao_driver/</a>, <a href="http://ros.org/doc/diamondback/api/nao_driver/" target="_blank">http://ros.org/doc/diamondback/api/nao_driver/</a>).
This means that, at one point, documentation for the nao_driver package succeeded, but we don't even know in which distro that was. All we know is that it fails now, for reasons that may not be at all related to that stack, on all three distros. The good news
is that it works with the new indexer: <a href="http://ros.org/rosdoclite/fuerte/api/nao_driver/" target="_blank">http://ros.org/rosdoclite/fuerte/api/nao_driver/</a>. So, when we switch over Fuerte to the new doc system, things will display correctly. I'm
leaning towards doing this later today.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">* The reason that roscpp lacks header information for Fuerte is actually different. The ros_comm stack was ported over to catkin for Fuerte, but the old documentation pipeline was never updated to support catkin-ized packages. As such,
roscpp was never properly documented for Fuerte. However, no one noticed because the last successful run of the roscpp header (which might have been in electric) was displayed and used on the wiki.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">* The information used to generate the browse pages is actually different (in the old system) from the information used to generate the package headers. So, the rosbrowse page isn't the most reliable way to see if something is known by
the indexer or properly documented. This will all change with the new system though I still have to do some wiki macros work to get browsing up with the new stuff.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">* After writing this e-mail, I've decided to switch over the wiki for Fuerte. I'll send out a separate announcement soon, but all of your pages should work now. One thing to note is that, with Groovy switching over to meta-packages, release
pages will be based off of repositories rather than stacks. In most cases, this amounts to using the same name but, for certain SVN situations, like alufr-ros-pkg, you might want to change your rosinstall file to list each stack separately with a local-name
corresponding to that of the stack. Otherwise, the indexer will assume that you mean to release all of alufr-ros-pkg as a unit (since you document it as a unit) and link to a page on the wiki called <a href="http://www.ros.org/wiki/alufr-ros-pkg_trunk/Releases" target="_blank">http://www.ros.org/wiki/alufr-ros-pkg_trunk/Releases</a> rather
than something like <a href="http://www.ros.org/wiki/alufr-ros-pkg_trunk/Releases" target="_blank">http://www.ros.org/wiki/octomap_ros/Releases</a>. Also, there is still some work that needs to be done for auxiliary pages like Releases, the Browse page, etc.
to work correctly. So, just a heads up that things there may be a little flaky for a day or two. Just to make my local-name point clear, here's a rosinstall file for octomap_ros that would lead to proper release links:<o:p></o:p></p>
</div>
<div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">- svn:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> local-name: octomap_ros<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> uri: <a href="http://alufr-ros-pkg.googlecode.com/svn/trunk/octomap_stacks/octomap_ros" target="_blank">http://alufr-ros-pkg.googlecode.com/svn/trunk/octomap_stacks/octomap_ros</a><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Hope all is well,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Eitan<o:p></o:p></p>
</div>
</div>
<div>
<div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">On Fri, Oct 26, 2012 at 8:59 AM, Christian Dornhege <<a href="mailto:dornhege@informatik.uni-freiburg.de" target="_blank">dornhege@informatik.uni-freiburg.de</a>> wrote:<o:p></o:p></p>
<div>
<p class="MsoNormal">On 26.10.2012 17:40, Armin Hornung wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<p class="MsoNormal">On 2012-10-23 03:00, Eitan Marder-Eppstein wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<p class="MsoNormal"><br>
On a logistical note, we're already using the new indexer to build<br>
documentation for Groovy packages, but have not switched the wiki over<br>
to use the new indexer for Fuerte quite yet. First, we want to make<br>
sure that the community has a chance to add their packages to the<br>
indexer. So, within the next two weeks, please take some time to add<br>
any package you maintain to the indexer. Once again, to do this,<br>
please follow the instructions here<o:p></o:p></p>
</div>
<p class="MsoNormal"><<a href="http://www.ros.org/wiki/Get%20Involved#Fuerte_and_later" target="_blank">http://www.ros.org/wiki/Get%20Involved#Fuerte_and_later</a>>.<o:p></o:p></p>
</blockquote>
<div>
<p class="MsoNormal"><br>
Is the old indexer information completely dismissed? It appears that the<br>
wiki information is now working only for packages & stacks that were<br>
released for diamondback or electric. We had our complete repository<br>
indexed at <a href="http://alufr-ros-pkg.googlecode.com/svn/trunk/" target="_blank">
http://alufr-ros-pkg.googlecode.com/svn/trunk/</a> and now only<br>
packages appear properly that were released in the past, e.g.:<br>
<br>
<a href="http://www.ros.org/wiki/nao_driver" target="_blank">http://www.ros.org/wiki/nao_driver</a> - not working at all<br>
<a href="http://ros.org/wiki/humanoid_localization" target="_blank">http://ros.org/wiki/humanoid_localization</a> - not working at all<br>
<a href="http://www.ros.org/wiki/footstep_planner" target="_blank">http://www.ros.org/wiki/footstep_planner</a> - only information for<br>
electric works (was released once)<br>
<a href="http://www.ros.org/wiki/octomap_ros" target="_blank">http://www.ros.org/wiki/octomap_ros</a> - only information for fuerte works<o:p></o:p></p>
</div>
</blockquote>
<p class="MsoNormal" style="margin-bottom:12.0pt"><br>
The indexer seems to know this, but it's not arriving at the package<br>
pages, see for example:<br>
Package List: <a href="http://www.ros.org/browse/details.php?name=rxparamedit" target="_blank">
http://www.ros.org/browse/details.php?name=rxparamedit</a><br>
Wiki Page: <a href="http://ros.org/wiki/rxparamedit" target="_blank">http://ros.org/wiki/rxparamedit</a><br>
<br>
It seems to affect everything, as even roscpp<br>
(<a href="http://ros.org/wiki/roscpp" target="_blank">http://ros.org/wiki/roscpp</a>) does not have the header for fuerte.<br>
<br>
As I see it, the browse pages take the information from the current<br>
state of the indexed repository, but the wiki page header are generated<br>
from the releases (only). Is this maybe even intended behaviour?<br>
<br>
Cheers,<br>
Christian<o:p></o:p></p>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">We resubmitted the repo for indexing in fuerte with a pull request, so I<br>
guess that will at least clear up. But what about electric and earlier?<br>
<br>
<br>
As a side note <a href="http://www.ros.org/wiki/octomap_ros/Releases" target="_blank">
http://www.ros.org/wiki/octomap_ros/Releases</a> appears to<br>
be broken and <a href="http://www.ros.org/wiki/octomap_msgs/Releases" target="_blank">
http://www.ros.org/wiki/octomap_msgs/Releases</a> empty, any<br>
idea how to fix it?<br>
<br>
Cheers,<br>
Armin<br>
<br>
--<br>
Armin Hornung<br>
Humanoid Robots Lab, Albert-Ludwigs-Universität Freiburg<br>
Contact:<a href="http://www.informatik.uni-freiburg.de/~hornunga" target="_blank">http://www.informatik.uni-freiburg.de/~hornunga</a><br>
<br>
<br>
<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">_______________________________________________<br>
ros-users mailing list<br>
<a href="mailto:ros-users@code.ros.org" target="_blank">ros-users@code.ros.org</a><br>
<a href="https://code.ros.org/mailman/listinfo/ros-users" target="_blank">https://code.ros.org/mailman/listinfo/ros-users</a><o:p></o:p></p>
</div>
<p class="MsoNormal"><span style="color:#888888"><br>
<br>
-- <br>
Albert-Ludwigs-University<br>
Institute of Computer Science<br>
Research Group Foundations of Artificial Intelligence<br>
Georges-Köhler-Allee 52<br>
79110 Freiburg<br>
Phone: <a href="tel:%2B49%20761%20203%208225" target="_blank">+49 761 203 8225</a></span><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal"><br>
_______________________________________________<br>
ros-users mailing list<br>
<a href="mailto:ros-users@code.ros.org" target="_blank">ros-users@code.ros.org</a><br>
<a href="https://code.ros.org/mailman/listinfo/ros-users" target="_blank">https://code.ros.org/mailman/listinfo/ros-users</a><o:p></o:p></p>
</div>
</div>
</div>
<p class="MsoNormal"><br>
<br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</div>
<div>
<p class="MsoNormal">-- <br>
Eitan Marder-Eppstein<o:p></o:p></p>
<div>
<p class="MsoNormal">President, hiDOF Inc.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><a href="http://www.hidof.com" target="_blank">http://www.hidof.com</a><o:p></o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</div>
<p class="MsoNormal"><br>
<br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">-- <br>
Eitan Marder-Eppstein<o:p></o:p></p>
<div>
<p class="MsoNormal">President, hiDOF Inc.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><a href="http://www.hidof.com" target="_blank">http://www.hidof.com</a><o:p></o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</body>
</html>