[RFC] [MERGE] Help text updates

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

James Westby wrote:
> On (29/10/07 20:16), Matthew Revell wrote:
>> Hi guys,
>>
>> I've made an initial stab at rewriting some of the Bazaar help texts
>> in builtins.py. A merge directive is attached.
> 
> Hi Matthew,
> 
> Thanks for the changes, a few review comments for your perusal inline.
> 
>>  class cmd_status(Command):
>> -    """Display status summary.
>> -
>> -    This reports on versioned and unknown files, reporting them
>> -    grouped by state.  Possible states are:
>> -
>> +    """Display a summary of files and directories whose status has recently changed.
> 
> I'm not sure about "recently", something is still reported as changed
> even if it was done 5 years ago.
> 
>> +    
>> +    If no arguments are specified, shows summary for entire working 
>> +    directory against previous revision.
> 
> Against its basis tree actually, but I wouldn't want to explain that
> here, so just 
> 
>   If no arguments are specified it shows the summary for the entire
>   working directory. This summary shows the changes that were made
>   since the last revision.
> 
>> +
>> +    Examples:
>> +    
>> +    bzr status
>> +    	Shows changes between current and previous revisions.
> 
>      Shows changes between the current and previous revision.
> 
>> +    	
>> +    bzr status -r 123 -r 321
>> +    	Shows changes between revisions 123 and 321.
> 
>      Shows the changes?
> 
> Wouldn't 'bzr status -r123..321' be more idiomatic?

Actually, it would also be more correct.

I think he was thinking in CVS mode where you supply -r more than once.

In Bazaar, if you do that, you get the working tree changes relative to
revision 321. Not the status between 123 and 321.

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHJsrwJdeBCYSNAAMRAnwJAJ9EfFSqmmc+R6fRNM9wp/f3fG160wCeO/hf
dz9QjG3xcmlMojPVb4t2O3U=
=M7IB
-----END PGP SIGNATURE-----