[med-svn] r17591 - trunk/community/website/docs

[Charles Plessy]

Author: plessy
Date: 2014-07-31 23:50:28 +0000 (Thu, 31 Jul 2014)
New Revision: 17591

Modified:
   trunk/community/website/docs/policy.xml
Log:
To create a pristine-tar branch when it is missing.


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2014-07-31 14:45:48 UTC (rev 17590)
+++ trunk/community/website/docs/policy.xml	2014-07-31 23:50:28 UTC (rev 17591)
@@ -402,6 +402,19 @@
 				<para>With recent versions of git, the remote branch will be automatically tracked when running <command>git</command> checkout.  For example, when a <literal>pristine-tar</literal> branch is available upstream and not yet tracked locally, the command <command>git checkout</command> <option><replaceable>pristine-tar</replaceable></option> will implicitely run the command <command>git branch</command> <option>-t <replaceable>pristine-tar</replaceable> <replaceable>origin/pristine-tar</replaceable></option>.
         </para>
   		</sect3>
+  		<sect3 id="git-missing-pristine-tar">
+  		<title>To create a pristine-tar branch when it is missing.</title>
+  		<para>
+  			See the <ulink url="http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.import.html">documentation of git-buildpackage</ulink>
+  			for details.  Use a similar command for any other missing branch.
+  		<programlisting>
+<command>git checkout</command> <option>--orphan</option> <replaceable>upstream</replaceable>
+<command>git rm</command> <option>-rf</option> <replaceable>.</replaceable>
+<command>git commit</command> <option>--allow-empty</option> <option>-m</option> <replaceable>'Initial upstream branch.'</replaceable>
+<command>git checkout</command> <option>-f</option> <replaceable>master</replaceable>
+</programlisting>
+  		</para>
+  		</sect3>
 			<sect3 id="create-git-repository-on-alioth">
 			<title>Pushing to git.debian.org, creating a new bare repository on Alitoh.</title>
 			<para>Before pushing to git.debian.org for the first time, an empty repository needs to be created there.