On Sun, Aug 24, 2014 at 04:09:13PM +0100, Michael Treibton wrote: > On 24 August 2014 10:00, Thomas Adam <tho...@fvwm.org> wrote: > > But heed my previous email; when you get down to it, *roff (mdoc) *is* > > the abstraction layer. That mdoc allows for all these things, and is > > still letting you use the very typesetting language man pages render > > with, etc., is a winner in my eyes. > > https://github.com/ThomasAdam/fvwm/blob/ta/asciidoc/Documentation/FvwmDecor/DefaultColors.txt > > the mdoc version is going to be a lot more work - many more commands > to include - and it gets in the way.
That example lacks almost all the markup in the text. It does not allow to automatically generate links in html format, or identify command names, command options, styles, strings, key sequences etc. by markup. An Asciidoc source file without all that is useless. I've spent weeks to add the proper markup to the original fvwm man pages before they were converted to xml. I won't accept any documentation format that throws all this extra information away for no reason. Ciao Dominik ^_^ ^_^ -- Dominik Vogt
