[PATCH 1 of 3] help: move part of hgrc.5.txt to help/config.txt (issue2804)

[yun lee]

2011/5/30 Martin Geisler <mg at lazybytes.net>:
> Yun Lee <yun.lee.bj at gmail.com> writes:
>
>> # HG changeset patch
>> # User Yun Lee <yun.lee.bj at gmail.com>
>> # Date 1306557566 -28800
>> # Node ID be66dc433d4b4852ea0d74bbe5c8b48af8c62ace
>> # Parent  d1a1578c5f7860b17f2f238b2c1e6adb555ffa4f
>> help: move part of hgrc.5.txt to help/config.txt (issue2804)
>
> I think you should drop the Issue2804 labels from your patches until
> they really solve that issue: the issue is about making 'hg help' show
> subtopics and this is just a step on the way.
It's reasonable.
>
>> diff -r d1a1578c5f78 -r be66dc433d4b mercurial/help/config.txt
>> --- a/mercurial/help/config.txt       Fri May 27 15:59:52 2011 +0200
>> +++ b/mercurial/help/config.txt       Sat May 28 12:39:26 2011 +0800
>> @@ -55,3 +55,1156 @@
>>
>>  - on Unix-like systems: ``man hgrc``
>>  - online: http://www.selenic.com/mercurial/hgrc.5.html
>> +
>> +
>> +Synopsis
>> +--------
>> +
>> +The Mercurial system uses a set of configuration files to control
>> +aspects of its behavior.
>
> I would not move the "Synopsis" section to the built-in help -- it makes
> sense in the man page and fits how man pages are traditionally written.
>
> Actually, I just pushed your patch and some follow-up patches... That
> should show you what I had in mind :-)
Yes, Martin, I have seen your commits on this issue. Thanks for your encourage.
>
> --
> Martin Geisler
>
> Mercurial links: http://mercurial.ch/
>



-- 
Yun Lee