commit 70aa33adee469b8f5e86316e2345cf1504434985
author ddekany <ddekany@apache.org> Fri Jan 06 23:12:43 2017 +0100
committer ddekany <ddekany@apache.org> Fri Jan 06 23:12:43 2017 +0100
tree 1dba38406fb90b7747b9419356f921b9fc84d013
parent db9c95d50f9acefd4a8e2c6acc81fc3def43929e

Added to Committer how-to: Closing GitHub PR requests without merging

src/main/docgen/book.xml

diff --git a/src/main/docgen/book.xml b/src/main/docgen/book.xml
index 56f89cd..52e513f 100644
--- a/src/main/docgen/book.xml
+++ b/src/main/docgen/book.xml
@@ -1342,14 +1342,14 @@
         <itemizedlist>
           <listitem>
             <para><literal> <replaceable>&lt;PROJECT&gt;</replaceable>
-            </literal> is usually
+            </literal>is usually
             <literal>incubator-freemarker</literal></para>
           </listitem>
 
           <listitem>
             <para><literal> <replaceable>&lt;PR_NUMBER&gt;</replaceable>
-            </literal> is the pull request number that GitHub shows
-            prominently after a <quote>#</quote></para>
+            </literal>is the pull request number that GitHub shows prominently
+            after a <quote>#</quote></para>
           </listitem>
         </itemizedlist>
 
@@ -1365,6 +1365,35 @@
         close the pull request on Github.</para>
       </section>
 
+      <section xml:id="close-pull-request-without-merging">
+        <title>Closing GitHub pull requests without merging</title>
+
+        <programlisting language="unknown">git commit --allow-empty -m "closes apache/&lt;PROJECT&gt;#&lt;PR_NUMBER&gt;: &lt;WHY&gt;"</programlisting>
+
+        <para>Where:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><literal> <replaceable>&lt;PROJECT&gt;</replaceable>
+            </literal>is usually
+            <literal>incubator-freemarker</literal></para>
+          </listitem>
+
+          <listitem>
+            <para><literal> <replaceable>&lt;PR_NUMBER&gt;</replaceable>
+            </literal>is the pull request number that GitHub shows prominently
+            after a <quote>#</quote></para>
+          </listitem>
+
+          <listitem>
+            <para><literal> <replaceable>&lt;WHY&gt;</replaceable>
+            </literal>is the reason of the closing. For clarity, you may want
+            to end it with <quote>Closed PR without merging.</quote> or
+            something similar.</para>
+          </listitem>
+        </itemizedlist>
+      </section>
+
       <section xml:id="making-releases">
         <title>Making releases</title>