[CMake] help texts

[Michael Jackson]

On Thursday, December 8, 2011, Michael Wild <themiwi at gmail.com> wrote:
> On 12/08/2011 10:35 AM, Rolf Eike Beer wrote:
>>> words, the markers are doubled, e.g. **bold words**.
>>>
>>> * lists formatting. E.g:
>>>
>>>   - bullet list
>>>   * another bullet item
>>>   ** nested bullet list
>>>   *** deeply nested list
>>
>> How to specify bold words in the second bullet item? Simple solution
would
>> be to force list and title specifiers to always be at the beginning of a
>> line (with no spaces before them).
>
> That was the idea. And if it is to mark bold text, it mustn't be
> followed by space.
>
>>
>>> * section titles. I would go for something like this:
>>>
>>>   = Title
>>>   == Sub-Title
>>>   === Sub-Sub-Title
>>
>> Just a thought: one could take the MediaWiki style and require the same
>> symbol be after the text, e.g. = Title =.
>>
>
> I'd make it optional, the way AsciiDoc does. The one-sided style is
> unambiguous as it is, and is less error prone since it doesn't require
> me to match up the number or equal signs. But that is my preference...
>
> Michael
>
> --
>
> 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
>

What about the docbook.xml file. I have a parser that does everything you
asked for. It is what I used to generate the help files for the CMakeEd
eclipse plugin. The source is in c++ and is open. It generates more XML as
the output but can be used to generate other formats as well.

Mike Jackson

-- 
_________________________________________________________
Mike Jackson                  mike.jackson at bluequartz.net
BlueQuartz Software                    www.bluequartz.net
Principal Software Engineer                  Dayton, Ohio
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.cmake.org/pipermail/cmake/attachments/20111208/2d14dd90/attachment-0001.htm>