[darcs-users] `darcs annotate -p` misnamed

Dan Pascu dan at ag-projects.com
Tue Jul 14 23:25:21 UTC 2009

On 15 Jul 2009, at 01:57, Max Battcher wrote:

> Ashley Moran wrote:
> > I have a feeling `annotate -p` may be better under a different darcs
>> command.  Maybe as an option to `darcs changes` or `darcs show`.   
>> Perhaps `darcs show patch ...`?
>> WDYT?
> IIRC, I, or someone else, has made a similar suggestion in the past:  
> keep ``darcs annotate -p`` as is, but provide ``darcs show patch``  
> as a nice, discoverable alternative. (Just as ``darcs show tags`` is  
> nicer than ``darcs changes --tags .`` + parsing.)

+1 on this.

I didn't know about annotate -p, but now that I did learn about it, I  
find it a bit confusing. I expect annotate to show me who did what  
changes to a certain file, not to show a patch content.

What's even more confusing, is that if I specify both a patch name and  
a file name, the patch is completely ignored and I get the full  
annotation for that file (even if the filename I provide is one  
affected by the patch I specify):

darcs annotate --patch "Foobar" filename


More information about the darcs-users mailing list