Autogenerated HTML docs for v1.9.1-315-g3f09d

1 files changed, 50 insertions, 7 deletions

diff --git a/git-request-pull.html b/git-request-pull.html
index 71bb3e8aa..536cf868a 100644
--- a/git-request-pull.html
+++ b/git-request-pull.html
@@ -758,8 +758,13 @@ git-request-pull(1) Manual Page
 <div class="sect1">

 <h2 id="_description">DESCRIPTION</h2>

 <div class="sectionbody">

-<div class="paragraph"><p>Summarizes the changes between two commits to the standard output, and includes

-the given URL in the generated summary.</p></div>

+<div class="paragraph"><p>Generate a request asking your upstream project to pull changes into

+their tree.  The request, printed to the standard output, summarizes

+the changes and indicates from where they can be pulled.</p></div>

+<div class="paragraph"><p>The upstream project is expected to have the commit named by

+<tt>&lt;start&gt;</tt> and the output asks it to integrate the changes you made

+since that commit, up to the commit named by <tt>&lt;end&gt;</tt>, by visiting

+the repository named by <tt>&lt;url&gt;</tt>.</p></div>

 </div>

 </div>

 <div class="sect1">

@@ -771,7 +776,7 @@ the given URL in the generated summary.</p></div>
 </dt>

 <dd>

 <p>

-        Show patch text

+        Include patch text in the output.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -779,7 +784,8 @@ the given URL in the generated summary.</p></div>
 </dt>

 <dd>

 <p>

-        Commit to start at.

+        Commit to start at.  This names a commit that is already in

+        the upstream history.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -787,7 +793,7 @@ the given URL in the generated summary.</p></div>
 </dt>

 <dd>

 <p>

-        URL to include in the summary.

+        The repository URL to be pulled from.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -795,13 +801,50 @@ the given URL in the generated summary.</p></div>
 </dt>

 <dd>

 <p>

-        Commit to end at; defaults to HEAD.

+        Commit to end at (defaults to HEAD).  This names the commit

+        at the tip of the history you are asking to be pulled.

 </p>

+<div class="paragraph"><p>When the repository named by <tt>&lt;url&gt;</tt> has the commit at a tip of a

+ref that is different from the ref you have locally, you can use the

+<tt>&lt;local&gt;:&lt;remote&gt;</tt> syntax, to have its local name, a colon <tt>:</tt>, and

+its remote name.</p></div>

 </dd>

 </dl></div>

 </div>

 </div>

 <div class="sect1">

+<h2 id="_example">EXAMPLE</h2>

+<div class="sectionbody">

+<div class="paragraph"><p>Imagine that you built your work on your <tt>master</tt> branch on top of

+the <tt>v1.0</tt> release, and want it to be integrated to the project.

+First you push that change to your public repository for others to

+see:</p></div>

+<div class="literalblock">

+<div class="content">

+<pre><tt>git push https://git.ko.xz/project master</tt></pre>

+</div></div>

+<div class="paragraph"><p>Then, you run this command:</p></div>

+<div class="literalblock">

+<div class="content">

+<pre><tt>git request-pull v1.0 https://git.ko.xz/project master</tt></pre>

+</div></div>

+<div class="paragraph"><p>which will produce a request to the upstream, summarizing the

+changes between the <tt>v1.0</tt> release and your <tt>master</tt>, to pull it

+from your public repository.</p></div>

+<div class="paragraph"><p>If you pushed your change to a branch whose name is different from

+the one you have locally, e.g.</p></div>

+<div class="literalblock">

+<div class="content">

+<pre><tt>git push https://git.ko.xz/project master:for-linus</tt></pre>

+</div></div>

+<div class="paragraph"><p>then you can ask that to be pulled with</p></div>

+<div class="literalblock">

+<div class="content">

+<pre><tt>git request-pull v1.0 https://git.ko.xz/project master:for-linus</tt></pre>

+</div></div>

+</div>

+</div>

+<div class="sect1">

 <h2 id="_git">GIT</h2>

 <div class="sectionbody">

 <div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>

@@ -811,7 +854,7 @@ the given URL in the generated summary.</p></div>
 <div id="footnotes"><hr /></div>

 <div id="footer">

 <div id="footer-text">

-Last updated 2013-08-20 08:40:27 PDT

+Last updated 2014-03-21 15:07:58 PDT

 </div>

 </div>

 </body>