[PATCH] hgrc5: wrap corrected text at 80 chars for manpage

[Matt Mackall]

On Wed, 2009-06-10 at 01:31 +0200, Martin Geisler wrote:
> 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...
> 
> But I've now gotten the man pages somewhat into shape:
> 
>   http://hg.intevation.org/mercurial/crew/rev/a5d0e821ab77
> 
> 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.

As I suggested last time this came up, it might be time to reconsider
our use of asciidoc. Our formatting needs here are fairly minimal. It'd
probably be pretty easy for gendoc.py to generate decent nroff output
directly. 

-- 
http://selenic.com : development and support for Mercurial and Linux