summaryrefslogtreecommitdiff
path: root/docs/chapters/building.sgml
diff options
context:
space:
mode:
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>