[RFC] [MERGE] Help text updates
John Arbash Meinel
john at arbash-meinel.com
Tue Oct 30 06:11:14 GMT 2007
-----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-----
More information about the bazaar
mailing list