Re: doc/tools/help2doc rewrite in Perl

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.

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.

_______________________________________________
elinks-dev mailing list
[email protected]
http://linuxfromscratch.org/mailman/listinfo/elinks-dev

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFH0rCQHm9IGt60eMgRAo+mAKCj1zYCc7AN03ZPX8h8uhqAAHP+gACgnC40
uDjxE8SDr6qtUBgqSmfenls=
=nDZh
-----END PGP SIGNATURE-----