Changing order in bzr help command text

Alexander Belchenko bialix at ukr.net
Mon Oct 29 15:09:58 GMT 2007


Matthew Revell пишет:
> Hi,
> 
> Would it be desirable to move the "aliases" and "see also" lines in
> command-line help to the top of the output?
> 
> Taking "bzr status help" as an example:
> 
> Purpose: Display status summary.
> Usage:   bzr status [FILE...]
> Aliases:  st, stat
> See also: diff, revert, status-flags
> 
> Options:
> <snip>
> 
> I ask because longer descriptions can make the "aliases" and "see
> also" easy to miss.

Most of the time long ago aliases indeed was shown at the top of help.
IMO, Ian change this layout when he did refactoring of help subsystem.
I have no objection to move it back.

But 'see also' in all man pages I ever seen always shown at the bottom.
I don't think it make sense to have it at top.

> 
> I don't think it would be overloading the top of the help text to move
> them up front.
> 
> Anyone have an objection to moving them? I'm not proposing to move
> them myself, btw.
> 




More information about the bazaar mailing list