git-multi.erb in git-multi-1.1.0

- old
+ new

@@ -16,50 +16,68 @@
 
 There are some options for `git multi` itself, in which case it
 is invoked as follows:
 
 [verse]
-'git multi' <dash_dash_option> [<option_arguments>]
+'git multi' --<option> [<option_arguments>]
 
 To execute the same git command in multiple repositories, the
 invocation is as follows:
 
 [verse]
 'git multi' <git_command> [<git_command_arguments>]
 
+Both ways of running `git multi` take an optional, so-called "multi repo"
+argument to limit the operation to the list of repositories in the referenced
+"multi repo", ie. a single GitHub user or a single GitHub organization:
+
+[verse]
+'git multi' ++<multi_repo> --<option> [<option_arguments>]
+
+and...
+
+[verse]
+'git multi' ++<multi_repo> <git_command> [<git_command_arguments>]
+
 DESCRIPTION
 -----------
 
 Convenient way to execute the same git command in a set of related repos,
 currently the repositories of a GitHub user, incl. the organizations they
-are a member of; the repo list is determined via a GitHub API v3 call, and
+are a member of.
+
+The list of repositories is determined via a GitHub API v3 call, and
 cached locally '(in binary format)' for performance and offline usage.
 
+By default, `git multi` operates on all repositories for all configured users
+and all configured organizations.  To limit the operation to a single user or
+a single organization, the optional `++<multi_repo>` argument can be used.
+
 OPTIONS
 -------
 
+--version::
+	print out this script's version number
+
 --help::
 	you're looking at it: show the man page
 
 --html::
 	open the HTML version of the man page
 
 --check::
 	checks all the required settings and configurations
 
---version::
-	print out this script's version number
+--count::
+	print out the count of repos (per type)
 
 --refresh::
 	refresh the list of user & organization repos
 
 --json::
 	output repository details to JSON
 
---count::
-	print out the count of repos (per type)
-
 --list::
 	print out the names of all repos
 
 --archived::
 	print out the names of all repos
@@ -71,23 +89,23 @@
 	print out the names of all repos
 
 --paths::
 	print out the full path for each repos
 
---spurious::
-	list cloned repos whose remote doesn't match a github.com origin
-
 --missing::
 	print out names of repos that haven't been cloned
 
+--clone::
+	clones missing repositories into `${HOME}/Workarea` (by default)
+
 --stale::
 	list repos that have been deleted on github.com
 
 --excess::
 	list repos that don't exist on github.com
 
---clone::
-	clones missing repositories into `${HOME}/Workarea` (by default)
+--spurious::
+	list cloned repos whose remote doesn't match a github.com origin
 
 --query (args)::
 	query GitHub repo metadata for each repository
 
 --find <ruby>::