git-multi 1.0.10 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87a5098e57c1c0543ff692107ed8f72df532fb3dfdc0695c50611e2f478af8c4
-  data.tar.gz: 7d26ed3027f6115e335cb88786cc4cab70bf9f94eb184551d13df1d2f5c8a120
+  metadata.gz: 78f3a989686451a2c8da7e936efccc3c209a5128c2908650b640eef01f7f5997
+  data.tar.gz: 304141ffe253506dfa598a095dd9023e38be5bc8cd9de7c4ff742cada0ccfb2e
 SHA512:
-  metadata.gz: 947af0e03bb9bcbb8ee2b22ea976163c5becc4207b3d0787c0be3f9439c9cd64d657f8324fed2ee0e9acd7a2390e464e9d876bc700b21c1e79962b0ac5f2ef77
-  data.tar.gz: d8e11968d5a6eeba9157a21ff12f49f5a769a261f38a34d593019d150ed2812a1af3aab7f33aab2b4ce0022a7efb50ffb197dc8d2513772d8435794e62b364bc
+  metadata.gz: bbb67393419507f66f7c9936af27224d546f2fb3a69c6be00e1683b70ebce029aeaeabd21dce4ea3d2fdeaedd1e3f9214f9a9961f1be1da03b79ca7232969b0a
+  data.tar.gz: bd96d42a7982341c95f1f453743f6701107fdb2468f66ce9d5b3532f3ed80dea105a04e775f2d3e223bef98986f51e0032451f725eff22544b754a880f52751e

data/exe/git-multi

