2010/9/28 Marcel Loose <lo...@astron.nl>:
>
> On 28. Sep, 2010, at 9:33 , Marcel Loose wrote:
>
>> > Hi all,
>> >
>> > I was wondering how I could generate a list of user-definable CMake
>> > variables. This list, with a brief help per variable, would be
> *very*
>> > useful for the end-user. It's a bit like the well-known "configure
>> > --help" which gives you a overview of all variables that can be set.
>> >
>> > Best regards,
>> > Marcel Loose.
>>
>> Is "cmake -LAH" what you want?
>>
>> Michael
>
> Hi Michael,
>
> Well this is sort of what I was looking for, though I was hoping that it
> would be possible to list any useful variable *before* running CMake.
Before running cmake... I don't know but keep reading.
> Is there some kind of hook, e.g. 'cmake --custom-help', that can be used
> to display project-specific help. The help text should be provided by
> the developer, of course.
You may do the following:
Write an "HelpMe.cmake" file which contains CMake comments
just like plain CMake do (see e.g. CPackRPM.cmake which contains many
variable descriptions)
then add the following custom target to your project:
add_custom_target(HelpMe
COMMAND ${CMAKE_COMMAND}
-DCMAKE_MODULE_PATH=${CMAKE_CURRENT_SOURCE_DIR} --help-module HelpMe
COMMENT "Display User defined help")
this will use the "--help-module" option of cmake to display your custom help.
user can call the target
make HelpMe
and the help will be display.
You may want to call your target "help" but it would conflict/override
the cmake builtin "help" target
(at least for makefile generator) which display the list of available target.
This work AFTER cmake has been run. It could be run before as well using:
cmake -DCMAKE_MODULE_PATH=/path/to/source --help-module HelpMe
but this is awkward :-(
--
Erk
Membre de l'April - « promouvoir et défendre le logiciel libre » -
http://www.april.org
_______________________________________________
Powered by www.kitware.com
Visit other Kitware open-source projects at
http://www.kitware.com/opensource/opensource.html
Please keep messages on-topic and check the CMake FAQ at:
http://www.cmake.org/Wiki/CMake_FAQ
Follow this link to subscribe/unsubscribe:
http://www.cmake.org/mailman/listinfo/cmake
