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

[Adrian Buehlmann]

On 2011-04-28 20:43, Kevin Bullock wrote:
> On Apr 28, 2011, at 11:32 AM, Adrian Buehlmann wrote:
> 
>> 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.
>>
>> Imagine there would be a new 'files' command in the future: "hg files"
>> (we already have 'hg branches', 'hg tags', etc. and mercurial is about
>> tracking files...).
> 
> Umm, `hg manifest`?

Yeah. That's using the manifest :-)

>> Getting help about that hypothetical files command would be "hg help
>> files". If we take that for a help topic *now*, we would have to rename
>> it later, invalidating URLs to that help topic.
>>
>> (for a hypothetical files command candidate see [1])
>>
>> [1] https://bitbucket.org/abuehl/hgext-cifiles
> 
> 
> What does cifiles do in contradistinction to `manifest`?

As explained in

https://bitbucket.org/abuehl/hgext-cifiles/src/default/cifiles.py

    Prints the names of all files that have been checked-in in any revision
    of the repository (including files that are deleted or renamed in tip).

A pretty costly operation, if you try to do that by using the manifests.

cifiles doesn't access the manifests at all.