[vtk-developers] New module system preview

[Ken Martin]

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?

On Mon, Oct 29, 2018 at 5:42 PM, Ben Boeckel <ben.boeckel at kitware.com>
wrote:

> On Mon, Oct 29, 2018 at 22:31:38 +0100, Elvis Stansvik wrote:
> > Let me just jump in and say that while it sounds neat to embed it
> > comments, it might make it slightly harder to make an updated version
> > of Utilities/Maintenance/WhatModulesVTK.py script (which I love!).
>
> Thanks for the reminder that this file needs updated.
>
> CMake supports long-form comments now, so I'd think it'd be in blocks
> like this:
>
> ```cmake
> #[==[vtk.kit
> ...
> #]==]
> #[==[vtk.module
> ...
> #]==]
> ```
>
> with a limit of one `vtk.module` per file. Easy to slice out with a
> simple `sed` call. Not so easy in CMake, but also not ridiculous.
>
> This is similar to the way the new module system is documented:
>
> ```cmake
> #[==[.md
> ...
> #]==]
> ```
>
> which will make it possible to extract out these blocks and feed them to
> Doxygen and get the module system API docs on the web with the rest of
> VTK.
>
> There's also `#[==[.md INTERNAL` for internal function documentation as
> well.
>
> --Ben
> _______________________________________________
> Powered by www.kitware.com
>
> Visit other Kitware open-source projects at http://www.kitware.com/
> opensource/opensource.html
>
> Search the list archives at: http://markmail.org/search/?q=vtk-developers
>
> Follow this link to subscribe/unsubscribe:
> https://public.kitware.com/mailman/listinfo/vtk-developers
>
>


-- 
Ken Martin PhD
Distinguished Engineer
Kitware Inc.
101 East Weaver Street
Carrboro, North Carolina
27510 USA

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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://public.kitware.com/pipermail/vtk-developers/attachments/20181030/dd50222d/attachment.html>