2011/11/17 Brad King <brad.k...@kitware.com>:
> On 11/15/2011 2:43 PM, Eric Noulard wrote:
>>
>> The idea is to add extra CMake comment markup, i.e.
>>
>> #   CPACK_PACKAGE_NAME - The name of the package (or application). If
>> #   not specified, defaults to the project name.
>>
>> becomes:
>>
>> ##variable
>> #   CPACK_PACKAGE_NAME - The name of the package (or application). If
>> #   not specified, defaults to the project name.
>> ##end
>>
>> this way we can extract variable documentation from the file itself.
>
> That looks fine to me.  Please ensure that the implementation rejects
> or at least warns about markup that it doesn't understand.

Currently unknown markup are just ignored, but ok I'll add warning.

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