[PATCH] keyword: improve help for kwfiles

[Christian Ebert]

* timeless on Sunday, June 28, 2009 at 14:50:09 +0300
> I wrote:
>> oh gah. fail. i think you want file paths, perhaps. can you provide a
>> more detailed explanation?
> 
> christian wrote:
>> Yes, the docs for the extension (full to the brim of more pidgin
>> English), available canonically via
>> 
>> $ hg help keyword
> 
> yeah, i don't want that, i can type it as much as the next person, i
> want an explanation, not random strings of words.

I might be bad at English, but I was certainly not a chimp typing
randomly away when I tried to phrase the general help ;-) Well,
at least I hope not. I quoted the help so we don't duplicate
information.

If we take the "hg status -h" analogy, its summary is:

show changed files in the working directory

But one could argue that what hg status actually does is:

show file paths - relative to the repository root - of changed files in the working directory

(where "relative etc." again depends on options, arguments, and
pwd)

hg status certainly does not show the files. So perhaps revert to
just "files"? I really don't know any more.

>>> is it possible to match this/file and not that/file ?
>> 
>> Yes.
> 
>> *K*eyword expansion candidate?
>> 
>> (not *K*ellogg's *K*orn Flakes ;-) )
>> 
>> To someone already familiar with the flags of "hg status" not
>> that difficult a guess, I thought.
> 
> ah, but see, i don't have to guess.
> 
> hg help status has:
>    The codes used to show the status of files are:
>    M = modified
>    A = added
>    R = removed
>    C = clean
>    ! = missing (deleted by non-hg command, but still tracked)
>    ? = not tracked
>    I = ignored
>      = origin of the previous file listed as A (added)
> 
>> But something analogous to the status help would be:
>> 
>>    With -a/--all and -v/--verbose the codes used to show the status
>>    of files are:
>>    K = keyword expansion candidate
>>    I = ignored
> 
> yes please.

ok, might extend functionality to:

    k = keyword expansion candidate (untracked)
    i = ignored (untracked)

c
-- 
  Was heißt hier Dogma, ich bin Underdogma!
[ What the hell do you mean dogma, I am underdogma. ]
_F R E E_  _V I D E O S_  http://www.blacktrash.org/underdogma/
                          http://www.blacktrash.org/underdogma/index-en.html