2012/1/3 Eric Noulard <eric.noul...@gmail.com>:

> back to cleaner way of work.

I did update and clean-up my previous attempt to ease documentation
for CPack.
http://public.kitware.com/Bug/view.php?id=10067

the new up-to-date branch is "stage/ImproveCPackDoc-reloaded"

I'd rather wait for feedback before merging this to next.
Fast try is:

  cpack --help-variable-list
  cpack --help-command-list

then chose whatever var / command you like.
The documentation is extracted from files
(CPack.cmake, CPackComponent.cmake, CPackRPM.cmake, CPackDeb.cmake)
using new markup.

Currently the list of files used are builtin the cpack.cxx source code
but we can imagine
a more dynamic way to do that.

On the contrary if it is too dynamic we could do the extraction as
part of the build process
and embed the result in C++ code.

The proposed markup tries its best to be backward compatible, meaning that
a module "Blah.cmake" which contains the new markup is transparently parsed
by
cmake --help-module Blah

as if it does not contain the new markup.

We could do far better if we will be wanting to drop this but do we?
Give me feedbacks guys.


-- 
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://public.kitware.com/cgi-bin/mailman/listinfo/cmake-developers

Reply via email to