Since it's an HTML comment, perhaps it simply disappears when doxygen output is generated...? (I'm guessing...)<br><br><br><div class="gmail_quote">On Wed, Apr 27, 2011 at 4:37 PM, Michael Halle <span dir="ltr"><<a href="mailto:mhalle@bwh.harvard.edu">mhalle@bwh.harvard.edu</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">Since VTK already uses simpler text-style comment directives (//BTX, etc.), perhaps you could just choose something like (choose your combo):<br>

<br>
// PRAGMA:NewReference<br>
or<br>
// HINT:NewReference<br>
or<br>
or an extended version:<br>
// HINT:NewReference=true,ReturnElementCount=3<br>
<br>
(names could also be VTK_PRAGMA or VTK_HINT).<br>
<br>
On first glance, I find the HTML comment style to be confusing, because it's only ever seen in HTML, not in C++ code or plain text.  It's also not especially pretty. :)  Perhaps it has an advantage I'm not seeing....<br>

<br>
--Mike<div><div></div><div class="h5"><br>
<br>
<br>
On 04/27/2011 04:15 PM, David Gobbi wrote:<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
As a follow up to the recent discussion on wrapping factory methods,<br>
I'd like to put forth a proposal for adding wrapping hints to VTK:<br>
Hints could be placed inside the method descriptions, as html-style<br>
comments:<br>
<br>
// Description:<br>
// Return a new object instance.<br>
//<!--- hint newref='true' --><br>
vtkObjectBase *NewInstance();<br>
<br>
Size hints could replace the hints file currently used by the wrappers.<br>
I'm also keen to provide size hints for operator[] methods, since<br>
these operators cannot be properly wrapped in python until there<br>
is a hint to tell python what method to call to get the index range.<br>
<br>
  - David<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>
</blockquote>
<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>