[PATCH] help: move topic "files" from /doc/hg.1.txt to /mercurial/help/ (issue2760)

[Benoit Boissinot]

On Fri, Apr 29, 2011 at 3:08 PM, yun lee <yun.lee.bj at gmail.com> wrote:
> 2011/4/29 Martin Geisler <mg at lazybytes.net>:
>> Adrian Buehlmann <adrian at cadifra.com> writes:
>>
>>> On 2011-04-28 17:44, yun lee wrote:
>>>>  Bugs
>>>>  ----
>>>> diff -r 8f81d6f4047f -r 6d86d2c0f948 mercurial/help.py
>>>> --- a/mercurial/help.py Fri Apr 08 17:47:58 2011 +0300
>>>> +++ b/mercurial/help.py Sat Apr 09 23:39:55 2011 +0800
>>>> @@ -106,6 +106,7 @@
>>>>     (["subrepo", "subrepos"], _("Subrepositories"), loaddoc('subrepos')),
>>>>     (["hgweb"], _("Configuring hgweb"), loaddoc('hgweb')),
>>>>     (["glossary"], _("Glossary"), loaddoc('glossary')),
>>>> +    (["files"], _("Files"), loaddoc("files")),
>>>>  ])
>>>
>>> This might be a bit far-fetched: but - if possible - I would prefer if
>>> we could reserve the name "files" for something else and not consume
>>> the name "files" for this specific help topic here.
>>
>> Yeah, I don't think we should just move the help text into help topics
>> like this -- we'll get a lot of small help topics with little structure.
>
> Am, I agree with you, it will be better. Then, what are others'
> opinions, please?

What do you think we should do to move things from doc/ to mercurial/help/?
Only move self-contained topics, is there a minimum topic size?
What is the long term goal we want to achieve there (sorry I haven't
followed all the discussions).

regards,

Benoit