[PATCH] hgrc.5: separate line blocks from preceding paragraphs

Christian Ebert blacktrash at gmx.net
Thu Dec 3 16:27:49 CST 2009


* Christian Ebert on Thursday, December 03, 2009 at 23:10:09 +0100
> # HG changeset patch
> # User Christian Ebert <blacktrash at gmx.net>
> # Date 1259878162 -3600
> # Node ID b7086ee06823e7715304e371b32caa9726987745
> # Parent  16f49d671c7f076d046e641f50a0c6cefa4ee2c9
> hgrc.5: separate line blocks from preceding paragraphs
> 
> The line blocks showing hgrc paths should not be appended to
> the previous paragraph because the paths' explanations come
> after each line block, not before.
> 
> diff --git a/doc/hgrc.5.txt b/doc/hgrc.5.txt
> --- a/doc/hgrc.5.txt
> +++ b/doc/hgrc.5.txt
> @@ -32,6 +32,7 @@
> paths are given below, settings from earlier paths override later
> ones.
> 
> +|
>| (Unix, Windows) ``<repo>/.hg/hgrc``
> 
>     Per-repository configuration options that only apply in a
> @@ -42,6 +43,7 @@
>     trusted user or to a trusted group. See the documentation for the
>     trusted_ section below for more details.
> 
> +|
>| (Unix) ``$HOME/.hgrc``
>| (Windows) ``%USERPROFILE%\.hgrc``
>| (Windows) ``%USERPROFILE%\Mercurial.ini``

[...]

This change looks very cosmetic. Their might be a problem from
the point of view of logical markup: An indentation change is a
stronger separator than a line block. So it's hard to connect the
indented explanations logically to the preceding line blocks
without indentation.

c
-- 
So is das Leben / Eben. / Eben und flach. / Ach.
     --->> http://www.blacktrash.org/hanullmann/


More information about the Mercurial-devel mailing list