NAME

       gbp-export-orig - Export upstream tarballs from a Git repository

SYNOPSIS

       gbp export-orig [--verbose] [--color=[auto|on|off]] [--color-scheme= COLOR_SCHEME] [--upstream-branch=
                       BRANCH_NAME] [--[no-]submodules] [--upstream-tag= tag-format] [--upstream-tree=
                       [TAG|BRANCH|TREEISH]] [--tarball-dir= DIRECTORY] [--force-create] [--compression= TYPE]
                       [--compression-level= LEVEL] [--component= component]... [--[no-]pristine-tar]
                       [--[no-]pristine-tar-commit] [--upstream-signatures=[auto|on|off]]

DESCRIPTION

       gbp export-orig  is used to export upstream tarballs from a Git repository. Usually upstream tarballs are
       created by gbp buildpackage when needed but if you don't want to perform a build you can  use  this  com‐
       mand.

OPTIONS

       --verbose
              verbose execution

       --color=[auto|on|off]
              Whether to use colored output.

       --color-scheme=COLOR_SCHEME
              Colors  to  use  in  output  (when color is enabled). The format for COLOR_SCHEME is '<debug>:<in‐
              fo>:<warning>:<error>'.  Numerical values and color names are accepted, empty fields imply the de‐
              fault color. For example --color-scheme='cyan:34::' would show debug messages in cyan,  info  mes‐
              sages in blue and other messages in default (i.e. warning and error messages in red).

       --upstream-branch=BRANCH_NAME
              Branch to build the orig tarball from if --upstream-tree is set to BRANCH. Default is upstream.

       --[no-]submodules
              Include git submodules in the orig tarball.

       --upstream-tag=TAG-FORMAT
              Use this tag format when looking for tags of upstream versions, default is upstream/%(version)s.

       --force-create
              Force creation of an orig tarball (overwriting a pre-existing one if present).

       --upstream-tree=[BRANCH|TAG|TREEISH]
              How  to  find the upstream sources used to generate the tarball.  TAG (the default) looks at a tag
              corresponding to the version in the changelog. BRANCH looks at the upstream branch given  via  the
              --upstream-branch option.

              Other values are interpreted as treeishs.

              This doesn't have any effect if --pristine-tar is being used.

       --tarball-dir=DIRECTORY
              Search  for  original  tarballs  in DIRECTORY instead of generating them.  DIRECTORY can contain a
              version format substitution pattern, eg: foo-%(version)s.

       --compression=TYPE
              Specifies the upstream tarball compression type. This will be used to locate  and  build  the  up‐
              stream tarball if necessary. The default is auto which derives the compression type from the pris‐
              tine-tar branch if available and falls back to gzip otherwise. Other options are gzip, bzip2, lzma
              and xz.

       --compression-level=LEVEL
              Specifies the upstream tarball compression level if an upstream tarball needs to be built.

       --component=COMPONENT
              When  generating  tarballs  create  an  additional  original tarball of directory COMPONENT in the
              source tree. Using additional original tarballs is a feature of the 3.0 (quilt) source format. See
              the dpkg-source manpage for details. Note that the --pristine-tar-commit option is  currently  in‐
              compatible with this option.

              This is considered an experimental feature and might change incompatibly.

       --pristine-tar
              Use pristine-tar when generating the upstream tarball if it doesn't exist.

       --pristine-tar-commit
              Commit  the  pristine-tar  delta to the pristine-tar branch if a new tarball was generated and the
              pristine-tar data isn't already there.

       --upstream-signatures=[auto|on|off]
              Whether to export with upstream signatures.

EXAMPLES

       Generate an upstream tarball of the version currently referenced in the changelog using pristine-tar:

             gbp export-orig --pristine-tar

       Same as above but generate and additional tarball for directory foo.

             gbp export-orig --pristine-tar --component=foo

CONFIGURATION FILES

       Several gbp.conf files are parsed  to  set  defaults  for  the  above  command-line  arguments.  See  the
       gbp.conf(5) manpage for details.

SEE ALSO

       gbp-buildpackage(1),  gbp-import-orig(1), gbp-pristine-tar(1), gbp.conf(5), debuild(1), git(1), pristine-
       tar(1), The Git-Buildpackage Manual ⟨file:///usr/share/doc/git-buildpackage/manual-html/index.html⟩

AUTHOR

       Guido Günther <agx@sigxcpu.org>

                                                15 December 2023                              gbp-export-orig(1)