diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | docs/Makefile | 7 | ||||
| -rw-r--r-- | docs/Makefile.lang | 33 | ||||
| -rw-r--r-- | docs/po/de.po | 9147 | ||||
| -rw-r--r-- | docs/po/gbp.pot | 9262 | ||||
| -rw-r--r-- | docs/po/po4a.cfg | 39 |
6 files changed, 18489 insertions, 0 deletions
@@ -15,6 +15,7 @@ nosetests.xml docs/*.1 docs/*.5 +docs/_gen/ docs/buildxref/ docs/manual-html/ docs/manpage.links diff --git a/docs/Makefile b/docs/Makefile index b867e198..30be4a78 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -98,3 +98,10 @@ $(VERSION_ENT): $(GBP_VERSION) clean: -rm -r $(MANUAL) -rm *.1 *.5 $(VERSION_ENT) + +po4a: + po4a -v -f po/po4a.cfg + +langs: po4a + $(MAKE) -C _gen/de -f ../../Makefile.lang + diff --git a/docs/Makefile.lang b/docs/Makefile.lang new file mode 100644 index 00000000..d92e23e3 --- /dev/null +++ b/docs/Makefile.lang @@ -0,0 +1,33 @@ +MANUAL = manual-html + +ENTS = \ + manpages/manpages.ent \ + manpages/man.common-options.ent \ + chapters/chapters.ent \ + version.ent \ + common.ent \ + $(NULL) + +all: $(MANUAL)/index.html + +manpages/manpages.ent: ../../manpages/manpages.ent + cp -f $< $@ + +manpages/man.common-options.ent: ../../manpages/man.common-options.ent + cp -f $< $@ + +chapters/chapters.ent: ../../chapters/chapters.ent + cp -f $< $@ + +version.ent: ../../version.ent + cp -f $< $@ + +common.ent: ../../common.ent + cp -f $< $@ + +$(MANUAL)/index.html: manual.xml chapters/*.xml manpages/*.xml $(ENTS) + mkdir -p $(MANUAL) + xsltproc -o $(MANUAL)/ /usr/share/gtk-doc/data/gtk-doc.xsl $< + cp /usr/share/gtk-doc/data/*.png \ + /usr/share/gtk-doc/data/*.css \ + $(MANUAL) diff --git a/docs/po/de.po b/docs/po/de.po new file mode 100644 index 00000000..ee0bb86b --- /dev/null +++ b/docs/po/de.po @@ -0,0 +1,9147 @@ +#. type: Content of: <book><bookinfo><title> +#: 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 Gnther." +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 " +"perfer 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 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 droppend 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 respository 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 to 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>commitish</replaceable></arg> <arg><option>--since=</" +"option><replaceable>commitish</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 " +"alread 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 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>committish</replaceable>" +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: manpages/gbp-dch.xml:207 +msgid "" +"Start reading commit messages at <replaceable>committish</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: Raphal 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 Raphal 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 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 branchs 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>COMMITISH</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>COMMITTISH</replaceable>" +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: manpages/gbp-rpm-ch.xml:159 +msgid "Start reading commit messages at <replaceable>COMMITTISH</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 "" diff --git a/docs/po/gbp.pot b/docs/po/gbp.pot new file mode 100644 index 00000000..d71bd41e --- /dev/null +++ b/docs/po/gbp.pot @@ -0,0 +1,9262 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: Content of: <book><bookinfo><title> +#: 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 perfer 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 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 droppend 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 respository 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 to 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>commitish</replaceable></arg> " +"<arg><option>--since=</option><replaceable>commitish</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 " +"alread 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 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>committish</replaceable>" +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: manpages/gbp-dch.xml:207 +msgid "" +"Start reading commit messages at <replaceable>committish</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 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 branchs 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>COMMITISH</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>COMMITTISH</replaceable>" +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: manpages/gbp-rpm-ch.xml:159 +msgid "Start reading commit messages at <replaceable>COMMITTISH</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 "" diff --git a/docs/po/po4a.cfg b/docs/po/po4a.cfg new file mode 100644 index 00000000..fd6b6d71 --- /dev/null +++ b/docs/po/po4a.cfg @@ -0,0 +1,39 @@ +[po_directory] po/ + +[options] --master-charset UTF-8 --keep 0 + +[type: docbook] manual.xml $lang:_gen/$lang/manual.xml +[type: docbook] copyright.xml $lang:_gen/$lang/copyright.xml + +[type: docbook] chapters/building.xml $lang:_gen/$lang/chapters/building.xml +[type: docbook] chapters/cfgfile.xml $lang:_gen/$lang/chapters/cfgfile.xml +[type: docbook] chapters/import.xml $lang:_gen/$lang/chapters/import.xml +[type: docbook] chapters/intro.xml $lang:_gen/$lang/chapters/intro.xml +[type: docbook] chapters/patches.xml $lang:_gen/$lang/chapters/patches.xml +[type: docbook] chapters/releases.xml $lang:_gen/$lang/chapters/releases.xml +[type: docbook] chapters/special.xml $lang:_gen/$lang/chapters/special.xml + +[type: docbook] manpages/gbp-buildpackage-rpm.xml $lang:_gen/$lang/manpages/gbp-buildpackage-rpm.xml +[type: docbook] manpages/gbp-buildpackage.xml $lang:_gen/$lang/manpages/gbp-buildpackage.xml +[type: docbook] manpages/gbp-clone.xml $lang:_gen/$lang/manpages/gbp-clone.xml +[type: docbook] manpages/gbp-config.xml $lang:_gen/$lang/manpages/gbp-config.xml +[type: docbook] manpages/gbp.conf.xml $lang:_gen/$lang/manpages/gbp.conf.xml +[type: docbook] manpages/gbp-create-remote-repo.xml $lang:_gen/$lang/manpages/gbp-create-remote-repo.xml +[type: docbook] manpages/gbp-dch.xml $lang:_gen/$lang/manpages/gbp-dch.xml +[type: docbook] manpages/gbp-export-orig.xml $lang:_gen/$lang/manpages/gbp-export-orig.xml +[type: docbook] manpages/gbp-import-dscs.xml $lang:_gen/$lang/manpages/gbp-import-dscs.xml +[type: docbook] manpages/gbp-import-dsc.xml $lang:_gen/$lang/manpages/gbp-import-dsc.xml +[type: docbook] manpages/gbp-import-orig.xml $lang:_gen/$lang/manpages/gbp-import-orig.xml +[type: docbook] manpages/gbp-import-ref.xml $lang:_gen/$lang/manpages/gbp-import-ref.xml +[type: docbook] manpages/gbp-import-srpm.xml $lang:_gen/$lang/manpages/gbp-import-srpm.xml +[type: docbook] manpages/gbp-pq-rpm.xml $lang:_gen/$lang/manpages/gbp-pq-rpm.xml +[type: docbook] manpages/gbp-pq.xml $lang:_gen/$lang/manpages/gbp-pq.xml +[type: docbook] manpages/gbp-pristine-tar.xml $lang:_gen/$lang/manpages/gbp-pristine-tar.xml +[type: docbook] manpages/gbp-pull.xml $lang:_gen/$lang/manpages/gbp-pull.xml +[type: docbook] manpages/gbp-push.xml $lang:_gen/$lang/manpages/gbp-push.xml +[type: docbook] manpages/gbp-rpm-ch.xml $lang:_gen/$lang/manpages/gbp-rpm-ch.xml +[type: docbook] manpages/gbp-setup-gitattributes.xml $lang:_gen/$lang/manpages/gbp-setup-gitattributes.xml +[type: docbook] manpages/gbp-tag.xml $lang:_gen/$lang/manpages/gbp-tag.xml +[type: docbook] manpages/gbp.xml $lang:_gen/$lang/manpages/gbp.xml +[type: docbook] manpages/man.conffiles.xml $lang:_gen/$lang/manpages/man.conffiles.xml +[type: docbook] manpages/man.seealso.xml $lang:_gen/$lang/manpages/man.seealso.xml |