[vtk-developers] New module system preview

[Elvis Stansvik]

Den mån 29 okt. 2018 kl 22:42 skrev Ben Boeckel <ben.boeckel at kitware.com>:
>
> 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.

Fair enough, not as simple as a cat, but almost.

Elvis

>
> 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