[cmake-developers] documenting a CMake 'use' file

Brad King brad.king at kitware.com
Wed Jan 8 16:25:58 EST 2014


On 01/08/2014 04:00 PM, Matthew Woehlke wrote:
> To be clear, I meant *only* the '#.rst' syntax (i.e. the code to extract 
> the reST markup from a CMake module). I would not expect *that* to 
> change again?

It may.  It already supports a version with long bracket comments:

#[========================================[.rst:
reST docs here
#]========================================]

Either way the scanning implementation belongs in the same place as
the rest of the infrastructure.  It is actually the implementation
of the ".. cmake-module::" directive in the Sphinx extension module.

-Brad




More information about the cmake-developers mailing list