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> &#8230; hooray!</p></div> +<div class="paragraph"><p>This is <code>v6.0.0</code> of <em>git multi</em> &#8230; 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 ++&lt;multi_repo&gt; --json | jq -r '.[] | select(."archived" == false) | ."full_name"' | git multi &lt;git_command&gt;</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 ++&lt;multi_repo&gt; --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>