[PATCH] more clear and consistent basic help

Nir Soffer nirs at freeshell.org
Wed Aug 31 04:40:06 BST 2005


In my first use of bzr I failed to notice the important bzr help 
command and bzr help commands, because they are hidden in that last 
line with no space at the end. I think it will not happen when they are 
formatted just like any other command.

While fixing this, I added the missing help line for commit.

And last, I removed the word "pull" from the help of "merge" because 
"pull" is another command, and this might confuse the reader.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: help.patch
Type: application/octet-stream
Size: 1340 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20050831/3a238db5/attachment.obj 
-------------- next part --------------



There are some more problems, that I'm not sure how to solve:

   bzr init           makes this branch versioned

	bzr help commands says: "Make a directory into a versioned branch." 
seems more correct.

   bzr mv             move or rename a versioned file

	there is bzr move and bzr rename - is this a third option? confusing

   bzr status         summarize changes in working copy

	show summary of changes in this branch?	
	

The help should talk about the same terms, at least in the same screen 
:).

I'm not sure there is point to repeat "this branch" "this branch", all 
commands work on "this branch", expect "merge" which use "another 
branch" and copy which copy one branch to new location.


Best Regards,

Nir Soffer


More information about the bazaar mailing list