man/git-multi.html in git-multi-5.0.0 vs man/git-multi.html in git-multi-6.0.0
- old
+ new
@@ -2,11 +2,11 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 9.0.0" />
+<meta name="generator" content="AsciiDoc 10.1.1" />
<title>git-multi(1)</title>
<style type="text/css">
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
/* Default font. */
@@ -746,11 +746,11 @@
</div>
<div id="content">
<div class="sect1">
<h2 id="_version">VERSION</h2>
<div class="sectionbody">
-<div class="paragraph"><p>This is <code>v5.0.0</code> of <em>git multi</em> … hooray!</p></div>
+<div class="paragraph"><p>This is <code>v6.0.0</code> of <em>git multi</em> … hooray!</p></div>
</div>
</div>
<div class="sect1">
<h2 id="_synopsis">SYNOPSIS</h2>
<div class="sectionbody">
@@ -1111,36 +1111,38 @@
<h2 id="_query_arguments">QUERY ARGUMENTS</h2>
<div class="sectionbody">
<div class="paragraph"><p>The following is a list of valid arguments for the <code>git multi --query</code> option:</p></div>
<div class="literalblock">
<div class="content">
-<pre><code>archive_url archived assignees_url
-blobs_url branches_url clone_url
-collaborators_url comments_url commits_url
-compare_url contents_url contributors_url
-created_at default_branch deployments_url
-description disabled downloads_url
-events_url fork forks
-forks_count forks_url full_name
-git_commits_url git_refs_url git_tags_url
-git_url has_downloads has_issues
-has_pages has_projects has_wiki
-homepage hooks_url html_url
-id issue_comment_url issue_events_url
-issues_url keys_url labels_url
-language languages_url license
-merges_url milestones_url mirror_url
-name network_count node_id
-notifications_url open_issues open_issues_count
-organization owner permissions
-private pulls_url pushed_at
-releases_url size ssh_url
-stargazers_count stargazers_url statuses_url
-subscribers_count subscribers_url subscription_url
-svn_url tags_url teams_url
-temp_clone_token trees_url updated_at
-url watchers watchers_count</code></pre>
+<pre><code>allow_forking archive_url archived
+assignees_url blobs_url branches_url
+clone_url collaborators_url comments_url
+commits_url compare_url contents_url
+contributors_url created_at default_branch
+deployments_url description disabled
+downloads_url events_url fork
+forks forks_count forks_url
+full_name git_commits_url git_refs_url
+git_tags_url git_url has_downloads
+has_issues has_pages has_projects
+has_wiki homepage hooks_url
+html_url id is_template
+issue_comment_url issue_events_url issues_url
+keys_url labels_url language
+languages_url license merges_url
+milestones_url mirror_url name
+network_count node_id notifications_url
+open_issues open_issues_count organization
+owner permissions private
+pulls_url pushed_at releases_url
+size ssh_url stargazers_count
+stargazers_url statuses_url subscribers_count
+subscribers_url subscription_url svn_url
+tags_url teams_url temp_clone_token
+topics trees_url updated_at
+url visibility watchers
+watchers_count</code></pre>
</div></div>
</div>
</div>
<div class="sect1">
<h2 id="_jq_integration">JQ INTEGRATION</h2>
@@ -1160,10 +1162,27 @@
git multi --json | jq -r '.[] | select(.fork == true) | .full_name'</code></pre>
</div></div>
</div>
</div>
<div class="sect1">
+<h2 id="_chained_invocation">CHAINED INVOCATION</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>When <code>git multi</code> gets its input from a Unix pipeline <em>(as opposed to from a TTY)</em>, it constructs an "implicit" multi repo comprised of the "full" repo names it reads from <code>STDIN</code> <em>(one full repo name per line)</em>.</p></div>
+<div class="paragraph"><p>This allows multiple <code>git multi</code> invocations to be chained, for example by using the <code>--json</code> or <code>--find</code> options as follows:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># 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></code></pre>
+</div></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># 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'</code></pre>
+</div></div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_files">FILES</h2>
<div class="sectionbody">
<div class="dlist"><dl>
<dt class="hdlist1">
<code>${HOME}/Workarea</code>
@@ -1220,10 +1239,10 @@
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Last updated
- 2020-06-20 07:51:21 BST
+ 2022-02-02 12:24:05 GMT
</div>
</div>
</body>
</html>