# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2023-10-29 17:49+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: ../dgit.1:2 ../dgit.7:1 #, no-wrap msgid "dgit" msgstr "" #. type: TH #: ../dgit.1:2 ../dgit.7:1 #, no-wrap msgid "Debian Project" msgstr "" #. type: =head1 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1 #: ../dgit-maint-bpo.7.pod:1 ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1 #: ../git-debpush.1.pod:1 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: ../dgit.1:5 msgid "dgit - git integration with the Debian archive" msgstr "" #. type: =head1 #: ../dgit.1:6 ../git-debpush.1.pod:5 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: ../dgit.1:10 msgid "" "B [I] B [I] I [I] [B<./" ">IBI]" msgstr "" #. type: Plain text #: ../dgit.1:14 msgid "B [I] B|B [I] [I]" msgstr "" #. type: Plain text #: ../dgit.1:18 msgid "" "B [I] B|B|B [I]" msgstr "" #. type: Plain text #: ../dgit.1:22 msgid "B [I] B|B [I]" msgstr "" #. type: Plain text #: ../dgit.1:26 msgid "B [I] B|B [I] [I]" msgstr "" #. type: Plain text #: ../dgit.1:30 msgid "" "B [I] B|B IB<:>I " "[I]" msgstr "" #. type: Plain text #: ../dgit.1:33 msgid "B [I] I ..." msgstr "" #. type: =head1 #: ../dgit.1:33 ../git-debpush.1.pod:9 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: ../dgit.1:41 msgid "" "B allows you to treat the Debian archive as if it were a git " "repository. Conversely, it allows Debian to publish the source of its " "packages as git branches, in a format which is directly useable by ordinary " "people." msgstr "" #. type: Plain text #: ../dgit.1:44 msgid "This is the command line reference. Please read the tutorial(s):" msgstr "" #. type: tbl table #: ../dgit.1:46 #, no-wrap msgid "dgit-user(7)" msgstr "" #. type: tbl table #: ../dgit.1:46 #, no-wrap msgid "for users: edit, build and share packages" msgstr "" #. type: tbl table #: ../dgit.1:47 #, no-wrap msgid "dgit-nmu-simple(7)" msgstr "" #. type: tbl table #: ../dgit.1:47 #, no-wrap msgid "for DDs: do a straightforward NMU" msgstr "" #. type: tbl table #: ../dgit.1:48 #, no-wrap msgid "dgit-maint-native(7)" msgstr "" #. type: tbl table #: ../dgit.1:48 #, no-wrap msgid "for maintainers of Debian-native packages" msgstr "" #. type: tbl table #: ../dgit.1:49 #, no-wrap msgid "dgit-maint-debrebase(7)" msgstr "" #. type: tbl table #: ../dgit.1:49 #, no-wrap msgid "for maintainers: a pure-git rebasish workflow" msgstr "" #. type: tbl table #: ../dgit.1:50 #, no-wrap msgid "dgit-maint-merge(7)" msgstr "" #. type: tbl table #: ../dgit.1:50 #, no-wrap msgid "for maintainers: a pure-git merging workflow" msgstr "" #. type: tbl table #: ../dgit.1:51 #, no-wrap msgid "dgit-maint-gbp(7)" msgstr "" #. type: tbl table #: ../dgit.1:51 #, no-wrap msgid "for maintainers already using git-buildpackage" msgstr "" #. type: tbl table #: ../dgit.1:52 #, no-wrap msgid "dgit-sponsorship(7)" msgstr "" #. type: tbl table #: ../dgit.1:52 #, no-wrap msgid "for sponsors and sponsored contributors" msgstr "" #. type: tbl table #: ../dgit.1:53 #, no-wrap msgid "dgit-downstream-dsc(7)" msgstr "" #. type: tbl table #: ../dgit.1:53 #, no-wrap msgid "setting up dgit push for a new distro" msgstr "" #. type: Plain text #: ../dgit.1:60 msgid "" "See B for detailed information about the data model, common " "problems likely to arise with certain kinds of package, etc." msgstr "" #. type: SH #: ../dgit.1:60 #, no-wrap msgid "OPERATIONS" msgstr "" #. type: TP #: ../dgit.1:61 #, no-wrap msgid "B I [I] [B<./>IBI]" msgstr "" #. type: Plain text #: ../dgit.1:74 msgid "" "Consults the archive and dgit-repos to construct the git view of history for " "I in I (B by default) in a new directory (named B<./" ">I by default); also, downloads any necessary orig tarballs." msgstr "" #. type: Plain text #: ../dgit.1:85 msgid "" "The suite's git tip is left on the local branch BI ready for " "work, and on the corresponding dgit remote tracking branch. The B " "remote will be set up to point to the package's dgit-repos tree for the " "distro to which I belongs." msgstr "" #. type: Plain text #: ../dgit.1:90 msgid "" "I may be a combination of several underlying suites in the form " "IB<,>I...; see COMBINED SUITES in dgit(7)." msgstr "" #. type: Plain text #: ../dgit.1:97 msgid "" "For your convenience, the B remote will be set up from the " "package's Vcs-Git field, if there is one - but note that in the general case " "the history found there may be different to or even disjoint from dgit's " "view. (See also dgit update-vcs-git.)" msgstr "" #. type: TP #: ../dgit.1:97 #, no-wrap msgid "B [I]" msgstr "" #. type: Plain text #: ../dgit.1:110 msgid "" "Consults the archive and git-repos to update the git view of history for a " "specific suite (and downloads any necessary orig tarballs), and updates the " "remote tracking branch BI. If the current branch " "is BI then dgit fetch defaults to I; otherwise it " "parses debian/changelog and uses the suite specified there. suite may be a " "combined suite, as for clone." msgstr "" #. type: TP #: ../dgit.1:110 #, no-wrap msgid "B [I]" msgstr "" #. type: Plain text #: ../dgit.1:116 msgid "" "Does dgit fetch, and then merges the new head of the remote tracking branch " "BI into the current branch." msgstr "" #. type: TP #: ../dgit.1:116 #, no-wrap msgid "B I" msgstr "" #. type: Plain text #: ../dgit.1:120 msgid "Checks out the local branch BI." msgstr "" #. type: Plain text #: ../dgit.1:127 msgid "" "If the branch does not exist, dgit checkout creates it, and sets it up the " "same way as dgit clone would. In that case, if the archive remote tracking " "branch does not exist, dgit checkout will do a dgit fetch first." msgstr "" #. type: Plain text #: ../dgit.1:132 msgid "" "NB: dgit checkout will only do a fetch if it has to. If you already have " "the suite branch, and want to merge your branch with updates from the " "archive, use dgit pull." msgstr "" #. type: Plain text #: ../dgit.1:137 msgid "" "dgit checkout will normally need to access the archive server, to " "canonicalise the provided suite name. The exception is if you specify the " "canonical name, and the branch (or tracking branch) already exists." msgstr "" #. type: TP #: ../dgit.1:137 #, no-wrap msgid "B ..." msgstr "" #. type: Plain text #: ../dgit.1:146 msgid "" "Runs B with some suitable options. Options and arguments " "after build will be passed on to dpkg-buildpackage. It is not necessary to " "use dgit build when using dgit; it is OK to use any approach which ensures " "that the generated source package corresponds to the relevant git commit." msgstr "" #. type: Plain text #: ../dgit.1:148 ../dgit.1:196 ../dgit.1:236 msgid "Tagging, signing and actually uploading should be left to dgit push." msgstr "" #. type: Plain text #: ../dgit.1:152 msgid "" "dgit's build operations access the network, to get the -v option right. See " "-v, below." msgstr "" #. type: TP #: ../dgit.1:152 #, no-wrap msgid "B ..." msgstr "" #. type: Plain text #: ../dgit.1:161 msgid "" "Builds the source package, and a changes file for a prospective source-only " "upload, using B. The output is left in " "IB<_>IB<.dsc> and IB<_>IB<_source." "changes>." msgstr "" #. type: Plain text #: ../dgit.1:164 msgid "" "Tagging, signing and actually uploading should be left to dgit push-source, " "or dgit push." msgstr "" #. type: TP #: ../dgit.1:164 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:168 msgid "" "Cleans the current working tree (according to the --clean= option in force)." msgstr "" #. type: TP #: ../dgit.1:168 #, no-wrap msgid "B [I|B<.>] [B<-->] [I]" msgstr "" #. type: TQ #: ../dgit.1:170 #, no-wrap msgid "B [IB<.>] B<->" msgstr "" #. type: Plain text #: ../dgit.1:175 msgid "" "Sets up, or updates the url of, the vcs-git remote, and (unless B<-> was " "specified) runs git fetch on it." msgstr "" #. type: Plain text #: ../dgit.1:182 msgid "" "By default, the Vcs-Git field of the .dsc from Debian sid is used, as that " "is probably most up to date. Another suite may be specified, or B<.> to " "indicate that the Vcs-Git of the cwd's debian/control should be used instead." msgstr "" #. type: TP #: ../dgit.1:182 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:185 ../dgit.1:1350 msgid "Print a usage summary." msgstr "" #. type: TP #: ../dgit.1:185 #, no-wrap msgid "B ..." msgstr "" #. type: Plain text #: ../dgit.1:194 msgid "" "Constructs the source package, uses B to do a binary build, and uses " "mergechanges to merge the source and binary changes files. Options and " "arguments after sbuild will be passed on to sbuild. The output is left in " "IB<_>IB<_multi.changes>." msgstr "" #. type: TP #: ../dgit.1:196 #, no-wrap msgid "B [I]" msgstr "" #. type: Plain text #: ../dgit.1:204 msgid "" "Constructs the source package, uses B to do a binary build, and " "uses mergechanges to merge the source and binary changes files. The output " "is left in IB<_>IB<_multi.changes>." msgstr "" #. type: Plain text #: ../dgit.1:207 msgid "" "You should ensure that your dgit --build-products-dir setting matches your " "pbuilder --buildresult." msgstr "" #. type: Plain text #: ../dgit.1:213 msgid "" "The I are passed to pbuilder using its --debbuildopts option. " "If you want to pass other options to pbuilder, use the B<--pbuilder:> dgit " "option as described below (remember that dgit options should appear between " "B and B)." msgstr "" #. type: Plain text #: ../dgit.1:219 msgid "" "You should ensure that in your pbuilderrc you do B have the setting " "B as this may cause trouble." msgstr "" #. type: TP #: ../dgit.1:219 #, no-wrap msgid "B [I]" msgstr "" #. type: Plain text #: ../dgit.1:225 msgid "Like B, but uses B instead of B" msgstr "" #. type: TP #: ../dgit.1:225 #, no-wrap msgid "B ..." msgstr "" #. type: Plain text #: ../dgit.1:231 msgid "" "Runs B with some suitable options. Options and arguments " "after gbp-build will be passed on to git-buildpackage." msgstr "" #. type: Plain text #: ../dgit.1:234 msgid "" "By default this uses --quilt=gbp, so HEAD should be a git-buildpackage style " "branch, not a patches-applied branch." msgstr "" #. type: TP #: ../dgit.1:236 #, no-wrap msgid "B [I]" msgstr "" #. type: Plain text #: ../dgit.1:241 msgid "" "Does an `upload': sends the current HEAD to dgit-repos (as git commits), and " "to the archive (as a source package, built by this command)." msgstr "" #. type: Plain text #: ../dgit.1:245 msgid "" "This is the usual way to upload to Debian. It is like saying \"update the " "source code in the archive to match my git HEAD, and let the autobuilders do " "the rest.\"" msgstr "" #. type: Plain text #: ../dgit.1:256 msgid "" "In more detail: dgit push-source builds a source package from HEAD. It then " "pushes the HEAD to the suite's dgit-repos branch, adjusts the .changes to " "include any .origs which the archive lacks and exclude .origs which the " "archive has (so -sa and -sd are not needed when building for dgit push), " "makes a signed git tag, edits the .dsc to contain the dgit metadata field, " "runs debsign to sign the upload (.dsc and .changes), pushes the signed tag, " "and finally uses dput to upload the .changes to the archive." msgstr "" #. type: Plain text #: ../dgit.1:260 msgid "" "dgit push always uses the package, suite and version specified in the debian/" "changelog and the .dsc, which must agree. If the command line specifies a " "suite then that must match too." msgstr "" #. type: Plain text #: ../dgit.1:265 msgid "" "When used on a git-debrebase branch, dgit calls git-debrebase to prepare the " "branch for source package upload and push." msgstr "" #. type: Plain text #: ../dgit.1:269 msgid "" "With B<-C>, dgit push-source performs a dgit push-built, additionally " "ensuring that no binary packages are uploaded." msgstr "" #. type: TP #: ../dgit.1:269 #, no-wrap msgid "B [I]" msgstr "" #. type: Plain text #: ../dgit.1:276 msgid "" "Does an `upload' of a previously built package, possibly including " "binaries. Sends the current HEAD to dgit-repos (as git commits); and, sends " "the previously built source package and binaries to the archive." msgstr "" #. type: Plain text #: ../dgit.1:283 msgid "" "The package must already have been built ready for upload, with the .dsc " "and .changes left in the parent directory. It is normally best to do the " "build with dgit too (e.g. with dgit sbuild): some existing build tools pass " "unhelpful options to dpkg-source et al by default, which can result in the " "built source package not being identical to the git tree." msgstr "" #. type: Plain text #: ../dgit.1:288 msgid "" "dgit will check that the .dsc corresponds exactly to the current HEAD, " "ensuring that all users, whether of the dgit git view, or of the traditional " "archive, see the same source package." msgstr "" #. type: TP #: ../dgit.1:288 #, no-wrap msgid "B|B IB<:>I [I]" msgstr "" #. type: Plain text #: ../dgit.1:295 msgid "" "Pushes the contents of the specified directory on a remote machine. This is " "like running dgit push on build-host with src-dir as the current directory; " "however, signing operations are done on the invoking host. This allows you " "to do a push when the system which has the source code (and any built " "binaries) has no access to the key:" msgstr "" #. type: =item #: ../dgit.1:298 ../dgit-maint-merge.7.pod:464 #, no-wrap msgid "1." msgstr "" #. type: tbl table #: ../dgit.1:298 #, no-wrap msgid "Clone on build host (dgit clone)" msgstr "" #. type: =item #: ../dgit.1:299 ../dgit-maint-merge.7.pod:468 #, no-wrap msgid "2." msgstr "" #. type: tbl table #: ../dgit.1:299 #, no-wrap msgid "Edit code on build host (edit, git commit)" msgstr "" #. type: =item #: ../dgit.1:300 ../dgit-maint-merge.7.pod:473 #, no-wrap msgid "3." msgstr "" #. type: tbl table #: ../dgit.1:300 #, no-wrap msgid "Build package on build host (dgit build)" msgstr "" #. type: tbl table #: ../dgit.1:301 #, no-wrap msgid "4." msgstr "" #. type: tbl table #: ../dgit.1:301 #, no-wrap msgid "Test package on build host or elsewhere (dpkg -i, test)" msgstr "" #. type: tbl table #: ../dgit.1:302 #, no-wrap msgid "5." msgstr "" #. type: tbl table #: ../dgit.1:302 #, no-wrap msgid "Upload by invoking dgit rpush on host with your GPG key." msgstr "" #. type: Plain text #: ../dgit.1:308 msgid "" "However, the build-host must be able to ssh to the dgit repos. If this is " "not already the case, you must organise it separately, for example by the " "use of ssh agent forwarding." msgstr "" #. type: Plain text #: ../dgit.1:312 msgid "" "The remaining arguments are treated just as dgit push-source or dgit push-" "built would handle them." msgstr "" #. type: Plain text #: ../dgit.1:317 msgid "" "build-host and build-dir can be passed as separate arguments; this is " "assumed to be the case if the first argument contains no : (except perhaps " "one in [ ], to support IPv6 address literals)." msgstr "" #. type: Plain text #: ../dgit.1:321 msgid "" "You will need similar enough versions of dgit on the build-host and the " "invocation host. The build-host needs gnupg installed, with your public key " "in its keyring (but not your private key, obviously)." msgstr "" #. type: TP #: ../dgit.1:321 #, no-wrap msgid "B|B I<...>" msgstr "" #. type: Plain text #: ../dgit.1:332 msgid "" "Configurable aliases for B and B. These " "aliases will in the future change to mean B and B, and therefore they currently generate a warning." msgstr "" #. type: Plain text #: ../dgit.1:336 msgid "" "The behaviour of dgit push is controlled by the B " "git config option:" msgstr "" #. type: tbl table #: ../dgit.1:338 #, no-wrap msgid "B" msgstr "" #. type: tbl table #: ../dgit.1:338 #, no-wrap msgid "runs B" msgstr "" #. type: tbl table #: ../dgit.1:338 #, no-wrap msgid "future default" msgstr "" #. type: tbl table #: ../dgit.1:339 #, no-wrap msgid "B" msgstr "" #. type: tbl table #: ../dgit.1:339 #, no-wrap msgid "and runs B" msgstr "" #. type: tbl table #: ../dgit.1:340 #, no-wrap msgid "B" msgstr "" #. type: tbl table #: ../dgit.1:340 #, no-wrap msgid "warns, and runs B" msgstr "" #. type: tbl table #: ../dgit.1:340 #, no-wrap msgid "current default" msgstr "" #. type: tbl table #: ../dgit.1:341 #, no-wrap msgid "B" msgstr "" #. type: tbl table #: ../dgit.1:341 #, no-wrap msgid "fails" msgstr "" #. type: Plain text #: ../dgit.1:352 msgid "" "For dgit rpush, the behaviour is controlled by B, " "falling back to B if that is not set. Because " "dgit rpush is not typically run in a git working tree, only global git " "config options (and B<-c> command line options) are relevant." msgstr "" #. type: Plain text #: ../dgit.1:362 msgid "" "These settings can safely be passed to older dgit (via B<-c);> the value " "B will be supported indefinitely. This should be used in scripts " "that need to work with both old versions of dgit (that don't have B) and new versions (where B is the default)." msgstr "" #. type: TP #: ../dgit.1:362 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:378 msgid "" "Configure the current working tree the way that dgit clone would have set it " "up. Like running B, B and " "B (but only does each thing if dgit is configured to do " "it automatically). You can use these in any git repository, not just ones " "used with the other dgit operations. Does B run B (as " "that requires Debian packaging information)." msgstr "" #. type: TP #: ../dgit.1:378 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:384 msgid "" "Set the working tree's user.name and user.email from the distro-specific " "dgit configuration (BIB<.user-name> and B<.user-" "email>), or DEBFULLNAME or DEBEMAIL." msgstr "" #. type: TP #: ../dgit.1:384 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:390 msgid "" "Configures a git merge helper for the file B which uses " "B." msgstr "" #. type: TP #: ../dgit.1:390 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:405 msgid "" "Set up the working tree's B<.git/info/attributes> to disable all " "transforming attributes for all files. This is done by defining a macro " "attribute, B and applying it to B<*>. For why, see " "B in B. Note that only attributes affecting the " "working tree are suppressed. git-archive may remain exciting." msgstr "" #. type: Plain text #: ../dgit.1:413 msgid "" "If there is an existing macro attribute line B<[attr]dgit-defuse-attrs> in ." "git/info/attributes, but it is insufficient, because it was made by an " "earlier version of dgit and git has since introduced new transforming " "attributes, this modifies the macro to disable the newer transformations." msgstr "" #. type: Plain text #: ../dgit.1:424 msgid "" "(If there is already a macro attribute line B<[attr]dgit-defuse-attrs> in ." "git/info/attributes which does what dgit requires (whatever files it " "effects), this operation does nothing further. This fact can be used to " "defeat or partially defeat dgit setup-gitattributes and hence dgit setup-new-" "tree.)" msgstr "" #. type: TP #: ../dgit.1:424 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:431 msgid "" "`3.0 (quilt)' format source packages need changes representing not only in-" "tree but also as patches in debian/patches. dgit quilt-fixup checks whether " "this has been done; if not, dgit will make appropriate patches in debian/" "patches and also commit the resulting changes to git." msgstr "" #. type: Plain text #: ../dgit.1:433 msgid "This is normally done automatically by dgit build and dgit push." msgstr "" #. type: Plain text #: ../dgit.1:439 msgid "" "dgit will try to turn each relevant commit in your git history into a new " "quilt patch. dgit cannot convert nontrivial merges, or certain other kinds " "of more exotic history. If dgit can't find a suitable linearisation of your " "history, by default it will fail, but you can ask it to generate a single " "squashed patch instead." msgstr "" #. type: Plain text #: ../dgit.1:448 msgid "" "When used with a git-debrebase branch, dgit will ask git-debrebase to " "prepare patches. However, dgit can make patches in some situations where " "git-debrebase fails, so dgit quilt-fixup can be useful in its own right. To " "always use dgit's own patch generator instead of git-debrebase make-patches, " "pass --git-debrebase=true to dgit." msgstr "" #. type: Plain text #: ../dgit.1:453 msgid "See B in B." msgstr "" #. type: TP #: ../dgit.1:453 #, no-wrap msgid "B [I] I<../path/to/.dsc> [B<+>|B<..>]branch" msgstr "" #. type: Plain text #: ../dgit.1:459 msgid "" "Import a Debian-format source package, specified by its .dsc, into git, the " "way dgit fetch would do." msgstr "" #. type: Plain text #: ../dgit.1:470 msgid "" "This does about half the work of dgit fetch: it will convert the .dsc into a " "new, orphan git branch. Since dgit has no access to a corresponding source " "package archive or knowledge of the history it does not consider whether " "this version is newer than any previous import or corresponding git " "branches; and it therefore does not make a pseudomerge to bind the import " "into any existing git history." msgstr "" #. type: Plain text #: ../dgit.1:480 msgid "" "Because a .dsc can contain a Dgit field naming a git commit (which you might " "not have), and specifying where to find that commit (and any history rewrite " "table), import-dsc might need online access. If this is a problem (or " "dgit's efforts to find the commit fail), consider --no-chase-dsc-distro or --" "force-import-dsc-with-dgit-field." msgstr "" #. type: Plain text #: ../dgit.1:482 msgid "There is only one sub-option:" msgstr "" #. type: Plain text #: ../dgit.1:488 msgid "" "B<--require-valid-signature> causes dgit to insist that the signature on " "the .dsc is valid (using the same criteria as dpkg-source -x). Otherwise, " "dgit tries to verify the signature but the outcome is reported only as " "messages to stderr." msgstr "" #. type: Plain text #: ../dgit.1:507 msgid "" "If I is prefixed with B<+> then if it already exists, it will be " "simply overwritten, no matter its existing contents. If I is " "prefixed with B<..> then if it already exists and dgit actually imports the " "dsc (rather than simply reading the git commit out of the Dgit field), dgit " "will make a pseudomerge so that the result is necessarily fast forward from " "the existing branch. Otherwise, if I already exists, dgit will stop " "with an error message." msgstr "" #. type: Plain text #: ../dgit.1:511 msgid "If I does not start with refs/, refs/heads/ is prepended." msgstr "" #. type: TP #: ../dgit.1:511 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:514 msgid "Prints version information and exits." msgstr "" #. type: TP #: ../dgit.1:514 #, no-wrap msgid "BI< destdir>" msgstr "" #. type: Plain text #: ../dgit.1:518 msgid "" "Tries to fetch a copy of the source code for the dgit-repos-server, as " "actually being used on the dgit git server, as a git tree." msgstr "" #. type: TP #: ../dgit.1:518 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:523 msgid "" "Prints the url used by dgit clone-dgit-repos-server. This is hopefully " "suitable for use as a git remote url. It may not be useable in a browser." msgstr "" #. type: TP #: ../dgit.1:523 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:530 msgid "" "Prints the -i and -I arguments which must be passed to dpkg-souce to cause " "it to exclude exactly the .git directory and nothing else. The separate " "arguments are unquoted, separated by spaces, and do not contain spaces." msgstr "" #. type: TP #: ../dgit.1:530 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../dgit.1:541 msgid "" "Constructs a tree-ish approximating the patches-unapplied state of your 3.0 " "(quilt) package, and prints the git object name to stdout. This requires " "appropriate .orig tarballs. This tree object is identical to your .origs as " "regards upstream files. The contents of the debian subdirectory is not " "interesting and should not be inspected; except that debian/patches will be " "identical to your HEAD." msgstr "" #. type: Plain text #: ../dgit.1:548 msgid "" "To make this operate off-line, the access configuration key which is used to " "determine the build-products-dir is the uncanonicalised version of the suite " "name from the changelog, or (of course) dgit.default.build-products-dir. " "See ACCESS CONFIGURATION, below." msgstr "" #. type: Plain text #: ../dgit.1:550 msgid "This function is primarily provided for the benefit of git-debrebase." msgstr "" #. type: =head1 #: ../dgit.1:550 ../git-debrebase.1.pod:473 #, no-wrap msgid "OPTIONS" msgstr "" #. type: TP #: ../dgit.1:551 #, no-wrap msgid "B<-k>I" msgstr "" #. type: Plain text #: ../dgit.1:560 msgid "" "Use I for signing the tag and the upload. The default comes from the " "distro's B config setting (see CONFIGURATION, below), or failing " "that, the uploader trailer line in debian/changelog." msgstr "" #. type: TP #: ../dgit.1:560 #, no-wrap msgid "B<--no-sign>" msgstr "" #. type: Plain text #: ../dgit.1:563 msgid "does not sign tags or uploads (meaningful only with push)." msgstr "" #. type: TP #: ../dgit.1:564 #, no-wrap msgid "B<-p>I" msgstr "" #. type: Plain text #: ../dgit.1:570 msgid "" "Specifies that we should process source package I rather than " "looking in debian/control or debian/changelog. Valid with dgit fetch and " "dgit pull, only." msgstr "" #. type: TP #: ../dgit.1:570 #, no-wrap msgid "B<--clean=git> | B<-wg>" msgstr "" #. type: Plain text #: ../dgit.1:576 msgid "" "Use B to clean the working tree, rather than running the " "package's rules clean target." msgstr "" #. type: Plain text #: ../dgit.1:579 msgid "" "This will delete all files which are not tracked by git. (Including any " "files you forgot to git add.)" msgstr "" #. type: Plain text #: ../dgit.1:584 msgid "" "B<--clean=>I<...> options other than dpkg-source are useful when the " "package's clean target is troublesome, or to avoid needing the build-" "dependencies." msgstr "" #. type: Plain text #: ../dgit.1:591 msgid "" "dgit will only actually clean the tree if it needs to (because it needs to " "build the source package or binaries from your working tree). Otherwise it " "will just check that there are no untracked unignored files. See --" "clean=git[-ff],always, below." msgstr "" #. type: TP #: ../dgit.1:591 #, no-wrap msgid "B<--clean=git-ff> | B<-wgf>" msgstr "" #. type: Plain text #: ../dgit.1:600 msgid "" "Use B to clean the working tree. Like git clean -xdf but " "it also removes any subdirectories containing different git trees (which " "only unusual packages are likely to create)." msgstr "" #. type: TP #: ../dgit.1:600 #, no-wrap msgid "B<--clean=git>[B<-ff>]B<,always> | B<-wga> | B<-wgfa>" msgstr "" #. type: Plain text #: ../dgit.1:604 msgid "" "Like --clean=git, but always does the clean and not just a check, deleting " "any untracked un-ignored files." msgstr "" #. type: TP #: ../dgit.1:604 #, no-wrap msgid "B<--clean=check> | B<--clean=check,ignores> | B<-wc> | B<-wci>" msgstr "" #. type: Plain text #: ../dgit.1:610 msgid "" "Merely check that the tree is clean (does not contain uncommitted files). " "Avoids running rules clean, and can avoid needing the build-dependencies." msgstr "" #. type: Plain text #: ../dgit.1:621 msgid "" "With B<,ignores> or B<-wci>, untracked files covered by .gitignore are " "tolerated, so only files which show up as B in git status (ie, ones you " "maybe forgot to git add) are treated as a problem." msgstr "" #. type: TP #: ../dgit.1:621 #, no-wrap msgid "B<--clean=none> | B<-wn>" msgstr "" #. type: Plain text #: ../dgit.1:629 msgid "" "Do not clean the tree, nor check that it is clean. Avoids running rules " "clean, and can avoid needing the build-dependencies. If there are files " "which are not in git, or if the build creates such files, a subsequent dgit " "push will fail." msgstr "" #. type: TP #: ../dgit.1:629 #, no-wrap msgid "B<--clean=dpkg-source>[B<-d>] | B<-wd> | B<-wdd>" msgstr "" #. type: Plain text #: ../dgit.1:634 msgid "" "Use dpkg-buildpackage to do the clean, so that the source package is cleaned " "by dpkg-source running the package's clean target. --clean=dpkg-source is " "the default." msgstr "" #. type: Plain text #: ../dgit.1:638 msgid "Without the extra B, requires the package's build dependencies." msgstr "" #. type: Plain text #: ../dgit.1:648 msgid "" "With B<...>-d or B<-wdd>, the build-dependencies are not checked (due to " "passing B<-d> to dpkg-buildpackage), which violates policy, but may work in " "practice." msgstr "" #. type: Plain text #: ../dgit.1:655 msgid "" "The rules clean target will only be run if it is needed: when dgit is going " "to build source or binary packages from your working tree, rather than from " "your git branch (for example because of --include-dirty or because the " "binary package build uses your working tree)." msgstr "" #. type: Plain text #: ../dgit.1:665 msgid "" "In all cases, dgit will check that there are (after rules clean, if " "applicable) no untracked un-ignored files, in case these are files you " "forgot to git add. (Except that this check is not done for a `3.0 (quilt)' " "package when dgit has to apply patches, dirtily, to the working tree.) If " "your package does not have a good .gitignore you will probably need --" "clean=dpkg-source,no-check aka -wdn." msgstr "" #. type: TP #: ../dgit.1:665 #, no-wrap msgid "B<--clean=dpkg-source>[B<-d>]B<,no-check> | B<-wdn> | B<-wddn>" msgstr "" #. type: Plain text #: ../dgit.1:669 msgid "" "Like --clean=dpkg-source, but does not care about untracked un-ignored files." msgstr "" #. type: TP #: ../dgit.1:669 #, no-wrap msgid "B<--clean=dpkg-source>[B<-d>]B<,all-check> | B<-wda> | B<-wdda>" msgstr "" #. type: Plain text #: ../dgit.1:674 msgid "" "Like --clean=dpkg-source, but fails even on ignored untracked files. This " "could perhaps be used to detect bugs in your rules clean target." msgstr "" #. type: TP #: ../dgit.1:674 #, no-wrap msgid "B<-N> | B<--new>" msgstr "" #. type: Plain text #: ../dgit.1:680 msgid "" "The package is, or may be, new in this suite. Without this, dgit will " "refuse to push. Needing --new is not unusual; for example, it is frequently " "needed for uploading to Debian experimental." msgstr "" #. type: Plain text #: ../dgit.1:686 msgid "" "Note that dgit may be unable to access the git history for an entirely new " "package which has not been accepted by the archive. So for an entirely new " "package you need to properly coordinate with anyone else who might upload." msgstr "" #. type: TP #: ../dgit.1:686 #, no-wrap msgid "B<--include-dirty>" msgstr "" #. type: Plain text #: ../dgit.1:694 msgid "" "Do not complain if the working tree does not match your git HEAD, and when " "building, include the changes from your working tree. This can be useful " "with build, if you plan to commit later. (dgit push will still ensure that " "the .dsc you upload and the git tree you push are identical, so this option " "won't make broken pushes.)" msgstr "" #. type: Plain text #: ../dgit.1:706 msgid "" "Note that this does B prevent dgit from cleaning your tree, so if the " "changes in your working tree are in the form of untracked files, those might " "still be deleted, especially with --clean=git. If you want to include " "untracked files in the build, you can use --clean=none or --clean=dpkg-" "source[-d] in addition to --include-dirty. Note that this combination can " "fail if the untracked files are under I." msgstr "" #. type: TP #: ../dgit.1:706 #, no-wrap msgid "B<--ignore-dirty>" msgstr "" #. type: Plain text #: ../dgit.1:709 msgid "Deprecated alias for --include-dirty." msgstr "" #. type: TP #: ../dgit.1:709 #, no-wrap msgid "B<--overwrite>[=I]" msgstr "" #. type: Plain text #: ../dgit.1:720 msgid "" "Declare that your HEAD really does contain all the (wanted) changes from all " "versions listed in its changelog; or, all (wanted) changes from I. This promise is needed when your git branch is not a descendant " "of the version in the archive according to the git revision history." msgstr "" #. type: Plain text #: ../dgit.1:727 msgid "" "It is safer not to specify I, and usually it's not " "needed. Just say B<--overwrite>, unless you know what you are doing." msgstr "" #. type: Plain text #: ../dgit.1:733 msgid "" "This option is useful if you are the maintainer, and you have incorporated " "NMU changes into your own git workflow in a way that doesn't make your " "branch a fast forward from the NMU. It can also be useful when there was an " "upload made without dgit since the most recent upload made with dgit." msgstr "" #. type: Plain text #: ../dgit.1:739 msgid "" "This option is also usually necessary the first time a package is pushed " "with dgit push to a particular suite. See BI<*>B<(7)>." msgstr "" #. type: Plain text #: ../dgit.1:753 msgid "" "If I is not specified, dgit will check that the version in " "the archive is mentioned in your debian/changelog. (This will avoid losing " "changes, even with B<--overwrite>, unless someone committed to git a " "finalised changelog entry, and then made later changes to that version.) If " "I is specified, it ought to be the version currently in " "the archive." msgstr "" #. type: Plain text #: ../dgit.1:759 msgid "" "dgit push --overwrite will, if necessary, make a pseudo-merge (that is, " "something that looks like the result of git merge -s ours) to stitch the " "archive's version into your own git history, so that your push is a fast " "forward from the archive." msgstr "" #. type: Plain text #: ../dgit.1:766 msgid "" "(In quilt mode B, B, B or B*, implying a " "split between the dgit view and the maintainer view, the pseudo-merge will " "appear only in the dgit view; B<--split-view=always> can be used to force " "that behaviour, e.g. in other quilt modes.)" msgstr "" #. type: TP #: ../dgit.1:766 #, no-wrap msgid "B<--delayed>=I" msgstr "" #. type: Plain text #: ../dgit.1:769 msgid "Upload to a DELAYED queue." msgstr "" #. type: Plain text #: ../dgit.1:779 msgid "" "B If the maintainer responds by cancelling your upload from the " "queue, and does not make an upload of their own, this will not rewind the " "git branch on the dgit git server. Other dgit users will then see your push " "(with a warning message from dgit) even though the maintainer wanted to " "abolish it. Such users might unwittingly reintroduce your changes." msgstr "" #. type: Plain text #: ../dgit.1:784 msgid "" "If this situation arises, someone should make a suitable dgit push to update " "the contents of dgit-repos to a version without the controversial changes." msgstr "" #. type: TP #: ../dgit.1:784 #, no-wrap msgid "B<--no-chase-dsc-distro>" msgstr "" #. type: Plain text #: ../dgit.1:790 msgid "" "Tells dgit not to look online for additional git repositories containing " "information about a particular .dsc being imported. Chasing is the default." msgstr "" #. type: Plain text #: ../dgit.1:800 msgid "" "For most operations (such as fetch and pull), disabling chasing means dgit " "will access only the git server for the distro you are directly working " "with, even if the .dsc was copied verbatim from another distro. For import-" "dsc, disabling chasing means dgit will work completely offline." msgstr "" #. type: Plain text #: ../dgit.1:808 msgid "" "Disabling chasing can be hazardous: if the .dsc names a git commit which has " "been rewritten by those in charge of the distro, this option may prevent " "that rewrite from being effective. Also, it can mean that dgit fails to " "find necessary git commits." msgstr "" #. type: TP #: ../dgit.1:808 #, no-wrap msgid "B<--save-dgit-view=>I|I" msgstr "" #. type: Plain text #: ../dgit.1:818 msgid "" "Specifies that when split view is in operation, and dgit calculates (or " "looks up in its cache) a dgit view corresponding to your HEAD, the dgit " "view will be left in I. The specified ref is unconditionally " "overwritten, so don't specify a branch you want to keep." msgstr "" #. type: Plain text #: ../dgit.1:822 msgid "" "This option is effective only with the following operations: quilt-fixup; " "push; all builds. And it is only effective when split view is actually in " "operation." msgstr "" #. type: Plain text #: ../dgit.1:826 msgid "" "If ref does not start with refs/ it is taken to be a branch - i.e. refs/" "heads/ is prepended." msgstr "" #. type: Plain text #: ../dgit.1:830 msgid "B<--dgit-view-save> is a deprecated alias for --save-dgit-view." msgstr "" #. type: TP #: ../dgit.1:830 #, no-wrap msgid "B<--deliberately->I" msgstr "" #. type: Plain text #: ../dgit.1:844 msgid "" "Declare that you are deliberately doing I. This can be used to " "override safety catches, including safety catches which relate to distro-" "specific policies. The use of --deliberately is declared and published in " "the signed tags generated for you by dgit, so that the archive software can " "give effect to your intent, and for the benefit of humans looking at the " "history. The meanings of Is understood in the context of Debian " "are discussed below:" msgstr "" #. type: TP #: ../dgit.1:844 #, no-wrap msgid "B<--deliberately-not-fast-forward>" msgstr "" #. type: Plain text #: ../dgit.1:850 msgid "" "Declare that you are deliberately rewriting history. This could be because " "your branch is not fast forward from the dgit server history, or not fast " "forward from a locally-synthesised dsc import." msgstr "" #. type: Plain text #: ../dgit.1:856 msgid "" "When pushing to Debian, use this only when you are making a renewed upload " "of an entirely new source package whose previous version was not accepted " "for release from NEW because of problems with copyright or " "redistributibility; or, exceptionally, for the very first upload with dgit." msgstr "" #. type: Plain text #: ../dgit.1:867 msgid "" "When split view is in operation, this also prevents the construction by dgit " "of a pseudomerge to make the dgit view fast forwarding. Normally only one " "of --overwrite (which creates a suitable pseudomerge) and --deliberately-" "not-fast-forward (which suppresses the pseudomerge and the fast forward " "checks) should be needed; --overwrite is usually better." msgstr "" #. type: TP #: ../dgit.1:867 #, no-wrap msgid "B<--deliberately-include-questionable-history>" msgstr "" #. type: Plain text #: ../dgit.1:876 msgid "" "Declare that you are deliberately including, in the git history of your " "current push, history which contains a previously-submitted version of this " "package which was not approved (or has not yet been approved) by the " "ftpmasters. When pushing to Debian, only use this option after verifying " "that: none of the rejected-from-NEW (or never-accepted) versions in the git " "history of your current push, were rejected by ftpmaster for copyright or " "redistributability reasons." msgstr "" #. type: TP #: ../dgit.1:876 #, no-wrap msgid "B<--deliberately-fresh-repo>" msgstr "" #. type: Plain text #: ../dgit.1:881 msgid "" "Declare that you are deliberately rewriting history and want to throw away " "the existing repo. Not relevant when pushing to Debian, as the Debian " "server will do this automatically when necessary." msgstr "" #. type: =item #: ../dgit.1:881 ../git-debpush.1.pod:114 #, no-wrap msgid "B<--quilt=linear>" msgstr "" #. type: Plain text #: ../dgit.1:888 msgid "" "With format `3.0 (quilt)', insist on a linear patch stack: one new patch for " "each relevant commit. If such a stack cannot be generated, fail. This is " "the default for Debian." msgstr "" #. type: Plain text #: ../dgit.1:893 msgid "" "HEAD should be a series of plain commits (not touching debian/patches/), and " "pseudomerges, with as ancestor a patches-applied branch." msgstr "" #. type: TP #: ../dgit.1:893 #, no-wrap msgid "B<--quilt=try-linear>" msgstr "" #. type: Plain text #: ../dgit.1:903 msgid "" "With format `3.0 (quilt)', prefer a linear patch stack (as with --" "quilt=linear) but if that doesn't seem possible, try to generate a single " "squashed patch for all the changes made in git (as with --quilt=smash). " "This is not a good idea for an NMU in Debian." msgstr "" #. type: =item #: ../dgit.1:903 ../git-debpush.1.pod:120 #, no-wrap msgid "B<--quilt=smash>" msgstr "" #. type: Plain text #: ../dgit.1:909 msgid "" "With format `3.0 (quilt)', assume patches-applied (as obtained from dgit " "clone) and generate a single additional patch for all the changes made in " "git. This is not a good idea for an NMU in Debian." msgstr "" #. type: Plain text #: ../dgit.1:915 msgid "" "(If HEAD has any in-tree patches already, they must apply cleanly. This " "will be the case for any trees produced by dgit fetch or clone; if you do " "not change the upstream version nor make changes in debian/patches, it will " "remain true.)" msgstr "" #. type: TP #: ../dgit.1:915 #, no-wrap msgid "B<--quilt=single>" msgstr "" #. type: Plain text #: ../dgit.1:922 msgid "" "With format `3.0 (quilt)', assume patches-applied (as obtained from dgit " "clone), delete all the existing patches, and then generate a single patch " "for all the changes made in git. This is not a good idea for an NMU in " "Debian." msgstr "" #. type: Plain text #: ../dgit.1:931 msgid "" "Use this instead of the B dpkg-source format option. " "That dpkg-source option cannot handle certain changes to the tree that dpkg-" "source otherwise permits, and in some cases it can generate strange source " "packages that dpkg-source appears to accept but which become corrupted when " "people later try to modify them." msgstr "" #. type: =item #: ../dgit.1:931 ../git-debpush.1.pod:131 #, no-wrap msgid "B<--quilt=nofix>" msgstr "" #. type: Plain text #: ../dgit.1:941 msgid "" "With format `3.0 (quilt)', assume patches-applied (as obtained from dgit " "clone), and check that the patch metadata is up to date. If it isn't, fail; " "you must then fix the metadata yourself somehow before pushing. (NB that " "dpkg-source --commit will not work because the dgit git tree does not have a " "B<.pc> directory.)" msgstr "" #. type: TP #: ../dgit.1:941 #, no-wrap msgid "B<--quilt=nocheck> | B<--no-quilt-fixup>" msgstr "" #. type: Plain text #: ../dgit.1:948 msgid "" "With format `3.0 (quilt)', assume that the tree is patches-applied (as " "obtained from dgit clone), and I that the patch metadata is up to " "date. If you use this option and the patch metadata is out of date, dgit " "push will fail." msgstr "" #. type: TP #: ../dgit.1:948 #, no-wrap msgid "B<-->[B]B | B<-->[B]B | B<--quilt=unapplied> | B<-->[B]B[B<+git>|B<+tarball>]" msgstr "" #. type: Plain text #: ../dgit.1:955 msgid "" "Tell dgit that you are using a nearly-dgit-compatible git branch, aka a " "B, and do not want your branch changed by dgit." msgstr "" #. type: Plain text #: ../dgit.1:959 msgid "" "These quilt modes are known as B. See --split-view, " "below." msgstr "" #. type: Plain text #: ../dgit.1:967 msgid "" "B<--gbp> (short for B<--quilt=gbp>) is for use with git-buildpackage. Your " "HEAD is expected to be a patches-unapplied git branch, except that it might " "contain changes to upstream .gitignore files. This is the default for dgit " "gbp-build." msgstr "" #. type: Plain text #: ../dgit.1:975 msgid "" "B<--dpm> (short for B<--quilt=dpm>) is for use with git-dpm. Your HEAD is " "expected to be a patches-applied git branch, except that it might contain " "changes to upstream .gitignore files." msgstr "" #. type: Plain text #: ../dgit.1:980 msgid "" "B<--quilt=unapplied> specifies that your HEAD is a patches-unapplied git " "branch (and that any changes to upstream .gitignore files are represented as " "patches in debian/patches)." msgstr "" #. type: Plain text #: ../dgit.1:994 msgid "" "B<--quilt=baredebian> (or its alias B<--quilt=baredebian+git>) specifies " "that your HEAD contains only a debian/ directory, with any changes to " "upstream files represented as patches in debian/patches. The upstream " "source must be available in git, by default, in a suitably named git tag; " "see --upstream-commitish. In this mode, dgit cannot check that all edited " "upstream files are properly represented as patches: dgit relies on debian/" "patches being correct." msgstr "" #. type: Plain text #: ../dgit.1:1005 msgid "" "B<--quilt=baredebian+tarball> is like --quilt=baredebian, but is used when " "there is no appropriate upstream git history. To construct the dgit view, " "dgit will import your orig tarballs' contents into git. In this mode, dgit " "cannot check that the upstream parts of your upload correspond to what you " "intend: dgit relies on the right orig tarball(s) existing, and debian/" "patches being correct." msgstr "" #. type: Plain text #: ../dgit.1:1023 msgid "" "With --quilt=gbp|dpm|unapplied|baredebian*, dgit push (or precursors like " "quilt-fixup and build) will automatically generate a conversion of your git " "branch into the right form. dgit push will push the dgit-compatible form " "(the B) to the dgit git server. The dgit view will be visible " "to you in the dgit remote tracking branches, but your own branch will not be " "modified. dgit push will create a tag BI for the " "maintainer view, and the dgit tag BI for the dgit " "view. dgit quilt-fixup will merely do some checks, and cache the maintainer " "view." msgstr "" #. type: Plain text #: ../dgit.1:1032 msgid "" "B This is because it is not always possible to tell: a " "patches-unapplied git branch of a package with one patch, for example, looks " "very like a patches-applied branch where the user has used git revert to " "undo the patch, expecting to actually revert it. However, if you fail to " "specify the right --quilt option, and you aren't too lucky, dgit will notice " "the problem and stop, with a useful hint." msgstr "" #. type: TP #: ../dgit.1:1032 #, no-wrap msgid "B<-d>I | B<--distro=>I" msgstr "" #. type: Plain text #: ../dgit.1:1041 msgid "" "Specifies that the suite to be operated on is part of distro I. " "This overrides the default value found from the git config option BIB<.distro>. The only effect is that other configuration " "variables (used for accessing the archive and dgit-repos) used are BIB<.*>." msgstr "" #. type: Plain text #: ../dgit.1:1047 msgid "" "If your suite is part of a distro that dgit already knows about, you can use " "this option to make dgit work even if your dgit doesn't know about the " "suite. For example, specifying B<-ddebian> will work when the suite is an " "unknown suite in the Debian archive." msgstr "" #. type: Plain text #: ../dgit.1:1052 msgid "" "To define a new distro it is necessary to define methods and URLs for " "fetching (and, for dgit push, altering) a variety of information both in the " "archive and in dgit-repos. How to set this up is not yet documented." msgstr "" #. type: TP #: ../dgit.1:1052 #, no-wrap msgid "B<--split-view=auto>|B|B" msgstr "" #. type: Plain text #: ../dgit.1:1057 msgid "" "Controls whether dgit operates a split view, separating your own branch (as " "Debian maintainer) from that shown to users of dgit clone and dgit fetch." msgstr "" #. type: Plain text #: ../dgit.1:1065 msgid "" "When split view is in operation dgit will not make or merge any commits onto " "your own branch. Specifically, only the dgit view will contain dgit's " "pseudomerges, which bring into the git history previous uploads made with " "dgit push, and any commits in debian/patches required to make a correct `3.0 " "(quilt)' source package." msgstr "" #. type: Plain text #: ../dgit.1:1071 msgid "" "B is the default, and splits the view only when needed: i.e., when you " "are working with a `3.0 (quilt)' source package and a splitting quilt mode: " "--[quilt=]gbp, dpm, unpatched or baredebian*." msgstr "" #. type: Plain text #: ../dgit.1:1074 msgid "" "B splits the view regardless of the source format and the quilt mode." msgstr "" #. type: Plain text #: ../dgit.1:1077 msgid "B will cause dgit to fail if split view is needed." msgstr "" #. type: Plain text #: ../dgit.1:1085 msgid "" "When split view is in operation, the dgit view is visible in your local git " "clone, but only in refs specific to dgit: notably BI and BIBI." msgstr "" #. type: Plain text #: ../dgit.1:1088 msgid "" "Note that split view does not affect dgit fetch, and is not compatible with " "dgit pull." msgstr "" #. type: TP #: ../dgit.1:1088 #, no-wrap msgid "B<-C>I" msgstr "" #. type: Plain text #: ../dgit.1:1093 msgid "" "Specifies the .changes file which is to be uploaded. By default dgit push " "looks for a single .changes file in the parent directory whose filename " "suggests it is for the right package and version." msgstr "" #. type: Plain text #: ../dgit.1:1102 msgid "" "If the specified I pathname contains slashes, the directory " "part is also used as the value for B<--build-products-dir>; otherwise, the " "changes file is expected in that directory (by default, in B<..>)." msgstr "" #. type: TP #: ../dgit.1:1102 #, no-wrap msgid "B<--upstream-commitish=>I" msgstr "" #. type: Plain text #: ../dgit.1:1110 msgid "" "For use with --quilt=baredebian only. Specifies the commit containing the " "upstream source. This commit must be identical to your .orig tarball. The " "default is to look for one of the git tags IB< v>IB< upstream/>I " "(in that order), where U is the upstream version." msgstr "" #. type: TP #: ../dgit.1:1110 #, no-wrap msgid "B<--rm-old-changes>" msgstr "" #. type: Plain text #: ../dgit.1:1122 msgid "" "When doing a build, delete any changes files matching " "IB<_>IB<_*.changes> before starting. This ensures that " "dgit push (and dgit sbuild) will be able to unambiguously identify the " "relevant changes files from the most recent build, even if there have been " "previous builds with different tools or options. The default is not to " "remove, but B<--no-rm-old-changes> can be used to override a previous --rm-" "old-changes or the .rm-old-changes configuration setting." msgstr "" #. type: Plain text #: ../dgit.1:1125 msgid "" "Note that B will always find the right .changes, " "regardless of this option." msgstr "" #. type: TP #: ../dgit.1:1125 #, no-wrap msgid "B<--build-products-dir=>I" msgstr "" #. type: Plain text #: ../dgit.1:1129 msgid "" "Specifies where to find and create tarballs, binary packages, source " "packages, .changes files, and so on." msgstr "" #. type: Plain text #: ../dgit.1:1132 msgid "By default, dgit uses the parent directory (B<..>)." msgstr "" #. type: Plain text #: ../dgit.1:1141 msgid "" "Changing this setting may necessitate moving .orig tarballs to the new " "directory, so it is probably best to use the B configuration setting (see CONFIGURATION, below) which this command " "line option overrides)." msgstr "" #. type: TP #: ../dgit.1:1141 #, no-wrap msgid "B<--no-rm-on-error>" msgstr "" #. type: Plain text #: ../dgit.1:1144 msgid "Do not delete the destination directory if clone fails." msgstr "" #. type: TP #: ../dgit.1:1144 #, no-wrap msgid "B<--dep14tag>" msgstr "" #. type: Plain text #: ../dgit.1:1151 msgid "" "Generates a DEP-14 tag (eg BI) as well as a dgit tag (eg " "BI). This is the default." msgstr "" #. type: TP #: ../dgit.1:1151 #, no-wrap msgid "B<--no-dep14tag>" msgstr "" #. type: Plain text #: ../dgit.1:1154 msgid "Do not generate a DEP-14 tag, except when split view is in operation." msgstr "" #. type: TP #: ../dgit.1:1154 #, no-wrap msgid "B<--always-dep14tag>" msgstr "" #. type: Plain text #: ../dgit.1:1157 msgid "Obsolete alias for --dep14tag, retained for compatibility." msgstr "" #. type: TP #: ../dgit.1:1157 #, no-wrap msgid "B<-D>" msgstr "" #. type: Plain text #: ../dgit.1:1161 msgid "" "Prints debugging information to stderr. Repeating the option produces more " "output (currently, up to -DDDD is meaningfully different)." msgstr "" #. type: TP #: ../dgit.1:1161 #, no-wrap msgid "B<-c>IB<=>I" msgstr "" #. type: Plain text #: ../dgit.1:1165 msgid "" "Specifies a git configuration option, to be used for this run. dgit itself " "is also controlled by git configuration options." msgstr "" #. type: TP #: ../dgit.1:1165 #, no-wrap msgid "B<-v>I|B<_> | B<--since-version=>versionI<|>B<_>" msgstr "" #. type: Plain text #: ../dgit.1:1174 msgid "" "Specifies the B<-v>I option to pass to dpkg-genchanges, during " "builds. Changes (from debian/changelog) since this version will be included " "in the built changes file, and hence in the upload. If this option is not " "specified, dgit will query the archive and use the latest version uploaded " "to the intended suite." msgstr "" #. type: Plain text #: ../dgit.1:1180 msgid "" "Specifying B<_> inhibits this, so that no -v option will be passed to dpkg-" "genchanges (and as a result, only the last stanza from debian/changelog will " "be used for the build and upload)." msgstr "" #. type: TP #: ../dgit.1:1180 #, no-wrap msgid "B<-m>I" msgstr "" #. type: Plain text #: ../dgit.1:1183 msgid "Passed to dpkg-genchanges (eventually)." msgstr "" #. type: TP #: ../dgit.1:1183 #, no-wrap msgid "B<--ch:>I config when B, " "or when pushing and B." msgstr "" #. type: TP #: ../dgit.1:1584 #, no-wrap msgid "BIB<.git-url>" msgstr "" #. type: TP #: ../dgit.1:1586 #, no-wrap msgid "BIB<.git-url>[B<-suffix>]" msgstr "" #. type: TP #: ../dgit.1:1588 #, no-wrap msgid "BIB<.git-proto>" msgstr "" #. type: TP #: ../dgit.1:1590 #, no-wrap msgid "BIB<.git-path>" msgstr "" #. type: TP #: ../dgit.1:1592 #, no-wrap msgid "BIB<.git-check> B|B|B|B" msgstr "" #. type: TP #: ../dgit.1:1594 #, no-wrap msgid "BIB<.git-check-suffix>" msgstr "" #. type: TP #: ../dgit.1:1596 #, no-wrap msgid "BIB<.policy-query-supported-ssh>I< >BI<|>BI<|>B" msgstr "" #. type: TP #: ../dgit.1:1598 #, no-wrap msgid "BIB<.diverts.divert> B|BI" msgstr "" #. type: TP #: ../dgit.1:1600 #, no-wrap msgid "BIB<.git-create>I< >BI<|>B" msgstr "" #. type: TP #: ../dgit.1:1602 #, no-wrap msgid "BIB<.archive-query> B | BI | BI | BIB<@>IB<:>IB< >|B< aptget:>" msgstr "" #. type: TP #: ../dgit.1:1604 #, no-wrap msgid "BIB<.archive-query->(B|B|B)" msgstr "" #. type: TP #: ../dgit.1:1606 #, no-wrap msgid "BIB<.madison-distro>" msgstr "" #. type: TP #: ../dgit.1:1608 #, no-wrap msgid "BIB<.archive-query-default-component>" msgstr "" #. type: TP #: ../dgit.1:1610 #, no-wrap msgid "BIB<.dep14tag> B|B[|B]" msgstr "" #. type: TP #: ../dgit.1:1612 #, no-wrap msgid "BIB<.ssh>" msgstr "" #. type: TP #: ../dgit.1:1614 #, no-wrap msgid "BIB<.sshpsql-dbname>" msgstr "" #. type: TP #: ../dgit.1:1616 #, no-wrap msgid "BIB<.>(B|B)B<->(B|B|B)" msgstr "" #. type: TP #: ../dgit.1:1618 #, no-wrap msgid "BIB<.backports-quirk>" msgstr "" #. type: TP #: ../dgit.1:1620 #, no-wrap msgid "BIB<.rewrite-map-enable>" msgstr "" #. type: TP #: ../dgit.1:1622 #, no-wrap msgid "BIB<.source-only-uploads> B|B|B|B" msgstr "" #. type: TP #: ../dgit.1:1624 #, no-wrap msgid "B" msgstr "" #. type: TP #: ../dgit.1:1626 #, no-wrap msgid "BI" msgstr "" #. type: TP #: ../dgit.1:1628 #, no-wrap msgid "B" msgstr "" #. type: TP #: ../dgit.1:1630 #, no-wrap msgid "B" msgstr "" #. type: TP #: ../dgit.1:1632 #, no-wrap msgid "BI< >BI<|>BI<|>B" msgstr "" #. type: Plain text #: ../dgit.1:1636 msgid "Controls the behaviour of B." msgstr "" #. type: TP #: ../dgit.1:1636 #, no-wrap msgid "B I[B<;>...]" msgstr "" #. type: SH #: ../dgit.1:1638 #, no-wrap msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: TP #: ../dgit.1:1639 #, no-wrap msgid "B, B" msgstr "" #. type: Plain text #: ../dgit.1:1648 msgid "" "specify an alternative default program (and perhaps arguments) to use " "instead of ssh. DGIT_SSH is consulted first and may contain arguments; if " "it contains any whitespace will be passed to the shell. GIT_SSH specifies " "just the program; no arguments can be specified, so dgit interprets it the " "same way as git does. See also the --ssh= and --ssh: options." msgstr "" #. type: TP #: ../dgit.1:1648 #, no-wrap msgid "B, B" msgstr "" #. type: Plain text #: ../dgit.1:1652 msgid "" "Default git user.email and user.name for new trees. See B." msgstr "" #. type: TP #: ../dgit.1:1652 #, no-wrap msgid "B, B..., B, B, [B]B, B" msgstr "" #. type: Plain text #: ../dgit.1:1657 msgid "" "and other subprograms and modules used by dgit are affected by various " "environment variables. Consult the documentation for those programs for " "details." msgstr "" #. type: SH #: ../dgit.1:1657 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: ../dgit.1:1664 msgid "" "There should be a `dgit rebase-prep' command or some such to turn a fast-" "forwarding branch containing pseudo-merges back into a rebasing patch " "stack. It might have to leave a note for a future dgit push." msgstr "" #. type: Plain text #: ../dgit.1:1670 msgid "" "If the dgit push fails halfway through, it is not necessarily restartable " "and idempotent. It would be good to check that the proposed signing key is " "available before starting work." msgstr "" #. type: Plain text #: ../dgit.1:1675 msgid "" "dgit's build functions, and dgit push, may make changes to your current " "HEAD. Sadly this is necessary for packages in the `3.0 (quilt)' source " "format. This is ultimately due to what I consider design problems in quilt " "and dpkg-source." msgstr "" #. type: Plain text #: ../dgit.1:1680 msgid "" "--dry-run does not always work properly, as not doing some of the git " "fetches may result in subsequent actions being different. Doing a non-dry-" "run dgit fetch first will help. --damp-run is likely to work much better." msgstr "" #. type: =head1 #: ../dgit.1:1680 ../dgit.7:23 ../dgit-user.7.pod:447 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:125 #: ../dgit-maint-merge.7.pod:509 ../dgit-maint-gbp.7.pod:139 #: ../dgit-maint-debrebase.7.pod:792 ../dgit-downstream-dsc.7.pod:352 #: ../dgit-sponsorship.7.pod:322 ../dgit-maint-bpo.7.pod:140 #: ../git-debrebase.1.pod:643 ../git-debrebase.5.pod:678 #: ../git-debpush.1.pod:261 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: ../dgit.1:1689 msgid "" "B(7), B(7), B(1), B(1), B(1), B(1), B(1), B(1)," msgstr "" #. type: Plain text #: ../dgit.1:1690 msgid "https://browse.dgit.debian.org/" msgstr ""