[PATCH] hgrc5: wrap corrected text at 80 chars for manpage
Christian Ebert
blacktrash at gmx.net
Tue Jun 9 23:25:28 CDT 2009
Hi Martin, Benoit,
* Martin Geisler on Wednesday, June 10, 2009 at 01:31:25 +0200
> Christian Ebert <blacktrash at gmx.net> writes:
>> The more I look at it the stronger I believe that this is by far not
>> enough. There are many more mistakes in the manpage, like characters
>> disappearing because they are not escaped, more or less random
>> indentation levels ... Definitely the bastard child of Mercurial, the
>> man pages.
>
> I've now looked at them and you're completely right -- just splicing
> text together at random is *not* a good idea when it comes to asciidoc
> syntax... I really don't like the syntax, it makes nested lists look
> absolutely horrible with '+'-signs between each paragraph...
Yeah, I saw those '+'-signs, experimented a bit, tried to find
out about it in the asciidoc docs ... and gave up :-(
> But I've now gotten the man pages somewhat into shape:
>
> http://hg.intevation.org/mercurial/crew/rev/a5d0e821ab77
Ah, great!
> The hg.1 man page is still broken since it is mostly built from text
> extracted from the docstrings. I'll have to mess with gendoc.py to make
> it more intelligent about escaping and so.
I know.
Thank you and Benoit!
Sorry for just ranting and not having been more constructive.
It's just that atm I /have/ to do other stuff -- which in parts
is even more annoying than asciidoc syntax.
c
--
\black\trash movie _C O W B O Y_ _C A N O E_ _C O M A_
Ein deutscher Western/A German Western
-->> http://www.blacktrash.org/underdogma/ccc.html
-->> http://www.blacktrash.org/underdogma/ccc-en.html
More information about the Mercurial-devel
mailing list