Kalle Olavi Niemitalo <[EMAIL PROTECTED]> wrote Sat, Mar 08, 2008: > Jonas Fonseca <[EMAIL PROTECTED]> writes: > > > Kalle Olavi Niemitalo <[EMAIL PROTECTED]> wrote Sat, Mar 08, 2008: > >> OK to apply? If not, please fix the shell version. > > > > Nice! OK from here. > > There was still a bug in that one. Apparently, because the > option description is part of a list item, AsciiDoc wants its > paragraphs to be separated with lines containing only "+". > Also, if the second paragraph is indented like the first one, > it will be indented deeper in the man page. I fixed these in > a new version, which I pushed to 0.12 and then merged to 0.13. > It could be cherry-picked to 0.11 too but I'll let you decide > whether to do that.
It looks good. For lists with items spanning mulitple paragrahps there is a "list environment token": -- - First para. Second para. - New item. -- > AsciiDoc syntax seems full of traps for the unwary. > It might be better to make help2doc generate DocBook, > and then convert from that to HTML and man pages. > An earlier version already did that though, > so perhaps there was some reason to change it. I have changed the ELinks documentation several times, most recently to use AsciiDoc because I liked it and text files are easier. There are as you mention many traps in the syntax of AsciiDoc. We could generate "raw" DocBook and HTML and tell AsciiDoc to use that when compiling to .xml and .html. A different problem is the "syntax" of the option descriptions, which are somewhat freeform when it comes to the int option "lists". -- Jonas Fonseca _______________________________________________ elinks-dev mailing list [email protected] http://linuxfromscratch.org/mailman/listinfo/elinks-dev
