# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2021-10-01 17:31+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: Content of: #: manual.xml:16 msgid "Building Debian Packages with git-buildpackage" msgstr "" #. type: Content of: <book><bookinfo><address> #: manual.xml:18 #, no-wrap msgid "&dhemail;" msgstr "" #. type: Content of: <book><bookinfo> #: manual.xml:17 msgid "" "<author>&dhfirstname; &dhsurname;</author> <placeholder type=\"address\" " "id=\"0\"/>" msgstr "" #. type: Content of: <book><bookinfo><subtitle> #: manual.xml:19 msgid "Version: &gbp-version;" msgstr "" #. type: Content of: <book><appendix><title> #: manual.xml:31 msgid "Command Reference" msgstr "" #. type: Content of: <book><appendix><title> #: manual.xml:55 msgid "Copyright" msgstr "" #. type: Content of: <para> #: copyright.xml:2 msgid "" "git-buildpackage, all associated scripts and programs, this manual, and all " "build scripts are Copyright © 2006-2017 Guido Günther." msgstr "" #. type: Content of: <para> #: copyright.xml:6 msgid "" "This program is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " "Software Foundation; Version 2 of the License." msgstr "" #. type: Content of: <para> #: copyright.xml:12 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for " "more details." msgstr "" #. type: Content of: <para> #: copyright.xml:19 msgid "" "You should have received a copy of the GNU General Public License along with " "this program; if not, please see <http://www.gnu.org/licenses/>" msgstr "" #. type: Content of: <chapter><title> #: chapters/building.xml:2 msgid "Building Packages from the &git; Repository" msgstr "" #. type: Content of: <chapter><para> #: chapters/building.xml:4 msgid "" "In order to build a &debian; package from the &git; repository, you use: " "&gbp-buildpackage;. This builds the upstream tarball (as will be described " "below) and invokes &debuild; to build the package. To use another build " "command, you can use the <option>--git-builder</option> option as described " "later in the manual, but &debuild; is nice since it can invoke " "<productname>lintian</productname>. During the development phase (when " "you're either not on the <emphasis>debian-branch</emphasis> or when you have " "uncommitted changes in your repository), you'll usually use:" msgstr "" #. type: Content of: <chapter><programlisting> #: chapters/building.xml:14 #, no-wrap msgid "&gbp-buildpackage; <option>--git-ignore-new</option>\n" msgstr "" #. type: Content of: <chapter><para> #: chapters/building.xml:16 msgid "" "If &gbp-buildpackage; doesn't find a valid upstream tarball, it will create " "one by looking at the tag matching the upstream version. To change this " "behaviour, see the <option>--git-upstream-tree</option> option." msgstr "" #. type: Content of: <chapter><para> #: chapters/building.xml:20 msgid "" "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>--git-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." msgstr "" #. type: Content of: <chapter><para> #: chapters/building.xml:26 msgid "" "Once you're satisfied with the build and want to do a release, you commit " "all your changes and issue:" msgstr "" #. type: Content of: <chapter><programlisting> #: chapters/building.xml:29 #, no-wrap msgid "&gbp-buildpackage; <option>--git-tag</option>\n" msgstr "" #. type: Content of: <chapter><para> #: chapters/building.xml:31 msgid "" "This will again build the &debian; package and tag the final result after " "extracting the current version from the changelog. If you want &gpg;-signed " "tags, you can use the <option>--git-sign</option> and " "<option>--git-keyid</option> options. To save typing, these option can be " "specified via the configuration files. You can furthermore change the tag " "format used when creating tags with the <option>debian-tag</option> option; " "the default is <replaceable>debian/<version></replaceable>." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/building.xml:39 msgid "Using a separate build dir" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/building.xml:40 msgid "" "Tools like &svn-buildpackage; use a separate build-area. To achieve a " "similar behaviour with &gbp-buildpackage;, use the " "<option>--git-export-dir</option> option:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/building.xml:43 #, no-wrap msgid "" "&gbp-buildpackage; " "<option>--git-export-dir</option>=<replaceable>../build-area/</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/building.xml:45 msgid "" "This will export the head of the current branch to " "<replaceable>../build-area/package-version</replaceable> and build the " "package. If you don't want to export the current branch head, you can use " "<option>--git-export</option> to export any treeish object. Here are some " "examples:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/building.xml:51 #, no-wrap msgid "" "&gbp-buildpackage; " "<option>--git-export-dir</option>=<replaceable>../build-area</replaceable> " "<option>--git-export</option>=<replaceable>debian/0.4.3</replaceable>\n" "&gbp-buildpackage; " "<option>--git-export-dir</option>=<replaceable>../build-area</replaceable> " "<option>--git-export</option>=<replaceable>etch</replaceable>\n" "&gbp-buildpackage; " "<option>--git-export-dir</option>=<replaceable>../build-area</replaceable> " "<option>--git-export</option>=<replaceable>8caed309653d69b7ab440e3d35abc090eb4c6697</replaceable>\n" "&gbp-buildpackage; " "<option>--git-export-dir</option>=<replaceable>../build-area</replaceable> " "<option>--git-export</option>=<replaceable>INDEX</replaceable>\n" "&gbp-buildpackage; " "<option>--git-export-dir</option>=<replaceable>../build-area</replaceable> " "<option>--git-export</option>=<replaceable>WC</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/building.xml:57 msgid "" "The special argument <replaceable>INDEX</replaceable> exports the state of " "the current index, which can be used to include staged but uncommitted " "changes in the build. Whereas the special argument " "<replaceable>WC</replaceable> exports the current working copy as is." msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/building.xml:64 #, no-wrap msgid "" "[buildpackage]\n" "# use a build area relative to the git repository\n" "export-dir=../build-area\n" "# to use the same build area for all packages use an absolute path:\n" "#export-dir=/home/debian-packages/build-area\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/building.xml:61 msgid "" "If you want to default to build in a separate build area, you can specify " "the directory to use in the <filename>gbp.conf</filename> file. " "<placeholder type=\"programlisting\" id=\"0\"/> &gbp-buildpackage; will " "cleanup the build-area after a successful build. If you want to keep the " "build tree, use <replaceable>--git-no-purge</replaceable>." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/building.xml:75 msgid "Invoking external programs" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/building.xml:77 msgid "" "Besides the commands for cleaning the package build dir " "(<option>cleaner</option>) and building the package " "(<option>builder</option>), you can also invoke hooks during the package " "build: immediately before a build (<option>prebuild</option>), after a " "successful build (<option>postbuild</option>), and after creating a tag " "(<option>posttag</option>). Typical applications are running " "<productname>lintian</productname> or pushing changes into a remote " "repository." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/building.xml:87 msgid "Running lintian" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/building.xml:93 #, no-wrap msgid "" "&gbp-buildpackage; <option>--git-postbuild</option>=<replaceable>'lintian " "$GBP_CHANGES_FILE'</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/building.xml:97 #, no-wrap msgid "" "<option>postbuild</option>=<replaceable>lintian " "$GBP_CHANGES_FILE</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:88 msgid "" "&gbp-buildpackage; exports several variables into the " "<option>posttag</option>'s environment (for details see the <xref " "linkend=\"man.gbp.buildpackage\"/> manual page). To invoke &lintian;, we " "need to tell it where to find the changes file: <placeholder " "type=\"programlisting\" id=\"0\"/> To call &lintian; automatically after " "each successful build, add: <placeholder type=\"programlisting\" id=\"1\"/> " "to your <filename>.gbp.conf</filename>." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/building.xml:103 msgid "Pushing into a remote repository" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/building.xml:107 #, no-wrap msgid "" "&gbp-buildpackage; <option>--git-tag</option> " "<option>--git-posttag</option>=<replaceable>\"git push && git push " "--tags\"</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:104 msgid "" "If you want to push your changes automatically after a successful build and " "tag, you can use &gbp-buildpackage;'s posttag hook. A very simple invocation " "would look like this: <placeholder type=\"programlisting\" id=\"0\"/> This " "assumes you have set up a remote repository to push to in " "<filename>.git/config</filename>." msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/building.xml:117 #, no-wrap msgid "" "#!/bin/sh -e\n" "#\n" "# gbp-posttag-push: post tag hook to push out the newly created tag and to\n" "# forward the remote branch to that position\n" "\n" "if ! REMOTE=$(git config --get branch.\"${GBP_BRANCH}\".remote); then\n" " REMOTE=origin\n" "fi\n" "\n" "if [ \"$GBP_TAG\" ]; then\n" " echo \"Pushing $GBP_TAG to $REMOTE\"\n" " git push \"$REMOTE\" \"$GBP_TAG\"\n" "else\n" " echo \"GBP_TAG not set.\"\n" " exit 1\n" "fi\n" "\n" "if [ \"$GBP_SHA1\" ] && [ \"$GBP_BRANCH\" ]; then\n" " git push \"$REMOTE\" \"$GBP_SHA1\":\"$GBP_BRANCH\"\n" "else\n" " echo \"GBP_SHA1 or GBP_BRANCH not set.\"\n" " exit 1\n" "fi\n" "echo \"done.\"\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/building.xml:146 #, no-wrap msgid "<option>posttag</option>=<replaceable>\"gbp-posttag-push\"</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:112 msgid "" "Usually, you want to make sure you don't push out any unrelated changes into " "the remote repository. This is handled by the following hook which only " "pushes out the created tag to where you pulled from and also forwards the " "corresponding remote branch to that position: <placeholder " "type=\"programlisting\" id=\"0\"/> <envar>GBP_TAG</envar>, " "<envar>GBP_SHA1</envar> and <envar>GBP_BRANCH</envar> are passed to the hook " "via the environment. To call this hook automatically upon tag creation, add: " "<placeholder type=\"programlisting\" id=\"1\"/> to your " "<filename>.gbp.conf</filename> and make sure <filename>gbp-push</filename> " "is somewhere in your <envar>$PATH</envar>. On &debian; systems, a more " "complete example can be found in " "<filename>/usr/share/doc/examples/git-buildpackage/examples/gbp-posttag-push</filename>." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/building.xml:155 msgid "Running postexport hook" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:156 msgid "" "&gbp-buildpackage; exports several variables into the " "<option>postexport</option>'s environment (for details see the <xref " "linkend=\"man.gbp.buildpackage\"/> manual page). The motivation for the " "postexport action is to allow further adjustment of the sources prior to " "building the package. A typical use case scenario is to allow creating " "multiple source and binary packages from one &debian; branch, e.g. the " "bootstrap gcc and in the next stage the full gcc." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:165 msgid "" "The postexport action postpones the creation of the upstream tarball, so " "that the metadata for creating it is already present in the exported source " "tree. The example postexport script below " "(<filename>crosstoolchain-expand.sh</filename>) expands changelog, lintian " "override files, rules and control files according to an environment variable " "<envar>PKG_FLAVOR</envar>." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:173 msgid "" "Sample <filename>gbp.conf</filename> - enables source tree export by " "specifying the export directory:" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/building.xml:177 #, no-wrap msgid "" "[buildpackage]\n" "# use a build area relative to the git repository\n" "export-dir = ../build-area\n" "# disable the since the sources are being exported first\n" "cleaner =\n" "# post export script that handles expansion of &debian; specific files\n" "postexport = crosstoolchain-expand.sh\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:187 msgid "Sample postexport script: <filename>crosstoolchain-expand.sh</filename>" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/building.xml:189 #, no-wrap msgid "" "#!/bin/sh\n" "#\n" "# Purpose: this script is intended for creating multiple source and\n" "# binary Debian packages from one source tree. It can be used in\n" "# conjunction with git-buildpackage that support a postexport hook\n" "#\n" "# A typical use is preparing a bootstrap gcc package that is needed\n" "# for building newlib and then preparing a full gcc package from the\n" "# same source tree. The user may specify the package flavor via\n" "# PKG_FLAVOR environmental variable. \n" "#\n" "#\n" "# The script expands/processes the following files:\n" "#\n" "# - changelog.tmpl is converted to standard Debian changelog\n" "#\n" "#\n" "# - all binary package lintian override template files are expanded\n" "# and renamed to the requested package flavor\n" "#\n" "# - source package lintian override template file is expanded and\n" "# renamed\n" "#\n" "# - rules.$PKG_FLAVOR and control.$PKG_FLAVOR are renamed to rules and\n" "# control resp.\n" "\n" "\n" "# the template string has been carefully chosen, so that\n" "# e.g. changelogs that refer to the source package can still be\n" "# processed by dch/git-dch resp.\n" "TMPL_STR=-XXXXXX\n" "\n" "# by default replace string for the template is empty\n" "REPLACE_STR=\n" "\n" "if [ -n \"$PKG_FLAVOR\" ]; then\n" " REPLACE_STR=-$PKG_FLAVOR\n" "fi\n" "\n" "REPLACE_EXPR=\"s/$TMPL_STR/$REPLACE_STR/g\"\n" "\n" "\n" "# actual processing of relevant files\n" "cd debian\n" "\n" "# expand the template changelog\n" "# remove the symlinked version\n" "rm changelog\n" "chglog_tmpl=changelog.tmpl\n" "[ -f \"$chglog_tmpl\" ] || {\n" " echo \"Missing changelog template (debian/$chglog_tmpl)\"\n" " exit 1\n" "}\n" "cat changelog.tmpl | sed -e \"$REPLACE_EXPR\" > changelog\n" "rm changelog.tmpl\n" "\n" "# process binary package lintian overrides - each override must match\n" "# its package name\n" "for f in *.lintian-overrides.tmpl; do\n" " outfile=${f%.tmpl}\n" " [ -f \"$f\" ] || {\n" "\techo \"Missing lintian override files for binary packages\"\n" "\texit 1\n" " }\n" " cat $f | sed -e \"$REPLACE_EXPR\" > ${outfile/$TMPL_STR/$REPLACE_STR}\n" " rm $f\n" "done\n" "\n" "# process the only source package lintian override\n" "source_lintian=source/lintian-overrides.tmpl\n" "cat $source_lintian | sed -e \"$REPLACE_EXPR\" > ${source_lintian%.tmpl}\n" "rm $source_lintian\n" "\n" "# rules and control file are package flavor specific\n" "[ -f rules.$PKG_FLAVOR ] && mv rules.$PKG_FLAVOR rules\n" "[ -f control.$PKG_FLAVOR ] && mv control.$PKG_FLAVOR control\n" "rm -f rules.* control.*\n" "\n" "exit 0\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/building.xml:271 msgid "Running preexport hook" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/building.xml:272 msgid "" "&gbp-buildpackage; exports several variables into the " "<option>preexport</option>'s environment (for details see the <xref " "linkend=\"man.gbp.buildpackage\"/> manual page). The motivation for the " "preexport action is to allow further actions before preparing and exporting " "the orig tarballs to the build directory. A usecase could be having the " "orig tarballs in a separate repository due to very large binary assets, that " "need to be checked out to the correct branch before creating the tarballs." msgstr "" #. type: Content of: <chapter><title> #: chapters/cfgfile.xml:2 msgid "Configuration Files" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><term> #: chapters/cfgfile.xml:6 manpages/gbp.conf.xml:23 msgid "/etc/git-buildpackage/gbp.conf" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:7 msgid "system wide configuration" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><term> #: chapters/cfgfile.xml:10 manpages/gbp.conf.xml:33 msgid "~/.gbp.conf" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:11 msgid "per user configuration" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><term> #: chapters/cfgfile.xml:14 manpages/gbp.conf.xml:43 msgid ".gbp.conf" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:15 msgid "per repository/branch configuration (deprecated)" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><term> #: chapters/cfgfile.xml:18 manpages/gbp.conf.xml:54 msgid "debian/gbp.conf" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:19 msgid "per repository/branch configuration" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><term> #: chapters/cfgfile.xml:22 manpages/gbp.conf.xml:64 msgid ".git/gbp.conf" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:23 msgid "per (local) repository configuration" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><term> #: chapters/cfgfile.xml:29 msgid "[DEFAULT]" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:31 msgid "Options in this section apply to all &gbp; commands." msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><term> #: chapters/cfgfile.xml:35 msgid "[buildpackage]" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:36 msgid "" "Options in this section apply to &gbp-buildpackage; only and override " "options from the [DEFAULT] section." msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><term> #: chapters/cfgfile.xml:40 msgid "[import-orig]" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:41 msgid "" "Options in this section apply to &gbp-import-orig; only and override options " "from the [DEFAULT] section." msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><term> #: chapters/cfgfile.xml:45 msgid "[import-dsc]" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:46 msgid "" "Options in this section apply to &gbp-import-dsc; only and override options " "from the [DEFAULT] section." msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><term> #: chapters/cfgfile.xml:50 msgid "[dch]" msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:51 msgid "" "Options in this section apply to &gbp-dch; only and override options from " "the [DEFAULT] section." msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><term> #: chapters/cfgfile.xml:55 msgid "..." msgstr "" #. type: Content of: <chapter><para><variablelist><varlistentry><listitem><para> #: chapters/cfgfile.xml:56 msgid "Same for the other &gbp; commands" msgstr "" #. type: Content of: <chapter><para> #: chapters/cfgfile.xml:3 msgid "" "The configuration files are parsed in this order: <placeholder " "type=\"variablelist\" id=\"0\"/> All have the same format. They consist of " "several sections, all of them are optional: <placeholder " "type=\"variablelist\" id=\"1\"/> The actual options in these sections are " "the command line options without the '--' prefix. So " "<option>--upstream-branch=</option><replaceable>dfsgfree</replaceable> would " "read:" msgstr "" #. type: Content of: <chapter><screen> #: chapters/cfgfile.xml:63 #, no-wrap msgid "" " <option>upstream-branch</option>=<replaceable>dfsgfree</replaceable>\n" " " msgstr "" #. type: Content of: <chapter><para> #: chapters/cfgfile.xml:66 msgid "" "in the config file. In the special case of &gbp-buildpackage;, the stripped " "prefix is not '--' but '--git-'. Here's a more complete example:" msgstr "" #. type: Content of: <chapter><programlisting> #: chapters/cfgfile.xml:70 #, no-wrap msgid "" " [DEFAULT]\n" " # the default build command\n" " builder=debuild -i\\.git -I.git\n" " # the default branch for upstream sources\n" " upstream-branch=upstream\n" " # the default branch for the debian patch\n" " debian-branch=master\n" "\n" " [buildpackage]\n" " upstream-branch=dfsgclean\n" " # Sign tags with GPG:\n" " sign-tags = True\n" " # Keyid to sign tags with\n" " #keyid = 0xdeadbeef\n" "\n" " [import-orig]\n" " upstream-branch=notdfsgclean\n" "\n" " [import-dsc]\n" " upstream-branch=notdfsgclean\n" "\n" " [dch]\n" " git-log=--no-merges\n" " " msgstr "" #. type: Content of: <chapter><para> #: chapters/cfgfile.xml:95 msgid "For more details, see the <xref linkend=\"man.gbp.conf\"/> manual page." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/cfgfile.xml:99 msgid "Overriding Parsing Order" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/cfgfile.xml:114 #, no-wrap msgid "" "\t$ cat <<EOF >~/.gbp.late.conf\n" "\t[DEFAULT]\n" "\texport-dir = ../build-area\n" "\ttarball-dir = ../tarballs\n" "\tEOF\n" "\n" "\t$ export GBP_CONF_FILES=~/.gbp.conf:debian/gbp.conf:~/.gbp.late.conf\n" "\t$ cd <mypkg>\n" "\t$ gbp config buildpackage.export-dir\n" "\t../build-area\n" " " msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/cfgfile.xml:101 msgid "" "The environment variable <envar>GBP_CONF_FILES</envar> can be used to " "override the order in which configuration files are parsed. The following " "example parses two configuration files in the users home directory " "(<filename>~/.gbp.conf</filename> and <filename>~/.gbp.late.conf</filename>) " "and in the debian directory (<filename>debian/gbp.conf</filename>). The " "file are parsed from left to right. Since <filename> " "~/.gbp.late.conf</filename> is at the very end of the list it can be used to " "override configuration entries shipped by the package. This can be useful if " "packages set e.g. <option>export-dir</option> or " "<option>tarball-dir</option> and you prefer different locations: " "<placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/cfgfile.xml:131 #, no-wrap msgid "" "\t$ export GBP_CONFI_FILES=/does/not/exist\n" "\t$ gbp config buildpackage.debian-branch\n" "\tmaster\n" " " msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/cfgfile.xml:127 msgid "" "If you want all configuration files to be skipped, set " "<envar>GBP_CONF_FILES</envar> to a non existing location. This way only " "default values and options from the command line will be used: <placeholder " "type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><title> #: chapters/import.xml:2 msgid "Importing Sources" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/import.xml:5 msgid "Importing already existing &debian; packages" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:8 #, no-wrap msgid " &gbp-import-dsc; package_0.1-1.dsc\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:6 msgid "" "Importing an already existing &debian; package into a &git; repository is as " "easy as: <placeholder type=\"programlisting\" id=\"0\"/> This will create a " "new &git; repository named after the imported package, put the upstream " "sources onto the <option>upstream-branch</option> and the &debian; patch on " "the <option>debian-branch</option>. In case of a &debian; native package, " "only the <option>debian-branch</option> is being used. You can specify " "alternative branch names via the <option>--upstream-branch</option> and " "<option>--debian-branch</option> options, or via the " "<option>upstream-branch</option> and <option>debian-branch</option> options " "in the configuration file." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:20 chapters/import.xml:100 msgid "" "If you want to be able to exactly recreate the original tarball " "(orig.tar.gz) from &git;, you should also specify the " "<option>--pristine-tar</option> option. This is recommended." msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:28 #, no-wrap msgid "" " cd package/\n" " &gbp-import-dsc; package_0.1-2.dsc\n" " &gbp-import-dsc; package_0.1-3.dsc\n" " &gbp-import-dsc; package_0.2-1.dsc\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:25 msgid "" "If you want to import further versions, you can change into your shiny new " "&git; repository and just continue with the same command: <placeholder " "type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:37 #, no-wrap msgid " &gbp-import-dscs; /path/to/history/package_*.dsc\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:35 msgid "" "Or you can import all versions at once using &gbp-import-dscs;: <placeholder " "type=\"programlisting\" id=\"0\"/> This will create a &git; repository if " "necessary and import all versions sorted by version number." msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:46 #, no-wrap msgid " &gbp-import-dscs; --debsnap package\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:42 msgid "" "You can also import all versions of a package known from the <ulink " "url=\"http://snapshot.debian.org/\">snapshot.debian.org</ulink> service " "using the <option>--debsnap</option> option of &gbp-import-dscs;: " "<placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/import.xml:52 chapters/patches.xml:181 msgid "Importing a new upstream version" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:56 #, no-wrap msgid "" " &gbp-import-orig; <filename>/path/to/package_0.2.orig.tar.gz</filename>\n" " &gbp-import-orig; <filename>/path/to/package_0.2.tar.bz2</filename>\n" " &gbp-import-orig; <filename>/path/to/package-0.2/</filename>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:53 msgid "" "Change into your &git; repository (which can be empty), make sure it has all " "local modifications committed, and run either of: <placeholder " "type=\"programlisting\" id=\"0\"/> This puts the upstream sources onto the " "<option>upstream-branch</option> and tags them accordingly (the default tag " "format is <replaceable>upstream/%(version)s</replaceable>)." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:65 msgid "" "The result is then placed onto the <option>debian-branch</option>. The way " "this happens is determined by the <option>--merge-mode</option> option. The " "default mode <option>auto</option> replaces the upstream sources while " "preserving the <filename>debian/</filename> directory for 3.0 (quilt) " "packages. A &git; merge is used for all other source format versions." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:74 msgid "" "You can again specify different branch names via the " "<option>--upstream-branch</option> and <option>--debian-branch</option> " "options." msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:83 #, no-wrap msgid " &gbp-import-orig; --uscan\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:78 msgid "" "If you are using <filename>debian/watch</filename> to keep track of how to " "retrieve upstream sources, you can simply use the <option>--uscan</option> " "option to download and import the latest upstream version: <placeholder " "type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:89 #, no-wrap msgid "" " &gbp-import-orig; " "<option>--filter</option>=<replaceable>'CVS/*'</replaceable> " "<filename>/path/to/package_0.2.orig.tar.gz</filename>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:86 msgid "" "You can also filter out content you don't want imported: <placeholder " "type=\"programlisting\" id=\"0\"/> The <option>--filter</option> option can " "be used multiple times for more complex filtering." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:95 msgid "" "If you expect a merge conflict, you can delay the merge to the " "<option>debian-branch</option> via the <option>--no-merge</option> option " "and pull in the changes from the <option>upstream-branch</option> later." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:104 msgid "" "To customize the commit message used by &gbp-import-orig;, use the " "<option>--import-msg</option> option. This string is a &pyformat;, into " "which the <replaceable>version</replaceable> variable is " "interpolated. (i.e., use <replaceable>%(version)s</replaceable> in your " "message to get the imported upstream version)." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/import.xml:113 msgid "Recovering from errors" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:114 msgid "" "In case of an error &gbp-import-orig; will by default rollback (undo) all " "changes it has done to the repository so far:" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/import.xml:118 #, no-wrap msgid "" "\t$ &gbp; import-orig --verbose --filter='CVS/*' --filter='.bzr/*' " "--filter='.hg/*' --filter='.svn/*' --upstream-version=1.9 " "../gif2apng-1.9.tar.gz\n" "\tgbp:info: Importing '../gif2apng-1.9.tar.gz' to branch 'upstream' " "(filtering out [\"'CVS/*'\", \"'.bzr/*'\", \"'.hg/*'\", \"'.svn/*'\"])...\n" "\tgbp:info: Source package is gif2apng\n" "\tgbp:info: Upstream version is 1.9\n" "\tgbp:info: Merging to 'master'\n" "\tgbp:error: Automatic merge failed.\n" "\tgbp:error: Error detected, Will roll back changes.\n" "\tgbp:info: Rolling back branch upstream by resetting it to " "a6733c1f1e190ac0ed4774abc3466e9986a6df5e\n" "\tgbp:info: Rolling back branch pristine-tar by resetting it to " "0ee24ac614c920e30af82d602882c2ee841c88e5\n" "\tgbp:info: Rolling back tag upstream/1.9 by deleting it\n" "\tgbp:info: Rolling back branch master by resetting it to " "ce99782336e83a56e8e579b3cdadf93b0c19e1a8\n" "\tgbp:info: Rolling back failed merge of upstream/1.9\n" "\tgbp:error: Rolled back changes after import error.\n" " " msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:133 msgid "" "In this case the import failed due to a merge conflict. Other reasons are " "running out of disk space, problems when generating the pristine-tar " "delta. If you don't want &gbp-import-orig; to undo changes made to the " "repository use the <option>--no-rollback</option>." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/import.xml:143 msgid "Converting an existing &git; repository" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:145 msgid "" "If the &git; repository wasn't created with &gbp-import-dsc;, you have to " "tell &gbp-buildpackage; and friends where to find the upstream sources." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/import.xml:149 msgid "Upstream sources on a branch" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/import.xml:155 #, no-wrap msgid " &gitcmd; branch -m theupstream-branch upstream\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/import.xml:160 #, no-wrap msgid "" "<command>cat</command> <<EOF > <filename>.git/gbp.conf</filename>\n" "[DEFAULT]\n" "# this is the upstream-branch:\n" "upstream-branch=theupstream-branch\n" "EOF\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:151 msgid "" "If the upstream sources are already on a separate branch, things are pretty " "simple. You can either rename that branch to the default " "<option>upstream-branch</option> name <emphasis>upstream</emphasis> with: " "<placeholder type=\"programlisting\" id=\"0\"/> or you can tell " "&gbp-buildpackage; the name of the branch to use as " "<option>upstream-branch</option>: <placeholder type=\"programlisting\" " "id=\"1\"/> If you then use &gbp-import-orig; to import new upstream sources, " "they will from now on end up on <emphasis>theupstream-branch</emphasis> and " "merged to the <option>debian-branch</option>." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/import.xml:172 msgid "Upstream sources not on a branch" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/import.xml:179 #, no-wrap msgid " &gitcmd; branch upstream $(&gitcmd; log --format='%H' | tail -1)\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:174 msgid "" "If you don't have an upstream branch but started your repository with only " "the upstream sources (not the &debian; patch), you can simply branch from " "that point. So use &gitkcmd; or &gitcmd;-log to locate the commit-id of that " "commit and create the upstream branch from there, e.g.: <placeholder " "type=\"programlisting\" id=\"0\"/> The important thing here is that the " "<envar>COMMIT_ID</envar> specifies a point on the master branch that carried " "<emphasis>only</emphasis> the upstream sources and not the &debian; " "modifications. The above example assumes that this was the first commit to " "that repository." msgstr "" #. type: Content of: <chapter><sect1><sect2><warning><para> #: chapters/import.xml:186 msgid "" "There's currently no <emphasis>easy</emphasis> way to create the " "<option>upstream-branch</option> if you never had the upstream sources as a " "single commit. Using &gbp-import-orig; on such repositories might lead to " "unexpected merge results." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:190 msgid "" "In order to fix this you can prepend the upstream sources as a single commit " "to your tree using &git;'s <ulink " "url=\"http://git.or.cz/gitwiki/GraftPoint\">grafts</ulink>. Afterwards you " "can simply create a branch as explained above and &gbp-import-orig; will " "work as expected." msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/import.xml:200 #, no-wrap msgid "" " <command>git checkout</command> <option>--orphan</option> " "<replaceable>upstream</replaceable>\n" " <command>git rm</command> <option>-rf</option> " "<replaceable>.</replaceable>\n" " <command>git commit</command> <option>--allow-empty</option> " "<option>-m</option> <replaceable>'Initial upstream branch.'</replaceable>\n" " <command>git checkout</command> <option>-f</option> " "<replaceable>master</replaceable>\n" " # When not using 3.0 (quilt) with the default --merge-mode=auto\n" " <command>git merge</command> <option>--allow-unrelated-histories</option> " "<replaceable>upstream</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:195 msgid "" "Alternatively, if you are only importing source from original tarballs (for " "instance when converting from a Subversion repository where the " "mergeWithUpstream was set for svn-buildpackage), you can create an empty " "upstream branch with the following commands: <placeholder " "type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/import.xml:212 msgid "Starting a &debian; package from scratch" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:214 msgid "" "So far, we assumed you already have a &debian; package to start with, but " "what if you want to start a new package? First, create an empty repository:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/import.xml:218 #, no-wrap msgid "" " <command>mkdir</command> package-0.1\n" " <command>cd</command> package-0.1\n" " <command>git init</command>\n" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/import.xml:225 #, no-wrap msgid "" " &gbp-import-orig; <option>-u</option> <replaceable>0.1</replaceable> " "<filename>../package-0.1.tar.gz</filename>\n" " <command>dh_make</command>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:222 msgid "" "Then, you import the upstream sources, branch off the " "<option>upstream-branch</option> branch and add the &debian; files (e.g. via " "dh_make): <placeholder type=\"programlisting\" id=\"0\"/> That's it, you're " "done. If you want to publish your new repository, you can use " "&gbp-create-remote-repo;." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/import.xml:233 msgid "When upstream uses Git" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:235 msgid "" "If upstream uses &git; for development (and you don't want to ignore that " "fact entirely), there are at least three ways to handle packaging. The first " "one uses &git; exclusively and creates the upstream tarballs from the " "upstream tag while the second one still uses upstream tarballs but links " "your packaging &git; history with upstreams &git; history. The third one " "also uses a tarballs but does not link to the upstream history." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/import.xml:245 msgid "No upstream tarballs" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:246 msgid "" "If upstream doesn't build upstream tarballs, or you don't care about them, " "the simplest way is to clone upstream's repository and create a separate " "packaging branch in there. You will not need &gbp-import-orig; at all with " "this workflow. &gbp-buildpackage; will handle creating the upstream tarballs " "needed for the Debian source package." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:254 msgid "" "For that to work you need to tell &gbp; what the upstream tag format looks " "like. Therefore you either use the <option>--git-upstream-tag</option> " "command line option or the <option>upstream-tag</option> configuration file " "variable to specify upstream's tag format." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:262 msgid "" "For example a common upstream format is to put a " "<replaceable>v</replaceable> in front of the version number. In this case, " "the configuration option would look like:" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/import.xml:268 #, no-wrap msgid "" "[DEFAULT]\n" "upstream-tag = v%(version)s\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:272 msgid "" "<replaceable>version</replaceable> will be replaced by &gbp; with the " "upstream version number as determined from " "<filename>debian/changelog</filename>. The <replaceable>%()s</replaceable> " "might be familiar from &pyformat;s. The option was placed in the " "<emphasis>[DEFAULT]</emphasis> section instead of the " "<emphasis>[buildpackage]</emphasis> section of the configuration so other " "tools like &gbp-dch; make use of it too." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:283 msgid "" "Some upstreams use other formats though and don't separate numbers by dots " "but rather by underscore(<replaceable>_</replaceable>), " "hyphen(<replaceable>-</replaceable>) or anything else. In order to cope with " "that you can use version mangling of these characters via substitution. The " "substitution works as follows:" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/import.xml:292 #, no-wrap msgid "" "[DEFAULT]\n" "upstream-tag = v%(version%.%_)s\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:296 msgid "" "This means that each occurrence of <replaceable>.</replaceable> will be " "replaced by <replaceable>_</replaceable> in the upstream version number. For " "example the upstream version <replaceable>1.2.3</replaceable> as determined " "from the <filename>debian/changelog</filename> will be looked up as &git; " "tag <replaceable>v1_2_3</replaceable> by &gbp-buildpackage;." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:306 msgid "" "If you want the substitution to be the <replaceable>%</replaceable> " "character you have to escape " "it. E.g. <replaceable>%(version%-%\\%)s</replaceable> will replace " "<replaceable>-</replaceable> with <replaceable>%</replaceable>, transforming " "<replaceable>1-A.B.C</replaceable> to <replaceable>1%A.B.C</replaceable>. " "Only a single replacement is supported and it can only replace a single " "character." msgstr "" #. type: Content of: <chapter><sect1><sect2><para><warning><para> #: chapters/import.xml:312 msgid "" "Since some of the possible mangling characters like " "<replaceable>_</replaceable> and <replaceable>%</replaceable> are also used " "to denote epochs and tilde revisions these versions can't be reconstructed " "when mapping from &git; tags back to &debian; versions and will therefore " "break other tools like &gbp-dch;. So use version mangling with care. It's " "better to come up with a Debian compatible tag format upstream. See &dep14; " "for the currently used expansion rules for Debian version numbers." msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:321 msgid "" "If you're using &pristine-tar; you can make &gbp-buildpackage; commit the " "generated tarball back to the pristine-tar branch using the " "<option>--git-pristine-tar-commit</option> option or you can use " "&gbp-pristine-tar; after you've created the tarballs. This will make sure " "others building your package can exactly regenerate the tarball you created " "when building the &debian; package." msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><title> #: chapters/import.xml:334 msgid "Step by step" msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para> #: chapters/import.xml:335 msgid "" "To not make any assumptions about &gbp;'s configuration, the following steps " "have all options given in its long versions on the command line. You can add " "these to &gbp.conf; to save lots of typing." msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para><programlisting> #: chapters/import.xml:344 #, no-wrap msgid "" " <command>git clone</command> --no-checkout -o upstream " "git://git.example.com/libgbp.git\n" " <command>cd</command> libgbp\n" " <command>git checkout</command> -b debian/sid v1.0\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para> #: chapters/import.xml:340 msgid "" "First, we clone the upstream repository. To avoid any ambiguities between " "the &debian; packaging repository and the upstream repository, we name the " "upstream repository <replaceable>upstream</replaceable> instead of the " "default <replaceable>origin</replaceable>. <placeholder " "type=\"programlisting\" id=\"0\"/> The above makes sure we have " "<replaceable>debian/sid</replaceable> for the &debian; packaging. We didn't " "create any <replaceable>upstream/*</replaceable> branches; they're not " "needed for the packaging and only need to be kept up to date. We started the " "branch at the commit corresponding to the tag " "<replaceable>v1.0</replaceable>." msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para><programlisting> #: chapters/import.xml:356 #, no-wrap msgid "" " <command>gbp buildpackage</command> --git-pristine-tar " "--git-pristine-tar-commit --git-upstream-tag='v%(version)s' " "--git-debian-branch=debian/sid\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para><programlisting> #: chapters/import.xml:361 #, no-wrap msgid "" " <command>git fetch</command> upstream\n" " <command>git merge</command> v1.1\n" " <command>gbp dch</command> --debian-branch=debian/sid --snapshot --auto " "debian/\n" " &gbp-buildpackage; --git-ignore-new --git-pristine-tar " "--git-pristine-tar-commit --git-upstream-tag='v%(version)s'\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para><programlisting> #: chapters/import.xml:371 #, no-wrap msgid "" " <command>gbp dch</command> --release --auto --debian-branch=debian/sid\n" " <command>git commit</command> -m\"Release 1.1-1\" debian/changelog\n" " &gbp-buildpackage; --git-upstream-tag='v%(version)s' " "--git-debian-branch=debian/sid\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><sect3><para> #: chapters/import.xml:353 msgid "" "After adding the &debian; packaging, we build the package. This assumes " "you're using &pristine-tar; and upstream uses a version number format as " "described above: <placeholder type=\"programlisting\" id=\"0\"/> When " "updating to a new upstream version, we simply fetch from upstream and merge " "in the new tag. Afterwards, we update the changelog and build the package: " "<placeholder type=\"programlisting\" id=\"1\"/> Note that the above " "&gbp-dch; call makes sure we only pickup changes in the " "<filename>debian/</filename> directory. Since we told it to build a snapshot " "changelog entry and we hadn't commit the changelog yet, we need to tell " "&gbp-buildpackage; that the working directory is unclean via the " "<option>--git-ignore-new</option> option. Once everything looks good, " "commit the changelog and build a release version: <placeholder " "type=\"programlisting\" id=\"2\"/> If you want to share your repository with " "others, you can use &gbp-create-remote-repo; and &gbp-pull; as usual." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/import.xml:381 msgid "Upstream tarballs and linked upstream history" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/import.xml:388 #, no-wrap msgid " &gbp-import-orig; --upstream-vcs-tag=v0.0.1 foo_0.0.1.orig.tar.gz\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:382 msgid "" "If you want to track upstream's &git; but continue to import the upstream " "tarballs, e.g. to make sure the tarball uploaded to &debian; has the same " "checksum as upstream's, you can use the <option>--upstream-vcs-tag</option> " "option when importing new tarballs with &gbp-import-orig;. Assuming you have " "the upstream source in your repository with a tag " "<replaceable>v0.0.1</replaceable>, you can use: <placeholder " "type=\"programlisting\" id=\"0\"/> to add upstream's tag as additional " "parent to the merge commit. See <ulink " "url=\"http://bugs.debian.org/664771\">#664771</ulink> for more details." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/import.xml:396 msgid "Upstream tarballs and separate upstream history" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/import.xml:404 #, no-wrap msgid "" " &gitcmd; remote add upstream https://upstream.example.com/upstream.git\n" " &gitcmd; fetch upstream\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/import.xml:398 msgid "" "If you want to have upstream's &git; history available but don't want to " "link it to your packaging history you can simply keep it as a separate " "history. E.g. if you already have a &git; repository with your packaging, " "change into that repository and do: <placeholder type=\"programlisting\" " "id=\"0\"/> This will pull in upstream's &git; history into your repo but " "since your packaging commits and upstreams commits have no common parents " "the two histories will stay nicely separated. Of course you can browse it " "and cherry-pick from it but any remote repos you push to will not get " "upstream's history by default unless you push any of upstream's refs." msgstr "" #. type: Content of: <chapter><sect1><sect2><para><warning><para> #: chapters/import.xml:415 msgid "" "Since &git; has a single tag namespace pushing changes with <command>git " "push --tags</command> will push upstream's tags (and therefore it's history) " "too so be sure to only push dedicated tag names." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/import.xml:426 msgid "Branch layout" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:428 msgid "" "By default, &gbp; uses one branch to keep the &debian; packaging called " "<emphasis>master</emphasis> and a branch to keep the upstream packaging " "called <emphasis>upstream</emphasis>." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:432 msgid "" "This layout is simple to get started but falls short if one needs to " "maintain several versions of the package at the same time. Therefore the " "following the &dep14; layout is recommended:" msgstr "" #. type: Content of: <chapter><sect1><variablelist><varlistentry><term> #: chapters/import.xml:439 msgid "debian/<release>" msgstr "" #. type: Content of: <chapter><sect1><variablelist><varlistentry><listitem><para> #: chapters/import.xml:443 msgid "" "the &debian; packaging for a release <emphasis>jessie</emphasis>, " "<emphasis>stretch</emphasis>, <emphasis>sid</emphasis>, " "<emphasis>jessie</emphasis>, <emphasis>jessie-backports</emphasis>, " "<emphasis>jessie-security</emphasis> or <emphasis>experimental</emphasis>." msgstr "" #. type: Content of: <chapter><sect1><variablelist><varlistentry><term> #: chapters/import.xml:451 msgid "upstream/latest" msgstr "" #. type: Content of: <chapter><sect1><variablelist><varlistentry><listitem><para> #: chapters/import.xml:455 msgid "the latest upstream sources." msgstr "" #. type: Content of: <chapter><sect1><variablelist><varlistentry><term> #: chapters/import.xml:461 msgid "dfsg/latest" msgstr "" #. type: Content of: <chapter><sect1><variablelist><varlistentry><listitem><para> #: chapters/import.xml:465 msgid "" "the DFSG-clean upstream sources in case the cleanup is done via a &git; " "merge from upstream to this branch." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/import.xml:472 msgid "" "In case &pristine-tar; is being used, there will be a single " "<emphasis>pristine-tar</emphasis> branch that keeps all binary deltas." msgstr "" #. type: Content of: <chapter><title> #: chapters/intro.xml:2 msgid "Introduction" msgstr "" #. type: Content of: <chapter><para> #: chapters/intro.xml:4 msgid "" "Welcome to git-buildpackage (short &gbp;), a system that integrates the " "<ulink url=\"http://www.debian.org/\">Debian</ulink> package build system " "with <ulink url=\"http://git.or.cz/\">Git</ulink>. The most recent version " "of this manual can be found &manual;." msgstr "" #. type: Content of: <chapter><para> #: chapters/intro.xml:10 msgid "This is what &gbp; can do for you:" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:12 msgid "Initially import an existing &debian; package into &git;" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:13 msgid "" "Incrementally import new versions of a Debian package into &git; e.g. for " "importing NMUs or to maintain downstream modifications" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:16 msgid "Import new upstream versions from tarballs with optionally filters applied" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:17 msgid "Recreate the upstream tarball from information stored in &git;" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:18 msgid "" "Maintain a consistent branch and tag naming within a &git; repository, " "across repositories or across a team of developers" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:20 msgid "Automatically sign generated tags" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:21 msgid "" "Make sure you have committed all changes to the right branch before building " "and releasing" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:24 msgid "" "Execute hooks at various points of the package build process e.g. to " "automatically push changes to remote repositories" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:28 msgid "Integrate the build process with cowbuilder or other builders" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:29 msgid "Export to a clean build area before building the package" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:30 msgid "Generate debian/changelog automatically" msgstr "" #. type: Content of: <chapter><para><itemizedlist><listitem><para> #: chapters/intro.xml:31 msgid "Manage your quilt patches when using 3.0 (quilt) source format" msgstr "" #. type: Content of: <chapter><para> #: chapters/intro.xml:34 msgid "" "All of this is (hopefully) being done without restricting the user to " "certain usage patterns." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/intro.xml:38 msgid "Repository Layout and Terminology" msgstr "" #. type: Content of: <chapter><sect1><para><footnote><para> #: chapters/intro.xml:40 msgid "this, of course, has no meaning for &debian; native packages" msgstr "" #. type: Content of: <chapter><sect1><para><footnote><para> #: chapters/intro.xml:45 msgid "corresponding to the command line and config file options" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/intro.xml:39 msgid "" "It is recommended to have the &debian; packaging on a separate branch than " "the upstream source <placeholder type=\"footnote\" id=\"0\"/>. This is " "necessary to be able to import and merge in new upstream versions via " "&gbp-import-orig;. To distinguish these two branches, the following " "terminology <placeholder type=\"footnote\" id=\"1\"/> is used:" msgstr "" #. type: Content of: <chapter><sect1><itemizedlist><listitem><para> #: chapters/intro.xml:49 msgid "" "The <option>debian-branch</option> (the default branch name used in the " "&git; repository is <emphasis>master</emphasis>) holds your current " "development work. That's the branch you usually cut your releases from and " "the default branch new upstream releases are merged onto." msgstr "" #. type: Content of: <chapter><sect1><itemizedlist><listitem><para> #: chapters/intro.xml:55 msgid "" "The <option>upstream-branch</option> (the default branch name used in the " "&git; repository is <emphasis>upstream</emphasis>) holds the upstream " "releases. This can either be a branch you import to or a branch of an " "upstream &git; repository you pull from." msgstr "" #. type: Content of: <chapter><sect1><itemizedlist><listitem><para> #: chapters/intro.xml:61 msgid "" "The <option>pristine-tar branch</option> (the default branch name used in " "the &git; repository is <emphasis>pristine-tar</emphasis>) holds the " "necessary additional information to recreate the original tarball from the " "<option>upstream-branch</option>. In order to use this feature, you need to " "install the &pristine-tar; package." msgstr "" #. type: Content of: <chapter><sect1><itemizedlist><listitem><para> #: chapters/intro.xml:68 msgid "" "There can be one or more <option>patch-queue</option> branches. Every " "patch-queue branch is related to a <option>debian-branch</option>. If the " "<option>debian-branch</option> is called <emphasis>master</emphasis>, the " "corresponding patch-queue branch is called " "<emphasis>patch-queue/master</emphasis>. The patch-queue branch is the " "&debian; branch plus the contents of <emphasis>debian/patches</emphasis> " "applied. These branches are managed with &gbp-pq;." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/intro.xml:79 msgid "" "You're completely free to pick any repository layout; the branch names above " "are only &gbp;'s defaults. They can be changed at any point in time, and you " "can work with an arbitrary number of branches. For example, branches like " "<emphasis>nmu</emphasis>, <emphasis>backports</emphasis> or " "<emphasis>stable</emphasis> might (temporarily or permanently) become your " "<option>debian-branch</option>, and branches like <emphasis>dfsg</emphasis> " "or <emphasis>snapshots</emphasis> might become your " "<option>upstream-branch</option>—it doesn't matter if these branches " "are maintained with &gbp-import-orig; or not." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/intro.xml:91 msgid "" "A recommended branch layout is described in <xref " "linkend=\"gbp.branch.naming\"/>." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/intro.xml:94 msgid "" "Since &gbp-buildpackage; only works with local &git;-repositories, you have " "to use <command>git push</command> in order to publish your changes to " "remote repositories like <ulink " "url=\"http://git.debian.org/\">git.debian.org</ulink>; this can be automated " "with &gbp-buildpackage;'s <option>post-tag</option> hook." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/intro.xml:103 msgid "Workflow" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/intro.xml:105 msgid "A typical, simple workflow consists of the following steps:" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/intro.xml:108 msgid "" "Initially import a &debian; package via &gbp-import-dsc;. This imports the " "&debian; Package on the <option>debian-branch</option> and the upstream " "sources on the <option>upstream-branch</option>." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/intro.xml:111 msgid "" "Develop, test, commit changes. During this time, you can always build the " "package with &gbp-buildpackage;. In case you have uncommitted changes in " "your source tree, you can use the <option>--git-ignore-new</option> option." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/intro.xml:115 msgid "" "Optionally you can create the &debian; changelog entries using &gbp-dch; and " "create snapshot releases for testing using its <option>--snapshot</option> " "option." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/intro.xml:118 msgid "" "Once satisfied, you can build the final package with &gbp-buildpackage; " "<option>--git-tag</option>. This additionally creates a tag within &git; so " "you can switch back to that version later at any time. The format of the " "tags can be specified; tags can be &gpg; signed." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/intro.xml:123 msgid "" "When a new upstream version is released and upstream isn't using &git;, you " "can import the new version via &gbp-import-orig; onto the " "<option>upstream-branch</option>. &gbp-import-orig; will by default try to " "merge the new upstream version onto the <option>debian-branch</option> (you " "can skip the merge with <option>--no-merge</option>). After resolving any " "potential conflicts, go back to the second step." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/intro.xml:131 msgid "These steps will be explained in more details in the following sections." msgstr "" #. type: Content of: <chapter><title> #: chapters/patches.xml:2 msgid "Working with Patches" msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:5 msgid "" "&gbp-pq; can be used to manage patches that modify the upstream source " "inside <filename>debian/patches/</filename>. This is mostly intended for 3.0 " "(quilt) format source packages." msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:12 msgid "" "The basic idea is that patches are imported from your &debian-branch; to a " "patch-queue branch with one patch file in " "<filename>debian/patches/</filename> becoming one commit on the " "patch-queue branch. The created branch will be named after the branch you " "imported from with <filename>patch-queue/</filename> prepended. So if you do " "your &debian; packaging on <filename>debian/sid</filename> and do a" msgstr "" #. type: Content of: <chapter><programlisting> #: chapters/patches.xml:22 #, no-wrap msgid " &gbp-pq-import;\n" msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:25 msgid "" "then the newly created branch will be called " "<filename>patch-queue/debian/sid</filename>." msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:29 msgid "" "On the patch-queue branch you can work on the commits using familiar &git; " "commands (rebase, commit --amend, etc). When done, &gbp-pq; will be used to " "turn the commits on the patch-queue branch into patch in " "<filename>debian/patches/</filename> files again." msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:37 msgid "" "This workflow facilitates e.g. the cherry-picking of patches for stable " "releases, the forward-porting of patches to new upstream versions by using " "git rebase on the patch-queue branch (patches already applied upstream are " "detected automatically) as well as the reordering, dropping and renaming of " "patches without having to resort to &quilt;. The generated patches in " "<filename>debian/patches/</filename> have all the necessary information to " "forward them upstream since they use a format similar to " "<command>git-format-patch</command>." msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:49 msgid "" "The main drawback of this workflow is the lack of history on the patch-queue " "branch since it is frequently dropped and recreated. But there is full " "history on the your &debian-branch;, of course." msgstr "" #. type: Content of: <chapter><para> #: chapters/patches.xml:56 msgid "" "Also, beware that &gbp-pq; currently has incomplete support for <ulink " "url=\"https://dep-team.pages.debian.net/deps/dep3/\">DEP3</ulink> headers. " "Initially, parsing with <command>git-mailinfo(1)</command> is attempted, " "which supports only the <computeroutput>From</computeroutput> and " "<computeroutput>Subject</computeroutput> fields. If neither of these are " "present, &gbp-pq; will attempt to convert the patch from DEP3 format into a " "<command>git-mailinfo(1)</command> compatible format. This involves first " "loading <computeroutput>From</computeroutput> using the " "<computeroutput>Author</computeroutput> field and " "<computeroutput>Subject</computeroutput> using the first line of the " "<computeroutput>Description</computeroutput> field. Then, any additional " "fields (such as <computeroutput>Origin</computeroutput> and " "<computeroutput>Forwarded</computeroutput>), and the remainder of the " "<computeroutput>Description</computeroutput> (if any), will be appended to " "the body." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/patches.xml:74 msgid "Basic Workflow" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:77 msgid "" "This example assumes you're working on a source 3.0 (quilt) format package " "with patches in <filename>debian/patches</filename> parseable by " "<command>git-quiltimport(1)</command>. The git branch currently checked out " "is named <filename>debian/sid</filename>." msgstr "" #. type: Content of: <chapter><sect1><mediaobject> #: chapters/patches.xml:85 msgid "" "<imageobject> <imagedata fileref=\"images/pq-unapplied.png\" " "format=\"PNG\"/> </imageobject>" msgstr "" #. type: Content of: <chapter><sect1><mediaobject><caption><para> #: chapters/patches.xml:90 msgid "The &debian-branch; we start from." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:95 msgid "" "Let's first create the patch-queue branch and import the contents of " "<filename>debian/patches</filename> onto it using &gbp-pq;" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:101 #, no-wrap msgid "" " <command>cd <replaceable>REPO</replaceable></command>\n" " &gbp-pq; import\n" msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/patches.xml:108 #, no-wrap msgid "" " gbp:info: Trying to apply patches at " "'aaa1011bfd5aa74fea43620aae94709de05f80be'\n" " gbp:info: 18 patches listed in 'debian/patches/series' imported on " "'patch-queue/debian/sid'\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:106 msgid "" "This will generate output like: <placeholder type=\"screen\" id=\"0\"/> What " "happened is that &gbp-pq; imported each patch file and switched you to the " "newly created patch-queue branch " "(<filename>patch-queue/debian/sid</filename>) automatically." msgstr "" #. type: Content of: <chapter><sect1><mediaobject> #: chapters/patches.xml:117 msgid "" "<imageobject> <imagedata fileref=\"images/pq-applied.png\" format=\"PNG\"/> " "</imageobject>" msgstr "" #. type: Content of: <chapter><sect1><mediaobject><caption><para> #: chapters/patches.xml:122 msgid "" "The patch-queue branch with patches from <filename>debian/patches</filename> " "applied." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:129 msgid "" "Now you can work on the patch-queue branch (add, remove, rebase, test) to " "get your patches into shape:" msgstr "" #. type: Content of: <chapter><sect1><para><itemizedlist><listitem><para> #: chapters/patches.xml:134 msgid "" "To add what will later become a patch in " "<filename>debian/patches/</filename> simply make a commit. The first line of " "the commit message will become the patch name later. The following lines " "include the details of what the patch does." msgstr "" #. type: Content of: <chapter><sect1><para><itemizedlist><listitem><para> #: chapters/patches.xml:143 msgid "" "To remove or edit commits use git rebase -i . The git documentation explains " "how to work with git-rebase." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:151 msgid "" "Once satisfied with the commits let's regenerate the patches in " "<filename>debian/patches/</filename> using &gbp-pq;. This will switch you " "back to the branch <filename>debian/sid</filename> and regenerate the " "patches using a method similar to <command>git-format-patch</command>:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:159 #, no-wrap msgid " &gbp-pq; export\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:162 msgid "You can now commit the result by using:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:164 #, no-wrap msgid "" " &gitcmd; add debian/patches\n" " &gitcmd; commit\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:168 msgid "" "If you don't want to commit the result by hand each time you can also pass " "<option>--commit</option> to the &gbp; <option>export</option> command " "above." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:174 msgid "" "Next you can update <filename>debian/changelog</filename> (e.g. by running " "\"&gbp-dch; <option>-S</option> <option>-a</option>\") and build the package " "as usual." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:184 msgid "To update your patches for a new upstream version one" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:189 msgid "" "Imports the current patches onto the patch-queue branch (if not done " "already) using &gbp-pq-import;. This will allow you to rebase the patches on " "the new upstream version later." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:196 msgid "" "Imports the new upstream version with &gbp-import-orig; " "<option>--uscan</option>." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:202 msgid "" "Rebases the patches onto the new upstream version using " "&gbp-pq-rebase;. This will bring the patches up to date regarding the new " "upstream version. Patches already applied upstream can be dropped and " "remaining patches can be modified to apply to the new version." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:211 msgid "" "Exports the patches to <filename>debian/patches</filename> using " "&gbp-pq-export;." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:218 msgid "" "But don't worry if you forgot to do so before importing the new version (or " "if another team member imported the version already)." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:223 msgid "" "In this case you can make &gbp-pq; figure out where to apply the patches by " "using the <option>--time-machine=</option> option. The following command" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:229 #, no-wrap msgid " &gbp-pq-import; --force --time-machine=10\n" msgstr "" #. type: Content of: <chapter><sect1><para><footnote><para> #: chapters/patches.xml:236 msgid "" "This is not necessarily your debian-branch; HEAD since the new upstream " "version might have changed so that the patches no longer apply cleanly " "there." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:233 msgid "" "would drop your current patch-queue branch (if existent) and create a new " "one by going back in your commit history as far as 10 commits to find a " "place where your patches still apply <placeholder type=\"footnote\" " "id=\"0\"/>. If it finds such a commit on your &debian-branch; it will create " "the patch-queue branch from there and switch you to that branch. You can now " "rework your patches to apply to the new upstream version by using " "&gbp-pq-rebase;:" msgstr "" #. type: Content of: <chapter><sect1><mediaobject> #: chapters/patches.xml:247 msgid "" "<imageobject> <imagedata fileref=\"images/pq-time-machine.png\" " "format=\"PNG\"/> </imageobject>" msgstr "" #. type: Content of: <chapter><sect1><mediaobject><caption><para> #: chapters/patches.xml:252 msgid "The patch-queue branch and &debian-branch; after importing the patches." msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:259 #, no-wrap msgid " &gbp-pq-rebase;\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:263 msgid "or you can invoke &gitcmd; <option>rebase</option> directly:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:267 #, no-wrap msgid " &gitcmd; rebase -i debian/sid\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:271 msgid "" "Should the rebase fail (e.g. because the upstream source changed at the same " "place your patches modify the code) you can resolve this by using the " "options of &gitcmd; <option>rebase</option> (if you simply want to abort use " "&gitcmd; <option>rebase</option> <option>--abort</option>)." msgstr "" #. type: Content of: <chapter><sect1><mediaobject> #: chapters/patches.xml:279 msgid "" "<imageobject> <imagedata fileref=\"images/pq-rebase.png\" format=\"PNG\"/> " "</imageobject>" msgstr "" #. type: Content of: <chapter><sect1><mediaobject><caption><para> #: chapters/patches.xml:284 msgid "" "The patch-queue branch after rebasing the patches. Patches that were merged " "upstream were dropped." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:291 msgid "Once done you can export your commits to patch files again:" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><programlisting> #: chapters/patches.xml:294 chapters/patches.xml:345 #, no-wrap msgid " &gbp-pq-export; --commit\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:298 msgid "The export will also switch you back to the &debian-branch;." msgstr "" #. type: Content of: <chapter><sect1><mediaobject> #: chapters/patches.xml:301 msgid "" "<imageobject> <imagedata fileref=\"images/pq-export.png\" format=\"PNG\"/> " "</imageobject>" msgstr "" #. type: Content of: <chapter><sect1><mediaobject><caption><para> #: chapters/patches.xml:306 msgid "The &debian-branch; after exporting the patches and committing the changes." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:312 msgid "" "See this in action in a <ulink " "url=\"https://honk.sigxcpu.org/piki/projects/git-buildpackage/videos/gbp-pq-new-upstream-version.ogv\">short " "video</ulink>." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/patches.xml:319 msgid "Adding your first patch" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:322 msgid "" "If a package doesn't have any patches yet, these are the steps to add your " "first patch:" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para><programlisting> #: chapters/patches.xml:330 #, no-wrap msgid " &gbp-pq-import;\n" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:327 msgid "" "Launch an import. If there's nothing to import &gbp-pq; will just create an " "empty branch and switch your working copy to it: <placeholder " "type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:336 msgid "" "Create your first patch: edit files, test, commit your changes using " "<command>git commit</command>" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:342 msgid "To generate the new Quilt patch set use" msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:348 msgid "" "This will switch you back to your &debian-branch; branch, generate the " "patches and commit them right away to this branch." msgstr "" #. type: Content of: <chapter><sect1><orderedlist><listitem><para> #: chapters/patches.xml:353 msgid "" "Skip the <option>--commit</option> if you don't want to commit right " "away. If you want to pick the changelog message from the patch see " "<filename>/usr/share/doc/git-buildpackage/examples/gbp-add-patch</filename>." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/patches.xml:363 msgid "Team maintenance" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:365 msgid "" "The easiest way is to not push out any patch-queue/* branches at all. They " "can be recreated by any team member easily by using" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:369 #, no-wrap msgid " &gbp-pq-import; --force\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:373 msgid "" "The patch-queue branch can also be re-created when pulling (this will " "additionally drop your current patch-queue branch and recreate it from " "<filename>debian/patches</filename>):" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/patches.xml:377 #, no-wrap msgid " &gbp-pull; --redo-pq\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/patches.xml:381 msgid "" "Note that you can push out patch-queue branches. Other team members must " "just be aware that branches in the patch-queue/ namespace are being rebased " "frequently and therefore cause non fast-forward updates." msgstr "" #. type: Content of: <chapter><title> #: chapters/releases.xml:2 msgid "Releases and Snapshots" msgstr "" #. type: Content of: <chapter><para> #: chapters/releases.xml:5 msgid "" "The &changelog; gives the &debian; package a version number and keeps track " "of changes made to the package in a particular version. While the changelog " "can still be maintained by hand we can make use of &gbp-dch; to have our " "&git; commit messages end up in &changelog;. This avoids the double " "maintenance of the &git; commit history and the &debian; changelog. If you " "don't want a one to one mapping of changelog entries to &git; commits you're " "free to edit the changelog by hand at any point." msgstr "" #. type: Content of: <chapter><para> #: chapters/releases.xml:16 msgid "" "Not committing changelog entries with the actual modifications also has the " "advantage that the changelog won't cause any trouble when cherry-picking " "patches from different branches. It can be created when releasing the " "package or after performing several commits. Invocations of &dch; and " "&gbp-dch; can be mixed." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/releases.xml:24 msgid "Maintaining <filename>debian/changelog</filename>" msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/releases.xml:26 msgid "Creating &changelog; just before the release" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/releases.xml:28 msgid "" "The simplest way is doing all the changes to the " "<option>debian-branch</option> without touching " "<filename>debian/changelog</filename> at all. Then, when done, do:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/releases.xml:33 chapters/releases.xml:115 #, no-wrap msgid "&gbp-dch; <option>--release</option>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/releases.xml:36 msgid "" "This will look up the latest released version in the changelog, increment " "the version in the &debian; changelog, generate changelog messages from the " "corresponding &git; commit id up to the branch head, and finally spawns an " "editor for final changelog editing." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/releases.xml:43 msgid "Incrementally filling &changelog;" msgstr "" #. type: Content of: <chapter><sect1><sect2><para><programlisting> #: chapters/releases.xml:49 #, no-wrap msgid "&gbp-dch;\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/releases.xml:45 msgid "" "You can run &gbp-dch; without any options to make it add all commit messages " "since the last &debian; tag to a new UNRELEASED changelog section: " "<placeholder type=\"programlisting\" id=\"0\"/> You can then commit the " "<filename>debian/changelog</filename> to have your current changes " "recorded. Later invocations of &gbp-dch; will check when " "<filename>debian/changelog</filename> was last modified and not add these " "commits again. Upon your last call of &gbp-dch; before releasing the package " "add <option>--release</option> again to have the " "<emphasis>UNRELEASED</emphasis> distribution in the changelog turned into " "<emphasis>unstable</emphasis>." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/releases.xml:64 msgid "Creating snapshots with increasing version numbers" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:66 msgid "" "The downside of the above methods is that you either have the version number " "of the last release in &changelog; or that you have a changelog entry with " "<emphasis>UNRELEASED</emphasis> that has the same version number for all " "commits you do during the development cycle of your package. Although this " "is common practice in &debian; it means that also all your test builds have " "the same version number which makes them hard to distinguish in " "e.g. continuous integration pipelines." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:77 msgid "" "To address these shortcomings &gbp-dch; has a <option>--snapshot</option> " "option that can be used to create (unreleased) snapshots for intermediate " "testing with a version number that is lower than the one of the final " "package:" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/releases.xml:83 chapters/releases.xml:103 #, no-wrap msgid "&gbp-dch; <option>--snapshot</option>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:86 msgid "" "will generate a snapshot release with a specially crafted version number and " "a warning in the changelog that this is a snapshot release:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/releases.xml:90 #, no-wrap msgid "" "git-buildpackage (0.3.7~1.gbp470ce2) UNRELEASED; urgency=low\n" "\n" " ** SNAPSHOT build @470ce29ec7877705c844474a2fd89869aea0406d **\n" "\n" " * add support for automatic snapshot \n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:97 msgid "" "During subsequent calls with <option>--snapshot</option>, this version " "number will continue to increase. Since the snapshot banner contains the " "commit id of the current branch HEAD, &gbp-dch; can figure out what to " "append to the changelog by itself (even without committing the changelog " "first): <placeholder type=\"programlisting\" id=\"0\"/> will fetch the " "commit id from &changelog; and add changelog entries from that point to the " "current HEAD—again auto incrementing the version number. If you don't " "want to start at that commit id, you can specify any id or tag with:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/releases.xml:109 #, no-wrap msgid "" "&gbp-dch; " "<option>--since</option>=<replaceable>e76a6a180a57701ae4ae381f74523cacb3152780</replaceable> " "<option>--snapshot</option>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:112 msgid "After testing, you can remove the snapshot header by a final &gbp-dch; call:" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:118 msgid "" "This will pick new commit if present and remove the specially crafted " "version number and the snapshot header. If you want finer control of what is " "being added you can again use the <option>--since</option>." msgstr "" #. type: Content of: <chapter><sect1><sect2><title> #: chapters/releases.xml:123 msgid "Customizing snapshot numbers" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/releases.xml:124 msgid "" "If the auto incrementing of the snapshot number doesn't suite your needs, " "you can give any Python expression that evaluates to a positive integer to " "calculate the new snapshot number:" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/releases.xml:128 #, no-wrap msgid "" "&gbp-dch; <option>-S</option> <option>-a</option> " "<option>--snapshot-number</option>=<replaceable>1</replaceable>\n" "&gbp-dch; <option>-S</option> <option>-a</option> " "<option>--snapshot-number</option>=<replaceable>'snapshot + " "2'</replaceable>\n" "&gbp-dch; <option>-S</option> <option>-a</option> " "<option>--snapshot-number</option>=<replaceable>'os.popen(\"git-log " "--pretty=oneline | wc -l\").readlines()[0]'</replaceable>\n" "&gbp-dch; <option>-S</option> <option>-a</option> " "<option>--snapshot-number</option>=<replaceable>`git-log --pretty=oneline " "debian/0.3.3 | wc -l`</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><sect2><para> #: chapters/releases.xml:134 msgid "" "You can also add the snapshot-number calculation to " "<filename>gbp.conf</filename>:" msgstr "" #. type: Content of: <chapter><sect1><sect2><programlisting> #: chapters/releases.xml:137 #, no-wrap msgid "" "[DEFAULT]\n" "snapshot-number = os.popen(\"git-log --pretty=oneline | wc " "-l\").readlines()[0]\n" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/releases.xml:144 msgid "Tuning commit messages" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:146 msgid "" "You can use <option>--full</option> to include the full commit message in " "the changelog. If you want to tweak the formatting there's a " "<option>--customizations</option>." msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:155 #, no-wrap msgid "" "New upstream version\n" "\n" "Closes: #1000\n" "Thanks: cool upstream\n" msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:162 #, no-wrap msgid " * New upstream version (Closes: #1000) - thanks to cool upstream\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:151 msgid "" "Additionally, there are tags <option>Closes:</option> and " "<option>Thanks:</option> available to customize the commit message. Each tag " "has to start at the beginning of a single line. For example, the git commit " "message <placeholder type=\"screen\" id=\"0\"/> would result in a changelog " "entry: <placeholder type=\"screen\" id=\"1\"/> You can use the " "<option>Closes:</option> tag multiple times." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:167 msgid "" "There are several tags to further customize what (and how) commit messages " "get included into the changelog:" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:171 msgid "To exclude a commit from the generated changelog, use:" msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:175 #, no-wrap msgid "Gbp-Dch: Ignore\n" msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:181 #, no-wrap msgid "" "Set correct branchnames in debian/gbp.conf\n" "\n" "Gbp-Dch: Ignore\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:174 msgid "" "<placeholder type=\"screen\" id=\"0\"/> This is e.g. useful if you're just " "fixing up a previous commit and couldn't amend it, or for other janitorial " "commits that really don't need to end up in the changelog. For example, the " "following git commit message <placeholder type=\"screen\" id=\"1\"/> will " "not show up in the generated changelog in any way." msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:190 #, no-wrap msgid "Gbp-Dch: Full\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:188 msgid "" "To include the full commit message in the changelog, use: <placeholder " "type=\"screen\" id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:196 #, no-wrap msgid "Gbp-Dch: Short\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:194 msgid "" "To only include the short description in the changelog and skip the body, " "use: <placeholder type=\"screen\" id=\"0\"/> The latter only takes effect " "when running &gbp-dch; with the <option>--full</option> option since " "including only the short description is the default." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:203 msgid "" "Usually, changelog entries should correspond to a single &git; commit. In " "this case, it's convenient to include the commit id in the changelog entry. " "This has the advantage that it's easy for people to identify changes without " "having to write very extensive changelog messages—the link back to " "&git; can be automated via the <option>Vcs-Browser</option> and " "<option>Vcs-Git</option> fields in <filename>debian/control</filename>. See " "<ulink url=\"https://honk.sigxcpu.org/cl2vcs\"> Cl2vcs</ulink> for how this " "looks." msgstr "" #. type: Content of: <chapter><sect1><para><screen> #: chapters/releases.xml:219 #, no-wrap msgid "" " * [571bfd4] New upstream version (Closes: #1000) - thanks to cool " "upstream\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/releases.xml:215 msgid "" "The inclusion of the commit id can be done automatically via &gbp-dch;'s " "<option>--id-length</option> option. Using " "<option>--id-length</option>=<replaceable>7</replaceable> would change the " "above example to: <placeholder type=\"screen\" id=\"0\"/> This makes it much " "easier to see which commit actually fixed bug #1000." msgstr "" #. type: Content of: <chapter><title> #: chapters/special.xml:2 msgid "Special Use Cases" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/special.xml:4 msgid "Handling non-DFSG clean upstream sources" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:5 msgid "" "If you have to handle non-DFSG clean upstream sources, you can use a " "different branch which you have to create once:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:9 #, no-wrap msgid " &gitcmd; branch dfsg_clean upstream\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:12 msgid "" "This creates the <emphasis>dfsg_clean</emphasis> branch from the tip of a " "branch called <emphasis>upstream</emphasis>. Then, when importing a new " "upstream version, you import the new version on the " "<option>upstream-branch</option> (by default named " "<emphasis>upstream</emphasis>) as usual and just don't merge to the " "<emphasis>debian-branch</emphasis> (by default named " "<emphasis>master</emphasis>):" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:21 #, no-wrap msgid "" " &gbp-import-orig; --no-merge " "<filename>/path/to/nondfsg-clean-package_10.4.orig.tar.gz</filename>\n" " &gitcmd; <option>tag</option> 10.4\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:25 msgid "" "After the import, you can switch to the <emphasis>dfsg_clean</emphasis> " "branch and get the newly imported changes from the upstream branch:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:29 #, no-wrap msgid "" " &gitcmd; <option>checkout</option> dfsg_clean\n" " &gitcmd; <option>pull</option> <filename>.</filename> upstream\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:32 msgid "" "Now make this checkout dfsg clean (preferably by a cleanup script), commit " "your changes and merge to your <option>debian-branch</option>:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:35 #, no-wrap msgid "" " cleanup-script.sh\n" " &gitcmd; commit -a -m \"Make source dfsg clean\"\n" " &gitcmd; tag <replaceable>10.4.dfsg</replaceable>\n" " &gitcmd; checkout <replaceable>master</replaceable>\n" " &gitcmd; pull <replaceable>.</replaceable> " "<replaceable>dfsg_clean</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/special.xml:44 msgid "Importing NMUs" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:46 msgid "" "First, create a branch that holds the NMUs from the tip of your " "<option>debian-branch</option> (default is <emphasis>master</emphasis>) " "once:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:50 #, no-wrap msgid "" " &gitcmd; <option>branch</option> <replaceable>nmu</replaceable> " "<replaceable>master</replaceable>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:53 msgid "To import an NMU, change into the git repository and use &gbp-import-dsc;:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:56 #, no-wrap msgid "" " &gitcmd; checkout <replaceable>master</replaceable>\n" " &gbp-import-dsc; " "<option>--debian-branch</option>=<replaceable>nmu</replaceable> " "<filename>/path/to/package_1.0-1nmu0.dsc</filename>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:60 msgid "" "This will import the NMU onto the branched named <emphasis>nmu</emphasis> " "instead of the default <option>master</option>. This method can also be used " "to import \"old\" releases into the &git; repository when migrating to &git; " "from another VCS." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/special.xml:68 msgid "Building with &cowbuilder;" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:70 msgid "" "&cowbuilder; is nice tool to build Debian packages in a defined " "environment. It makes sure all build-dependencies are specified correctly " "by building the package in a clean chroot. As its cousin &pbuilder; it can " "be extended via hooks to (e.g. run autopkg tests) but doesn't need a tarball " "unpacked but uses copy on write tree to speed up the build." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:79 msgid "" "Since &cowbuilder; uses different command line arguments than &debuild; and " "&dpkg-buildpackage;, we can't simply pass the options to run it on the " "command line. To simplifiy the integration we use a separate helper named " "&git-pbuilder;. &gbp; has it's own command line option for this:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:86 #, no-wrap msgid " &gbp-buildpackage; <option>--git-pbuilder</option>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:89 msgid "" "This will set the build command to run &git-pbuilder; (which invokes " "&cowbuilder; by default) and the clean command to " "<command>/bin/true</command>. It also activates the parsing of several " "&git-pbuilder; related options like <option>--git-dist</option>, " "<option>--git-arch</option> and <option>--git-pbuilder-options</option>." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:98 msgid "" "We can make &git-pbuilder; usage the default by adding it to " "<filename>~/.gbp.conf</filename>:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:102 #, no-wrap msgid "" "cat <<EOF > <filename>~/.gbp.conf</filename>\n" "[DEFAULT]\n" "# We invoke cowbuilder via git-pbuilder. Arguments passed to " "&gbp-buildpackage;\n" "# will be passed to dpkg-buildpackage in the chroot\n" "pbuilder = True\n" "EOF\n" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/special.xml:115 #, no-wrap msgid " &gbp-buildpackage; --git-pbuilder --git-dist=jessie\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:110 msgid "" "<command>git-pbuilder</command> defaults to building a package for the " "<envar>sid</envar> distribution. If you want to build for another " "distribution, pass this in the <option>--git-dist</option> option: " "<placeholder type=\"programlisting\" id=\"0\"/> If you want to use " "<command>debuild</command> again (without modifying " "<filename>~/.gbp.conf</filename>), you can use:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:122 #, no-wrap msgid " &gbp-buildpackage; --git-no-pbuilder\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:125 msgid "" "In order for all of the above to work you have to create a base chroot first " "using &git-pbuilder;:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:129 #, no-wrap msgid " <command>git-pbuilder</command> create\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:132 msgid "This can later be updated using:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:135 #, no-wrap msgid " <command>git-pbuilder</command> update\n" msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/special.xml:140 msgid "Working on random packages" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/special.xml:145 #, no-wrap msgid "" " &gbp-import-dsc; apt:<filename>package</filename>\n" " cd <filename>package</filename>\n" " &gitcmd; branch debian\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:142 msgid "" "Whenever you need to work on an arbitrary &debian; package, you can check it " "right into &git; with one command: <placeholder type=\"programlisting\" " "id=\"0\"/>" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:151 msgid "" "This uses <command>apt-get</command> to download the source package, puts " "the orig tarball on the <option>upstream-branch</option> and the &debian; " "changes on the <option>debian-branch</option> (by default " "<emphasis>master</emphasis>). The second command creates a branch called " "<emphasis>debian</emphasis>. Now you can easily modify the package, revert " "changes you made, create other branches for testing, see what changes you " "made, etc. When finished, just do" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:159 #, no-wrap msgid "" " &gitcmd; commit -a\n" " &gitcmd; diff debian --\n" msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/special.xml:167 #, no-wrap msgid "" " &gbp-import-dsc; " "<filename>http://mentors.debian.net/debian/pool/main/i/ipsec-tools/ipsec-tools_0.7.3-9.dsc</filename>\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:163 msgid "" "to get a nice patch that can be submitted to the &debian; BTS. You can also " "fetch the source package from a URL: <placeholder type=\"programlisting\" " "id=\"0\"/> The import works incrementally; you can import new versions on " "top of already imported ones for e.g. easy review of changes." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/special.xml:176 msgid "Sloppy tarball creation" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:178 msgid "" "By default &gbp-buildpackage; uses <filename>debian/changelog</filename> to " "detect the upstream version and build the corrsponding tarball either via " "&pristine-tar; or by using <command>git archive</command> directly. This " "ensures that the tarball matches what's in the Debian archive already." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:184 msgid "" "But there might be cases where you don't want to follow these packaging " "practice and create a fresh <emphasis>dirty</emphasis> tarball that contains " "additional changes. Such tarballs are not suitable for upload into the " "archive but might be helpful in local testing." msgstr "" #. type: Content of: <chapter><sect1><para><programlisting> #: chapters/special.xml:194 #, no-wrap msgid "" "dpkg-source: info: local changes detected, the modified files are:\n" " hello-debhelper/configure\n" "dpkg-source: error: aborting due to unexpected upstream changes, see " "/tmp/hello-debhelper_2.8-1.diff.har2Xx\n" "dpkg-source: info: you can integrate the local changes with dpkg-source " "--commit\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:190 msgid "" "Especially when getting started and when you first want to get a package " "built and dive into &gbp-dch;, &git-pbuilder; and the 3.0 (quilt) format " "later to find out what exactly <placeholder type=\"programlisting\" " "id=\"0\"/> means." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:202 msgid "" "For that you can force &gbp-buildpackage; to create a tarball from the " "<emphasis>debian-branch</emphasis> dropping the <filename>debian/</filename> " "directory. This will give you a tarball that is very close to your current " "working copy except for the packaging." msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:209 #, no-wrap msgid "" " &gbp-buildpackage; --git-ignore-new --git-force-create " "--git-upstream-tree=SLOPPY --git-no-pristine-tar\n" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:212 msgid "" "The important part is the <emphasis>SLOPPY</emphasis> above. The other " "options are there to prevent &gbp-buildpackage; from using &pristine-tar;, " "to force the creation of a new tarball and to not abort if you have changes " "in your current working copy. If you're still getting an error about " "<emphasis>unexpected upstream changes</emphasis> make sure you have no " "uncommitted changes in you workig copy (changes in the " "<filename>debian/</filename> directory are o.k.) and no files that are " "ignored by git via <filename>.gitignore</filename>. A <command>git clean " "-dfx</command> can help here." msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:226 msgid "" "Please don't use this tarball to upload to the Debian archive since changes " "outside <filename>debian/</filename> need to be represented by patches in " "<filename>debian/patches</filename>. See the <command>dpkg-source</command> " "manpage for details." msgstr "" #. type: Content of: <chapter><sect1><title> #: chapters/special.xml:235 msgid "Integrating with pk4" msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:237 msgid "" "&pk4; provides an easy way to fetch the sources of packages currently " "installed on the system. In order to let pk4 provide these packages as &git; " "repositories you can enable &gbp;'s unpack hook:" msgstr "" #. type: Content of: <chapter><sect1><programlisting> #: chapters/special.xml:243 #, no-wrap msgid "" "mkdir -p ~/.config/pk4/hooks-enabled/unpack/\n" "ln -s /usr/share/pk4/hooks-available/unpack/gbp " "~/.config/pk4/hooks-enabled/unpack/\n" " " msgstr "" #. type: Content of: <chapter><sect1><para> #: chapters/special.xml:247 msgid "" "This will make sure packages are imported into a git repository after " "download." msgstr "" #. type: Content of: <refentry><refentryinfo><address> #: manpages/gbp-buildpackage-rpm.xml:4 manpages/gbp-import-srpm.xml:4 #: manpages/gbp-pq-rpm.xml:4 manpages/gbp-rpm-ch.xml:4 #, no-wrap msgid "" " &rpm-email;\n" " " msgstr "" #. type: Content of: <refentry><refentryinfo> #: manpages/gbp-buildpackage-rpm.xml:3 manpages/gbp-import-srpm.xml:3 #: manpages/gbp-pq-rpm.xml:3 manpages/gbp-rpm-ch.xml:3 msgid "" "<placeholder type=\"address\" id=\"0\"/> <author> &rpm-firstname; " "&rpm-surname; </author>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-buildpackage-rpm.xml:11 manpages/gbp-buildpackage-rpm.xml:15 msgid "gbp-buildpackage-rpm" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-buildpackage-rpm.xml:16 msgid "Build RPM packages from a Git repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-buildpackage-rpm.xml:20 msgid "" "&gbp-buildpackage-rpm; <arg><option>--git-[no-]ignore-new</option></arg> " "<arg><option>--git-tag</option></arg> " "<arg><option>--git-verbose</option></arg> " "<arg><option>--git-color=</option>[auto|on|off]</arg> " "<arg><option>--git-color-scheme=</option><replaceable>COLOR_SCHEME</replaceable></arg> " "<arg><option>--git-notify=</option>[auto|on|off]</arg> " "<arg><option>--git-tmp-dir</option>=<replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-vendor</option>=<replaceable>VENDOR</replaceable></arg> " "<arg><option>--git-native</option>[auto|on|off]</arg> " "<arg><option>--git-upstream-branch=</option><replaceable>TREEISH</replaceable></arg> " "<arg><option>--git-packaging-branch=</option><replaceable>BRANCH_NAME</replaceable></arg> " "<arg><option>--git-ignore-branch</option></arg> " "<arg><option>--git-[no-]submodules</option></arg> " "<arg><option>--git-builder=</option><replaceable>BUILD_CMD</replaceable></arg> " "<arg><option>--git-cleaner=</option><replaceable>CLEAN_CMD</replaceable></arg> " "<arg><option>--git-[no-]sign-tags</option></arg> " "<arg><option>--git-keyid=</option><replaceable>GPG-KEYID</replaceable></arg> " "<arg><option>--git-posttag=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-postbuild=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-postexport=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-prebuild=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-preexport=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-[no-]build</option></arg> " "<arg><option>--git-[no-]hooks</option></arg> " "<arg><option>--git-packaging-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--git-upstream-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--git-force-create</option></arg> " "<arg><option>--git-no-create-orig</option></arg> " "<arg><option>--git-upstream-tree=</option><replaceable>[TAG|BRANCH|TREEISH]</replaceable></arg> " "<arg><option>--git-tarball-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-compression-level=</option><replaceable>LEVEL</replaceable></arg> " "<arg><option>--git-export-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-export=</option><replaceable>TREEISH</replaceable></arg> " "<arg><option>--git-packaging-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-spec-file=</option><replaceable>FILEPATH</replaceable></arg> " "<arg><option>--git-export-sourcedir</option>=<replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-export-specdir</option>=<replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-[no-]pristine-tar</option></arg> " "<arg><option>--git-[no-]pristine-tar-commit</option></arg> " "<arg><option>--git-tag-only</option></arg> " "<arg><option>--git-retag</option></arg> " "<arg><option>--git-mock</option></arg> " "<arg><option>--git-dist</option>=<replaceable>DISTRIBUTION</replaceable></arg> " "<arg><option>--git-arch</option>=<replaceable>ARCHITECTURE</replaceable></arg> " "<arg><option>--git-mock-options</option>=<replaceable>OPTIONS</replaceable></arg> " "<arg><option>--git-mock-root</option>=<replaceable>ROOT</replaceable></arg> " "<arg><option>--git-spec-vcs-tag</option>=<replaceable>TAG_FORMAT</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-buildpackage-rpm.xml:71 manpages/gbp-buildpackage.xml:70 #: manpages/gbp-clone.xml:41 manpages/gbp-config.xml:32 #: manpages/gbp.conf.xml:75 manpages/gbp-create-remote-repo.xml:40 #: manpages/gbp-dch.xml:84 manpages/gbp-export-orig.xml:38 #: manpages/gbp-import-dscs.xml:40 manpages/gbp-import-dsc.xml:53 #: manpages/gbp-import-orig.xml:51 manpages/gbp-import-ref.xml:37 #: manpages/gbp-import-srpm.xml:57 manpages/gbp-pq-rpm.xml:41 #: manpages/gbp-pq.xml:46 manpages/gbp-pristine-tar.xml:35 #: manpages/gbp-pull.xml:38 manpages/gbp-push.xml:36 manpages/gbp-rpm-ch.xml:46 #: manpages/gbp-setup-gitattributes.xml:28 manpages/gbp-tag.xml:35 #: manpages/gbp.xml:31 msgid "DESCRIPTION" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:73 msgid "" "&gbp-buildpackage-rpm; is used to build RPM packages from a &git; " "repository. It is an RPM counterpart for the &gbp-buildpackage; tool that is " "designed for building Debian packages." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:78 msgid "&gbp-buildpackage-rpm; will, in order:" msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:83 manpages/gbp-buildpackage.xml:81 msgid "Verify that it is being executed from the proper location." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:88 manpages/gbp-buildpackage.xml:86 #: manpages/gbp-tag.xml:47 msgid "Verify that the repository doesn't contain any uncommitted source changes." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:94 manpages/gbp-buildpackage.xml:92 msgid "Verify that it is being executed from the correct branch." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:99 msgid "Export packaging files to a separate build area." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:104 msgid "Create an orig source tarball if it doesn't exist." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:109 msgid "" "Call <application>rpmbuild</application>(1) (or the application specified " "via <option>--git-builder</option>), passing along all command line " "arguments that don't start with --git-." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:116 msgid "(Optionally) tag the tree after a successful build." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:121 msgid "" "(Optionally) call a post build hook - e.g. to run " "<productname>rpmlint</productname>." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:127 manpages/gbp-buildpackage.xml:137 msgid "" "(Optionally) call a post tag hook - e.g. to push the results to a remote " "repository after creating the tag." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-buildpackage-rpm.xml:134 manpages/gbp-buildpackage.xml:144 #: manpages/gbp-clone.xml:50 manpages/gbp-config.xml:40 #: manpages/gbp-create-remote-repo.xml:61 manpages/gbp-dch.xml:148 #: manpages/gbp-export-orig.xml:47 manpages/gbp-import-dscs.xml:55 #: manpages/gbp-import-dsc.xml:79 manpages/gbp-import-orig.xml:108 #: manpages/gbp-import-ref.xml:46 manpages/gbp-import-srpm.xml:70 #: manpages/gbp-pq-rpm.xml:128 manpages/gbp-pq.xml:133 #: manpages/gbp-pristine-tar.xml:46 manpages/gbp-pull.xml:54 #: manpages/gbp-push.xml:90 manpages/gbp-rpm-ch.xml:66 #: manpages/gbp-setup-gitattributes.xml:50 manpages/gbp-tag.xml:64 #: manpages/gbp.xml:37 msgid "OPTIONS" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:137 manpages/gbp-buildpackage.xml:751 msgid "<option>--git-[no-]ignore-new</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:141 msgid "" "Don't abort if there are uncommitted changes in the source tree or the " "current branch doesn't match the " "<replaceable>PACKAGING-BRANCH</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:148 manpages/gbp-buildpackage.xml:574 msgid "<option>--git-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:152 msgid "Add a git tag after a successful build." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:157 manpages/gbp-buildpackage.xml:333 msgid "<option>--git-builder=<replaceable>BUILD_CMD</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:161 msgid "" "Use <replaceable>BUILD_CMD</replaceable> instead of <command>rpmbuild " "-ba</command>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:167 manpages/gbp-buildpackage.xml:345 msgid "<option>--git-cleaner=<replaceable>CLEAN_CMD</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:171 msgid "Use <replaceable>CLEAN_CMD</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:176 manpages/gbp-buildpackage.xml:767 msgid "<option>--git-verbose</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:180 msgid "Verbose execution" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:185 manpages/gbp-buildpackage.xml:776 msgid "<option>--git-color=</option>[auto|on|off]" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:189 manpages/gbp-buildpackage.xml:780 #: manpages/gbp-export-orig.xml:63 msgid "Whether to use colored output." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:194 msgid "<option>--git-color-scheme=</option><replaceable>COLOR_SCHEME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:198 manpages/gbp-buildpackage.xml:789 msgid "" "Colors to use in output (when color is enabled). The format for COLOR_SCHEME " "is '<debug>:<info>:<warning>:<error>'. Numerical " "values and color names are accepted, empty fields imply the default " "color. For example --git-color-scheme='cyan:34::' would show debug messages " "in cyan, info messages in blue and other messages in default (i.e. warning " "and error messages in red)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:209 manpages/gbp-buildpackage.xml:457 msgid "<option>--git-notify=</option>[auto|on|off]" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:213 msgid "Whether to send a desktop notification after the build." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:218 manpages/gbp-rpm-ch.xml:71 msgid "<option>--git-tmp-dir</option>=<replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:222 manpages/gbp-rpm-ch.xml:75 msgid "Base directory under which temporary directories are created." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:227 msgid "<option>--git-vendor</option>=<replaceable>VENDOR</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:231 manpages/gbp-import-srpm.xml:79 #: manpages/gbp-rpm-ch.xml:84 msgid "Distribution vendor name." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:236 msgid "<option>--git-native=</option>[auto|on|off]" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:240 msgid "" "Define the 'nativity' of a package. The default value " "<replaceable>auto</replaceable> makes &gbp-buildpackage-rpm; to " "guess. Guessing is based on the existence of upstream branch." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:247 manpages/gbp-buildpackage.xml:207 msgid "<option>--git-upstream-branch</option>=<replaceable>BRANCH_NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:251 manpages/gbp-buildpackage.xml:211 msgid "" "Branch to build the orig tarball from if " "<option>--git-upstream-tree</option> is set to " "<replaceable>BRANCH</replaceable>. Default is " "<replaceable>upstream</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:259 msgid "<option>--git-packaging-branch</option>=<replaceable>BRANCH_NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:263 msgid "" "If you're not on this branch when invoking &gbp-buildpackage-rpm; it will " "fail. Default is <replaceable>master</replaceable>. This is done to make " "sure you don't accidentally release from a topic branch. Not being on this " "branch will be ignored when using <option>--git-ignore-new</option>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:272 manpages/gbp-buildpackage.xml:741 msgid "<option>--git-ignore-branch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:276 manpages/gbp-rpm-ch.xml:103 msgid "" "Don't check if the current branch matches " "<replaceable>PACKAGING-BRANCH</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:282 manpages/gbp-buildpackage.xml:290 msgid "<option>--git-[no-]submodules</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:286 manpages/gbp-export-orig.xml:99 msgid "Include git submodules in the orig tarball." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:291 manpages/gbp-buildpackage.xml:590 msgid "<option>--git-[no-]sign-tags</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:295 manpages/gbp-buildpackage.xml:594 #: manpages/gbp-import-orig.xml:199 manpages/gbp-import-ref.xml:139 #: manpages/gbp-import-srpm.xml:108 manpages/gbp-tag.xml:87 msgid "GPG sign all created tags." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:300 manpages/gbp-buildpackage.xml:599 msgid "<option>--git-keyid=</option><replaceable>GPG-KEYID</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:304 manpages/gbp-buildpackage.xml:603 #: manpages/gbp-import-dsc.xml:117 manpages/gbp-import-srpm.xml:117 #: manpages/gbp-tag.xml:96 msgid "Use this keyid for gpg signing tags." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:309 manpages/gbp-buildpackage.xml:541 msgid "<option>--git-posttag=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:313 msgid "Execute <replaceable>COMMAND</replaceable> after tagging a new version." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:317 manpages/gbp-buildpackage.xml:550 #: manpages/gbp-tag.xml:75 msgid "" "Exported environment variables are: <envar>GBP_TAG</envar> (the name of the " "generated tag), <envar>GBP_BRANCH</envar> (the branch the package was built " "from) and <envar>GBP_SHA1</envar> (the sha1 of the commit the tag was " "created at)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:325 manpages/gbp-buildpackage.xml:525 msgid "<option>--git-postbuild=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:329 msgid "Execute <replaceable>COMMAND</replaceable> after successful build." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:333 manpages/gbp-buildpackage.xml:534 msgid "" "Exported environment variables are: <envar>GBP_CHANGES_FILE</envar> (the " "name of the generated changes file), <envar>GBP_BUILD_DIR</envar> (the build " "dir)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:340 manpages/gbp-buildpackage.xml:476 msgid "<option>--git-preexport=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:344 msgid "Execute <replaceable>COMMAND</replaceable> before exporting the source tree." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:348 manpages/gbp-buildpackage-rpm.xml:364 #: manpages/gbp-buildpackage.xml:501 msgid "" "Exported environment variables are: <envar>GBP_GIT_DIR</envar> (the " "repository the package is being built from), <envar>GBP_TMP_DIR</envar> (the " "temporary directory where the sources have been initially exported)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:356 manpages/gbp-buildpackage.xml:491 msgid "<option>--git-postexport=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:360 msgid "Execute <replaceable>COMMAND</replaceable> after exporting the source tree." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:372 manpages/gbp-buildpackage.xml:509 msgid "<option>--git-prebuild=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:376 msgid "" "Execute <replaceable>COMMAND</replaceable> from the build directory before " "calling <application>rpmbuild</application> or the application specified via " "<option>--git-builder</option>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:381 manpages/gbp-buildpackage.xml:484 #: manpages/gbp-buildpackage.xml:518 msgid "" "Exported environment variables are: <envar>GBP_GIT_DIR</envar> (the " "repository the package is being built from), <envar>GBP_BUILD_DIR</envar> " "(the build dir)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:388 msgid "<option>--git-[no-]build</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:392 msgid "" "Enable builder. Note: <option>--git-no-build</option> causes the postbuild " "hook to be disabled, too." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:398 manpages/gbp-buildpackage.xml:558 msgid "<option>--git-[no-]hooks</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:402 manpages/gbp-buildpackage.xml:562 msgid "" "Enable running all (cleaner, preexport, postexport, prebuild, postbuild, and " "posttag) hooks. Note: the <option>--git-builder</option> command is not " "affected by this option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:409 msgid "<option>--git-packaging-tag=</option><replaceable>TAG-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:413 msgid "Use this tag format when tagging released versions of the package." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:418 manpages/gbp-buildpackage.xml:170 #: manpages/gbp-dch.xml:173 msgid "<option>--git-upstream-tag=</option><replaceable>TAG-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:422 manpages/gbp-dch.xml:177 #: manpages/gbp-export-orig.xml:108 manpages/gbp-pq-rpm.xml:157 #: manpages/gbp-pq.xml:277 msgid "" "Use this tag format when looking for tags of upstream versions, default is " "<replaceable>upstream/%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:428 manpages/gbp-buildpackage.xml:261 msgid "<option>--git-force-create</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:432 manpages/gbp-export-orig.xml:118 msgid "" "Force creation of an orig tarball (overwriting a pre-existing one if " "present)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:438 manpages/gbp-buildpackage.xml:271 msgid "<option>--git-no-create-orig</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:442 msgid "Don't try to create any orig tarball." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:447 manpages/gbp-buildpackage.xml:658 msgid "<option>--git-export-dir=</option><replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:451 msgid "" "Export the packaging files from the current branch head (or the treeish " "object given via <option>--git-export</option> to " "<replaceable>DIRECTORY</replaceable> before building." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:458 msgid "<option>--git-export-sourcedir</option>=<replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:460 msgid "<option>--git-export-specdir</option>=<replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:464 msgid "" "Subdirectories under export directory where packaging files are " "exported. The default build options of rpmbuild builder are also adjusted " "accordingly." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:471 manpages/gbp-buildpackage.xml:670 msgid "<option>--git-export=</option><replaceable>TREEISH</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:475 msgid "" "Instead of exporting the current branch head, export the treeish object " "<replaceable>TREEISH</replaceable>. The special name " "<replaceable>INDEX</replaceable> exports the current index, " "<replaceable>WC</replaceable>) exports all files in the current working " "directory." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:484 manpages/gbp-import-srpm.xml:164 msgid "<option>--git-packaging-dir=</option><replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:488 manpages/gbp-pq-rpm.xml:136 #: manpages/gbp-rpm-ch.xml:123 msgid "Subdirectory that contains the RPM packaging files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:493 msgid "<option>--git-spec-file=</option><replaceable>FILEPATH</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:497 msgid "" "Relative path to the spec file to use. Special value " "<replaceable>auto</replaceable> causes &gbp-buildpackage-rpm; to search and " "guess. Other values cause the <option>--git-packaging-dir</option> option " "to be ignored: the directory of the spec file is used, instead." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:506 msgid "<option>--git-upstream-tree=</option><replaceable>[TAG|BRANCH|TREEISH]</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:510 msgid "" "How to find the upstream sources used to generate the tarball. " "<replaceable>TAG</replaceable> looks at a tag corresponding to the version " "in the changelog. <replaceable>BRANCH</replaceable> looks at the upstream " "branch given via the <option>--git-upstream-branch</option> option. Other " "values are interpreted as treeishs." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:518 manpages/gbp-buildpackage.xml:201 msgid "" "This doesn't have any effect if <option>--git-pristine-tar</option> is being " "used." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:524 manpages/gbp-buildpackage.xml:219 msgid "<option>--git-tarball-dir=</option><replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:528 msgid "" "Search for original tarballs in <replaceable>DIRECTORY</replaceable> instead " "of generating them." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:534 manpages/gbp-buildpackage.xml:314 msgid "<option>--git-compression-level=</option><replaceable>LEVEL</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:538 manpages/gbp-buildpackage.xml:318 #: manpages/gbp-export-orig.xml:175 msgid "" "Specifies the upstream tarball compression level if an upstream tarball " "needs to be built." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:544 manpages/gbp-buildpackage.xml:637 msgid "<option>--git-tag-only</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:548 msgid "Don't build, only tag and run post-tag hooks." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:553 manpages/gbp-buildpackage.xml:626 msgid "<option>--git-retag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:557 msgid "" "Don't fail tag operations if a tag with the same version already exists, " "but, overwrite the existing tag, instead." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:563 manpages/gbp-buildpackage.xml:158 msgid "<option>--git-pristine-tar</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:567 manpages/gbp-export-orig.xml:204 msgid "Use pristine-tar when generating the upstream tarball if it doesn't exist." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:573 manpages/gbp-buildpackage.xml:251 msgid "<option>--git-pristine-tar-commit</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:577 manpages/gbp-buildpackage.xml:255 msgid "" "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." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:583 msgid "<option>--git-mock</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:587 msgid "Use &mock; to build the rpms by invoking &gbp-builder-mock;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:592 msgid "<option>--git-dist</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:596 msgid "Build for this distribution when using &mock; (e.g.: epel-6)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:601 msgid "<option>--git-arch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:605 msgid "" "Build for this architecture when using mock, default is to build for the " "current host architecture." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:611 msgid "<option>--git-mock-root</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:615 msgid "" "The mock root to use. Defaults to " "<replaceable>DIST</replaceable>-<replaceable>ARCH</replaceable> from above." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:622 msgid "<option>--git-mock-options</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:626 msgid "" "Additional options to pass to mock. Default is to pass no additional " "options." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-buildpackage-rpm.xml:632 msgid "<option>--git-spec-vcs-tag</option>=<replaceable>TAG_FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage-rpm.xml:636 msgid "" "&gbp-buildpackage-rpm; always automatically sets/updates the 'VCS:' tag in " "the spec file after exporting. This option defines the format string for " "the 'VCS:' tag. An empty value causes no 'VCS:' tag to be inserted and " "possible old 'VCS:' tag to be removed. Otherwise, the old 'VCS:' tag is " "updated or a new 'VCS:' tag is added if one does not exist. In the format " "string '%(tagname)s' expands to the long tag name (from git-describe) and " "'%(commit)s' expans to the sha1 of the exported commit." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-buildpackage-rpm.xml:650 manpages/gbp-buildpackage.xml:803 #: manpages/gbp-clone.xml:189 manpages/gbp-config.xml:72 #: manpages/gbp.conf.xml:215 manpages/gbp-export-orig.xml:221 #: manpages/gbp-import-dsc.xml:278 manpages/gbp-import-orig.xml:409 #: manpages/gbp-import-ref.xml:211 manpages/gbp-pristine-tar.xml:84 #: manpages/gbp-tag.xml:166 msgid "EXAMPLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:652 msgid "Only build a source RPM with &rpmbuild;" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-buildpackage-rpm.xml:655 #, no-wrap msgid "" " &gbp-buildpackage-rpm; -bs\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:658 msgid "" "Build an RPM package with &rpmbuild; on a custom branch with the uncommitted " "changes included." msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-buildpackage-rpm.xml:662 #, no-wrap msgid "" " &gbp-buildpackage-rpm; --git-ignore-branch --git-export=WC\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:668 msgid "All options in the config files are specified without the 'git-' prefix." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-buildpackage-rpm.xml:672 manpages/gbp-buildpackage.xml:840 #: manpages/gbp-clone.xml:216 manpages/gbp-config.xml:89 #: manpages/gbp.conf.xml:304 manpages/gbp-create-remote-repo.xml:146 #: manpages/gbp-dch.xml:645 manpages/gbp-export-orig.xml:241 #: manpages/gbp-import-dscs.xml:79 manpages/gbp-import-dsc.xml:300 #: manpages/gbp-import-orig.xml:430 manpages/gbp-import-ref.xml:234 #: manpages/gbp-import-srpm.xml:270 manpages/gbp-pq-rpm.xml:262 #: manpages/gbp-pq.xml:337 manpages/gbp-pristine-tar.xml:97 #: manpages/gbp-pull.xml:164 manpages/gbp-push.xml:162 #: manpages/gbp-rpm-ch.xml:339 manpages/gbp-setup-gitattributes.xml:82 #: manpages/gbp-tag.xml:184 manpages/gbp.xml:182 msgid "SEE ALSO" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:674 msgid "" "<xref linkend=\"man.gbp.import.srpm\"/>, <xref linkend=\"man.gbp.pq.rpm\"/>, " "<xref linkend=\"man.gbp.rpm.ch\"/>, <citerefentry> " "<refentrytitle>rpmbuild</refentrytitle> <manvolnum>8</manvolnum> " "</citerefentry>, <citerefentry> <refentrytitle>mock</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common;" msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-buildpackage-rpm.xml:690 manpages/gbp-buildpackage.xml:867 #: manpages/gbp-clone.xml:229 manpages/gbp-config.xml:95 #: manpages/gbp-create-remote-repo.xml:154 manpages/gbp-dch.xml:658 #: manpages/gbp-export-orig.xml:251 manpages/gbp-import-dscs.xml:91 #: manpages/gbp-import-dsc.xml:324 manpages/gbp-import-orig.xml:445 #: manpages/gbp-import-ref.xml:249 manpages/gbp-import-srpm.xml:281 #: manpages/gbp-pq-rpm.xml:270 manpages/gbp-pq.xml:352 #: manpages/gbp-pristine-tar.xml:105 manpages/gbp-pull.xml:173 #: manpages/gbp-push.xml:171 manpages/gbp-rpm-ch.xml:350 #: manpages/gbp-setup-gitattributes.xml:98 manpages/gbp-tag.xml:192 #: manpages/gbp.xml:206 msgid "AUTHOR" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage-rpm.xml:692 manpages/gbp-import-srpm.xml:283 #: manpages/gbp-pq-rpm.xml:272 manpages/gbp-rpm-ch.xml:352 msgid "&rpm-username; &rpm-email;" msgstr "" #. type: Content of: <refentry><refentryinfo><address> #: manpages/gbp-buildpackage.xml:4 manpages/gbp-clone.xml:4 #: manpages/gbp-config.xml:4 manpages/gbp.conf.xml:4 #: manpages/gbp-create-remote-repo.xml:4 manpages/gbp-dch.xml:4 #: manpages/gbp-export-orig.xml:4 manpages/gbp-import-dscs.xml:4 #: manpages/gbp-import-dsc.xml:4 manpages/gbp-import-orig.xml:4 #: manpages/gbp-import-ref.xml:4 manpages/gbp-pq.xml:4 #: manpages/gbp-pristine-tar.xml:4 manpages/gbp-pull.xml:4 #: manpages/gbp-push.xml:4 manpages/gbp-tag.xml:4 manpages/gbp.xml:4 #, no-wrap msgid "" " &dhemail;\n" " " msgstr "" #. type: Content of: <refentry><refentryinfo> #: manpages/gbp-buildpackage.xml:3 manpages/gbp-clone.xml:3 #: manpages/gbp-config.xml:3 manpages/gbp.conf.xml:3 #: manpages/gbp-create-remote-repo.xml:3 manpages/gbp-dch.xml:3 #: manpages/gbp-export-orig.xml:3 manpages/gbp-import-dscs.xml:3 #: manpages/gbp-import-dsc.xml:3 manpages/gbp-import-orig.xml:3 #: manpages/gbp-import-ref.xml:3 manpages/gbp-pq.xml:3 #: manpages/gbp-pristine-tar.xml:3 manpages/gbp-pull.xml:3 #: manpages/gbp-push.xml:3 manpages/gbp-tag.xml:3 manpages/gbp.xml:3 msgid "" "<placeholder type=\"address\" id=\"0\"/> <author> &dhfirstname; &dhsurname; " "</author>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-buildpackage.xml:11 manpages/gbp-buildpackage.xml:15 msgid "gbp-buildpackage" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-buildpackage.xml:16 msgid "Build &debian; packages from a &git; repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-buildpackage.xml:20 msgid "" "&gbp-buildpackage; <arg><option>--git-[no-]ignore-new</option></arg> " "<arg><option>--git-tag</option></arg> " "<arg><option>--git-verbose</option></arg> " "<arg><option>--git-color=</option>[auto|on|off]</arg> " "<arg><option>--git-color-scheme</option>=<replaceable>COLOR_SCHEME</replaceable></arg> " "<arg><option>--git-notify=</option>[auto|on|off]</arg> " "<arg><option>--git-upstream-branch=</option><replaceable>TREEISH</replaceable></arg> " "<arg><option>--git-debian-branch=</option><replaceable>BRANCH_NAME</replaceable></arg> " "<arg><option>--git-ignore-branch</option></arg> " "<arg><option>--git-[no-]submodules</option></arg> " "<arg><option>--git-builder=</option><replaceable>BUILD_CMD</replaceable></arg> " "<arg><option>--git-cleaner=</option><replaceable>CLEAN_CMD</replaceable></arg> " "<arg><option>--git-[no-]overlay</option></arg> " "<arg><option>--git-[no-]pbuilder</option></arg> " "<arg><option>--git-[no-]qemubuilder</option></arg> " "<arg><option>--git-dist=</option><replaceable>DIST</replaceable></arg> " "<arg><option>--git-arch=</option><replaceable>ARCH</replaceable></arg> " "<arg><option>--git-[no-]pbuilder-autoconf</option></arg> " "<arg><option>--git-pbuilder-options</option>=<replaceable>PBUILDER_OPTIONS</replaceable></arg> " "<arg><option>--git-[no-]sign-tags</option></arg> " "<arg><option>--git-keyid=</option><replaceable>GPG-KEYID</replaceable></arg> " "<arg><option>--git-preexport=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-postexport=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-prebuild=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-postbuild=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-posttag=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--git-[no-]hooks</option></arg> " "<arg><option>--git-debian-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--git-debian-tag-msg=</option><replaceable>tag-msg-format</replaceable></arg> " "<arg><option>--git-upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--git-force-create</option></arg> " "<arg><option>--git-no-create-orig</option></arg> " "<arg><option>--git-upstream-signatures=</option>[auto|on|off]</arg> " "<arg><option>--git-upstream-tree=</option><replaceable>[BRANCH|SLOPPY|TAG|TREEISH]</replaceable></arg> " "<arg><option>--git-tarball-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-compression=</option><replaceable>TYPE</replaceable></arg> " "<arg><option>--git-compression-level=</option><replaceable>LEVEL</replaceable></arg> " "<arg " "rep='repeat'><option>--git-component=</option><replaceable>component</replaceable></arg> " "<arg><option>--git-export-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--git-export=</option><replaceable>TREEISH</replaceable></arg> " "<arg><option>--git-[no-]pristine-tar</option></arg> " "<arg><option>--git-[no-]pristine-tar-commit</option></arg> " "<arg><option>--git-[no-]-purge</option></arg> " "<arg><option>--git-tag-only</option></arg> " "<arg><option>--git-retag</option></arg> <arg " "rep=\"repeat\"><option>OPTION_PASSED_TO_BUILD_CMD</option></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:72 msgid "" "&gbp-buildpackage; is used to build &debian; source and .deb packages from a " "&git; repository." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:76 msgid "&gbp-buildpackage; will, in order:" msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:97 msgid "" "(Optionally) run a clean command specified with " "<option>--git-cleaner</option>." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:103 msgid "(Optionally) export the source tree to a separate build area." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:108 msgid "Build an orig tarball if it doesn't exist. Optionally using &pristine-tar;." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:113 msgid "(Optionally) call a pre build hook." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:118 msgid "" "Call <application>debuild</application>(1) or &cowbuilder; (via " "<option>--git-pbuilder</option>) or the application specified via " "<option>--git-builder</option> passing along all arguments given to " "&gbp-buildpackage; on the command line that don't start with --git-." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:127 msgid "(Optionally) tag the current commit after a successful build." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-buildpackage.xml:132 msgid "(Optionally) call a post build hook - e.g. to run &lintian;." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:146 msgid "" "All options are prefixed with <option>git-</option> to distinguish options " "for &gbp-buildpackage; from options passed to the " "<replaceable>BUILD_CMD</replaceable>:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:151 msgid "Upstream tarball creation options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp-buildpackage.xml:152 msgid "" "When &gbp-buildpackage; doesn't find a suitable upstream tarball it will " "create one either using &pristine-tar; or <command>git " "archive</command>. These options determine how the tarball is created:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:162 msgid "" "Use pristine-tar when generating the upstream tarball if it doesn't " "exist. If this mode is enabled the <option>--git-upstream-tag</option>, " "<option>--git-upstream-tree</option> options have no effect when creating " "tarballs." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:174 msgid "" "Use this tag format when looking for tags of upstream versions to build the " "upstream tarballs. Default is " "<replaceable>upstream/%(version)s</replaceable>. This must be set correctly " "if you don't want to pass any other options. The default matches what " "&gbp-import-orig; uses to create tags." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:184 msgid "<option>--git-upstream-tree=</option><replaceable>[BRANCH|SLOPPY|TAG|TREEISH]</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:188 msgid "" "How to find the upstream sources used to generate the tarball. " "<replaceable>TAG</replaceable> (the default) looks at a tag corresponding to " "the version in the changelog. <replaceable>BRANCH</replaceable> looks at the " "upstream branch given via the <option>--git-upstream-branch</option> " "option. The <replaceable>SLOPPY</replaceable> option looks at the debian " "branch given via the <option>--git-debian-branch</option> and drops the " "<filename>debian/</filename> dir." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:198 manpages/gbp-export-orig.xml:135 msgid "Other values are interpreted as treeishs." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:223 msgid "" "Search for upstream tarballs in <replaceable>DIRECTORY</replaceable> instead " "of generating them. If a tarball is not found here it will be generated " "nevertheless. <replaceable>DIRECTORY</replaceable> can contain a version " "format substitution pattern, eg: <replaceable>foo-%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:232 msgid "<option>--git-component=</option><replaceable>COMPONENT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:236 msgid "" "When generating tarballs create an additional upstream tarball of directory " "<replaceable>COMPONENT</replaceable> in the source tree. Using additional " "upstream tarballs is a feature of the 3.0 (quilt) source format. See the " "<command>dpkg-source</command> manpage for details. Note that the " "<replaceable>--git-pristine-tar-commit</replaceable> option is currently " "incompatible with this option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:245 manpages/gbp-export-orig.xml:194 msgid "This is considered an experimental feature and might change incompatibly." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:265 msgid "" "Force creation of an upstream tarball (overwriting a pre-existing one if " "present)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:275 msgid "" "Don't try to create any upstream tarballs or to create symlinks to existing " "tarballs in <option>tarball-dir</option>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:281 msgid "<option>--git-upstream-signatures=</option>[auto|on|off]" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:285 msgid "Whether to export the upstream tarball with signatures." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:294 msgid "Include &git; submodules in the orig tarball if present." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:299 msgid "<option>--git-compression=</option><replaceable>TYPE</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:303 manpages/gbp-export-orig.xml:160 msgid "" "Specifies the upstream tarball compression type. This will be used to locate " "and build the upstream tarball if necessary. The default is " "<replaceable>auto</replaceable> which derives the compression type from the " "pristine-tar branch if available and falls back to gzip otherwise. Other " "options are <replaceable>gzip</replaceable>, " "<replaceable>bzip2</replaceable>, <replaceable>lzma</replaceable> and " "<replaceable>xz</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:326 msgid "Package build options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp-buildpackage.xml:327 msgid "" "&gbp-buildpackage; can invoke different types of builders to produce the " "source and binary packages. These options determine which builder is invoked " "and how." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:337 msgid "" "Use <replaceable>BUILD_CMD</replaceable> instead of <command>debuild -i " "-I</command>. If you want to use &cowbuilder; or &pbuilder; see the " "<option>--git-pbuilder</option>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:349 msgid "" "Use <replaceable>CLEAN_CMD</replaceable> to clean the source tree before the " "build. The default is <command>/bin/true</command> (no cleaning)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:356 msgid "<option>--git-pbuilder</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:360 msgid "" "Build the package using <command>git-pbuilder</command> (which uses " "<command>cowbuilder</command> by default). Note that this overwrites any " "<option>--git-builder</option> and <option>--git-cleaner</option> options." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:368 msgid "<option>--git-qemubuilder</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:372 msgid "" "Build package using <command>git-pbuilder</command> with " "<command>qemubuilder</command>. Note that this overwrites any " "<option>--git-builder</option> and <option>--git-cleaner</option> options." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:380 msgid "<option>--git-dist=<replaceable>DIST</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:384 msgid "" "Build for distribution <replaceable>DIST</replaceable> when using " "&git-pbuilder; (either via <option>--git-pbuilder</option>, " "<option>--git-qemubuilder</option> or the corresponding configuration file " "options). If unset build for the unstable distribution. The special value " "<symbol>DEP14</symbol> will set the distribution to build for from the " "branch name. I.e. if you're starting the build from a branch named " "<replaceable>debian/wheezy-backports</replaceable> the distribution is set " "to <replaceable>wheezy-backports</replaceable>. If the branch is named " "<replaceable>downstream/sid</replaceable> the distribution is set to " "<replaceable>downstream_sid</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:402 msgid "<option>--git-arch=<replaceable>ARCH</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:406 msgid "" "Build for architecture <replaceable>ARCH</replaceable> when using " "&git-pbuilder; (either via <option>--git-pbuilder</option>, " "<option>--git-qemubuilder</option> or the corresponding configuration file " "options). If unset no architecture is passed to " "<command>git-pbuilder</command>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:416 msgid "<option>--git-pbuilder-autoconf</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:420 msgid "" "Whether to try to autoconfigure &git-pbuilder; or to rely on the settings in " ".pbuilderrc. See the &git-pbuilder; manpage for details. Only takes effect " "when using &git-pbuilder; (either via <option>--git-pbuilder</option>, " "<option>--git-qemubuilder</option> or the corresponding configuration file " "options)." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:429 msgid "<option>--git-pbuilder-options</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:433 msgid "" "Options to pass to pbuilder when building via &git-pbuilder; (either via " "<option>--git-pbuilder</option>, <option>--git-qemubuilder</option> or the " "corresponding configuration file options). It does so by using the " "<envar>GIT_PBUILDER_OPTIONS</envar> environment variable to pass options to " "&git-pbuilder;." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:440 msgid "" "As an example, to tell pbuilder to use an alternate .pbuilderrc file, you " "may run &gbp-buildpackage; with " "<option>--git-pbuilder-options=<replaceable>\"--configfile " "/tmp/my/pbuilderrc\"</replaceable></option>. See <citerefentry> " "<refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> " "</citerefentry> for more options to pass through here." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:451 msgid "" "If unset the <envar>GIT_PBUILDER_OPTIONS</envar> environment variable will " "be left untouched." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:461 msgid "" "Whether to send a desktop notification after the build. This needs " "python3-notify2 installed." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:469 msgid "Hook options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp-buildpackage.xml:471 msgid "" "Hooks allow you to run arbitrary commands at different stages of the " "build. These options configure what will be run:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:480 msgid "" "Execute <replaceable>COMMAND</replaceable> before exporting the source " "tree. Valid only if --git-export-dir has been specified." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:495 msgid "" "Execute <replaceable>COMMAND</replaceable> after exporting the source " "tree. Valid only if --git-export-dir has been specified. The working " "directory of this hook is the toplevel directory of the exported source " "tree." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:513 msgid "" "Execute <replaceable>COMMAND</replaceable> from the build directory before " "calling <application>debuild</application> or the application specified via " "<option>--git-builder</option>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:529 msgid "" "Execute <replaceable>COMMAND</replaceable> after successful build. The " "working directory of this hook is the directory the package was built in." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:545 msgid "" "Execute <replaceable>COMMAND</replaceable> after tagging a new version. The " "working directory of this hook is the toplevel directory of the &git; " "repository." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:571 msgid "Tagging options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:578 msgid "" "Add a git tag after a successful build. It tags the currently checked out " "commit except when you're on a patch-queue branch. In that case the " "corresponding debian branch is tagged." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:584 msgid "This is a command line only option that cannot be specified via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:608 msgid "<option>--git-debian-tag=</option><replaceable>TAG-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:612 manpages/gbp-import-dsc.xml:126 #: manpages/gbp-tag.xml:105 msgid "" "Use this tag format when tagging &debian; versions, default is " "<replaceable>debian/%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:618 msgid "<option>--git-debian-tag-msg=</option><replaceable>tag-msg-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:621 manpages/gbp-tag.xml:114 msgid "" "Use this tag message format when signing &debian; versions, default is " "<replaceable>%(pkg)s Debian release %(version)s</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:630 manpages/gbp-tag.xml:123 msgid "" "Don't fail tag operations if a tag with the same version already " "exists. This is a command line only option that cannot be specified via " "&gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:641 msgid "" "Don't build, only tag and run post-tag hooks. This is a command line only " "option that cannot be specified via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:650 msgid "Build area options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp-buildpackage.xml:652 msgid "" "&gbp-buildpackage; can export the source tree to a different build-area " "before performing the build. This options specify if and how this is done:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:662 msgid "" "Export the current branch head (or the treeish object given via " "<option>--git-export</option> to <replaceable>DIRECTORY</replaceable> before " "building. If unset the source will not be exported before starting the " "build." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:674 msgid "" "Instead of exporting the current branch head, export the treeish object " "<replaceable>TREEISH</replaceable>. The special name " "<replaceable>INDEX</replaceable> exports the current index whereas the " "special name <replaceable>WC</replaceable> exports the current working copy " "as is." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:681 msgid "" "Note that using <replaceable>WC</replaceable> enables the " "<option>--git-ignore-branch</option> and <option>--git-ignore-new</option> " "options as well since when exporting the working copy there's no point in " "enforcing any branch or modification checks." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:690 msgid "<option>--git[-no]-purge</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:694 msgid "" "Purge (remove) temporary build area after build. This is the default but it " "can be turned off for e.g. debugging purposes." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:701 msgid "<option>--git-[no-]overlay</option>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:705 msgid "" "Extract upstream tarball from <option>tarball-dir</option> when using the " "<option>export-dir</option> option (in analogy to mergeWithUpstream in " "svn-bp). Also remove debian/ if contained in the upstream tarball in case of " "2.0 and 3.0 source formats." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:712 msgid "" "This option allows one to keep only the debian/ dir in the version control " "system." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:720 msgid "Safety options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp-buildpackage.xml:722 msgid "" "In order to make sure what you build is what you upload &gbp-buildpackage; " "performs several safety checks. These options allow one to configure and " "disable them:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:728 msgid "<option>--git-debian-branch</option>=<replaceable>BRANCH_NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:732 msgid "" "If you're not on this branch when invoking &gbp-buildpackage; it will " "fail. Default is <replaceable>master</replaceable>. This is done to make " "sure you don't accidentally release from a topic branch. Not being on this " "branch will be ignored when using <option>--git-ignore-new</option>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:745 manpages/gbp-tag.xml:147 msgid "" "Don't check if the current branch matches " "<replaceable>DEBIAN-BRANCH</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:755 manpages/gbp-tag.xml:157 msgid "" "Don't abort if there are uncommitted changes in the source tree or the " "current branch doesn't match the <replaceable>DEBIAN-BRANCH</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp-buildpackage.xml:764 msgid "Color and verbosity options" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> #: manpages/gbp-buildpackage.xml:771 msgid "Verbose execution. Useful for debugging and bug reports." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term> #: manpages/gbp-buildpackage.xml:785 msgid "<option>--git-color-scheme</option>=<replaceable>COLOR_SCHEME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:805 msgid "" "Build a &debian; package using &git-pbuilder; which in turn invokes " "&cowbuildercmd;. Instruct cowbuilder to build within a Wheezy chroot for " "i386." msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-buildpackage.xml:810 #, no-wrap msgid "" " &gbp-buildpackage; --git-pbuilder --git-arch=i386 --git-dist=wheezy\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:813 msgid "" "Note that the above needs a &cowbuildercmd; chroot already. This can be " "created using:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-buildpackage.xml:817 #, no-wrap msgid "" " DIST=wheezy ARCH=i386 &git-pbuilder; create\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:820 msgid "To export the source tree without performing any build you can use:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-buildpackage.xml:823 #, no-wrap msgid "" " gbp buildpackage --git-export-dir=/where/to/export " "--git-builder=/bin/true --git-no-pbuilder --git-no-hooks --git-no-purge\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:829 msgid "" "All options in the config files must be specified without the 'git-' " "prefix. So " "e.g. " "<option>--git-debian-branch</option>=<replaceable>debian/sid</replaceable> " "becomes in &gbp.conf;:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp-buildpackage.xml:835 #, no-wrap msgid "" " [buildpackage]\n" " debian-branch = debian/sid\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:842 msgid "" "<xref linkend=\"man.gbp.import.dsc\"/>, <xref " "linkend=\"man.gbp.import.dscs\"/>, <xref linkend=\"man.gbp.import.orig\"/>, " "<xref linkend=\"man.gbp.dch\"/>, <citerefentry> " "<refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>, <citerefentry> <refentrytitle>cowbuilder</refentrytitle> " "<manvolnum>8</manvolnum> </citerefentry>, <citerefentry> " "<refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>, <citerefentry> <refentrytitle>git-submodule</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common;" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-buildpackage.xml:869 manpages/gbp-clone.xml:231 #: manpages/gbp-config.xml:97 manpages/gbp.conf.xml:321 #: manpages/gbp-create-remote-repo.xml:156 manpages/gbp-dch.xml:660 #: manpages/gbp-export-orig.xml:253 manpages/gbp-import-dscs.xml:93 #: manpages/gbp-import-dsc.xml:326 manpages/gbp-import-orig.xml:447 #: manpages/gbp-import-ref.xml:251 manpages/gbp-pq.xml:354 #: manpages/gbp-pristine-tar.xml:107 manpages/gbp-pull.xml:175 #: manpages/gbp-push.xml:173 manpages/gbp-tag.xml:194 manpages/gbp.xml:208 msgid "&dhusername; &dhemail;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-clone.xml:12 manpages/gbp-clone.xml:16 msgid "gbp-clone" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-clone.xml:18 msgid "Clone a repository from remote" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-clone.xml:22 msgid "" "&gbp-clone; &man.common.options.synopsis; <arg><option>--all</option></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--depth=</option><replaceable>depth</replaceable></arg> " "<arg><option>--reference=</option><replaceable>repository</replaceable></arg> " "<arg><option>--postclone=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--[no-]hooks</option></arg> " "<arg><option>--defuse-gitattributes=</option><replaceable>[auto|on|off]</replaceable></arg> " "<arg><option>--repo-user=</option><option>[GIT|DEBIAN]</option></arg> " "<arg><option>--repo-email=</option><option>[GIT|DEBIAN]</option></arg> <arg " "choice=\"plain\"><replaceable>repository</replaceable></arg> " "<arg><replaceable>directory</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-clone.xml:43 msgid "" "&gbp-clone; clones a remote repository and sets up tracking branches for the " "<emphasis>debian</emphasis>, <emphasis>upstream</emphasis> and " "<emphasis>pristine-tar</emphasis> branches. This way you can easily update " "later using &gbp-pull;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist> #: manpages/gbp-clone.xml:53 manpages/gbp-config.xml:42 #: manpages/gbp-create-remote-repo.xml:63 manpages/gbp-dch.xml:150 #: manpages/gbp-import-dsc.xml:81 manpages/gbp-import-orig.xml:110 #: manpages/gbp-import-ref.xml:48 manpages/gbp-import-srpm.xml:72 #: manpages/gbp-pq-rpm.xml:130 manpages/gbp-pq.xml:135 #: manpages/gbp-pristine-tar.xml:48 manpages/gbp-pull.xml:57 #: manpages/gbp-push.xml:92 manpages/gbp-rpm-ch.xml:68 #: manpages/gbp-setup-gitattributes.xml:52 manpages/gbp-tag.xml:66 msgid "&man.common.options.description;" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:56 manpages/gbp-pull.xml:68 #: manpages/gbp-setup-gitattributes.xml:71 msgid "<option>--all</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:59 msgid "" "Track all branches, not only <replaceable>debian</replaceable> and " "<replaceable>upstream</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:64 manpages/gbp-create-remote-repo.xml:102 #: manpages/gbp-dch.xml:153 manpages/gbp-import-dsc.xml:94 #: manpages/gbp-import-orig.xml:170 manpages/gbp-import-ref.xml:125 #: manpages/gbp-pull.xml:89 manpages/gbp-push.xml:103 msgid "<option>--debian-branch</option>=<replaceable>branch_name</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:67 manpages/gbp-dch.xml:157 manpages/gbp-pull.xml:92 msgid "" "The branch in the Git repository the Debian package is being developed on, " "default is <replaceable>master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:72 manpages/gbp-create-remote-repo.xml:110 #: manpages/gbp-dch.xml:163 manpages/gbp-import-dsc.xml:84 #: manpages/gbp-import-orig.xml:160 manpages/gbp-import-ref.xml:90 #: manpages/gbp-pull.xml:97 manpages/gbp-push.xml:122 msgid "<option>--upstream-branch</option>=<replaceable>branch_name</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:75 manpages/gbp-create-remote-repo.xml:113 #: manpages/gbp-import-dsc.xml:88 manpages/gbp-import-orig.xml:164 #: manpages/gbp-import-srpm.xml:88 manpages/gbp-pull.xml:100 msgid "" "The branch in the &git; repository the upstream sources are put " "onto. Default is <replaceable>upstream</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:80 manpages/gbp-pull.xml:119 msgid "<option>--depth</option>=<replaceable>depth</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:83 msgid "Git history depth, for creating shallow git clones." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:87 msgid "<option>--reference</option>=<replaceable>repository</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:90 msgid "" "Local repository to use as alternate instead of re-copying data from remote " "repository." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:94 manpages/gbp-create-remote-repo.xml:118 #: manpages/gbp-export-orig.xml:200 manpages/gbp-import-dsc.xml:187 #: manpages/gbp-import-srpm.xml:182 manpages/gbp-pull.xml:126 #: manpages/gbp-push.xml:142 msgid "<option>--pristine-tar</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:97 msgid "Track pristine tar branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:101 msgid "<option>--[no-]hooks</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:104 msgid "Enable running hooks." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:109 msgid "<option>--postclone=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:112 msgid "" "Execute <replaceable>COMMAND</replaceable> after cloning the source from the " "remote." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:116 msgid "" "Exported environment variables are: <envar>GBP_GIT_DIR</envar> (the " "repository the package is being built from)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:119 msgid "" "Note that if you clone a repository that contains a hook configuration in " "<filename>debian/gbp.conf</filename> this hook will not be run automatically " "to prevent execution of untrusted code." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:127 msgid "<option>--defuse-gitattributes=</option><option>[auto|on|off]</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:130 msgid "" "Disable Git attributes that may interfere with building packages. Works by " "updating <filename>.git/info/attributes</filename> to override attributes in " "the upstream sources which may cause files to be transformed on checkout. " "More specifically, a new macro attribute is defined, " "<symbol>[attr]dgit-defuse-attrs</symbol>, which is then applied to " "<filename>*</filename> together with <symbol>export-subst</symbol> and " "<symbol>export-ignore</symbol>. This is done to be compatible with " "<command>dgit</command> and <command>git-deborig</command> which disable Git " "attributes this way." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:139 msgid "" "If set to <replaceable>auto</replaceable>, first check whether there are any " "<filename>.gitattributes</filename> files in the upstream source, and act " "only if there are some. If set to <replaceable>on</replaceable>, " "unconditionally there are some. If set to <replaceable>off</replaceable>, " "does nothing." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:148 manpages/gbp-import-dsc.xml:262 #: manpages/gbp-import-srpm.xml:254 msgid "<option>--repo-email=</option><option>[GIT|DEBIAN]</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:151 msgid "" "When set to <option>DEBIAN</option> use the <envar>DEBEMAIL</envar> " "environment variable to set the user.email &git; configuration otherwise use " "&git;'s defaults." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:159 manpages/gbp-import-dsc.xml:251 #: manpages/gbp-import-srpm.xml:243 msgid "<option>--repo-user=</option><option>[GIT|DEBIAN]</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:162 msgid "" "When set to <option>DEBIAN</option> use the <envar>DEBUSER</envar> " "environment variable to set the user.name &git; configuration otherwise use " "&git;'s defaults." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:170 msgid "<replaceable>repository</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:173 msgid "" "The (possibly remote) repository to clone from. This is usually a &git; URL " "but some shortcuts are supported (see below)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-clone.xml:179 msgid "<replaceable>directory</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-clone.xml:182 msgid "The directory to clone to." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-clone.xml:191 msgid "Clone a repository and setup a tracking branch for pristine-tar as well:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-clone.xml:195 #, no-wrap msgid "" " &gbp-clone; --pristine-tar " "git://honk.sigxcpu.org/git/git-buildpackage.git" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-clone.xml:197 msgid "Clone from the <emphasis>Git-Vcs</emphasis> URL of a package:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-clone.xml:200 #, no-wrap msgid " &gbp-clone; vcsgit:libvirt" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-clone.xml:202 msgid "Clone a repository from salsa (Debian's code hosting):" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-clone.xml:205 #, no-wrap msgid " &gbp-clone; salsa:agx/git-buildpackage" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-clone.xml:207 msgid "Clone from a github repository:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-clone.xml:210 #, no-wrap msgid " &gbp-clone; github:agx/git-buildpackage" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-clone.xml:218 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.pull\"/>, " "<xref linkend=\"man.gbp.setup.gitattributes\"/>, <xref " "linkend=\"man.gbp.conf\"/>, <citerefentry> " "<refentrytitle>gitattributes</refentrytitle> <manvolnum>5</manvolnum> " "</citerefentry>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-config.xml:12 manpages/gbp-config.xml:16 msgid "gbp-config" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-config.xml:18 msgid "Query configuration values" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-config.xml:22 msgid "" "&gbp-config; &man.common.options.synopsis; <group choice='req'> <arg " "choice=\"plain\"><replaceable>command.option</replaceable></arg> <arg " "choice=\"plain\"><replaceable>command</replaceable></arg> </group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-config.xml:34 msgid "" "&gbp-config; prints values from the configuration files. It interpolates the " "value for <replaceable>option</replaceable> of " "<replaceable>command</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-config.xml:46 manpages/gbp-pull.xml:135 msgid "EXIT CODES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-config.xml:48 msgid "" "When &gbp-config; finishes, it indicates success or failure with its exit " "code:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-config.xml:52 manpages/gbp-pull.xml:141 msgid "<option>0</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-config.xml:54 manpages/gbp-pull.xml:143 msgid "Success." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-config.xml:58 manpages/gbp-pull.xml:147 msgid "<option>1</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-config.xml:60 msgid "Failed to parse command line" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-config.xml:64 manpages/gbp-pull.xml:153 msgid "<option>2</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-config.xml:66 msgid "The value did not exist" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-config.xml:73 msgid "" "Print the value <option>upstream-branch</option> that &gbp-buildpackage; " "would use:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-config.xml:76 #, no-wrap msgid "" " $ gbp config buildpackage.upstream-branch\n" " buildpackage.upstream-branch=upstream" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-config.xml:78 msgid "Print the values of all of &gbp-buildpackage; options" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-config.xml:80 #, no-wrap msgid "" " $ gbp config buildpackage\n" " buildpackage.upstream-branch=upstream\n" " buildpackage.debian-branch=master\n" " ..." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-config.xml:91 msgid "<xref linkend=\"man.gbp.conf\"/>" msgstr "" #. type: Content of: <refentry><refmeta><refentrytitle> #: manpages/gbp.conf.xml:12 msgid "gbp.conf" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp.conf.xml:16 msgid "&gbp.conf;" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp.conf.xml:17 msgid "Gbp configuration file" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:27 msgid "system wide" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:37 msgid "per user" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:47 msgid "per branch, can be published with the repository (deprecated)" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:58 msgid "per branch, can be published with the repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:68 msgid "per repository" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:77 msgid "" "The <filename>gbp.conf</filename> configuration files provide default global " "options and specific options for individual &gbp; commands. All files have " "the same format as described below and are parsed in the above order from " "top to bottom with increasing precedence. Non existing files will be " "skipped." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:84 msgid "" "Each file consists of either zero or one default section, and zero or one " "sections for each &gbp; command. Additionally, there can be an arbitrary " "number of <option>remote-config</option> sections. Comments start with a " "hash sign (<option>#</option>). The overall layout is:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp.conf.xml:91 #, no-wrap msgid "" " [DEFAULT]\n" " # This section is for global settings. Affects all commands.\n" " # Options set here have the lowest priority.\n" " key = value\n" "\n" " [<command>]\n" " # Specific sections for each command, like " "<command>buildpackage</command>\n" " # Options set here have lower priority than command line options\n" " key = value\n" "\n" " [remote-config <name>]\n" " # Specific sections for a remote configuration. This can be used " "several\n" " # times to set up remote configuration for <command>gbp " "create-remote-repo</command>\n" " key = value\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:107 msgid "" "The sections for each command are named like the command (without &gbp;) " "surrounded by square brackets (e.g. <option>[buildpackage]</option>). For " "backwards compatibility, command sections starting with " "<filename>git-</filename> or <filename>gbp-</filename> are also supported " "but will provoke a warning when parsed by &gbp;." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:115 msgid "" "The keys in the <option>key</option>=<parameter>value</parameter> pairs are " "named like the command-line options of the corresponding command (with the " "'--' stripped off) and can hold the same values, but see below for " "details. In case of &gbp-buildpackage; and &gbp-buildpackage-rpm; the key " "needs '--git-' instead of '--' stripped off." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:123 msgid "" "For example, the <xref linkend=\"man.gbp.buildpackage\"/> manual page " "documents the " "<option>--git-export-dir</option>=<parameter>directory</parameter> option " "which can be turned into configuration file setting by dropping the " "<option>--git-</option> prefix:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp.conf.xml:132 #, no-wrap msgid "" " [buildpackage]\n" " export-dir = directory\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:137 msgid "" "Options that can be repeated on the command line take Python-like lists in " "the config file. For example, the <xref linkend=\"man.gbp.import.orig\"/> " "command has the <option>--filter</option>=<parameter>pattern</parameter> " "option which can be turned into a configuration file option like this:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp.conf.xml:145 #, no-wrap msgid "" " [import-orig]\n" " filter = [ '.svn', '.hg' ]\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:150 msgid "" "Boolean options can be either <option>True</option> or " "<option>False</option>. For example, <xref linkend=\"man.gbp.import.orig\"/> " "has the <option>--pristine-tar</option> and " "<option>--no-pristine-tar</option> options which translate to:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp.conf.xml:155 #, no-wrap msgid "" " [import-orig]\n" " pristine-tar = True\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:159 msgid "and" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp.conf.xml:162 #, no-wrap msgid "" " [import-orig]\n" " pristine-tar = False\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:165 msgid "respectively." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp.conf.xml:168 msgid "Remote site configuration" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp.conf.xml:170 msgid "" "<xref linkend=\"man.gbp.create.remote.repo\"/> can additionally parse remote " "site configurations from <filename>gbp.conf</filename>. For example, a " "configuration like:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><programlisting> #: manpages/gbp.conf.xml:175 #, no-wrap msgid "" " [remote-config pkg-libvirt]\n" " # Location of the repository\n" " remote-url-pattern = ssh://git.debian.org/git/pkg-libvirt/%(pkg)s\n" " # Template dir to passed to git-init\n" " template-dir = " "/srv/alioth.debian.org/chroot/home/groups/pkg-libvirt/git-template\n" " " msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp.conf.xml:183 msgid "can be used to create remote repositories for the pkg-libvirt project using:" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><programlisting> #: manpages/gbp.conf.xml:187 #, no-wrap msgid "" " gbp-create-remote-repo --remote-config=pkg-libvirt\n" " " msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: manpages/gbp.conf.xml:191 msgid "" "This can be useful if you're often creating new remote repositories for " "different projects." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: manpages/gbp.conf.xml:197 msgid "Notes" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><note><para> #: manpages/gbp.conf.xml:200 msgid "" "To see the current set of values that would be applied after parsing the " "configuration files, use <xref linkend=\"man.gbp.config\"/>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><note><para> #: manpages/gbp.conf.xml:207 msgid "" "<command>gbp import-dscs</command> and <command>git-pbuilder</command> can't " "be configured via <filename>gbp.conf</filename>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:217 msgid "An example set up for packaging work:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: manpages/gbp.conf.xml:221 #, no-wrap msgid "" " # $HOME/.gbp.conf\n" "\n" " [DEFAULT]\n" " pristine-tar = True\n" " cleaner = fakeroot debian/rules clean\n" "\n" " [buildpackage]\n" " export-dir = ../build-area/\n" "\n" " [import-orig]\n" " dch = False\n" " filter = [\n" " '.svn',\n" " '.hg',\n" " '.bzr',\n" " 'CVS',\n" " 'debian/*',\n" " '*/debian/*'\n" " ]\n" " filter-pristine-tar = True\n" "\n" " [import-dsc]\n" " filter = [\n" " 'CVS',\n" " '.cvsignore',\n" " '.hg',\n" " '.hgignore'\n" " '.bzr',\n" " '.bzrignore',\n" " '.gitignore'\n" " ]\n" "\n" " # End of file\n" " " msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp.conf.xml:258 msgid "ENVIRONMENT" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:260 msgid "" "The following environment variables can be used to modify &gbp;'s " "configuration file handling:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.conf.xml:265 msgid "<envar>GBP_CONF_FILES</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:268 msgid "" "A colon separated list of configuration files to parse. If unset or empty " "the default list of files is parsed (see above)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.conf.xml:274 msgid "<envar>GBP_DISABLE_SECTION_DEPRECATION</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:277 msgid "" "When set to a non-empty value don't print a deprecation warning in case " "&gbp; encounters a section starting with <emphasis>git-</emphasis> or " "<emphasis>gbp-</emphasis>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.conf.xml:284 msgid "<envar>GBP_DISABLE_GBP_CONF_DEPRECATION</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.conf.xml:287 msgid "" "When set to a non-empty value don't print a deprecation warning in case " "&gbp; encounters a configuration file in a deprecated location." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp.conf.xml:297 msgid "FILES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:299 msgid "See <filename>/etc/git-buildpackage/gbp.conf</filename> for an example." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:306 msgid "" "<xref linkend=\"man.gbp.config\"/>, <xref linkend=\"man.gbp.clone\"/>, <xref " "linkend=\"man.gbp.create.remote.repo\"/>, <xref linkend=\"man.gbp.pq\"/>, " "<xref linkend=\"man.gbp.pull\"/>, <xref linkend=\"man.gbp.dch\"/>, <xref " "linkend=\"man.gbp.import.dsc\"/>, <xref linkend=\"man.gbp.import.orig\"/>, " "<xref linkend=\"man.gbp.buildpackage\"/>, <ulink " "url=\"file:///usr/share/doc/git-buildpackage/manual-html/index.html\"> " "<citetitle>The Git-Buildpackage Manual</citetitle></ulink>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp.conf.xml:320 msgid "AUTHORS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.conf.xml:322 msgid "" "This manual page is based on a POD version by Jari Aalto " "<email>jari.aalto@cante.net</email>. Released under license GNU GPL version " "2 or (at your option) any later. version." msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-create-remote-repo.xml:12 #: manpages/gbp-create-remote-repo.xml:16 msgid "gbp-create-remote-repo" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-create-remote-repo.xml:18 msgid "Create remote repositories" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-create-remote-repo.xml:22 msgid "" "&gbp-create-remote-repo; &man.common.options.synopsis; " "<arg><option>--remote-url-pattern=</option><replaceable>url-pattern</replaceable></arg> " "<arg><option>--remote-name=</option><replaceable>name</replaceable></arg> " "<arg><option>--template-dir=</option><replaceable>directory</replaceable></arg> " "<arg><option>--remote-config=</option><replaceable>config</replaceable></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--[no-]track</option></arg> " "<arg><option>--[no-]bare</option></arg> <group choice=\"opt\"> " "<arg><replaceable>create</replaceable></arg> " "<arg><replaceable>list</replaceable></arg> </group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-create-remote-repo.xml:42 msgid "" "&gbp-create-remote-repo; creates a repository at a remote location via ssh " "and pushes the local repository into it. It then sets up remote branch " "tracking so you can use &gbp-pull; to update your repository from there." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-create-remote-repo.xml:47 msgid "" "Before performing any action on the remote location, it will print the " "remote URL and ask for confirmation." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-create-remote-repo.xml:51 msgid "" "Note: By default, the remote repositories are created in the <systemitem " "class=\"groupname\">collab-maint</systemitem> repository on <systemitem " "class=\"systemname\">git.debian.org</systemitem>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-create-remote-repo.xml:56 msgid "" "When invoked with <option>list</option> it lists the available remote config " "templates." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-create-remote-repo.xml:66 msgid "<option>--remote-url-pattern</option>=<replaceable>pattern</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:69 msgid "" "Where to create the remote repository. The part " "<replaceable>%(pkg)s</replaceable> will be replaced by the package name." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-create-remote-repo.xml:75 msgid "<option>--remote-name</option>=<replaceable>name</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:78 msgid "What name git will use when referring to that repository, e.g. 'origin'." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-create-remote-repo.xml:83 msgid "<option>--template-dir</option>=<replaceable>directory</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:86 msgid "" "Template directory to pass to <command>git init</command> on the remote " "side. This can be used to customize the remote repository, e.g. to set up " "hooks." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-create-remote-repo.xml:92 msgid "<option>--remote-config</option>=<replaceable>config</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:95 msgid "" "Name of a config file section in <filename>gbp.conf</filename> that " "specifies the above parameters. See <xref linkend=\"man.gbp.conf\"/> manpage " "for details." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:105 manpages/gbp-import-ref.xml:129 msgid "" "The branch in the &git; repository the &debian; package is being developed " "on, default is <replaceable>master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:121 msgid "Whether to push the pristine tar branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-create-remote-repo.xml:125 msgid "<option>--[no-]track</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:128 msgid "" "Whether to set up branch tracking for the debian, upstream and pristine-tar " "branches." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-create-remote-repo.xml:133 msgid "<option>--[no-]bare</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-create-remote-repo.xml:136 msgid "" "Whether the remote repository should be a bare repository (this is the " "default)." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-create-remote-repo.xml:148 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.pull\"/>, " "<xref linkend=\"man.gbp.conf\"/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-dch.xml:12 manpages/gbp-dch.xml:16 msgid "gbp-dch" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-dch.xml:17 msgid "Generate the &debian; changelog from git commit messages" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-dch.xml:21 msgid "" "&gbp-dch; &man.common.options.synopsis; " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--debian-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--ignore-branch</option></arg> <group> <arg><option>-s</option> " "<replaceable>commit-ish</replaceable></arg> " "<arg><option>--since=</option><replaceable>commit-ish</replaceable></arg> " "</group> <group> <group> <arg><option>-S</option></arg> " "<arg><option>--snapshot</option></arg> </group> <group> " "<arg><option>-R</option></arg> <arg><option>--release</option></arg> " "</group> </group> <group> <arg><option>-N</option> " "<replaceable>version</replaceable></arg> " "<arg><option>--new-version=</option><replaceable>version</replaceable></arg> " "</group> <group> <arg><option>--bpo</option></arg> " "<arg><option>--nmu</option></arg> <arg><option>--qa</option></arg> " "<arg><option>--security</option></arg> <arg><option>--team</option></arg> " "<arg><option>--local=</option><replaceable>suffix</replaceable></arg> " "</group> " "<arg><option>--distribution=</option><replaceable>name</replaceable></arg> " "<arg><option>--force-distribution</option></arg> <group> " "<arg><option>-U</option> <replaceable>level</replaceable></arg> " "<arg><option>--urgency=</option><replaceable>level</replaceable></arg> " "</group> <arg><option>--[no-]full</option></arg> " "<arg><option>--[no-]meta</option></arg> " "<arg><option>--meta-closes=bug-close-tags</option></arg> " "<arg><option>--meta-closes-bugnum=bug-number-format</option></arg> " "<arg><option>--snapshot-number=</option><replaceable>expression</replaceable></arg> " "<arg><option>--id-length=</option><replaceable>number</replaceable></arg> " "<arg><option>--git-log=</option><replaceable>git-log-options</replaceable></arg> " "<arg><option>--[no-]git-author</option></arg> " "<arg><option>--[no-]multimaint</option></arg> " "<arg><option>--[no-]multimaint-merge</option></arg> " "<arg><option>--spawn-editor=[always|never|snapshot|release]</option></arg> " "<arg><option>--commit-msg=</option><replaceable>msg-format</replaceable></arg> " "<group> <arg><option>-c</option></arg> <arg><option>--commit</option></arg> " "</group> " "<arg><option>--customizations=</option><replaceable>customization-file</replaceable></arg> " "<arg><option>--postedit=</option><replaceable>COMMAND</replaceable></arg> " "<arg " "rep='repeat'><option>--dch-opt=</option><replaceable>dch-options</replaceable></arg> " "<arg><option>--verbose</option></arg> <arg " "choice=\"plain\"><replaceable><optional>path1 " "path2</optional></replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:86 msgid "" "&gbp-dch; reads git commit messages and generates the &debian; changelog " "from it. It starts at a given commit specified by the " "<option>--since</option> option up to the current " "<emphasis>HEAD</emphasis>. For each commit found it adds the commit message " "to the changelog. If <option>--since</option> is not given the commit to " "start from is determined by the following rules (first one matches):" msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: manpages/gbp-dch.xml:96 msgid "The start commit is read from the snapshot banner (see below for details)" msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: manpages/gbp-dch.xml:98 msgid "" "If the topmost version of the <filename>debian/changelog</filename> is " "already tagged. Use the commit the tag points to as start commit." msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: manpages/gbp-dch.xml:101 msgid "" "The last commit that modified <filename>debian/changelog</filename> is used " "as start commit." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:105 msgid "This is called automatic mode." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:108 msgid "" "If the distribution of the topmost section in " "<filename>debian/changelog</filename> is <emphasis>UNRELEASED</emphasis>, " "the changelog entries will be inserted into this section. Otherwise a new " "section will be created." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:115 msgid "" "If one ore more paths are given as arguments &gbp-dch; will only include " "changes in <filename>debian/changelog</filename> that affect these paths. " "E.g. using <emphasis>debian/</emphasis> is a good choice if upstream uses " "&git; and you don't want the upstream history to end up in " "<filename>debian/changelog</filename>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:123 msgid "" "To restrict the selected changes even further you can use the " "<option>--git-log</option> option which is passed on verbatim to " "<command>git log</command>. E.g. by using " "<option>--git-log=</option><replaceable>\"--author=Foo Bar\"</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:130 msgid "" "The above relies on the <option>--debian-branch</option> option pointing to " "the current branch and <option>--upstream-branch</option> pointing to the " "corresponding upstream branch in order to find the right merge points of " "these branches. Furthermore &gbp-dch; must be able to identify git tags from " "upstream and Debian version numbers. If you're not using the defaults check " "the <option>--upstream-tag</option> and <option>--debian-tag</option> " "options and make sure they match the tags created by e.g. &gbp-import-orig; " "(when using tarballs) or upstream's tagging pattern (when using upstream's " "git directly)." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:143 msgid "" "If not changelog exists yet it is created and the version number is derived " "from the last upstream tag if found." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:167 msgid "" "Branch to determine the upstream version from. Default is " "<replaceable>upstream</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:183 manpages/gbp-pull.xml:82 manpages/gbp-push.xml:94 #: manpages/gbp-rpm-ch.xml:99 manpages/gbp-tag.xml:143 msgid "<option>--ignore-branch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:187 msgid "" "Don't check if the current branch matches " "<replaceable>debian-branch</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:193 manpages/gbp-import-dsc.xml:122 msgid "<option>--debian-tag=</option><replaceable>tag-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:197 msgid "" "Tag format used, when tagging debian versions, default is " "<replaceable>debian/%(version)s</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:203 msgid "<option>--since=</option><replaceable>commit-ish</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:207 msgid "" "Start reading commit messages at <replaceable>commit-ish</replaceable>. " "This option can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:214 msgid "<option>--auto</option>, <option>-a</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:218 msgid "" "This option is ignored for compatibility with older versions. It used to " "trigger automatic mode." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:224 msgid "<option>--[no-]meta</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:227 msgid "" "Parse meta tags like <option>Closes:</option>, <option>Thanks:</option> and " "<option>Gbp-Dch:</option>. See META TAGS below." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:234 manpages/gbp-pq.xml:236 msgid "<option>--meta-closes=</option><replaceable>bug-close-tags</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:238 msgid "" "What meta tags to look for to generate bug-closing changelog entries. The " "default is <literal>'Closes|LP'</literal> to support Debian and Launchpad." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:244 manpages/gbp-pq.xml:247 msgid "<option>--meta-closes-bugnum=</option><replaceable>bug-number-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:248 msgid "" "What regular expression should be used to parse out the bug number. The " "default is <literal>'(?:bug|issue)?\\#?\\s?\\d+'</literal>. Note: the regex " "should suppress all portions of the bug number that are not wanted using " "<literal>\"(?:)\"</literal>, see Python regex manual for details." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><screen> #: manpages/gbp-dch.xml:259 #, no-wrap msgid "" " Possible Txt Match? Result\n" " ------------ ------ ------\n" " bug EX-12345 Y EX-12345\n" " ex-01273 Y ex-01273\n" " bug ex-1ab Y ex-1\n" " EX--12345 N" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:254 msgid "" "Example: " "<option>--meta-closes-bugnum=</option><literal>\"(?:bug)?\\s*ex-\\d+\"</literal> " "would match all of the following: <placeholder type=\"screen\" id=\"0\"/>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:269 manpages/gbp-rpm-ch.xml:175 msgid "<option>--[no-]full</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:273 manpages/gbp-rpm-ch.xml:179 msgid "Include the full commit message in the changelog output." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:278 msgid "<option>--snapshot</option>, <option>-S</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:282 msgid "" "Create a snapshot release entry. It uses a snapshot release number which is " "smaller than the final release number and adds a warning banner to the " "changelog entry. The version number is being auto incremented with every new " "snapshot release." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:289 msgid "" "The snapshot banner is also used by &gbp-dch; to determine which entries are " "already in the changelog. This prevents duplicated entries in " "<filename>debian/changelog</filename> when you did not commit the changelog " "yet." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:297 msgid "<option>--snapshot-number=</option><replaceable>expression</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:301 msgid "Python expression that gets eval()ed to the new snapshot number." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:306 msgid "<option>--release</option>, <option>-R</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:310 msgid "" "Remove any snapshot release banners and version suffixes (if any), set the " "current distribution to <replaceable>unstable</replaceable>, and open the " "changelog for final tweaking. This option can't be set via &gbp.conf;. It's " "usually used to finalize the changelog before making a release." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:320 msgid "" "<option>--new-version=</option><replaceable>version</replaceable>, " "<option>-N</option> <replaceable>version</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:325 msgid "" "Add a new changelog section with version " "<replaceable>newversion</replaceable>. Together with " "<option>--snapshot</option>, the snapshot number will be appended to " "<replaceable>newversion</replaceable>. This option can't be set via " "&gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:334 msgid "<option>--team</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:338 msgid "" "Create a Team upload changelog entry. This option can't be set via " "&gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:344 msgid "<option>--bpo</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:348 msgid "" "Increment the Debian release number for an upload to backports, and add a " "backport upload changelog comment. This option can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:355 msgid "<option>--nmu</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:359 msgid "" "Increment the Debian release number for a non-maintainer upload. This " "option can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:365 msgid "<option>--qa</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:369 msgid "" "Increment the Debian release number for a Debian QA Team upload, and add a " "QA upload changelog comment. This option can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:376 msgid "<option>--security</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:380 msgid "" "Increment the Debian release number for a Debian Security Team " "non-maintainer upload, and add a \"Security Team upload\" changelog " "comment. This option can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:388 msgid "" "<option>--local=</option><replaceable>suffix</replaceable>, " "<option>-l</option> <replaceable>suffix</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:393 msgid "" "Increment the Debian release number for a local build using the specified " "suffix. This option can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:400 msgid "<option>--distribution=</option><replaceable>name</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:404 msgid "" "Set the distribution field to <replaceable>name</replaceable>. This option " "can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:410 msgid "<option>--force-distribution</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:414 msgid "" "Force the distribution specified with <option>--distribution</option> to be " "used, even if it doesn't match the list of known distributions. This option " "can't be set via &gbp.conf;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:421 msgid "<option>--urgency=</option><replaceable>level</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:425 msgid "Set the urgency field to <replaceable>level</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:430 msgid "<option>--git-log=</option><replaceable>git-log-options</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:434 manpages/gbp-rpm-ch.xml:188 msgid "Options passed on verbatim to git-log(1)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:439 manpages/gbp-rpm-ch.xml:193 msgid "<option>--id-length=</option><replaceable>N</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:443 manpages/gbp-rpm-ch.xml:197 msgid "" "Include <replaceable>N</replaceable> digits of the commit id in the " "changelog entry. Default is to not include any commit ids at all." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:449 msgid "<option>--ignore-regex=</option><replaceable>regex</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:453 msgid "" "Ignore commit lines matching <replaceable>regex</replaceable> when " "generating the changelog." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:459 msgid "<option>--git-author</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:463 msgid "" "Use user.name and user.email from <application>git-config</application>(1) " "for changelog trailer." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:469 msgid "<option>--[no-]multimaint-merge</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:473 msgid "Merge commits by maintainer." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:478 msgid "<option>--spawn-editor=<replaceable>[always|never|snapshot|release]</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:482 msgid "" "Whether to spawn an editor: always, never, when doing snapshots or when " "doing a release." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:488 msgid "<option>--commit-msg=</option><replaceable>msg-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:492 msgid "" "Use this format string for the commit message when committing the generated " "changelog file (when <option>--commit</option> is given). Default is " "<replaceable>Update changelog for %(version)s release</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:500 msgid "<option>--commit</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:504 msgid "Commit the generated changelog." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:509 msgid "<option>--customizations=</option><replaceable>customization-file</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:513 msgid "" "Load Python code from <replaceable>customization-file</replaceable>. At the " "moment, the only useful thing the code can do is define a custom " "format_changelog_entry() function." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:520 msgid "<option>--postedit=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:524 msgid "" "Run<replaceable>COMMAND</replaceable> after changes to the changelog file " "have been finalized, That is, after dch has been run and possible text " "editor has been exited, but, before changes are (possibly) committed to git." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:532 msgid "<option>--dch-opt=</option><replaceable>dch-option</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:536 msgid "" "Pass option to &dch; verbatim. Note that &gbp-dch; invokes &dch; multiple " "times and the option is passed to all invocations so not all &dch; options " "make sense here. Options may also conflict with options picked by &gbp-dch;." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-dch.xml:547 msgid "Snapshot mode" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:549 msgid "" "Snapshot mode can be used for quick test and install cycles without having " "to worry about version numbers or changelog entries." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:553 msgid "" "When using <option>--snapshot</option> or <option>-S</option>, &gbp-dch; " "uses a pseudo header in the Debian changelog to remember the last git commit " "it added a changelog entry for. It also sets a version number ending in " "<replaceable>~<snaspshotnumber>.gbp<commitid></replaceable>. It " "automatically increments the snapshot number on subsequent invocations of " "&gbp-dch; <option>-S</option> so that later snapshots automatically have a " "higher version number. To leave snapshot mode, invoke &gbp-dch; with the " "<option>--release</option> option. This removes the pseudo header and " "unmangles the version number so the released version has a higher version " "number than the snapshots." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-dch.xml:567 manpages/gbp-pq-rpm.xml:204 #: manpages/gbp-rpm-ch.xml:280 msgid "META TAGS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:569 msgid "" "Additional to the above options, the formatting of the commit message in " "<filename>debian/changelog</filename> can be modified by special tags " "(called Meta Tags) given in the git commit message. Meta Tag processing can " "be activated via the <option>--meta</option> option. The tags must start at " "the first column of a commit message but can appear on any line. They are " "of the form <option>Tagname</option>: " "<replaceable>value</replaceable>. Valid Meta Tags are:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:581 msgid "<option>Gbp-Dch</option>: <replaceable>action</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:585 msgid "" "Supported actions are: <replaceable>Ignore</replaceable> which will ignore " "this commit when generating <filename>debian/changelog</filename>, " "<replaceable>Short</replaceable> which will only use the description (the " "first line) of the commit message when generating the changelog entry " "(useful when <option>--full</option> is given), and " "<replaceable>Full</replaceable> which will use the full commit message when " "generating the changelog entry (useful when <option>--full</option> is not " "given)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:597 msgid "" "In addition to <option>Gbp-Dch</option>, the deprecated " "<option>Git-Dch</option> is still supported." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:603 msgid "<option>Thanks</option>: <replaceable>msg</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:607 msgid "Add a thanks message after the commit message." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-dch.xml:612 msgid "<option>Closes</option>: <replaceable>bugnumber</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-dch.xml:616 msgid "" "Indicate in the <filename>debian/changelog</filename> that the bug was " "closed by this commit. See the <option>--meta-closes</option> on how to " "extend this for other bugtrackers." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:624 manpages/gbp-rpm-ch.xml:318 msgid "The following git commit message:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-dch.xml:627 #, no-wrap msgid "" " Document meta tags\n" "\n" " so one doesn't have to consult the manual\n" "\n" " Gbp-Dch: Short\n" " Closes: #636088\n" " Thanks: Raphaël Hertzog for the suggestion" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:635 msgid "Results in this <filename>debian/changelog</filename> entry:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-dch.xml:638 #, no-wrap msgid "" " * Document meta tags.\n" " Thanks to Raphaël Hertzog for the suggestion (Closes: #636088)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-dch.xml:647 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref " "linkend=\"man.gbp.import.dsc\"/>, <xref linkend=\"man.gbp.import.dscs\"/>, " "<xref linkend=\"man.gbp.import.orig\"/>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common; <ulink url=\"https://honk.sigxcpu.org/cl2vcs\"> " "<citetitle>Cl2vcs</citetitle></ulink>," msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-export-orig.xml:11 manpages/gbp-export-orig.xml:15 msgid "gbp-export-orig" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-export-orig.xml:16 msgid "Export upstream tarballs from a &git; repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-export-orig.xml:20 msgid "" "&gbp-export-orig; <arg><option>--verbose</option></arg> " "<arg><option>--color=</option>[auto|on|off]</arg> " "<arg><option>--color-scheme</option>=<replaceable>COLOR_SCHEME</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>BRANCH_NAME</replaceable></arg> " "<arg><option>--[no-]submodules</option></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--upstream-tree=</option><replaceable>[TAG|BRANCH|TREEISH]</replaceable></arg> " "<arg><option>--tarball-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--force-create</option></arg> " "<arg><option>--compression=</option><replaceable>TYPE</replaceable></arg> " "<arg><option>--compression-level=</option><replaceable>LEVEL</replaceable></arg> " "<arg " "rep='repeat'><option>--component=</option><replaceable>component</replaceable></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--upstream-signatures=</option>[auto|on|off]</arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-export-orig.xml:40 msgid "" "&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 command." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:50 msgid "<option>--verbose</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:54 msgid "verbose execution" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:59 msgid "<option>--color=</option>[auto|on|off]" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:68 msgid "<option>--color-scheme</option>=<replaceable>COLOR_SCHEME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:72 msgid "" "Colors to use in output (when color is enabled). The format for COLOR_SCHEME " "is '<debug>:<info>:<warning>:<error>'. Numerical " "values and color names are accepted, empty fields imply the default " "color. For example --color-scheme='cyan:34::' would show debug messages in " "cyan, info messages in blue and other messages in default (i.e. warning and " "error messages in red)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:83 msgid "<option>--upstream-branch</option>=<replaceable>BRANCH_NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:87 msgid "" "Branch to build the orig tarball from if <option>--upstream-tree</option> is " "set to <replaceable>BRANCH</replaceable>. Default is " "<replaceable>upstream</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:95 msgid "<option>--[no-]submodules</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:104 manpages/gbp-import-srpm.xml:141 #: manpages/gbp-pq-rpm.xml:153 manpages/gbp-pq.xml:273 #: manpages/gbp-push.xml:131 msgid "<option>--upstream-tag=</option><replaceable>TAG-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:114 msgid "<option>--force-create</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:124 msgid "<option>--upstream-tree=</option><replaceable>[BRANCH|TAG|TREEISH]</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:128 msgid "" "How to find the upstream sources used to generate the tarball. " "<replaceable>TAG</replaceable> (the default) looks at a tag corresponding to " "the version in the changelog. <replaceable>BRANCH</replaceable> looks at the " "upstream branch given via the <option>--upstream-branch</option> option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:138 msgid "" "This doesn't have any effect if <option>--pristine-tar</option> is being " "used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:144 msgid "<option>--tarball-dir=</option><replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:148 msgid "" "Search for original tarballs in <replaceable>DIRECTORY</replaceable> instead " "of generating them. <replaceable>DIRECTORY</replaceable> can contain a " "version format substitution pattern, eg: " "<replaceable>foo-%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:156 msgid "<option>--compression=</option><replaceable>TYPE</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:171 msgid "<option>--compression-level=</option><replaceable>LEVEL</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:181 manpages/gbp-import-orig.xml:246 #: manpages/gbp-pristine-tar.xml:60 msgid "<option>--component=</option><replaceable>COMPONENT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:185 msgid "" "When generating tarballs create an additional original tarball of directory " "<replaceable>COMPONENT</replaceable> in the source tree. Using additional " "original tarballs is a feature of the 3.0 (quilt) source format. See the " "<command>dpkg-source</command> manpage for details. Note that the " "<replaceable>--pristine-tar-commit</replaceable> option is currently " "incompatible with this option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-export-orig.xml:211 manpages/gbp-import-orig.xml:393 msgid "<option>--upstream-signatures=</option>[auto|on|off]" msgstr "" #. type: Content of: <refentry><refsect1><varlistentry><listitem><para> #: manpages/gbp-export-orig.xml:215 msgid "Whether to export with upstream signatures." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-export-orig.xml:223 msgid "" "Generate an upstream tarball of the version currently referenced in the " "changelog using &pristine-tar;:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-export-orig.xml:227 #, no-wrap msgid "" " &gbp-export-orig; --pristine-tar\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-export-orig.xml:230 msgid "" "Same as above but generate and additional tarball for directory " "<filename>foo</filename>." msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-export-orig.xml:234 #, no-wrap msgid "" " &gbp-export-orig; --pristine-tar --component=foo\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-export-orig.xml:243 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref " "linkend=\"man.gbp.import.orig\"/>, <xref linkend=\"man.gbp.pristine.tar\"/>, " "<xref linkend=\"man.gbp.conf\"/>, &man.seealso.common;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-import-dscs.xml:12 manpages/gbp-import-dscs.xml:16 msgid "gbp-import-dscs" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-import-dscs.xml:17 msgid "Import multiple versions of a Debian source packages into a Git repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-dscs.xml:21 msgid "" "&gbp-import-dscs; <arg><option>options</option></arg> <arg><option>gbp " "import-dsc options</option></arg> <arg " "choice=\"plain\"><replaceable>pkg_1.dsc</replaceable></arg> <arg " "choice=\"plain\"><replaceable>pkg_2.dsc</replaceable></arg> <arg " "choice=\"plain\"><replaceable>...</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><para> #: manpages/gbp-import-dscs.xml:29 msgid "or" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-dscs.xml:32 msgid "" "&gbp-import-dscs; <arg choice=\"req\">--debsnap</arg> " "<arg><option>options</option></arg> <arg><option>gbp import-dsc " "options</option></arg> <arg " "choice=\"req\"><replaceable>package</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dscs.xml:42 msgid "" "&gbp-import-dscs; imports several versions of a Debian source package into a " "&git; repository. To do so, it sorts the packages by their versions first, " "and then imports them via calling &gbp-import-dsc; on each package." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dscs.xml:48 msgid "" "If the current directory isn't a &git; repository already, the repository is " "created in a subdir of the current working directory, named after the first " "imported package, otherwise the &git; repository in the current working " "directory is being used. This allows for incremental imports." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dscs.xml:58 msgid "<option>--debsnap</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dscs.xml:61 msgid "Fetch snapshots from snapshots.debian.org using debsnap." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dscs.xml:65 msgid "<option>--ignore-repo-config</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dscs.xml:68 msgid "" "Ignore <filename>gbp.conf</filename> files stored in the git repository " "itself. This can be useful to ignore branch information and other options " "shipped in the package source." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dscs.xml:75 msgid "All other options are passed on verbatim to &gbp-import-dsc;." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dscs.xml:82 msgid "" "<xref linkend=\"man.gbp.import.dsc\"/>, <xref " "linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.import.orig\"/>, " "<xref linkend=\"man.gbp.dch\"/>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-import-dsc.xml:12 manpages/gbp-import-dsc.xml:16 msgid "gbp-import-dsc" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-import-dsc.xml:17 msgid "Import &debian; packages into a &git; repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-dsc.xml:21 msgid "" "&gbp-import-dsc; &man.common.options.synopsis; " "<arg><option>--allow-same-versions</option></arg> " "<arg><option>--author-date-is-committer-date</option></arg> " "<arg><option>--author-is-committer</option></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--debian-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg " "rep='repeat'><option>--filter=</option><replaceable>pattern</replaceable></arg> " "<arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg> " "<arg><option>--[no-]create-missing-branches</option></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--[no-]sign-tags</option></arg> " "<arg><option>--skip-debian-tag</option></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--upstream-vcs-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--repo-user=</option><option>[GIT|DEBIAN]</option></arg> " "<arg><option>--repo-email=</option><option>[GIT|DEBIAN]</option></arg> <arg " "choice=\"plain\"><replaceable>debian-source.dsc</replaceable></arg> <arg " "choice=\"opt\"><replaceable>target</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-dsc.xml:43 msgid "" "&gbp-import-dsc; <arg><option>options</option></arg> " "<arg><option>--[no-]allow-unauthenticated</option></arg> <group " "choice=\"plain\"> <arg><replaceable>URL</replaceable></arg> </group> <arg " "choice=\"opt\"><replaceable>target</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:55 msgid "" "&gbp-import-dsc; imports a &debian; source package into a &git; repository, " "notes the package version in the commit logs, and commits the change. All " "information, including package name, version, &debian; modifications and " "upstream source, is automatically detected from the source package. After " "import the repository can be used with the other &gbp; tools." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:62 msgid "" "If the command is run from within an existing &git; repository, it will " "import into it; if not, a new repository named as the Debian source package " "is created. You can override the location of the new repository by " "specifying the optional <replaceable>target</replaceable> argument." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:68 msgid "" "When given a <replaceable>URL</replaceable> &gbp-import-dsc; will download " "the source package prior to importing it. &dget; is used for all schemes " "except for the special scheme <replaceable>apt:///</replaceable> which uses " "&apt-get; (and therefore needs <replaceable>deb-src</replaceable> entries in " "your <filename>/etc/apt/sources.list</filename>). The later can be " "abbreviated by using the pseudo URL <replaceable>apt:</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:98 msgid "" "The branch in the &git; repository the debian sources are put onto. Default " "is <replaceable>master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:104 manpages/gbp-import-orig.xml:195 #: manpages/gbp-import-ref.xml:135 manpages/gbp-import-srpm.xml:104 #: manpages/gbp-tag.xml:83 msgid "<option>--[no-]sign-tags</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:108 msgid "GPG sign all created tags" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:113 manpages/gbp-import-orig.xml:204 #: manpages/gbp-import-ref.xml:144 msgid "<option>--keyid=</option><replaceable>gpg-keyid</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:132 manpages/gbp-import-orig.xml:214 #: manpages/gbp-import-ref.xml:100 manpages/gbp-pristine-tar.xml:50 msgid "<option>--upstream-tag=</option><replaceable>tag-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:136 manpages/gbp-import-orig.xml:218 #: manpages/gbp-import-srpm.xml:145 msgid "" "Use this tag format when tagging upstream versions, default is " "<replaceable>upstream/%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:142 manpages/gbp-import-orig.xml:182 msgid "<option>--upstream-vcs-tag</option>=<replaceable>tag-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:146 manpages/gbp-import-orig.xml:186 msgid "" "Add <replaceable>tag-format</replaceable> as additional parent to the commit " "of the upstream tarball. Useful when upstream uses git and you want to link " "to its revision history. The <replaceable>tag-format</replaceable> can be a " "pattern similar to what <option>--upstream-tag</option> supports." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:153 msgid "" "The default is to not add upstream tags as additional parents since this " "requires additional setup to have the upstream sources in the same " "repository." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:160 msgid "<option>--skip-debian-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:164 msgid "" "Don't create &debian; tag after importing the &debian; patch. This can be " "useful if you already created a package but want to further work on it after " "importing it into git." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:171 manpages/gbp-import-orig.xml:235 msgid "<option>--filter=</option><replaceable>pattern</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:175 msgid "" "Filter out files glob-matching " "<option><replaceable>pattern</replaceable></option> from upstream tarballs " "and the debian tarball of 3.0(quilt) packages. Note that the " "<emphasis>.diff.gz</emphasis> of 1.0 source format packages is currently not " "filtered." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:182 msgid "This option can be given multiple times." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:191 manpages/gbp-import-srpm.xml:186 msgid "Generate pristine-tar delta file." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:196 msgid "<option>--allow-unauthenticated</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:200 msgid "" "Whether to skip signature verification on downloads. Passed on verbatim to " "&dget; and &apt-get; respectively. Use with care." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:207 manpages/gbp-import-srpm.xml:191 msgid "<option>--allow-same-version</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:211 msgid "Allow one to import a package with the same debian version." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:216 manpages/gbp-import-srpm.xml:202 msgid "<option>--author-is-committer</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:220 msgid "" "When importing the &debian; patch, use the author identity as committer " "identity." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:226 msgid "<option>--author-date-is-committer-date</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:230 msgid "When importing the &debian; patch, use the author date as committer date." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><warning><para> #: manpages/gbp-import-dsc.xml:234 msgid "" "&git; will subtly misbehave if the committer date of a commit is not later " "than or equal to all its parents." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-dsc.xml:242 manpages/gbp-import-srpm.xml:212 msgid "<option>--[no-]create-missing-branches</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:246 msgid "Create upstream and debian branch if missing." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:254 manpages/gbp-import-srpm.xml:246 msgid "" "When set to <option>DEBIAN</option> use the <envar>DEBUSER</envar> " "environment variable to set the user.name &git; configuration otherwise use " "&git;'s defaults. Only affects newly created repos." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-dsc.xml:265 manpages/gbp-import-srpm.xml:257 msgid "" "When set to <option>DEBIAN</option> use the <envar>DEBEMAIL</envar> " "environment variable to set the user.email &git; configuration otherwise use " "&git;'s defaults. Only affects newly created repos." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:280 msgid "Download and import a source package from a URL:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-dsc.xml:283 #, no-wrap msgid "" " &gbp-import-dsc; " "http://http.debian.net/debian/pool/main/h/hello/hello_2.10-1.dsc\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:286 msgid "" "Download and import a source package via <command>apt-get source</command> " "from unstable:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-dsc.xml:290 #, no-wrap msgid "" " &gbp-import-dsc; apt:hello/sid\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:293 msgid "Import a source package in the local file system:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-dsc.xml:296 #, no-wrap msgid "" " &gbp-import-dsc; ../hello_2.10-1.dsc\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-dsc.xml:303 msgid "" "<xref linkend=\"man.gbp.import.dscs\"/>, <xref " "linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.import.orig\"/>, " "<xref linkend=\"man.gbp.dch\"/>, <citerefentry> " "<refentrytitle>apt-get</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>, <citerefentry> <refentrytitle>sources.list</refentrytitle> " "<manvolnum>5</manvolnum> </citerefentry>, <citerefentry> " "<refentrytitle>dget</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>, <xref linkend=\"man.gbp.conf\"/>, &man.seealso.common;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-import-orig.xml:12 manpages/gbp-import-orig.xml:16 msgid "gbp-import-orig" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-import-orig.xml:17 msgid "Import an upstream source into a git repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-orig.xml:21 msgid "" "&gbp-import-orig; &man.common.options.synopsis; " "<arg><option>--upstream-version=</option><replaceable>version</replaceable></arg> " "<arg><option>--[no-]merge</option></arg> " "<arg><option>--merge-mode=</option><replaceable>[auto|merge|replace]</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-vcs-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--[no-]sign-tags</option></arg> " "<arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg " "rep='repeat'><option>--filter=</option><replaceable>pattern</replaceable></arg> " "<arg " "rep='repeat'><option>--component=</option><replaceable>component</replaceable></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--[no-]filter-pristine-tar</option></arg> " "<arg><option>--[no-]symlink-orig</option></arg> " "<arg><option>--postimport=cmd</option></arg> " "<arg><option>--postunpack=cmd</option></arg> " "<arg><option>--[no-]interactive</option></arg> " "<arg><option>--[no-]rollback</option></arg> " "<arg><option>--upstream-signatures=</option>[auto|on|off]</arg> <group " "choice=\"plain\"> <arg " "choice=\"plain\"><replaceable>filename</replaceable></arg> <arg " "choice=\"plain\"><replaceable>url</replaceable></arg> " "<arg><option>--uscan</option></arg> </group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:53 msgid "" "&gbp-import-orig; imports upstream sources into a &git; repository. It can " "import from three sources:" msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: manpages/gbp-import-orig.xml:59 msgid "" "<replaceable>filename</replaceable>: A file in the local file system. Gzip, " "bzip2, lzma and xz compressed tar archives, zip archives and already " "unpacked source trees are supported." msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: manpages/gbp-import-orig.xml:67 msgid "" "<replaceable>url</replaceable>: The tarball is downloaded from a " "<replaceable>http</replaceable> or <replaceable>https</replaceable> " "<replaceable>url</replaceable>. This needs the python3-request package " "installed." msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: manpages/gbp-import-orig.xml:75 msgid "" "<option>--uscan</option>: The latest upstream or specified version is " "fetched via &uscan; relying on <filename>debian/watch</filename>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:81 msgid "" "If the tarballs name is already of the form " "<replaceable>package-name_version.orig.tar.gz</replaceable>, the version " "information is determined from the tarball's filename, otherwise it can be " "given on the command line via <option>--upstream-version</option>. If the " "source package name or version can't be determined, &gbp-import-orig; will " "prompt for it unless <option>--no-interactive</option> is given." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:90 msgid "" "The sources are placed on the upstream branch (default: " "<replaceable>upstream</replaceable>), tagged and merged onto the debian " "branch (default: <replaceable>master</replaceable>). This is either done " "using plain <command>git merge</command> or by creating a new tree that " "consists of the new upstream version plus the <filename>debian/</filename> " "directory. The later is used for source format 3.0 (quilt) packages since " "direct modifications of the upstream sources are not allowed in that format " "and so a 1:1 replacement of the upstream sources is almost always " "desired. It can be tweaked via the <option>--merge-mode</option>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:102 msgid "" "In case of an error &gbp-import-orig; will rollback (undo) all changes it " "has done to the repository (see the <option>--rollback</option> option)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:113 manpages/gbp-import-ref.xml:51 msgid "<option>--upstream-version</option>=<replaceable>version</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:114 manpages/gbp-import-ref.xml:52 msgid "<option>-u</option><replaceable>version</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:117 msgid "" "The upstream version number. With <option>--uscan</option>, passed to uscan " "as <option>--download-debversion</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:123 msgid "<option>--[no-]merge</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:126 msgid "Merge the upstream branch to the &debian; branch after import" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:131 manpages/gbp-import-ref.xml:61 msgid "<option>--merge-mode=</option><replaceable>[auto|merge|replace]</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:134 msgid "" "How to fold the newly imported upstream source to the &debian; packaging " "branch after import." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:138 manpages/gbp-import-ref.xml:68 msgid "" "<replaceable>merge</replaceable> does a &git; <command>merge</command> " "leaving you on your own in case of merge conflict resolution." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:143 manpages/gbp-import-ref.xml:73 msgid "" "<replaceable>replace</replaceable> mode on the other hand makes the head of " "the &debian; packaging branch identical to the newly imported tree but " "preserves the content of the <filename>debian/</filename> directory while " "keeping the current head as well as the newly imported tree as parents of " "the generated commit. This is similar to a <option>theirs</option> merge " "strategy while preserving <filename>debian/</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:153 manpages/gbp-import-ref.xml:83 msgid "" "The default is <replaceable>auto</replaceable> which uses " "<replaceable>replace</replaceable> for 3.0 (quilt) packages and " "<replaceable>merge</replaceable> otherwise." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:174 msgid "" "The branch in the &git; repository the &debian; package is being developed " "on, default is <replaceable>master</replaceable>. After importing the new " "sources on the upstream branch, &gbp-import-orig; will try to merge the new " "version onto this branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:208 manpages/gbp-import-ref.xml:148 msgid "" "Use this <option><replaceable>keyid</replaceable></option> for gpg signing " "tags." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:224 manpages/gbp-import-ref.xml:154 msgid "<option>--import-msg=</option><replaceable>msg-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:228 manpages/gbp-import-ref.xml:158 msgid "" "Use this format string for the commit message when importing upstream " "versions, default is <replaceable>New upstream version " "%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:239 msgid "" "Filter out files glob-matching " "<option><replaceable>pattern</replaceable></option>. This option can be " "given multiple times." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:250 msgid "" "When importing the upstream tarball also look for an additional tarball with " "component name <replaceable>COMPONENT</replaceable>. E.g. in " "<filename>hello-debhelper_1.0.orig-foo.tar.gz</filename> the component would " "be <replaceable>foo</replaceable>. The additional tarball is expected to be " "in the same directory than the upstream tarball and to use the same " "compression type." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:258 manpages/gbp-pristine-tar.xml:73 msgid "" "Using additional original tarballs is a feature of the 3.0 (quilt) source " "format. See the <command>dpkg-source</command> manpage for details. This is " "currently considered an experimental feature and might change incompatibly." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:267 msgid "<option>--[no-]pristine-tar</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:271 msgid "Generate <command>pristine-tar</command> delta file." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:276 msgid "<option>--[no-]filter-pristine-tar</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:280 msgid "" "If using a filter, also filter the files out of the tarball passed to " "<command>pristine-tar</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:286 msgid "<option>--[no-]symlink-orig</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:289 msgid "" "Whether to create and keep a symlink from the upstream tarball to a &debian; " "policy conformant upstream tarball name located in <filename " "class=\"directory\">../</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:294 msgid "" "This is a good idea if not using <command>pristine-tar</command> since it " "avoids creating a new tarball with a different md5sum." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:300 manpages/gbp-import-ref.xml:165 msgid "<option>--postimport=<replaceable>cmd</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:307 manpages/gbp-import-ref.xml:172 msgid "<envar>GBP_BRANCH</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:309 manpages/gbp-import-ref.xml:174 msgid "The name of the Debian packaging branch" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:313 manpages/gbp-import-ref.xml:178 msgid "<envar>GBP_TAG</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:315 manpages/gbp-import-ref.xml:180 msgid "The name of the just created upstream tag" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:319 manpages/gbp-import-ref.xml:184 msgid "<envar>GBP_UPSTREAM_VERSION</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:321 manpages/gbp-import-ref.xml:186 msgid "The just imported upstream version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:325 manpages/gbp-import-ref.xml:190 msgid "<envar>GBP_DEBIAN_VERSION</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:327 manpages/gbp-import-ref.xml:192 msgid "The Debian version of the package with a Debian revision of '-1'" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:303 manpages/gbp-import-ref.xml:168 msgid "" "Run <replaceable>cmd</replaceable> after the import. The hook gets the " "following environment variables passed: <placeholder type=\"variablelist\" " "id=\"0\"/>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:336 msgid "<option>--postunpack=<replaceable>cmd</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:344 msgid "<envar>GBP_TMP_DIR</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:346 msgid "The temporary directory the tarballs are unapcked into." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:350 msgid "<envar>GBP_SOURCES_DIR</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:352 msgid "The temporary directory where the unpacked sources are." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:356 msgid "<envar>GBP_GIT_DIR</envar>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:358 msgid "The directory of the git repository where the tarball will be imported into." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:339 msgid "" "Run <replaceable>cmd</replaceable> after the import. This can be useful to " "e.g. convert or remove certain files prior to the import. The hook gets " "passed the following environment variables: <placeholder " "type=\"variablelist\" id=\"0\"/>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:367 msgid "<option>--uscan</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:370 msgid "" "Use &uscan; to fetch new upstream version. The version can be specified with " "<option>--upstream-version</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:376 msgid "<option>--[no-]interactive</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:379 msgid "Run command interactively, i.e. ask package name and version if needed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-orig.xml:385 manpages/gbp-import-ref.xml:201 msgid "<option>--[no-]rollback</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:388 manpages/gbp-import-ref.xml:204 msgid "Rollback changes in case of an error." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-orig.xml:396 msgid "" "Whether upstream signatures should be imported as well (when using " "pristine-tar). <emphasis>no</emphasis> turns this off completely while " "<emphasis>yes</emphasis> always tries to import a signature (which can be " "useful if you want to fail if e.g. &uscan; did not fetch a signature). The " "default <emphasis>auto</emphasis> means to import a signature file if " "present but do nothing otherwise." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:411 msgid "" "Download and import a new upstream version using the information from " "<filename>debian/watch</filename>" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-orig.xml:414 #, no-wrap msgid " &gbp-import-orig; --uscan" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:416 msgid "Fetch tarball from an URL" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-orig.xml:419 #, no-wrap msgid "" " &gbp-import-orig; " "https://debian.example.com/sid/upstream-tarball-0.1.tar.gz" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:421 msgid "Import a local tarball" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-orig.xml:424 #, no-wrap msgid " &gbp-import-orig; ../upstream-tarball-0.1.tar.gz" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-orig.xml:432 manpages/gbp-import-ref.xml:236 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref " "linkend=\"man.gbp.import.dsc\"/>, <xref linkend=\"man.gbp.import.dscs\"/>, " "<xref linkend=\"man.gbp.dch\"/>, <xref linkend=\"man.gbp.conf\"/>, " "<citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>, &man.seealso.common;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-import-ref.xml:12 manpages/gbp-import-ref.xml:16 msgid "gbp-import-ref" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-import-ref.xml:17 msgid "Update upstream sources when using &git; only" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-ref.xml:21 msgid "" "&gbp-import-ref; &man.common.options.synopsis; " "<arg><option>--upstream-version=</option><replaceable>version</replaceable></arg> " "<arg><option>--merge-mode=</option><replaceable>[auto|merge|replace]</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag_format</replaceable></arg> " "<arg><option>--upstream-tree=</option><replaceable>[BRANCH|VERSION|commit-id]</replaceable></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--[no-]sign-tags</option></arg> " "<arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg> " "<arg><option>--postimport=cmd</option></arg> " "<arg><option>--[no-]rollback</option></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-ref.xml:39 msgid "" "&gbp-import-ref; merges upstream git commits onto your &debian-branch; You " "can either specify a branch to merge, give an upstream version or specify " "the commit id directly. If no tag exists for the imported commit it will be " "automatically created." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-ref.xml:55 msgid "" "The upstream version to merge. The upstream tag to use will be determined " "via the <option>--upstream-tag</option>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-ref.xml:64 msgid "How to fold the upstream commits onto the &debian; packaging branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-ref.xml:94 msgid "" "The branch in the &git; repository the upstream sources are on. Default is " "<replaceable>upstream</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-ref.xml:104 msgid "" "Use this tag format when looking up upstream tags, default is " "<replaceable>upstream/%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-ref.xml:110 msgid "<option>--upstream-tree=</option><replaceable>[BRANCH|VERSION|commit-id]</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-ref.xml:114 msgid "" "What to merge into the &debian-branch;. <replaceable>BRANCH</replaceable> " "merges from the upstream branch. <replaceable>VERSION</replaceable> (the " "default) looks for a tag determined from the given upstream version number " "via the <option>--upstream-version</option> option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-ref.xml:120 msgid "Other values are interpreted as git commit id to merge from." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-ref.xml:213 msgid "" "Merge commits from the &upstream-branch; into the &debian-branch; creating a " "tag for the version <replaceable>0.0~git20180524</replaceable>:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-ref.xml:217 #, no-wrap msgid " &gbp-import-ref; --upstream-tree=BRANCH -u0.0~git20180524" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-ref.xml:219 msgid "" "Merge commits from the tag corresponding to version " "<replaceable>1.0</replaceable>:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-ref.xml:222 #, no-wrap msgid " &gbp-import-ref; --upstream-tree=VERSION -u1.0" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-ref.xml:224 msgid "" "Merge commits given by a SHA1 creating a tag for the version " "<replaceable>0.0~git20180524</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-import-ref.xml:228 #, no-wrap msgid " &gbp-import-ref; --upstream-tree=c4398912c -u0.0~git20180524" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-import-srpm.xml:12 manpages/gbp-import-srpm.xml:16 msgid "gbp-import-srpm" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-import-srpm.xml:17 msgid "Import source RPM packages into a Git repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-srpm.xml:21 msgid "" "&gbp-import-srpm; &man.common.options.synopsis; " "<arg><option>--vendor</option>=<replaceable>VENDOR</replaceable></arg> " "<arg><option>--allow-same-versions</option></arg> " "<arg><option>--author-is-committer</option></arg> " "<arg><option>--packaging-branch=</option><replaceable>BRANCH-NAME</replaceable></arg> " "<arg><option>--packaging-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--skip-packaging-tag</option></arg> " "<arg><option>--packaging-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--filter=</option><replaceable>PATTERN</replaceable></arg> " "<arg><option>--keyid=</option><replaceable>GPG-KEYID</replaceable></arg> " "<arg><option>--[no-]create-missing-branches</option></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--[no-]sign-tags</option></arg> " "<arg><option>--upstream-branch=</option><replaceable>BRANCH-NAME</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--upstream-vcs-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--native</option></arg> " "<arg><option>--repo-user=</option><option>[GIT|DEBIAN]</option></arg> " "<arg><option>--repo-email=</option><option>[GIT|DEBIAN]</option></arg> " "<group choice=\"plain\"> <arg><replaceable>SRPM</replaceable></arg> " "<arg><replaceable>DIRECTORY</replaceable></arg> </group> <arg " "choice=\"opt\"><replaceable>target</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-import-srpm.xml:48 msgid "" "&gbp-import-srpm; <arg><option>options</option></arg> <group " "choice=\"plain\"> <arg><replaceable>URL</replaceable></arg> </group> <arg " "choice=\"opt\"><replaceable>target</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-srpm.xml:59 msgid "" "&gbp-import-srpm; imports an RPM source package into a &git; repository, " "notes the package version in the commit logs, and commits the change. All " "information, including package name, version and upstream source is " "automatically detected from the source package but you can override the " "location of the new repository by optionally specifying the " "<replaceable>target</replaceable> argument. The tool supports importing both " "archived (src.rpm files) or unpacked (directory) source RPMs. It also " "imports from http(s)-URLs." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:75 manpages/gbp-rpm-ch.xml:80 msgid "<option>--vendor</option>=<replaceable>VENDOR</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:84 msgid "<option>--upstream-branch</option>=<replaceable>BRANCH-NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:94 manpages/gbp-rpm-ch.xml:89 msgid "<option>--packaging-branch</option>=<replaceable>BRANCH-NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:98 msgid "" "The branch in the &git; repository the packaging files are put onto. Default " "is <replaceable>master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:113 manpages/gbp-tag.xml:92 msgid "<option>--keyid=</option><replaceable>GPG-KEYID</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:122 manpages/gbp-rpm-ch.xml:109 msgid "<option>--packaging-tag=</option><replaceable>TAG-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:126 msgid "" "Use this tag format when tagging released versions, default is " "<replaceable>%(vendor)s/%(version)s</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:132 msgid "<option>--skip-packaging-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:136 msgid "Do not create packaging tag after importing the packaging files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:151 msgid "<option>--upstream-vcs-tag</option>=<replaceable>TAG-NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:155 msgid "" "Add <replaceable>TAG-FORMAT</replaceable> as an additional parent of the " "commit of the upstream tarball. Useful when upstream uses git and you want " "to link to its revision history. <replaceable>TAG-FORMAT</replaceable> can " "be a pattern similar to what <option>--upstream-tag</option> supports." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:168 msgid "Subdirectory where to put the RPM packaging files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:173 msgid "<option>--filter=</option><replaceable>PATTERN</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:177 msgid "Filter out files glob-matching pattern. Can be given multiple times." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:195 msgid "" "Allow one to re-import a package with an already existing version. This " "will not re-import the upstream sources - only packaging files will be " "re-imported." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:206 msgid "" "Use the author identity as the committer when importing upstream sources and " "packaging files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:216 msgid "Create missing upstream and/or packaging branch if missing." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:221 msgid "<option>--orphan-packaging</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:225 msgid "" "Import packaging files into an orphan branch that will not be based on the " "upstream branch. Useful if you want to maintain (non-native) package using " "the 'orphan-packaging' model. This option have no effect if " "<option>--native</option> is used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-import-srpm.xml:233 msgid "<option>--native</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-import-srpm.xml:237 msgid "" "Treat the package as native package. No separate upstream branch or upstream " "tags will be created." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-import-srpm.xml:273 msgid "" "<xref linkend=\"man.gbp.buildpackage.rpm\"/>, <xref " "linkend=\"man.gbp.pq.rpm\"/>, <xref linkend=\"man.gbp.rpm.ch\"/>, <xref " "linkend=\"man.gbp.conf\"/>, &man.seealso.common;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-pq-rpm.xml:12 manpages/gbp-pq-rpm.xml:16 msgid "gbp-pq-rpm" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-pq-rpm.xml:17 msgid "Manage patches and development branches in Git" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-pq-rpm.xml:21 msgid "" "&gbp-pq-rpm; &man.common.options.synopsis; " "<arg><option>--packaging-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--spec-file=</option><replaceable>FILEPATH</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--abbrev=</option><replaceable>num</replaceable></arg> " "<arg><option>--force</option></arg> <arg><option>--[no-]drop</option></arg> " "<arg><option>--[no-]patch-numbers</option></arg> <group choice=\"plain\"> " "<arg><option>drop</option></arg> <arg><option>export</option></arg> " "<arg><option>import</option></arg> <arg><option>rebase</option></arg> " "<arg><option>switch</option></arg> <arg><option>apply</option></arg> " "</group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq-rpm.xml:43 msgid "" "&gbp-pq-rpm; helps in managing patches and development branch(es) for " "packages that are maintained with &gbp;. It designed to be used for packages " "that are maintained using the \"orphan-packaging\" model. &gbp-pq-rpm; has " "multiple subcommands, or actions, for working with the branches and patches." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq-rpm.xml:50 msgid "" "&gbp-pq-rpm; makes it easy to do source code development on a separate " "development branch (patch-queue branch in Debian git-buildpackage terms). " "For example, if the packaging files would be stored in " "<replaceable>master</replaceable> the associated development branch would be " "<replaceable>development/master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-pq-rpm.xml:58 manpages/gbp-pq.xml:62 msgid "ACTIONS" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:61 manpages/gbp-pq.xml:65 msgid "<option>import</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:65 msgid "" "Create a development (patch-queue) branch by applying all patches from the " "packaging branch on top of the upstream version. The patches must apply " "without fuzz." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:72 manpages/gbp-pq.xml:76 msgid "<option>export</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:76 msgid "" "Export patches from the development branch into the packaging branch. It " "generates patches (one-per-commit) from the development branch and updates " "the spec file accordingly. It doesn't automatically commit the changes " "though - they need to verified and committed manually." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:84 manpages/gbp-pq.xml:87 msgid "<option>rebase</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:88 msgid "" "Switch to the development branch and rebase it against the current upstream " "version (indicated in the spec file of the associated packaging branch)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:95 manpages/gbp-pq.xml:97 msgid "<option>drop</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:99 msgid "" "Drop (delete) the development branch associated to the current branch. For " "example, you're on branch <replaceable>foo</replaceable> this would drop " "branch <replaceable>development/foo</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:106 manpages/gbp-pq.xml:108 msgid "<option>apply</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:110 msgid "" "Add a single patch to the development branch - similar to using " "<command>git-am</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:116 manpages/gbp-pq.xml:121 msgid "<option>switch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:120 msgid "Switch between the development branch and the associated packaging branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:132 manpages/gbp-rpm-ch.xml:119 msgid "<option>--packaging-dir=</option><replaceable>DIRECTORY</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:141 manpages/gbp-rpm-ch.xml:143 msgid "<option>--spec-file=</option><replaceable>FILEPATH</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:145 manpages/gbp-rpm-ch.xml:147 msgid "" "Relative path to the spec file to use. Special value " "<replaceable>auto</replaceable> causes &gbp; to search and guess. Other " "values cause the <option>--packaging-dir</option> option to be ignored: the " "directory of the spec file is used, instead." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:163 manpages/gbp-pq.xml:206 msgid "<option>--abbrev=</option><replaceable>NUM</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:167 manpages/gbp-pq.xml:210 msgid "" "When exporting a patch queue abbreviate commit, instead of showing the full " "40-byte hexadecimal object name in header lines, show only a partial prefix " "of length <replaceable>NUM</replaceable>. This is useful when existing " "patches were not generated by &gbp-pq;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:175 manpages/gbp-pq.xml:218 manpages/gbp-pull.xml:60 msgid "<option>--force</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:178 msgid "" "Import even if the development (patch-queue) branch already exists. Only " "valid for the import action." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:184 manpages/gbp-pq.xml:199 msgid "<option>--[no-]drop</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:187 msgid "Whether to drop (delete) the patch queue branch after a successful export." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:193 manpages/gbp-pq.xml:138 msgid "<option>--[no-]patch-numbers</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:197 msgid "Whether the patch files should start with a number or not." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq-rpm.xml:206 msgid "" "When exporting patches from a patch-queue branch &gbp-pq-rpm; will look at " "the commit message for special tags it recognizes. All tags need to start at " "the first column and require at least one whitespace after the colon." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:212 msgid "<option>Gbp-Rpm: Ignore</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:216 manpages/gbp-pq.xml:297 msgid "Ignores the commit, no patch is generated out of it." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:221 msgid "<option>Gbp-Rpm: If <expression></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:225 msgid "" "Conditional patch. Put patch inside \"%if <expression>\" in the spec " "file." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq-rpm.xml:231 msgid "<option>Gbp-Rpm: IfArch<expression></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq-rpm.xml:235 msgid "" "Conditional patch. Put patch inside \"%ifarch <expression>\" in the " "spec file." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq-rpm.xml:242 msgid "For example, the following commit message:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-pq-rpm.xml:245 #, no-wrap msgid "" " Fix around a problem in Fedora\n" "\n" " which is not applicable elsewhere.\n" "\n" " Gbp-Rpm: If 0%{?fedora}\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq-rpm.xml:252 msgid "Will result something like this in the spec file:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-pq-rpm.xml:255 #, no-wrap msgid "" " # 0001-Fix-around-a-problem-in-Fedora.patch\n" " %if 0%{?fedora}\n" " %patch0 -p1\n" " %endif\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq-rpm.xml:264 msgid "" "<xref linkend=\"man.gbp.buildpackage.rpm\"/>, <xref " "linkend=\"man.gbp.import.srpm\"/>, <xref linkend=\"man.gbp.conf\"/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-pq.xml:12 manpages/gbp-pq.xml:16 msgid "gbp-pq" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-pq.xml:17 msgid "Manage quilt patches on patch queue branches in git" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-pq.xml:21 msgid "" "&gbp-pq; &man.common.options.synopsis; " "<arg><option>--[no-]patch-numbers</option></arg> " "<arg><option>--patch-num-format=</option><replaceable>format</replaceable></arg> " "<arg><option>--[no-]renumber</option></arg> " "<arg><option>--topic=</option><replaceable>topic</replaceable></arg> " "<arg><option>--time-machine=</option><replaceable>num</replaceable></arg> " "<arg><option>--[no-]drop</option></arg> " "<arg><option>--abbrev=</option><replaceable>num</replaceable></arg> " "<arg><option>--force</option></arg> <arg><option>--commit</option></arg> " "<arg><option>--meta-closes=bug-close-tags</option></arg> " "<arg><option>--meta-closes-bugnum=bug-number-format</option></arg> " "<arg><option>--pq-from=</option><replaceable>[DEBIAN|TAG]</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<group choice=\"plain\"> <arg><option>drop</option></arg> " "<arg><option>export</option></arg> <arg><option>import</option></arg> " "<arg><option>rebase</option></arg> <arg><option>switch</option></arg> " "</group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq.xml:48 msgid "" "&gbp-pq; helps one to manage quilt patches in &debian; packages that are " "maintained with &gbp;. This is especially useful with packages using the 3.0 " "(quilt) source format. With &gbp-pq;, you can maintain the quilt patches " "that should be applied to a package on a separate branch called patch-queue " "branch. So if your &debian; package lives on " "<replaceable>master</replaceable>, the associated patch-queue branch will be " "called <replaceable>patch-queue/master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq.xml:57 msgid "" "See <ulink " "url=\"https://honk.sigxcpu.org/piki/development/debian_packages_in_git/\"></ulink> " "for example workflows." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:69 msgid "" "Create a patch queue branch from quilt patches in debian/patches/ that are " "listed in debian/patches/series. The patches must apply without fuzz." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:80 msgid "" "Export the patches on the patch-queue branch associated to the current " "branch into a quilt patch series in debian/patches/ and update the series " "file." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:91 msgid "" "Switch to the patch-queue branch associated to the current branch and rebase " "it against the current branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:101 msgid "" "Drop (delete) the patch queue associated to the current branch. So if you're " "on branch <replaceable>foo</replaceable>, this would drop branch " "<replaceable>patch-queue/foo</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:112 msgid "" "Add a single patch to the patch-queue similar to using " "<command>git-am</command>. Use <option>--topic</option> if you want the " "patch to appear in a separate subdir when exporting the patch queue using " "<option>export</option>. This can be used to separate upstream patches from " "&debian; specific patches." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:125 msgid "" "Switch to the patch-queue branch if on the base branch and switch to base " "branch if on patch-queue branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:142 msgid "" "Whether or not the patch files should be prefixed with a number. The " "default is to export patches with patch numbers. Note, however, that this " "normally affects patches whose names are automatically generated, and has no " "effect on exporting patches which have a <option>Gbp[-Pq]: Name</option> " "tag, since the name specified is preserved unless the " "<option>--renumber</option> option is used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:153 msgid "<option>--patch-num-format=</option><replaceable>format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:157 msgid "" "The format specifier for patch number prefixes. The default format is " "'%04d-'." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:162 msgid "<option>--[no-]renumber</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:166 msgid "" "Whether or not to renumber patches exported from the patch queue, instead of " "preserving numbers specified in <option>Gbp-Pq: Name</option> tags. The " "default is not to renumber patches. Useful when patches need to be renamed " "for the sake of uniformity. For example, using <option>--renumber</option> " "with <option>--no-patch-num</option> will strip all numeric prefixes from " "exported patches." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:177 msgid "<option>--topic=</option><replaceable>topic</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:181 msgid "Topic to use when importing a single patch" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:186 msgid "<option>--time-machine=</option><replaceable>NUM</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:190 msgid "" "When importing a patch queue fails, go back commit-by-commit on the current " "branch to check if the patch-queue applies there. Do this at most " "<replaceable>NUM</replaceable> times. This can be useful if the patch-queue " "doesn't apply to the current branch HEAD anymore, e.g. after importing a " "new upstream version." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:201 msgid "" "Whether to automatically drop (delete) the patch queue branch after a " "successful export" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:220 msgid "" "In case of <option>import</option>, import even if the patch-queue branch " "already exists and overwrite its content with " "<filename>debian/patches</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:226 msgid "<option>--export</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:229 msgid "" "In case of <option>export</option>, commit " "<filename>debian/patches</filename>the changes to &git; after exporting the " "patches." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:240 msgid "" "What meta tags to look for to generate a commit message when using " "<option>export</option> <option>--commit</option>. The default is " "<literal>'Closes|LP'</literal> to support Debian and Launchpad." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:251 msgid "" "What regular expression should be used to parse out the bug number when " "using <option>export</option> <option>--commit</option>. The default is " "<literal>'(?:bug|issue)?\\#?\\s?\\d+'</literal>. See <xref " "linkend=\"man.gbp.dch\"/> for details." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:260 msgid "<option>--pq-from=</option><replaceable>[DEBIAN|TAG]</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:264 msgid "" "How to find the starting point for the patch queue base. The options are " "DEBIAN, that will use the Debian branch as the base for the patch queue " "branch, and TAG, that will use the corresponding upstream tag as a base for " "the patch queue branch." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:267 msgid "" "This is only needed if your upstream branch is not merged in the Debian " "branch. The default is <replaceable>DEBIAN</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp-pq.xml:285 msgid "TAGS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq.xml:287 msgid "" "When exporting patches from a patch-queue branch, &gbp-pq; will look at the " "patch header for special tags it recognizes. All tags need to start at the " "first column and require at least one whitespace after the colon." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:293 msgid "<option>Gbp[-Pq]: Ignore</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:302 msgid "<option>Gbp[-Pq]: Name</option> <replaceable>name</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><screen> #: manpages/gbp-pq.xml:307 manpages/gbp-pq.xml:319 #, no-wrap msgid "&gbp-pq; export" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:306 msgid "" "The name to use for the patch when running <placeholder type=\"screen\" " "id=\"0\"/> If unset, it will be formatted like <command>git am</command> " "would format it." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:314 msgid "<option>Gbp[-Pq]: Topic</option> <replaceable>topic</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:318 msgid "" "Moves the patch into a subdir called <replaceable>topic</replaceable> when " "running <placeholder type=\"screen\" id=\"0\"/> This allows for some " "structure below <filename>debian/patches</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pq.xml:325 msgid "<option>Gbp-Pq-Topic:</option> <replaceable>topic</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pq.xml:329 msgid "" "Deprecated: use <option>Gbp[-Pq]: Topic</option> " "<replaceable>topic</replaceable> instead." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pq.xml:339 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <citerefentry> " "<refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>, <citerefentry> <refentrytitle>quilt</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>, <xref linkend=\"man.gbp.conf\"/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-pristine-tar.xml:12 manpages/gbp-pristine-tar.xml:16 msgid "gbp-pristine-tar" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-pristine-tar.xml:17 msgid "Manage pristine-tar commits in a git repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-pristine-tar.xml:21 msgid "" "&gbp-pristine-tar; &man.common.options.synopsis; " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg " "rep='repeat'><option>--component=</option><replaceable>component</replaceable></arg> " "<group choice=\"plain\"> <arg><option>commit</option></arg> </group> <group " "choice=\"plain\"> <arg " "choice=\"plain\"><replaceable>filename</replaceable></arg> </group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pristine-tar.xml:37 msgid "" "&gbp-pristine-tar; adds the pristine-tar commit for a given upstream tarball " "to a &git; repository. This can be useful if a original tarball has been " "already imported and the pristine-tar commits should be added at a later " "time or if you're tracking upstream git and want to create pristine-tar " "commits nevertheless." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pristine-tar.xml:54 msgid "" "use this tag format when tagging upstream versions, default is " "<replaceable>upstream/%(version)s</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pristine-tar.xml:64 msgid "" "When creating the pristine-tar commits also look for an additional tarball " "with component name <replaceable>COMPONENT</replaceable>. E.g. in " "<filename>hello-debhelper_1.0.orig-foo.tar.gz</filename> the component name " "would be <replaceable>foo</replaceable>. The additional tarball is expected " "to be in the same directory than the upstream tarball and to use the same " "compression type. This option can be given multiple times to add multiple " "additional tarballs." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pristine-tar.xml:85 msgid "Add pristine-tar commits for an upstream tarball:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-pristine-tar.xml:87 #, no-wrap msgid " &gbp-pristine-tar; commit ../upstream-tarball-0.1.tar.gz" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pristine-tar.xml:88 msgid "" "Same as above with an additional tarball " "<filename>../upstream-tarball-foo-0.1.tar.gz:</filename>" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-pristine-tar.xml:91 #, no-wrap msgid "" " &gbp-pristine-tar; --component-tarball=foo commit " "../upstream-tarball-0.1.tar.gz" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pristine-tar.xml:99 msgid "" "<xref linkend=\"man.gbp.import.orig\"/>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-pull.xml:12 manpages/gbp-pull.xml:16 msgid "gbp-pull" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-pull.xml:18 msgid "Safely update a repository from remote" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-pull.xml:22 msgid "" "&gbp-pull; &man.common.options.synopsis; <arg><option>--force</option></arg> " "<arg><option>--all</option></arg> <arg><option>--redo-pq</option></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--ignore-branch</option></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--track-missing</option></arg> " "<arg><option>--depth=</option><replaceable>depth</replaceable></arg> " "<arg><replaceable>repository</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pull.xml:40 msgid "" "&gbp-pull; updates the <emphasis>debian</emphasis>, " "<emphasis>upstream</emphasis> and <emphasis>pristine-tar</emphasis> branches " "from remote repositories in one go. It checks if the update is safe (would " "result in a <emphasis>fast-forward</emphasis> merge) and aborts otherwise." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pull.xml:46 msgid "" "If given on the command line the changes are fetched from the given " "repository otherwise the default for <replaceable>repository</replaceable> " "is read from the <replaceable>remote</replaceable> configuration for each " "branch (in git's configuration)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:62 msgid "Force a branch update even if this results in a non fast forward update." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><warning><para> #: manpages/gbp-pull.xml:63 msgid "Forcing a branch update makes you lose your modifications." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:70 msgid "" "Update all remote-tracking branches that have identical name in the remote " "repository." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pull.xml:75 msgid "<option>--redo-pq</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:77 msgid "Also rebuild the corresponding patch-queue using &gbp-pq;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><warning><para> #: manpages/gbp-pull.xml:78 msgid "This drops the patch-queue branch if it exists." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:85 msgid "Don't care if we're on a branch or in detached head state." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-pull.xml:105 msgid "<option>--track-missing</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:108 msgid "" "If a branch is missing in the local repository try to fetch it from the " "remote side and (if it exists) fetch it and set up branch tracking for " "it. This ensures that branches that are added at a later point to the remote " "side (e.g. <replaceable>pristine-tar</replaceable>) are picked up " "automatically. Note that it's not an error for the branch to not exist on " "the remote side." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:122 msgid "Git history depth, for deepening shallow git clones." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:129 manpages/gbp-push.xml:144 msgid "Whether to update the pristine-tar branch too." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pull.xml:137 msgid "" "When &gbp-pull; finishes, it indicates success or failure with its exit " "code:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:149 msgid "" "An error occurred during the pull, see the printed error message for " "details." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-pull.xml:155 msgid "At least one branch couldn't be fast forwarded." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-pull.xml:166 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.clone\"/>, " "<xref linkend=\"man.gbp.pq\"/>, <xref linkend=\"man.gbp.conf\"/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-push.xml:12 manpages/gbp-push.xml:16 msgid "gbp-push" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-push.xml:18 msgid "Push &debian; packaging changes to a &git; remote" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-push.xml:22 msgid "" "&gbp-push; &man.common.options.synopsis; " "<arg><option>--ignore-branch</option></arg> " "<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> " "<arg><option>--debian-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--[no-]pristine-tar</option></arg> " "<arg><option>--dry-run</option></arg> " "<arg><replaceable>repository</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-push.xml:38 msgid "" "&gbp-push; pushes your local changes to a remote repository. It is best run " "after uploading a &debian; package to the archive to update you " "&debian-branch;, &upstream-branch;, &pristine-tar; branch and corresponding " "tags. It will in order" msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-push.xml:46 msgid "Verify that it is being executed from the &debian-branch;." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-push.xml:51 msgid "" "Determine the debian tag from <filename>debian/changelog</filename> and add " "it the list of things to push if the changelog does not indicate an " "unreleased package." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-push.xml:58 msgid "" "Determine the upstream tag from <filename>debian/changelog</filename> and " "add it to the list of things to push if it's not a native package." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-push.xml:64 msgid "" "Determine if the tags correspond to the branch tips of the corresponding " "upstream and debian branches. If so, these branches will be added to the " "list of things to push. If not the changes will only be pushed up to the " "commit that is referenced by the corresponding tag." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-push.xml:72 msgid "" "Determine if the pristine-tar branch needs to be pushed and if so adds it to " "the list of things to push." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-push.xml:78 msgid "" "Finally, if not in dry-run mode, pushes the above changes to the remote " "side." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-push.xml:83 msgid "" "If a <replaceable>remote</replaceable> is given on the command line the " "changes are pushed to the given remote repository. By default it will push " "to the current branches remote and fall back to <emphasis>origin</emphasis>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-push.xml:97 msgid "" "Don't fail if the &debian-branch; does not match the currently checked out " "branach and push the current branch instead." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-push.xml:106 msgid "" "The branch in the Git repository the Debian package is being developed " "on. If set to the empty value the branch will not be pushed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-push.xml:112 manpages/gbp-tag.xml:101 msgid "<option>--debian-tag=</option><replaceable>TAG-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-push.xml:115 msgid "" "Use this tag format when looking for tags corresponding to a &debian; " "version. Default is <replaceable>debian/%(version)s</replaceable>. If set " "to the empty value the tag will not be pushed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-push.xml:125 msgid "" "The branch in the &git; repository the upstream sources are put onto. If set " "to the empty value the branch will not be pushed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-push.xml:134 msgid "" "Use this tag format when looking for tags of upstream versions. Default is " "<replaceable>upstream/%(version)s</replaceable>. If set to the empty value " "the tag will not be pushed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-push.xml:148 msgid "<option>--dry-run</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-push.xml:151 msgid "" "Pass the <option>--dry-run</option> to &gitcmd; <option>push</option>. So " "don't push anything, only check if things are pushable." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-push.xml:164 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.clone\"/>, " "<xref linkend=\"man.gbp.pull\"/>, <xref linkend=\"man.gbp.conf\"/>" msgstr "" #. type: Content of: <refentry><refmeta><refentrytitle> #: manpages/gbp-rpm-ch.xml:12 msgid "gbp-rpm-ch" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-rpm-ch.xml:16 msgid "gbp-rpm-ch;" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-rpm-ch.xml:17 msgid "Generate the RPM changelog from git commit messages" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-rpm-ch.xml:21 msgid "" "&gbp-rpm-ch; &man.common.options.synopsis; " "<arg><option>--tmp-dir</option>=<replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--vendor</option>=<replaceable>VENDOR</replaceable></arg> " "<arg><option>--packaging-branch=</option><replaceable>BRANCH-NAME</replaceable></arg> " "<arg><option>--packaging-tag=</option><replaceable>TAG-FORMAT</replaceable></arg> " "<arg><option>--ignore-branch</option></arg> " "<arg><option>--packaging-dir=</option><replaceable>DIRECTORY</replaceable></arg> " "<arg><option>--changelog-file=</option><replaceable>FILEPATH</replaceable></arg> " "<arg><option>--spec-file=</option><replaceable>FILEPATH</replaceable></arg> " "<arg><option>--since=</option><replaceable>COMMIT-ISH</replaceable></arg> " "<arg><option>--no-release</option></arg> " "<arg><option>--[no-]git-author</option></arg> " "<arg><option>--[no-]full</option></arg> " "<arg><option>--id-length=</option><replaceable>NUMBER</replaceable></arg> " "<arg><option>--ignore-regex=</option><replaceable>REGEX</replaceable></arg> " "<arg><option>--changelog-revision=</option><replaceable>REV-FORMAT</replaceable></arg> " "<arg><option>--git-log=</option><replaceable>GIT-LOG-OPTIONS</replaceable></arg> " "<arg><option>--spawn-editor=<replaceable>[always|release|no]</replaceable></option></arg> " "<arg><option>--editor-cmd=</option><replaceable>EDITOR</replaceable></arg> " "<arg><option>--customizations=</option><replaceable>CUSTOMIZATION-FILE</replaceable></arg> " "<arg choice=\"plain\"><replaceable>[PATH1 PATH2]</replaceable></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-rpm-ch.xml:48 msgid "" "&gbp-rpm-ch; reads git commit messages up to the current tip of the current " "branch and updates the RPM changelog from them." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-rpm-ch.xml:52 msgid "" "By default, &gbp-rpm-ch; tries to guess the last &git; commit documented in " "the changelog. Alternatively, <option>--since</option> can be used to tell " "&gbp-rpm-ch; at which point it should start in the &git; history, or, " "<option>--all</option> to use all commits from the &git; history." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-rpm-ch.xml:58 msgid "" "The additional path arguments can be used to restrict the repository paths " "&gbp-rpm-ch; looks at. For even more detailed control, you can use " "<option>--git-log</option> to restrict the generated changelog entries " "further. E.g. by using " "<option>--git-log=</option><replaceable>\"--author=Foo Bar\"</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:93 msgid "" "The branch in the Git repository the package is being developed on, default " "is <replaceable>master</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:113 msgid "" "Tag format used, when tagging releases, default is " "<replaceable>%(vendor)s/%(version)s</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:128 msgid "<option>--changelog-file=</option><replaceable>FILEPATH</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:132 msgid "" "Relative path to the changelog file to use. Special value " "<replaceable>auto</replaceable> causes &gbp; to guess, " "<replaceable>SPEC</replaceable> uses the spec file, " "<replaceable>CHANGES</replaceable> uses a separate changelog file (name " "derived spec file name with .spec suffix replaced by .changes). Guessing " "logic is simple: use separate changelog file if it is found, otherwise use " "the spec file." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:155 msgid "<option>--since=</option><replaceable>COMMIT-ISH</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:159 msgid "Start reading commit messages at <replaceable>COMMIT-ISH</replaceable>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:165 msgid "<option>--no-release</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:169 msgid "" "Do not create a new changelog section, just update the last changelog " "section." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:184 msgid "<option>--git-log=</option><replaceable>GIT-LOG-OPTIONS</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:203 manpages/gbp-rpm-ch.xml:229 msgid "<option>--ignore-regex=</option><replaceable>REGEX</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:207 msgid "" "Ignore lines in commit message matching <replaceable>REGEX</replaceable> " "when generating the changelog." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:213 msgid "<option>--changelog-revision=</option><replaceable>REV-FORMAT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:217 msgid "" "Format string to use for revision field in the changelog header. The " "following string fields are accepted: " "<replaceable>%(upstreamversion)s</replaceable> the upstream version; " "<replaceable>%(release)s</replaceable> the rpm patchlevel, i.e. Release; " "<replaceable>%(version)s</replaceable> full rpm package version; " "<replaceable>%(tagname)s</replaceable> tag/commit, i.e. basically what " "<command>git-describe</command> would give. If empty or not defined the " "default from packaging policy is used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:233 msgid "" "Ignore commit lines matching <replaceable>REGEX</replaceable> when " "generating the changelog." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:239 msgid "<option>--[no-]git-author</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:243 msgid "" "Use user.name and user.email from <application>git-config</application>(1) " "for the changelog header." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:249 msgid "<option>--spawn-editor=<replaceable>[always|release|no]</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:253 msgid "Whether to spawn an editor: always, when doing a release or never." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:258 msgid "<option>--editor-cmd=<replaceable>EDITOR</replaceable></option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:262 msgid "The editor to use for editing the changelog." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:267 msgid "<option>--customizations=</option><replaceable>CUSTOMIZATION-FILE</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:271 msgid "" "Load Python code from <replaceable>CUSTOMIZATION-FILE</replaceable>. At the " "moment, the only useful thing the code can do is define a custom " "ChangelogEntryFormatter class." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-rpm-ch.xml:282 msgid "" "Additional to the above options the formatting of the new changelog entries " "(one-per-commit) in the changelog can be modified by special tags (called " "Meta Tags) given in the git commit message. The tags must start at the first " "column of a commit message but can appear on any line. They are of the form " "<option>Tagname</option>: <replaceable>VALUE</replaceable>. Valid Meta Tags " "are:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:291 msgid "<option>Git-Rpm-Ch</option>: <replaceable>ACTION</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:295 msgid "" "Supported actions are: <replaceable>Ignore</replaceable> which will ignore " "this commit when generating new changelog entries. " "<replaceable>Short</replaceable> which will only use the description (the " "first line) of the commit message when generating the changelog entry " "(useful when <option>--full</option> is given) and " "<replaceable>Full</replaceable> which will use the full commit message when " "generating the changelog entry (useful when <option>--full</option> is not " "given)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-rpm-ch.xml:307 msgid "<option>[Close|Closes|...]</option>: <replaceable>BUGNUMBER</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-rpm-ch.xml:311 msgid "" "Indicate in the changelog entry that bug " "<replaceable>BUGNUMBER</replaceable> was addressed in this commit." msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-rpm-ch.xml:321 #, no-wrap msgid "" " Document meta tags\n" "\n" " so one doesn't have to consult the manual\n" "\n" " Git-Rpm-Ch: Short\n" " Closes: #636088\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-rpm-ch.xml:329 msgid "Results in this changelog entry:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-rpm-ch.xml:332 #, no-wrap msgid "" " - Document meta tags (Closes: #636088)\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-rpm-ch.xml:341 msgid "" "<xref linkend=\"man.gbp.buildpackage.rpm\"/>, <xref " "linkend=\"man.gbp.import.srpm\"/>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common; <ulink url=\"https://honk.sigxcpu.org/cl2vcs\"> " "<citetitle>Cl2vcs</citetitle></ulink>," msgstr "" #. type: Content of: <refentry><refentryinfo><address> #: manpages/gbp-setup-gitattributes.xml:4 #, no-wrap msgid "" " <email>andrew@shadura.me</email>\n" " " msgstr "" #. type: Content of: <refentry><refentryinfo> #: manpages/gbp-setup-gitattributes.xml:3 msgid "" "<placeholder type=\"address\" id=\"0\"/> <author> " "<firstname>Andrej</firstname> <surname>Shadura</surname> </author>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-setup-gitattributes.xml:11 #: manpages/gbp-setup-gitattributes.xml:15 msgid "gbp-setup-gitattributes" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-setup-gitattributes.xml:16 msgid "Set up &git; attributes for packaging" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-setup-gitattributes.xml:20 msgid "" "&gbp-setup-gitattributes; &man.common.options.synopsis; " "<arg><option>--[no-]dgit-defuse-attrs</option></arg> " "<arg><option>--all</option></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-setup-gitattributes.xml:30 msgid "" "&gbp-setup-gitattributes; sets up <filename>.git/info/attributes</filename> " "in the current &git; repository to sane defaults most suitable for packaging " "work. At the moment, this amounts to making sure no transformations happen " "during checkout, commit or export. More attributes may be added in future, " "by default all known settings are applied." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-setup-gitattributes.xml:36 msgid "" "Upstream sources may ship <filename>.gitattributes</filename> files enabling " "certain transformations to the committed source, usually to make working " "with files in different encodings more convenient for the upstream " "authors. For Debian packaging, it is necessary to override these attributes, " "since they cause often unwanted conversion of files (e.g. line endings, " "encodings and some others). Working with such source tree is confusing, " "since the working tree differs from the Git history (and sometimes from the " "source tarball), and can lead to errors." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-setup-gitattributes.xml:45 msgid "" "By default, &gbp-clone; tries to detect the usage of " "<filename>.gitattributes</filename> in the upstream source and disables the " "Git attributes only when necessary." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-setup-gitattributes.xml:54 msgid "<option>--[no-]dgit-defuse-attrs</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-setup-gitattributes.xml:58 msgid "" "<option>Disables all transforming attributes for all files. This is done by " "defining a macro attribute <symbol>[attr]dgit-defuse-attrs</symbol> and " "applying it to <filename>*</filename> together with " "<symbol>export-subst</symbol> and <symbol>export-ignore</symbol>.</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-setup-gitattributes.xml:64 msgid "" "This method is compatible with <command>dgit</command> and " "<command>git-deborig</command> which use this macro attribute. Older " "versions of <command>dgit</command> use an incomplete preset missing some " "attributes; if such is found, it is replaced by an updated definition." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-setup-gitattributes.xml:75 msgid "Apply all known &git; attribute settings. This is the default." msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-setup-gitattributes.xml:84 msgid "" "<xref linkend=\"man.gbp.clone\"/>, <xref linkend=\"man.gbp.push\"/>, <xref " "linkend=\"man.gbp.conf\"/>, <citerefentry> " "<refentrytitle>gitattributes</refentrytitle> <manvolnum>5</manvolnum> " "</citerefentry>, <citerefentry> <refentrytitle>dgit</refentrytitle> " "<manvolnum>7</manvolnum> </citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-setup-gitattributes.xml:100 msgid "Andrej Shadura <email>andrew@shadura.me</email>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp-tag.xml:11 manpages/gbp-tag.xml:15 msgid "gbp-tag" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp-tag.xml:16 msgid "Tag a &debian; packages in a &git; repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp-tag.xml:20 msgid "" "&gbp-tag; &man.common.options.synopsis; " "<arg><option>--ignore-branch</option></arg> " "<arg><option>--[no-]ignore-new</option></arg> " "<arg><option>--[no-]sign-tags</option></arg> " "<arg><option>--keyid=</option><replaceable>GPG-KEYID</replaceable></arg> " "<arg><option>--debian-branch=</option><replaceable>BRANCH_NAME</replaceable></arg> " "<arg><option>--debian-tag=</option><replaceable>tag-format</replaceable></arg> " "<arg><option>--debian-tag-msg=</option><replaceable>tag-msg-format</replaceable></arg> " "<arg><option>--posttag=</option><replaceable>COMMAND</replaceable></arg> " "<arg><option>--retag</option></arg>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-tag.xml:37 msgid "&gbp-tag; tags the current head commit appropriately. It will in order:" msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-tag.xml:42 msgid "Verify that it is being executed from the Debian branch." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-tag.xml:53 msgid "" "Create a git tag using the information from " "<filename>debian/changelog</filename>." msgstr "" #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> #: manpages/gbp-tag.xml:58 msgid "(Optionally) call a post tag hook." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-tag.xml:68 msgid "<option>--posttag=</option><replaceable>COMMAND</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-tag.xml:72 msgid "Execute <replaceable>COMMAND</replaceable> after creating the tag." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-tag.xml:111 msgid "<option>--debian-tag-msg=</option><replaceable>tag-msg-format</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-tag.xml:119 msgid "<option>--retag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-tag.xml:130 msgid "<option>--debian-branch</option>=<replaceable>BRANCH_NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp-tag.xml:134 msgid "" "If you're not on this branch when invoking &gbp-tag; it will fail. Default " "is <replaceable>master</replaceable>. This is done to make sure you don't " "accidentally tag on the wrong branch. Not being on this branch will be " "ignored when using <option>--ignore-branch</option>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp-tag.xml:153 msgid "<option>--[no-]ignore-new</option>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-tag.xml:168 msgid "Create a tag with the current defaults" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-tag.xml:171 #, no-wrap msgid "" " &gbp-tag;\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-tag.xml:174 msgid "Create using a more upstreamish tag format:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: manpages/gbp-tag.xml:177 #, no-wrap msgid "" " &gbp-tag; --debian-tag='v%(version)s'\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp-tag.xml:186 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.push\"/>, " "<xref linkend=\"man.gbp.conf\"/>," msgstr "" #. type: Content of: <refentry><refmeta><refentrytitle> #: manpages/gbp.xml:12 msgid "gbp" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: manpages/gbp.xml:16 msgid "&gbp;" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: manpages/gbp.xml:17 msgid "Maintain &debian; packages in &git;" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: manpages/gbp.xml:21 msgid "" "&gbp; <group choice='req'> <arg><option>--help</option></arg> " "<arg><option>--version</option></arg> " "<arg><option>--list-cmds</option></arg> <arg><option>command</option><arg " "choice='opt' rep='repeat'><option>args</option></arg></arg> </group>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.xml:33 msgid "" "&gbp; is used to maintain &debian; source packages in the &git; version " "control system." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:40 msgid "<option>--help</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:43 msgid "Print help" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:47 msgid "<option>--version</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:50 msgid "Print the programs version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:54 msgid "<option>--list-cmds</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:57 msgid "List all available commands" msgstr "" #. type: Content of: <refentry><refsect1><title> #: manpages/gbp.xml:63 msgid "GBP COMMANDS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.xml:65 msgid "" "These are the possible commands. For possible arguments to these commands, " "please see the corresponding man pages." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:70 msgid "buildpackage" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:73 msgid "Build source and binary packages from a &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:79 msgid "import-orig" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:82 msgid "Import a new upstream version into a &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:88 msgid "export-orig" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:91 msgid "Recreate upstream tarballs from a &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:97 msgid "import-dsc" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:100 msgid "Import a &debian; source package into a &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:106 msgid "import-dscs" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:109 msgid "" "Import several &debian; source packages into a &git; repository, sorted by " "version number" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:116 msgid "dch" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:119 msgid "Generate the <filename>debian/changelog</filename> from &git; commit history" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:125 msgid "pq" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:128 msgid "" "Manage <filename>debian/patches</filename> using &git; " "<option>rebase</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:134 msgid "pull" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:137 msgid "Update a &git; repository from a remote" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:143 msgid "clone" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:146 msgid "" "Clone a &git; repository from a remote and set up the necessary branch " "tracking." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:152 msgid "create-remote-repo" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:155 msgid "Create a remote &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:161 msgid "tag" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:164 msgid "Tag a &debian; release in a &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: manpages/gbp.xml:170 msgid "push" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: manpages/gbp.xml:173 msgid "Push packaging branches to a remote &git; repository" msgstr "" #. type: Content of: <refentry><refsect1><para> #: manpages/gbp.xml:184 msgid "" "<xref linkend=\"man.gbp.buildpackage\"/>, <xref linkend=\"man.gbp.clone\"/>, " "<xref linkend=\"man.gbp.create.remote.repo\"/>, <xref " "linkend=\"man.gbp.dch\"/>, <xref linkend=\"man.gbp.export.orig\"/>, <xref " "linkend=\"man.gbp.import.dsc\"/>, <xref linkend=\"man.gbp.import.dscs\"/>, " "<xref linkend=\"man.gbp.import.orig\"/>, <xref linkend=\"man.gbp.pq\"/>, " "<xref linkend=\"man.gbp.pristine.tar\"/>, <xref linkend=\"man.gbp.pull\"/>, " "<xref linkend=\"man.gbp.push\"/>, <xref linkend=\"man.gbp.tag\"/>, " "<citerefentry> <refentrytitle>git-pbuilder</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>, <xref linkend=\"man.gbp.conf\"/>, " "&man.seealso.common;" msgstr "" #. type: Content of: <title> #: manpages/man.conffiles.xml:1 msgid "CONFIGURATION FILES" msgstr "" #. type: Content of: <para> #: manpages/man.conffiles.xml:2 msgid "" "Several <filename>gbp.conf</filename> files are parsed to set defaults for " "the above command-line arguments. See the <xref linkend=\"man.gbp.conf\"/> " "manpage for details." msgstr "" #. type: Content of: outside any tag (error?) #: manpages/man.seealso.xml:1 msgid "" "<citerefentry> <refentrytitle>debuild</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>, <citerefentry> " "<refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, " "<citerefentry> <refentrytitle>pristine-tar</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>, <ulink " "url=\"file:///usr/share/doc/git-buildpackage/manual-html/index.html\"> " "<citetitle>The Git-Buildpackage Manual</citetitle></ulink>" msgstr ""