summaryrefslogtreecommitdiff
path: root/docs/chapters/building.sgml
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2009-09-16 23:47:44 +0200
committerGuido Günther <agx@sigxcpu.org>2009-09-16 23:59:56 +0200
commit8a9b81302edcf0bc23c365f13432dc21b77fbdad (patch)
treece74fceed4953fb5846521be8ed1a402bd6560e0 /docs/chapters/building.sgml
parent78bcf5e946c0c7237ab2cbf97f82d75f5bb34d79 (diff)
mention pristine-tar branch and pristine-tar
Diffstat (limited to 'docs/chapters/building.sgml')
-rw-r--r--docs/chapters/building.sgml9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/chapters/building.sgml b/docs/chapters/building.sgml
index 5b8326a..d0687e9 100644
--- a/docs/chapters/building.sgml
+++ b/docs/chapters/building.sgml
@@ -16,7 +16,14 @@
one by looking at the tag matching the upstream version, if no tag can be
found it uses the tip of the current <option>upstream-branch</option>. Any
other treeish object to create the upstream tarball from can be given with
- the <option>--upstream-branch</option> option.</para>
+ the <option>--upstream-branch</option> option.
+ </para><para>
+ If you want to recreate the original tarball using the additional
+ information from the <option>pristine-tar branch</option> you have to
+ specify the <option>--pristine-tar</option> option. This will make sure the
+ upstream tarball matches exactly the one imported. Using this option is the
+ recommended way of recreating the upstream tarball.
+ </para>
<para>Once you're satisfied with the build and want to do a release you commit all
your changes and issue:</para>
<screen>