<div dir="ltr">This is what I think is happening:<div>* libxml2 uses gtk-doc instead of doxygen.</div><div><div>* our third party warnings prevention (VTK_THIRD_PARTY_WARNING_SUPPRESS from CMake/vtkThirdParty.cmake) is preventing warnings from the compilation of the libxml2 itself.<br>


</div><div>* your clang dashboard is the first one to try -Wdocumentation, which chases the header from IO/Infovis/vtkXMLTreeReader.cxx (which isn't suppressed) into libxml/include/hash.h .</div><div><br></div>
<div>I think the right thing to do is to add a global suppression for this case.</div><div style>Pushing a patch to gerrit now.</div><div style>Sean can you try it on one of the affected builds and see if it works?</div>

<div style><br></div><div><br><div><br></div></div></div></div><div class="gmail_extra"><br clear="all"><div>David E DeMarle<br>Kitware, Inc.<br>R&D Engineer<br>21 Corporate Drive<br>Clifton Park, NY 12065-8662<br>Phone: 518-881-4909</div>


<br><br><div class="gmail_quote">On Wed, May 22, 2013 at 1:09 PM, Sean McBride <span dir="ltr"><<a href="mailto:sean@rogue-research.com" target="_blank">sean@rogue-research.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div class="im">On Mon, 20 May 2013 10:06:34 -0400, Bill Lorensen said:<br>
<br>
</div><div class="im">>I have tried to fix these warnings:<br>
><a href="http://open.cdash.org/viewBuildError.php?type=1&buildid=2910415" target="_blank">http://open.cdash.org/viewBuildError.php?type=1&buildid=2910415</a><br>
><br>
>@relates and \relates are proper doxygen comments. It is possible that this<br>
>is a bogus warning?<br>
<br>
</div>So there are a bunch more warnings from the ThirdParty libxml2, ex:<br>
<br>
/Users/builder/external/VTK-clang-dbg-x86_64/ThirdParty/libxml2/vtklibxml2/libxml/hash.h:92:4: warning: unknown command tag name 'data'; did you mean 'date'? [-Wdocumentation]<br>
 * @data:  extra scannner data<br>
   ^~~~~<br>
<br>
The code is:<br>
<br>
/**<br>
 * xmlHashScannerFull:<br>
 * @payload:  the data in the hash<br>
 * @data:  extra scannner data<br>
 * @name:  the name associated<br>
 * @name2:  the second name associated<br>
 * @name3:  the third name associated<br>
 *<br>
 * Callback when scanning data in a hash with the full scanner.<br>
 */<br>
typedef void (*xmlHashScannerFull)(void *payload, void *data,<br>
                                   const xmlChar *name, const xmlChar *name2,<br>
                                   const xmlChar *name3);<br>
<br>
Any doxygen experts out there?  I thought you needed use @param, like so:<br>
<br>
 @param data : extra scannner data<br>
<br>
In any case, isn't there a mechanism to suppress warnings from 3rd party code on the dashboard?  I'd hate to disable -Wdocumentation everywhere in VTK because of this.<br>
<br>
Cheers,<br>
<div class="HOEnZb"><div class="h5"><br>
--<br>
____________________________________________________________<br>
Sean McBride, B. Eng                 <a href="mailto:sean@rogue-research.com">sean@rogue-research.com</a><br>
Rogue Research                        <a href="http://www.rogue-research.com" target="_blank">www.rogue-research.com</a><br>
Mac Software Developer              Montréal, Québec, Canada<br>
<br>
<br>
_______________________________________________<br>
Powered by <a href="http://www.kitware.com" target="_blank">www.kitware.com</a><br>
<br>
Visit other Kitware open-source projects at <a href="http://www.kitware.com/opensource/opensource.html" target="_blank">http://www.kitware.com/opensource/opensource.html</a><br>
<br>
Follow this link to subscribe/unsubscribe:<br>
<a href="http://www.vtk.org/mailman/listinfo/vtk-developers" target="_blank">http://www.vtk.org/mailman/listinfo/vtk-developers</a><br>
<br>
</div></div></blockquote></div><br></div>