# 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: 2024-04-13 21:12+0800\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:1389 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<--collab-non-dgit>" msgstr "" #. type: Plain text #: ../dgit.1:716 msgid "" "Make B, behave more suitably for collaborating (using shared git " "history) with git-using co-developers who aren't using dgit." msgstr "" #. type: Plain text #: ../dgit.1:722 msgid "" "With this option, dgit won't mind that the git history you're using isn't " "necessarily fast forward from the dgit view; instead, it will rely on the " "changelog to prevent accidentally overwriting changes." msgstr "" #. type: Plain text #: ../dgit.1:731 msgid "" "And, the synthetic commits needed to make the dgit git history fast forward " "will appear only on the dgit git server, and local dgit suite branches, not " "on your own main branch. So they won't end up in the maintainer-visible " "history, when you push your own branch to make a merge request." msgstr "" #. type: Plain text #: ../dgit.1:734 msgid "This is equivalent to B<--split-view=always --trust-changelog>." msgstr "" #. type: TP #: ../dgit.1:734 #, no-wrap msgid "B<--trust-changelog> | B<--overwrite>=I" msgstr "" #. type: Plain text #: ../dgit.1:745 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:751 msgid "" "It is safer to specify B<--trust-changelog>, than B<--overwrite=>I, and usually the latter is not needed." msgstr "" #. type: Plain text #: ../dgit.1:758 msgid "" "B<--trust-changelog> 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:764 msgid "" "It 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:773 msgid "" "With B<--trust-changelog> dgit will check that the version in the archive is " "mentioned in your debian/changelog. (This will avoid losing changes, unless " "someone committed to git a finalised changelog entry, and then made later " "changes to that version.)" msgstr "" #. type: Plain text #: ../dgit.1:779 msgid "" "With B<--overwrite=>I that version ought to be the version " "currently in the archive, and it will be unconditionally overwritten, " "regardless of what's in the changelog." msgstr "" #. type: Plain text #: ../dgit.1:785 msgid "" "These options 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:792 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: Plain text #: ../dgit.1:796 msgid "" "B<--overwrite> without a version number is an obsolete way of specifying B<--" "trust-changelog>." msgstr "" #. type: TP #: ../dgit.1:796 #, no-wrap msgid "B<--delayed>=I" msgstr "" #. type: Plain text #: ../dgit.1:799 msgid "Upload to a DELAYED queue." msgstr "" #. type: Plain text #: ../dgit.1:809 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:814 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:814 #, no-wrap msgid "B<--no-chase-dsc-distro>" msgstr "" #. type: Plain text #: ../dgit.1:820 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:830 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:838 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:838 #, no-wrap msgid "B<--save-dgit-view=>I|I" msgstr "" #. type: Plain text #: ../dgit.1:848 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:852 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:856 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:860 msgid "B<--dgit-view-save> is a deprecated alias for --save-dgit-view." msgstr "" #. type: TP #: ../dgit.1:860 #, no-wrap msgid "B<--deliberately->I" msgstr "" #. type: Plain text #: ../dgit.1:874 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:874 #, no-wrap msgid "B<--deliberately-not-fast-forward>" msgstr "" #. type: Plain text #: ../dgit.1:880 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:886 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:897 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 --trust-changelog (which creates a suitable pseudomerge) and --" "deliberately-not-fast-forward (which suppresses the pseudomerge and the fast " "forward checks) should be needed; --trust-changelog is usually better." msgstr "" #. type: TP #: ../dgit.1:897 #, no-wrap msgid "B<--deliberately-include-questionable-history>" msgstr "" #. type: Plain text #: ../dgit.1:906 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:906 #, no-wrap msgid "B<--deliberately-fresh-repo>" msgstr "" #. type: Plain text #: ../dgit.1:911 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:911 ../git-debpush.1.pod:114 #, no-wrap msgid "B<--quilt=linear>" msgstr "" #. type: Plain text #: ../dgit.1:918 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:923 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:923 #, no-wrap msgid "B<--quilt=try-linear>" msgstr "" #. type: Plain text #: ../dgit.1:933 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:933 ../git-debpush.1.pod:120 #, no-wrap msgid "B<--quilt=smash>" msgstr "" #. type: Plain text #: ../dgit.1:939 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:945 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:945 #, no-wrap msgid "B<--quilt=single>" msgstr "" #. type: Plain text #: ../dgit.1:952 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:961 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:961 ../git-debpush.1.pod:131 #, no-wrap msgid "B<--quilt=nofix>" msgstr "" #. type: Plain text #: ../dgit.1:971 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:971 #, no-wrap msgid "B<--quilt=nocheck> | B<--no-quilt-fixup>" msgstr "" #. type: Plain text #: ../dgit.1:978 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:978 #, 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:985 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:989 msgid "" "These quilt modes are known as B. See --split-view, " "below." msgstr "" #. type: Plain text #: ../dgit.1:997 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:1005 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:1010 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:1024 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:1035 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:1053 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:1062 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:1062 #, no-wrap msgid "B<-d>I | B<--distro=>I" msgstr "" #. type: Plain text #: ../dgit.1:1071 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:1077 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:1082 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:1082 #, no-wrap msgid "B<--split-view=auto>|B|B" msgstr "" #. type: Plain text #: ../dgit.1:1087 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:1095 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:1101 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:1104 msgid "" "B splits the view regardless of the source format and the quilt mode." msgstr "" #. type: Plain text #: ../dgit.1:1107 msgid "B will cause dgit to fail if split view is needed." msgstr "" #. type: Plain text #: ../dgit.1:1115 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:1118 msgid "" "Note that split view does not affect dgit fetch, and is not compatible with " "dgit pull." msgstr "" #. type: TP #: ../dgit.1:1118 #, no-wrap msgid "B<-C>I" msgstr "" #. type: Plain text #: ../dgit.1:1123 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:1132 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:1132 #, no-wrap msgid "B<--upstream-commitish=>I" msgstr "" #. type: Plain text #: ../dgit.1:1140 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:1140 #, no-wrap msgid "B<--rm-old-changes>" msgstr "" #. type: Plain text #: ../dgit.1:1152 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:1155 msgid "" "Note that B will always find the right .changes, " "regardless of this option." msgstr "" #. type: TP #: ../dgit.1:1155 #, no-wrap msgid "B<--build-products-dir=>I" msgstr "" #. type: Plain text #: ../dgit.1:1159 msgid "" "Specifies where to find and create tarballs, binary packages, source " "packages, .changes files, and so on." msgstr "" #. type: Plain text #: ../dgit.1:1162 msgid "By default, dgit uses the parent directory (B<..>)." msgstr "" #. type: Plain text #: ../dgit.1:1171 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:1171 #, no-wrap msgid "B<--no-rm-on-error>" msgstr "" #. type: Plain text #: ../dgit.1:1174 msgid "Do not delete the destination directory if clone fails." msgstr "" #. type: TP #: ../dgit.1:1174 #, no-wrap msgid "B<--dep14tag>" msgstr "" #. type: Plain text #: ../dgit.1:1181 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:1181 #, no-wrap msgid "B<--no-dep14tag>" msgstr "" #. type: Plain text #: ../dgit.1:1184 msgid "Do not generate a DEP-14 tag, except when split view is in operation." msgstr "" #. type: TP #: ../dgit.1:1184 #, no-wrap msgid "B<--always-dep14tag>" msgstr "" #. type: Plain text #: ../dgit.1:1187 msgid "Obsolete alias for --dep14tag, retained for compatibility." msgstr "" #. type: TP #: ../dgit.1:1187 #, no-wrap msgid "B<-D>" msgstr "" #. type: Plain text #: ../dgit.1:1191 msgid "" "Prints debugging information to stderr. Repeating the option produces more " "output (currently, up to -DDDD is meaningfully different)." msgstr "" #. type: TP #: ../dgit.1:1191 #, no-wrap msgid "B<--keep-playground>|B<--no--keep-playground>" msgstr "" #. type: Plain text #: ../dgit.1:1200 msgid "" "Controls whether to retain the \"playground\" working directory B<.git/dgit/" "unpack> even on success, for examination and debugging. The default is B<--" "no-keep-playground> which deletes the directory after a successful execution." msgstr "" #. type: TP #: ../dgit.1:1200 #, no-wrap msgid "B<-c>IB<=>I" msgstr "" #. type: Plain text #: ../dgit.1:1204 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:1204 #, no-wrap msgid "B<-v>I|B<_> | B<--since-version=>versionI<|>B<_>" msgstr "" #. type: Plain text #: ../dgit.1:1213 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:1219 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:1219 #, no-wrap msgid "B<-m>I" msgstr "" #. type: Plain text #: ../dgit.1:1222 msgid "Passed to dpkg-genchanges (eventually)." msgstr "" #. type: TP #: ../dgit.1:1222 #, no-wrap msgid "B<--ch:>I config when B, " "or when pushing and B." msgstr "" #. type: TP #: ../dgit.1:1623 #, no-wrap msgid "BIB<.git-url>" msgstr "" #. type: TP #: ../dgit.1:1625 #, no-wrap msgid "BIB<.git-url>[B<-suffix>]" msgstr "" #. type: TP #: ../dgit.1:1627 #, no-wrap msgid "BIB<.git-proto>" msgstr "" #. type: TP #: ../dgit.1:1629 #, no-wrap msgid "BIB<.git-path>" msgstr "" #. type: TP #: ../dgit.1:1631 #, no-wrap msgid "BIB<.git-check> B|B|B|B" msgstr "" #. type: TP #: ../dgit.1:1633 #, no-wrap msgid "BIB<.git-check-suffix>" msgstr "" #. type: TP #: ../dgit.1:1635 #, no-wrap msgid "BIB<.policy-query-supported-ssh>I< >BI<|>BI<|>B" msgstr "" #. type: TP #: ../dgit.1:1637 #, no-wrap msgid "BIB<.diverts.divert> B|BI" msgstr "" #. type: TP #: ../dgit.1:1639 #, no-wrap msgid "BIB<.git-create>I< >BI<|>B" msgstr "" #. type: TP #: ../dgit.1:1641 #, no-wrap msgid "BIB<.archive-query> B | BI | BI | BIB<@>IB<:>IB< >|B< aptget:>" msgstr "" #. type: TP #: ../dgit.1:1643 #, no-wrap msgid "BIB<.archive-query->(B|B|B)" msgstr "" #. type: TP #: ../dgit.1:1645 #, no-wrap msgid "BIB<.madison-distro>" msgstr "" #. type: TP #: ../dgit.1:1647 #, no-wrap msgid "BIB<.archive-query-default-component>" msgstr "" #. type: TP #: ../dgit.1:1649 #, no-wrap msgid "BIB<.dep14tag> B|B[|B]" msgstr "" #. type: TP #: ../dgit.1:1651 #, no-wrap msgid "BIB<.ssh>" msgstr "" #. type: TP #: ../dgit.1:1653 #, no-wrap msgid "BIB<.sshpsql-dbname>" msgstr "" #. type: TP #: ../dgit.1:1655 #, no-wrap msgid "BIB<.>(B|B)B<->(B|B|B)" msgstr "" #. type: TP #: ../dgit.1:1657 #, no-wrap msgid "BIB<.backports-quirk>" msgstr "" #. type: TP #: ../dgit.1:1659 #, no-wrap msgid "BIB<.rewrite-map-enable>" msgstr "" #. type: TP #: ../dgit.1:1661 #, no-wrap msgid "BIB<.source-only-uploads> B|B|B|B" msgstr "" #. type: TP #: ../dgit.1:1663 #, no-wrap msgid "B" msgstr "" #. type: TP #: ../dgit.1:1665 #, no-wrap msgid "BI" msgstr "" #. type: TP #: ../dgit.1:1667 #, no-wrap msgid "B" msgstr "" #. type: TP #: ../dgit.1:1669 #, no-wrap msgid "B" msgstr "" #. type: TP #: ../dgit.1:1671 #, no-wrap msgid "BI< >BI<|>BI<|>B" msgstr "" #. type: Plain text #: ../dgit.1:1675 msgid "Controls the behaviour of B." msgstr "" #. type: TP #: ../dgit.1:1675 #, no-wrap msgid "B I[B<;>...]" msgstr "" #. type: SH #: ../dgit.1:1677 #, no-wrap msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: TP #: ../dgit.1:1678 #, no-wrap msgid "B, B" msgstr "" #. type: Plain text #: ../dgit.1:1687 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:1687 #, no-wrap msgid "B, B" msgstr "" #. type: Plain text #: ../dgit.1:1691 msgid "" "Default git user.email and user.name for new trees. See B." msgstr "" #. type: TP #: ../dgit.1:1691 #, no-wrap msgid "B, B..., B, B, [B]B, B" msgstr "" #. type: Plain text #: ../dgit.1:1696 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:1696 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: ../dgit.1:1703 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:1709 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:1714 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:1719 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:1719 ../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:325 ../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:1728 msgid "" "B(7), B(7), B(1), B(1), B(1), B(1), B(1), B(1)," msgstr "" #. type: Plain text #: ../dgit.1:1729 msgid "https://browse.dgit.debian.org/" msgstr ""