Re: [PATCH 4/4] Documentation/git-svn.txt: Fix formatting errors

From: Sergey Vlasov <vsu@altlinux.ru>
Date: Mar 2, 2007, 18:23 UTC
Message-ID: <20070302182317.GB6811@procyon.home>
In-Reply-To: <20070301203833.GB25782@localdomain>

On Thu, Mar 01, 2007 at 12:38:33PM -0800, Eric Wong wrote:

Show 12 quoted lines

> Sergey Vlasov <vsu@altlinux.ru> wrote:
> > Fix some formatting problems:
> > 
> >   - Some list labels were missing their "::" characters.
> >   - Some of continuation paragraphs in labeled lists were incorrectly
> >     formatted as literal paragraphs.
> >   - In one case "[verse]" was missing before the config key list.
> >   - The "Basic Examples" section was incorrectly nested inside the
> >     "Config File-Only Options" section.
> 
> Thanks.  However, are the indentation changes in the source absolutely
> necessary for asciidoc to correctly format these things?

Yes - normally asciidoc formats indented text as literal paragraphs; only the first paragraph after "tag::" is processed specially. And using a "+" line inside a "--" block also does not work.

> I try to avoid building the docs because my computers are too slow.

Yes, asciidoc is slow, and xmlto (xsltproc) is even slower :(

Show 6 quoted lines

> If so:
> 
> Acked-by: Eric Wong <normalperson@yhbt.net>
> 
> > Signed-off-by: Sergey Vlasov <vsu@altlinux.ru>
> > Cc: Eric Wong <normalperson@yhbt.net>