[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