On Sat 2004-09-25 at 07:58:55 +0100, Max Bowsher wrote:
>
> Perhaps we should think about categorizing our svn help output, to help
> maintain it's readability as we increase the number of commands?
Since I pondered about this independently, I thought I'd make a start.
The excerpt below is the the output of "svn help" (from the 1.0.1
client, but the help output shouldn't have changed too much) with some
grouping added by me. The names of the groups IMHO suck, so please pay
more intention to the grouping itself. Whether you think the groups
themselves resp. the items assigned to them make sense.
Note, that one could easily get rid of the "Mass operations" and/or
"Working-copy maintenance" groups by putting them into the "misc"
group, if they are not worth their own group.
We could add a redundant "most used"/"basics" group at the start,
which would contain something like: add, commit, diff, help, update,
log, status.
I'd also add a (very) short description to the commands (regardless of
grouped or sorted output).
Ah, and if we decide to put the help into groups, we should consider
if we want to add a "--sorted" switch to get the current, sorted
output. Indeed, we may want to give the new output only when
"--grouped" (sp?) is added, depending on compatibility rules: Though I
doubt that some other tool depends on the command line help output,
it's not unthinkable, especially if it just get passed through to a
GUI.
And now to the subject of discussion:
----------------------------------------------------------------------
usage: svn <subcommand> [options] [args]
Type "svn help <subcommand>" for help on a specific subcommand.
Subversion is a tool for version control.
Most subcommands take file and/or directory arguments, recursing
on the directories. If no arguments are supplied to such a
command, it will recurse on the current directory (inclusive) by
default.
Available subcommands:
Modifying:
add
copy (cp)
delete (del, remove, rm)
mkdir
move (mv, rename, ren)
Synchronizing:
commit (ci)
update (up)
merge
resolved
Inspecting:
blame (praise, annotate, ann)
cat
diff (di)
info
list (ls)
log
status (stat, st)
Mass operations:
checkout (co)
export
import
Working-copy maintenance:
switch (sw)
cleanup
revert
Handling Properties:
propdel (pdel, pd)
propedit (pedit, pe)
propget (pget, pg)
proplist (plist, pl)
propset (pset, ps)
Misc:
help (?, h)
For additional information, see http://subversion.tigris.org/
----------------------------------------------------------------------
Bye,
Benjamin.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sat Oct 2 15:50:57 2004