<div dir="ltr">So.... if we are significantly changing the modules shoudl we also take the time to rename OpenGL2 back to OpenGL as was the original intent?<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 29, 2018 at 5:42 PM, Ben Boeckel <span dir="ltr"><<a href="mailto:ben.boeckel@kitware.com" target="_blank">ben.boeckel@kitware.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Mon, Oct 29, 2018 at 22:31:38 +0100, Elvis Stansvik wrote:<br>
> Let me just jump in and say that while it sounds neat to embed it<br>
> comments, it might make it slightly harder to make an updated version<br>
> of Utilities/Maintenance/<wbr>WhatModulesVTK.py script (which I love!).<br>
<br>
Thanks for the reminder that this file needs updated.<br>
<br>
CMake supports long-form comments now, so I'd think it'd be in blocks<br>
like this:<br>
<br>
```cmake<br>
#[==[vtk.kit<br>
...<br>
#]==]<br>
#[==[vtk.module<br>
...<br>
#]==]<br>
```<br>
<br>
with a limit of one `vtk.module` per file. Easy to slice out with a<br>
simple `sed` call. Not so easy in CMake, but also not ridiculous.<br>
<br>
This is similar to the way the new module system is documented:<br>
<br>
```cmake<br>
#[==[.md<br>
...<br>
#]==]<br>
```<br>
<br>
which will make it possible to extract out these blocks and feed them to<br>
Doxygen and get the module system API docs on the web with the rest of<br>
VTK.<br>
<br>
There's also `#[==[.md INTERNAL` for internal function documentation as<br>
well.<br>
<br>
--Ben<br>
______________________________<wbr>_________________<br>
Powered by <a href="http://www.kitware.com" rel="noreferrer" target="_blank">www.kitware.com</a><br>
<br>
Visit other Kitware open-source projects at <a href="http://www.kitware.com/opensource/opensource.html" rel="noreferrer" target="_blank">http://www.kitware.com/<wbr>opensource/opensource.html</a><br>
<br>
Search the list archives at: <a href="http://markmail.org/search/?q=vtk-developers" rel="noreferrer" target="_blank">http://markmail.org/search/?q=<wbr>vtk-developers</a><br>
<br>
Follow this link to subscribe/unsubscribe:<br>
<a href="https://public.kitware.com/mailman/listinfo/vtk-developers" rel="noreferrer" target="_blank">https://public.kitware.com/<wbr>mailman/listinfo/vtk-<wbr>developers</a><br>
<br>
</blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Ken Martin PhD<div>Distinguished Engineer<br><span style="font-size:12.8px">Kitware Inc.</span><br></div><div>101 East Weaver Street<br>Carrboro, North Carolina<br>
27510 USA<br><br><div><span style="font-size:10pt;font-family:Tahoma,sans-serif">This communication,
including all attachments, contains confidential and legally privileged
information, and it is intended only for the use of the addressee.  Access to this email by anyone else is
unauthorized. If you are not the intended recipient, any disclosure, copying,
distribution or any action taken in reliance on it is prohibited and may be
unlawful. If you received this communication in error please notify us
immediately and destroy the original message. 
Thank you.</span></div></div></div></div></div></div></div>
</div>