git-multi.erb in git-multi-6.0.0

- old
+ new
@@ -244,9 +244,22 @@
  git multi --json | jq -r '.[] | .name + ": " + .description'
 
  # print out the name of all "forked" repositories
  git multi --json | jq -r '.[] | select(.fork == true) | .full_name'
 
+CHAINED INVOCATION
+------------------
+
+When `git multi` gets its input from a Unix pipeline _(as opposed to from a TTY)_, it constructs an "implicit" multi repo comprised of the "full" repo names it reads from `STDIN` _(one full repo name per line)_.
+
+This allows multiple `git multi` invocations to be chained, for example by using the `--json` or `--find` options as follows:
+
+ # run a git query or subcommand on repos that aren't archived (on GitHub)
+ git multi ++<multi_repo> --json | jq -r '.[] | select(."archived" == false) | ."full_name"' | git multi <git_command>
+
+ # run a shell command inside repos that have Ruby as their main language
+ git multi ++<multi_repo> --find 'language == "Ruby"' | git multi --raw 'cat .ruby-version'
+
 FILES
 -----
 
 `${HOME}/Workarea`::
 	root directory where repos will been cloned