@@ -4,30 +4,41 @@ lib = File.expand_path('../../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'git/multi'
 
-case (command = ARGV.shift)
+if (command = ARGV.shift).start_with? '++'
+  multi_repo = command[2..-1]
+  if Git::Multi.valid?(multi_repo)
+    command = nil
+  else
+    abort \
+      "Unknown multi repo: #{multi_repo}\n\n" \
+      '(use --check to list all known multi repos)'
+  end
+end
+
+case (command ||= ARGV.shift)
 when /\A--/
   case command
+  when '--version' then Git::Multi::Commands.version
   when '--help'    then Git::Multi::Commands.help
   when '--html'    then Git::Multi::Commands.html
   when '--check'   then Git::Multi::Commands.check
-  when '--version' then Git::Multi::Commands.version
-  when '--refresh' then Git::Multi::Commands.refresh
-  when '--json'    then Git::Multi::Commands.json
   when '--count'   then Git::Multi::Commands.count
-  when '--list'    then Git::Multi::Commands.list
-  when '--archived'then Git::Multi::Commands.archived
-  when '--forked'  then Git::Multi::Commands.forked
-  when '--private' then Git::Multi::Commands.private
-  when '--paths'   then Git::Multi::Commands.paths
-  when '--spurious'then Git::Multi::Commands.spurious
-  when '--missing' then Git::Multi::Commands.missing
-  when '--stale'   then Git::Multi::Commands.stale
-  when '--excess'  then Git::Multi::Commands.excess
-  when '--clone'   then Git::Multi::Commands.clone
-  when '--query'   then Git::Multi::Commands.query(ARGV)
-  when '--find'    then Git::Multi::Commands.find(ARGV)
-  when '--eval'    then Git::Multi::Commands.eval(ARGV)
-  when '--raw'     then Git::Multi::Commands.raw(ARGV)
+  when '--refresh' then Git::Multi::Commands.refresh
+  when '--json'    then Git::Multi::Commands.json(multi_repo)
+  when '--list'    then Git::Multi::Commands.list(multi_repo)
+  when '--archived'then Git::Multi::Commands.archived(multi_repo)
+  when '--forked'  then Git::Multi::Commands.forked(multi_repo)
+  when '--private' then Git::Multi::Commands.private(multi_repo)
+  when '--paths'   then Git::Multi::Commands.paths(multi_repo)
+  when '--missing' then Git::Multi::Commands.missing(multi_repo)
+  when '--clone'   then Git::Multi::Commands.clone(multi_repo)
+  when '--stale'   then Git::Multi::Commands.stale(multi_repo)
+  when '--excess'  then Git::Multi::Commands.excess(multi_repo)
+  when '--spurious'then Git::Multi::Commands.spurious(multi_repo)
+  when '--query'   then Git::Multi::Commands.query(ARGV, multi_repo)
+  when '--find'    then Git::Multi::Commands.find(ARGV, multi_repo)
+  when '--eval'    then Git::Multi::Commands.eval(ARGV, multi_repo)
+  when '--raw'     then Git::Multi::Commands.raw(ARGV, multi_repo)
   else
     abort \
       "Unknown 'git multi' command: #{command}\n\n" \
@@ -36,8 +47,8 @@ when /\A--/
 when nil, '', '-h'
   Git::Multi::Commands.help
 else
-  Git::Multi::Commands.report
-  Git::Multi::Commands.exec command, ARGV
+  Git::Multi::Commands.report(multi_repo)
+  Git::Multi::Commands.exec(command, ARGV, multi_repo)
 end
 
 # That's all Folks!

data/lib/git/multi/commands.rb

@@ -8,6 +8,14 @@ module Git
         puts Git::Multi::LONG_VERSION
       end
 
+      def help
+        Kernel.exec "man #{Git::Multi::MAN_PAGE}"
+      end
+
+      def html
+        Kernel.exec "open #{Git::Multi::HTML_PAGE}"
+      end
+
       def check
         # Settings.user_status(Git::Multi::USER)
         # Settings.organization_status(Git::Multi::ORGANIZATIONS)
@@ -19,55 +27,6 @@ module Git
         # Settings.file_status(Git::Multi::REPOSITORIES)
       end
 
-      def help
-        Kernel.exec "man #{Git::Multi::MAN_PAGE}"
-      end
-
-      def html
-        Kernel.exec "open #{Git::Multi::HTML_PAGE}"
-      end
-
-      def report
-        (missing_repos = Git::Multi.missing_repositories).any? &&
-          notify(missing_repos.map(&:full_name), subtitle: "#{missing_repos.count} missing repos")
-      end
-
-      def list
-        puts Git::Multi.repositories.map(&:full_name)
-      end
-
-      def archived
-        puts Git::Multi.archived_repositories.map(&:full_name)
-      end
-
-      def forked
-        puts Git::Multi.forked_repositories.map(&:full_name)
-      end
-
-      def private
-        puts Git::Multi.private_repositories.map(&:full_name)
-      end
-
-      def paths
-        puts Git::Multi.repositories.map(&:local_path)
-      end
-
-      def missing
-        puts Git::Multi.missing_repositories.map(&:full_name)
-      end
-
-      def excess
-        puts Git::Multi.excess_repositories.map(&:full_name)
-      end
-
-      def stale
-        puts Git::Multi.stale_repositories.map(&:full_name)
-      end
-
-      def spurious
-        puts Git::Multi.spurious_repositories.map(&:full_name)
-      end
-
       def count
         # https://developer.github.com/v3/repos/#list-user-repositories
         Git::Multi::USERS.each do |user|
@@ -87,12 +46,36 @@ module Git
         Git::Multi.refresh_repositories
       end
 
-      def json
-        puts Git::Multi.repositories.to_json
+      def json(multi_repo = nil)
+        puts Git::Multi.repositories_for(multi_repo).to_json
+      end
+
+      def list(multi_repo = nil)
+        puts Git::Multi.repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def archived(multi_repo = nil)
+        puts Git::Multi.archived_repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def forked(multi_repo = nil)
+        puts Git::Multi.forked_repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def private(multi_repo = nil)
+        puts Git::Multi.private_repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def paths(multi_repo = nil)
+        puts Git::Multi.repositories_for(multi_repo).map(&:local_path)
+      end
+
+      def missing(multi_repo = nil)
+        puts Git::Multi.missing_repositories_for(multi_repo).map(&:full_name)
       end
 
-      def clone
-        Git::Multi.missing_repositories.each do |repo|
+      def clone(multi_repo = nil)
+        Git::Multi.missing_repositories_for(multi_repo).each do |repo|
           FileUtils.mkdir_p repo.parent_dir
           repo.just_do_it(
             ->(project) {
@@ -107,8 +90,20 @@ module Git
         end
       end
 
-      def query(args = [])
-        Git::Multi.repositories.each do |repo|
+      def stale(multi_repo = nil)
+        puts Git::Multi.stale_repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def excess(multi_repo = nil)
+        puts Git::Multi.excess_repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def spurious(multi_repo = nil)
+        puts Git::Multi.spurious_repositories_for(multi_repo).map(&:full_name)
+      end
+
+      def query(args = [], multi_repo = nil)
+        Git::Multi.repositories_for(multi_repo).each do |repo|
           repo.just_do_it(
             ->(project) {
               args.each do |attribute|
@@ -123,33 +118,8 @@ module Git
         end
       end
 
-      def system(args = [])
-        cmd = args.map!(&:shellescape).join(' ')
-        Git::Multi.cloned_repositories.each do |repo|
-          repo.just_do_it(
-            ->(_project) {
-              Kernel.system cmd
-            },
-            ->(project) {
-              Kernel.system "#{cmd} 2>&1 | sed -e 's#^##{project.full_name.shellescape}: #'"
-            },
-            in: 'local_path'
-          )
-        end
-      end
-
-      def raw(args)
-        args.unshift ['sh', '-c']
-        system args.flatten
-      end
-
-      def exec(command, args = [])
-        args.unshift ['git', '--no-pager', command]
-        system args.flatten
-      end
-
-      def find(commands)
-        Git::Multi.cloned_repositories.each do |repo|
+      def find(commands, multi_repo = nil)
+        Git::Multi.cloned_repositories_for(multi_repo).each do |repo|
           Dir.chdir(repo.local_path) do
             if repo.instance_eval(commands.join(' && '))
               repo.just_do_it(
@@ -164,8 +134,8 @@ module Git
         end
       end
 
-      def eval(commands)
-        Git::Multi.cloned_repositories.each do |repo|
+      def eval(commands, multi_repo)
+        Git::Multi.cloned_repositories_for(multi_repo).each do |repo|
           Dir.chdir(repo.local_path) do
             repo.instance_eval(commands.join(' ; '))
           rescue Octokit::NotFound
@@ -175,6 +145,41 @@ module Git
         end
       end
 
+      def raw(args, multi_repo = nil)
+        args.unshift ['sh', '-c']
+        system(args.flatten, multi_repo)
+      end
+
+      def report(multi_repo = nil)
+        (missing = Git::Multi.missing_repositories_for(multi_repo)).any? &&
+          notify(
+            missing.map(&:full_name),
+            subtitle: "#{missing.count} missing repos"
+          )
+      end
+
+      def exec(command, args = [], multi_repo = nil)
+        args.unshift ['git', '--no-pager', command]
+        system(args.flatten, multi_repo)
+      end
+
+      def system(args = [], multi_repo = nil)
+        cmd = args.map!(&:shellescape).join(' ')
+        Git::Multi.cloned_repositories_for(multi_repo).each do |repo|
+          repo.just_do_it(
+            ->(_project) {
+              Kernel.system cmd
+            },
+            ->(project) {
+              Kernel.system "#{cmd} 2>&1 | sed -e 's#^##{project.full_name.shellescape}: #'"
+            },
+            in: 'local_path'
+          )
+        end
+      end
+
+      private_class_method :system
+
     end
   end
 end

data/lib/git/multi/version.rb

@@ -6,7 +6,7 @@ require 'addressable'
 module Git
   module Multi
     NAME = 'git-multi'.freeze
-    VERSION = '1.0.10'.freeze
+    VERSION = '1.1.0'.freeze
 
     DEPENDENCY_VERSIONS = [
       "octokit.rb v#{Octokit::VERSION}",

data/lib/git/multi.rb

@@ -43,6 +43,14 @@ module Git
 
     module_function
 
+    #
+    # multi-repo support
+    #
+
+    def valid?(multi_repo)
+      (USERS + ORGANIZATIONS).include? multi_repo
+    end
+
     #
     # local repositories (in WORKAREA)
     #
@@ -56,23 +64,61 @@ module Git
     }
 
     def local_repositories
-      (
+      @local_repositories ||= (
         USERS.map { |user| @local_user_repositories[user] } +
         ORGANIZATIONS.map { |org| @local_org_repositories[org] }
       ).flatten
     end
 
+    def local_repositories_for(multi_repo = nil)
+      case (owner = multi_repo)
+      when nil
+        local_repositories
+      when *USERS
+        @local_user_repositories[owner]
+      when *ORGANIZATIONS
+        @local_org_repositories[owner]
+      else
+        raise "Unknown multi repo: #{multi_repo}"
+      end
+    end
+
     #
     # remote repositories (on GitHub)
     #
 
+    @github_user_repositories = Hash.new { |repos, user|
+      repos[user] = Git::Hub.user_repositories(user)
+    }
+
+    @github_org_repositories = Hash.new { |repos, org|
+      repos[org] = Git::Hub.org_repositories(org)
+    }
+
     def github_repositories
       @github_repositories ||= (
-        USERS.map { |user| Git::Hub.user_repositories(user) } +
-        ORGANIZATIONS.map { |org| Git::Hub.org_repositories(org) }
+        USERS.map { |user| @github_user_repositories[user] } +
+        ORGANIZATIONS.map { |org| @github_org_repositories[org] }
       ).flatten
     end
 
+    def github_repositories_for(multi_repo = nil)
+      case (owner = multi_repo)
+      when nil
+        github_repositories
+      when *USERS
+        @github_user_repositories[owner]
+      when *ORGANIZATIONS
+        @github_org_repositories[owner]
+      else
+        raise "Unknown multi repo: #{multi_repo}"
+      end
+    end
+
+    #
+    # manage the local repository cache
+    #
+
     def refresh_repositories
       File.directory?(CACHE) || FileUtils.mkdir_p(CACHE)
 
@@ -132,42 +178,56 @@ module Git
       end
     end
 
+    #
+    # lists of repos for a given multi-repo
+    #
+
+    def repositories_for(multi_repo = nil)
+      if multi_repo.nil?
+        repositories
+      else
+        repositories.find_all { |repository|
+          repository.owner.login == multi_repo
+        }
+      end
+    end
+
     #
     # lists of repositories with a given state
     #
 
-    def archived_repositories
-      repositories.find_all(&:archived)
+    def archived_repositories_for(multi_repo = nil)
+      repositories_for(multi_repo).find_all(&:archived)
     end
 
-    def forked_repositories
-      repositories.find_all(&:fork)
+    def forked_repositories_for(multi_repo = nil)
+      repositories_for(multi_repo).find_all(&:fork)
     end
 
-    def private_repositories
-      repositories.find_all(&:private)
+    def private_repositories_for(multi_repo = nil)
+      repositories_for(multi_repo).find_all(&:private)
     end
 
     #
     # derived lists of repositories
     #
 
-    def excess_repositories
-      repository_full_names = repositories.map(&:full_name)
-      local_repositories.reject { |project|
+    def excess_repositories_for(multi_repo = nil)
+      repository_full_names = repositories_for(multi_repo).map(&:full_name)
+      local_repositories_for(multi_repo).reject { |project|
         repository_full_names.include? project.full_name
       }
     end
 
-    def stale_repositories
-      repository_full_names = github_repositories.map(&:full_name)
-      repositories.reject { |project|
+    def stale_repositories_for(multi_repo = nil)
+      repository_full_names = github_repositories_for(multi_repo).map(&:full_name)
+      repositories_for(multi_repo).reject { |project|
         repository_full_names.include? project.full_name
       }
     end
 
-    def spurious_repositories
-      cloned_repositories.find_all { |project|
+    def spurious_repositories_for(multi_repo = nil)
+      cloned_repositories_for(multi_repo).find_all { |project|
         origin_url = `git -C #{project.local_path} config --get remote.origin.url`.chomp
         ![
           project.clone_url,
@@ -179,14 +239,14 @@ module Git
       }
     end
 
-    def missing_repositories
-      repositories.find_all { |project|
+    def missing_repositories_for(multi_repo = nil)
+      repositories_for(multi_repo).find_all { |project|
         !File.directory? project.local_path
       }
     end
 
-    def cloned_repositories
-      repositories.find_all { |project|
+    def cloned_repositories_for(multi_repo = nil)
+      repositories_for(multi_repo).find_all { |project|
         File.directory? project.local_path
       }
     end

data/man/git-multi.1

@@ -2,12 +2,12 @@
 .\"     Title: git-multi
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/01/2018
+.\"      Date: 11/09/2018
 .\"    Manual: Git Manual
 .\"    Source: Git 2.19.1.542.gc4df23f792.dirty
 .\"  Language: English
 .\"
-.TH "GIT\-MULTI" "1" "11/01/2018" "Git 2\&.19\&.1\&.542\&.gc4df23" "Git Manual"
+.TH "GIT\-MULTI" "1" "11/09/2018" "Git 2\&.19\&.1\&.542\&.gc4df23" "Git Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -31,13 +31,13 @@
 git-multi \- execute the same git command in multiple repositories
 .SH "VERSION"
 .sp
-This is \fBv1\&.0\&.10\fR of \fIgit multi\fR \&... hooray!
+This is \fBv1\&.1\&.0\fR of \fIgit multi\fR \&... hooray!
 .SH "SYNOPSIS"
 .sp
 There are some options for \fBgit multi\fR itself, in which case it is invoked as follows:
 .sp
 .nf
-\fIgit multi\fR <dash_dash_option> [<option_arguments>]
+\fIgit multi\fR \-\-<option> [<option_arguments>]
 .fi
 .sp
 .sp
@@ -47,11 +47,34 @@ To execute the same git command in multiple repositories, the invocation is as f
 \fIgit multi\fR <git_command> [<git_command_arguments>]
 .fi
 .sp
+.sp
+Both ways of running \fBgit multi\fR 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:
+.sp
+.nf
+\fIgit multi\fR ++<multi_repo> \-\-<option> [<option_arguments>]
+.fi
+.sp
+.sp
+and\&...
+.sp
+.nf
+\fIgit multi\fR ++<multi_repo> <git_command> [<git_command_arguments>]
+.fi
+.sp
 .SH "DESCRIPTION"
 .sp
-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 cached locally \fI(in binary format)\fR for performance and offline usage\&.
+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\&.
+.sp
+The list of repositories is determined via a GitHub API v3 call, and cached locally \fI(in binary format)\fR for performance and offline usage\&.
+.sp
+By default, \fBgit multi\fR 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 \fB++<multi_repo>\fR argument can be used\&.
 .SH "OPTIONS"
 .PP
+\-\-version
+.RS 4
+print out this script\(cqs version number
+.RE
+.PP
 \-\-help
 .RS 4
 you\(cqre looking at it: show the man page
@@ -67,9 +90,9 @@ open the HTML version of the man page
 checks all the required settings and configurations
 .RE
 .PP
-\-\-version
+\-\-count
 .RS 4
-print out this script\(cqs version number
+print out the count of repos (per type)
 .RE
 .PP
 \-\-refresh
@@ -82,11 +105,6 @@ refresh the list of user & organization repos
 output repository details to JSON
 .RE
 .PP
-\-\-count
-.RS 4
-print out the count of repos (per type)
-.RE
-.PP
 \-\-list
 .RS 4
 print out the names of all repos
@@ -112,14 +130,16 @@ print out the names of all repos
 print out the full path for each repos
 .RE
 .PP
-\-\-spurious
+\-\-missing
 .RS 4
-list cloned repos whose remote doesn\(cqt match a github\&.com origin
+print out names of repos that haven\(cqt been cloned
 .RE
 .PP
-\-\-missing
+\-\-clone
 .RS 4
-print out names of repos that haven\(cqt been cloned
+clones missing repositories into
+\fB${HOME}/Workarea\fR
+(by default)
 .RE
 .PP
 \-\-stale
@@ -132,11 +152,9 @@ list repos that have been deleted on github\&.com
 list repos that don\(cqt exist on github\&.com
 .RE
 .PP
-\-\-clone
+\-\-spurious
 .RS 4
-clones missing repositories into
-\fB${HOME}/Workarea\fR
-(by default)
+list cloned repos whose remote doesn\(cqt match a github\&.com origin
 .RE
 .PP
 \-\-query (args)

data/man/git-multi.erb

@@ -18,7 +18,7 @@ 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:
@@ -26,17 +26,38 @@ 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
 
@@ -46,8 +67,8 @@ OPTIONS
 --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
@@ -55,9 +76,6 @@ OPTIONS
 --json::
 	output repository details to JSON
 
---count::
-	print out the count of repos (per type)
-
 --list::
 	print out the names of all repos
 
@@ -73,20 +91,20 @@ OPTIONS
 --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

data/man/git-multi.html

@@ -748,7 +748,7 @@ git-multi(1) Manual Page
 <div class="sect1">
 <h2 id="_version">VERSION</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>This is <code>v1.0.10</code> of <em>git multi</em> &#8230; hooray!</p></div>
+<div class="paragraph"><p>This is <code>v1.1.0</code> of <em>git multi</em> &#8230; hooray!</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -757,7 +757,7 @@ git-multi(1) Manual Page
 <div class="paragraph"><p>There are some options for <code>git multi</code> itself, in which case it
 is invoked as follows:</p></div>
 <div class="verseblock">
-<pre class="content"><em>git multi</em> &lt;dash_dash_option&gt; [&lt;option_arguments&gt;]</pre>
+<pre class="content"><em>git multi</em> --&lt;option&gt; [&lt;option_arguments&gt;]</pre>
 <div class="attribution">
 </div></div>
 <div class="paragraph"><p>To execute the same git command in multiple repositories, the
@@ -766,6 +766,18 @@ invocation is as follows:</p></div>
 <pre class="content"><em>git multi</em> &lt;git_command&gt; [&lt;git_command_arguments&gt;]</pre>
 <div class="attribution">
 </div></div>
+<div class="paragraph"><p>Both ways of running <code>git multi</code> 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:</p></div>
+<div class="verseblock">
+<pre class="content"><em>git multi</em> ++&lt;multi_repo&gt; --&lt;option&gt; [&lt;option_arguments&gt;]</pre>
+<div class="attribution">
+</div></div>
+<div class="paragraph"><p>and&#8230;</p></div>
+<div class="verseblock">
+<pre class="content"><em>git multi</em> ++&lt;multi_repo&gt; &lt;git_command&gt; [&lt;git_command_arguments&gt;]</pre>
+<div class="attribution">
+</div></div>
 </div>
 </div>
 <div class="sect1">
@@ -773,8 +785,12 @@ invocation is as follows:</p></div>
 <div class="sectionbody">
 <div class="paragraph"><p>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.</p></div>
+<div class="paragraph"><p>The list of repositories is determined via a GitHub API v3 call, and
 cached locally <em>(in binary format)</em> for performance and offline usage.</p></div>
+<div class="paragraph"><p>By default, <code>git multi</code> 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 <code>++&lt;multi_repo&gt;</code> argument can be used.</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -782,6 +798,14 @@ cached locally <em>(in binary format)</em> for performance and offline usage.</p
 <div class="sectionbody">
 <div class="dlist"><dl>
 <dt class="hdlist1">
+--version
+</dt>
+<dd>
+<p>
+        print out this script&#8217;s version number
+</p>
+</dd>
+<dt class="hdlist1">
 --help
 </dt>
 <dd>
@@ -806,11 +830,11 @@ cached locally <em>(in binary format)</em> for performance and offline usage.</p
 </p>
 </dd>
 <dt class="hdlist1">
---version
+--count
 </dt>
 <dd>
 <p>
-        print out this script&#8217;s version number
+        print out the count of repos (per type)
 </p>
 </dd>
 <dt class="hdlist1">
@@ -830,14 +854,6 @@ cached locally <em>(in binary format)</em> for performance and offline usage.</p
 </p>
 </dd>
 <dt class="hdlist1">
---count
-</dt>
-<dd>
-<p>
-        print out the count of repos (per type)
-</p>
-</dd>
-<dt class="hdlist1">
 --list
 </dt>
 <dd>
@@ -878,19 +894,19 @@ cached locally <em>(in binary format)</em> for performance and offline usage.</p
 </p>
 </dd>
 <dt class="hdlist1">
---spurious
+--missing
 </dt>
 <dd>
 <p>
-        list cloned repos whose remote doesn&#8217;t match a github.com origin
+        print out names of repos that haven&#8217;t been cloned
 </p>
 </dd>
 <dt class="hdlist1">
---missing
+--clone
 </dt>
 <dd>
 <p>
-        print out names of repos that haven&#8217;t been cloned
+        clones missing repositories into <code>${HOME}/Workarea</code> (by default)
 </p>
 </dd>
 <dt class="hdlist1">
@@ -910,11 +926,11 @@ cached locally <em>(in binary format)</em> for performance and offline usage.</p
 </p>
 </dd>
 <dt class="hdlist1">
---clone
+--spurious
 </dt>
 <dd>
 <p>
-        clones missing repositories into <code>${HOME}/Workarea</code> (by default)
+        list cloned repos whose remote doesn&#8217;t match a github.com origin
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1184,7 +1200,7 @@ the <code>jq</code> command-line utility:
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2018-11-01 16:32:39 GMT
+ 2018-11-09 14:11:04 GMT
 </div>
 </div>
 </body>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: git-multi
 version: !ruby/object:Gem::Version
-  version: 1.0.10
+  version: 1.1.0
 platform: ruby
 authors:
 - Peter Vandenberk
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-11-01 00:00:00.000000000 Z
+date: 2018-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: octokit