po4a/dgit_1.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2018-10-04 01:04+0100\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: ../dgit.1:2 ../dgit.7:1
  21 #, no-wrap
  22 msgid "dgit"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: ../dgit.1:2 ../dgit.7:1
  27 #, no-wrap
  28 msgid "Debian Project"
  29 msgstr ""
  30
  31 #. type: =head1
  32 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
  33 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
  34 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
  35 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
  36 #: ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
  37 #, no-wrap
  38 msgid "NAME"
  39 msgstr ""
  40
  41 #. type: Plain text
  42 #: ../dgit.1:5
  43 msgid "dgit - git integration with the Debian archive"
  44 msgstr ""
  45
  46 #. type: SH
  47 #: ../dgit.1:6
  48 #, no-wrap
  49 msgid "SYNOPSIS"
  50 msgstr ""
  51
  52 #. type: Plain text
  53 #: ../dgit.1:10
  54 msgid ""
  55 "B<dgit> [I<dgit-opts>] B<clone> [I<dgit-opts>] I<package> [I<suite>] [B<./"
  56 ">I<dir|>B</>I<dir>]"
  57 msgstr ""
  58
  59 #. type: Plain text
  60 #: ../dgit.1:14
  61 msgid "B<dgit> [I<dgit-opts>] B<fetch>|B<pull> [I<dgit-opts>] [I<suite>]"
  62 msgstr ""
  63
  64 #. type: Plain text
  65 #: ../dgit.1:18
  66 msgid ""
  67 "B<dgit> [I<dgit-opts>] B<build>|B<sbuild>|B<build-source> [I<build-opts>]"
  68 msgstr ""
  69
  70 #. type: Plain text
  71 #: ../dgit.1:22
  72 msgid "B<dgit> [I<dgit-opts>] B<pbuilder>|B<cowbuilder> [I<debbuildopts>]"
  73 msgstr ""
  74
  75 #. type: Plain text
  76 #: ../dgit.1:26
  77 msgid "B<dgit> [I<dgit-opts>] B<push>|B<push-source> [I<dgit-opts>] [I<suite>]"
  78 msgstr ""
  79
  80 #. type: Plain text
  81 #: ../dgit.1:30
  82 msgid ""
  83 "B<dgit> [I<dgit-opts>] B<rpush> I<build-host>B<:>I<build-dir> [I<push args..."
  84 ">]"
  85 msgstr ""
  86
  87 #. type: Plain text
  88 #: ../dgit.1:33
  89 msgid "B<dgit> [I<dgit-opts>] I<action> ..."
  90 msgstr ""
  91
  92 #. type: SH
  93 #: ../dgit.1:33
  94 #, no-wrap
  95 msgid "DESCRIPTION"
  96 msgstr ""
  97
  98 #. type: Plain text
  99 #: ../dgit.1:41
 100 msgid ""
 101 "B<dgit> allows you to treat the Debian archive as if it were a git "
 102 "repository.  Conversely, it allows Debian to publish the source of its "
 103 "packages as git branches, in a format which is directly useable by ordinary "
 104 "people."
 105 msgstr ""
 106
 107 #. type: Plain text
 108 #: ../dgit.1:44
 109 msgid "This is the command line reference.  Please read the tutorial(s):"
 110 msgstr ""
 111
 112 #. type: tbl table
 113 #: ../dgit.1:46
 114 #, no-wrap
 115 msgid "dgit-user(7)"
 116 msgstr ""
 117
 118 #. type: tbl table
 119 #: ../dgit.1:46
 120 #, no-wrap
 121 msgid "for users: edit, build and share packages"
 122 msgstr ""
 123
 124 #. type: tbl table
 125 #: ../dgit.1:47
 126 #, no-wrap
 127 msgid "dgit-nmu-simple(7)"
 128 msgstr ""
 129
 130 #. type: tbl table
 131 #: ../dgit.1:47
 132 #, no-wrap
 133 msgid "for DDs: do a straightforward NMU"
 134 msgstr ""
 135
 136 #. type: tbl table
 137 #: ../dgit.1:48
 138 #, no-wrap
 139 msgid "dgit-maint-native(7)"
 140 msgstr ""
 141
 142 #. type: tbl table
 143 #: ../dgit.1:48
 144 #, no-wrap
 145 msgid "for maintainers of Debian-native packages"
 146 msgstr ""
 147
 148 #. type: tbl table
 149 #: ../dgit.1:49
 150 #, no-wrap
 151 msgid "dgit-maint-debrebase(7)"
 152 msgstr ""
 153
 154 #. type: tbl table
 155 #: ../dgit.1:49
 156 #, no-wrap
 157 msgid "for maintainers: a pure-git rebasish workflow"
 158 msgstr ""
 159
 160 #. type: tbl table
 161 #: ../dgit.1:50
 162 #, no-wrap
 163 msgid "dgit-maint-merge(7)"
 164 msgstr ""
 165
 166 #. type: tbl table
 167 #: ../dgit.1:50
 168 #, no-wrap
 169 msgid "for maintainers: a pure-git merging workflow"
 170 msgstr ""
 171
 172 #. type: tbl table
 173 #: ../dgit.1:51
 174 #, no-wrap
 175 msgid "dgit-maint-gbp(7)"
 176 msgstr ""
 177
 178 #. type: tbl table
 179 #: ../dgit.1:51
 180 #, no-wrap
 181 msgid "for maintainers already using git-buildpackage"
 182 msgstr ""
 183
 184 #. type: tbl table
 185 #: ../dgit.1:52
 186 #, no-wrap
 187 msgid "dgit-sponsorship(7)"
 188 msgstr ""
 189
 190 #. type: tbl table
 191 #: ../dgit.1:52
 192 #, no-wrap
 193 msgid "for sponsors and sponsored contributors"
 194 msgstr ""
 195
 196 #. type: tbl table
 197 #: ../dgit.1:53
 198 #, no-wrap
 199 msgid "dgit-downstream-dsc(7)"
 200 msgstr ""
 201
 202 #. type: tbl table
 203 #: ../dgit.1:53
 204 #, no-wrap
 205 msgid "setting up dgit push for a new distro"
 206 msgstr ""
 207
 208 #. type: Plain text
 209 #: ../dgit.1:60
 210 msgid ""
 211 "See B<dgit(7)> for detailed information about the data model, common "
 212 "problems likely to arise with certain kinds of package, etc."
 213 msgstr ""
 214
 215 #. type: SH
 216 #: ../dgit.1:60
 217 #, no-wrap
 218 msgid "OPERATIONS"
 219 msgstr ""
 220
 221 #. type: TP
 222 #: ../dgit.1:61
 223 #, no-wrap
 224 msgid "B<dgit clone> I<package> [I<suite>] [B<./>I<dir|>B</>I<dir>]"
 225 msgstr ""
 226
 227 #. type: Plain text
 228 #: ../dgit.1:74
 229 msgid ""
 230 "Consults the archive and dgit-repos to construct the git view of history for "
 231 "I<package> in I<suite> (B<sid> by default)  in a new directory (named B<./"
 232 ">I<package> by default); also, downloads any necessary orig tarballs."
 233 msgstr ""
 234
 235 #. type: Plain text
 236 #: ../dgit.1:85
 237 msgid ""
 238 "The suite's git tip is left on the local branch B<dgit/>I<suite> ready for "
 239 "work, and on the corresponding dgit remote tracking branch.  The B<origin> "
 240 "remote will be set up to point to the package's dgit-repos tree for the "
 241 "distro to which I<suite> belongs."
 242 msgstr ""
 243
 244 #. type: Plain text
 245 #: ../dgit.1:90
 246 msgid ""
 247 "I<suite> may be a combination of several underlying suites in the form "
 248 "I<mainsuite>B<,>I<subsuite>...; see COMBINED SUITES in dgit(7)."
 249 msgstr ""
 250
 251 #. type: Plain text
 252 #: ../dgit.1:97
 253 msgid ""
 254 "For your convenience, the B<vcs-git> remote will be set up from the "
 255 "package's Vcs-Git field, if there is one - but note that in the general case "
 256 "the history found there may be different to or even disjoint from dgit's "
 257 "view.  (See also dgit update-vcs-git.)"
 258 msgstr ""
 259
 260 #. type: TP
 261 #: ../dgit.1:97
 262 #, no-wrap
 263 msgid "B<dgit fetch> [I<suite>]"
 264 msgstr ""
 265
 266 #. type: Plain text
 267 #: ../dgit.1:110
 268 msgid ""
 269 "Consults the archive and git-repos to update the git view of history for a "
 270 "specific suite (and downloads any necessary orig tarballs), and updates the "
 271 "remote tracking branch B<remotes/dgit/dgit/>I<suite>.  If the current branch "
 272 "is B<dgit/>I<suite> then dgit fetch defaults to I<suite>; otherwise it "
 273 "parses debian/changelog and uses the suite specified there.  suite may be a "
 274 "combined suite, as for clone."
 275 msgstr ""
 276
 277 #. type: TP
 278 #: ../dgit.1:110
 279 #, no-wrap
 280 msgid "B<dgit pull> [I<suite>]"
 281 msgstr ""
 282
 283 #. type: Plain text
 284 #: ../dgit.1:116
 285 msgid ""
 286 "Does dgit fetch, and then merges the new head of the remote tracking branch "
 287 "B<remotes/dgit/dgit/>I<suite> into the current branch."
 288 msgstr ""
 289
 290 #. type: TP
 291 #: ../dgit.1:116
 292 #, no-wrap
 293 msgid "B<dgit checkout> I<suite>"
 294 msgstr ""
 295
 296 #. type: Plain text
 297 #: ../dgit.1:120
 298 msgid "Checks out the local branch B<dgit/>I<suite>."
 299 msgstr ""
 300
 301 #. type: Plain text
 302 #: ../dgit.1:127
 303 msgid ""
 304 "If the branch does not exist, dgit checkout creates it, and sets it up the "
 305 "same way as dgit clone would.  In that case, if the archive remote tracking "
 306 "branch does not exist, dgit checkout will do a dgit fetch first."
 307 msgstr ""
 308
 309 #. type: Plain text
 310 #: ../dgit.1:132
 311 msgid ""
 312 "NB: dgit checkout will only do a fetch if it has to.  If you already have "
 313 "the suite branch, and want to merge your branch with updates from the "
 314 "archive, use dgit pull."
 315 msgstr ""
 316
 317 #. type: Plain text
 318 #: ../dgit.1:137
 319 msgid ""
 320 "dgit checkout will normally need to aceess the archive server, to "
 321 "canonicalise the provided suite name.  The exception is if you specify the "
 322 "canonical name, and the branch (or tracking branch) already exists."
 323 msgstr ""
 324
 325 #. type: TP
 326 #: ../dgit.1:137
 327 #, no-wrap
 328 msgid "B<dgit build> ..."
 329 msgstr ""
 330
 331 #. type: Plain text
 332 #: ../dgit.1:146
 333 msgid ""
 334 "Runs B<dpkg-buildpackage> with some suitable options.  Options and arguments "
 335 "after build will be passed on to dpkg-buildpackage.  It is not necessary to "
 336 "use dgit build when using dgit; it is OK to use any approach which ensures "
 337 "that the generated source package corresponds to the relevant git commit."
 338 msgstr ""
 339
 340 #. type: Plain text
 341 #: ../dgit.1:148 ../dgit.1:200 ../dgit.1:240
 342 msgid "Tagging, signing and actually uploading should be left to dgit push."
 343 msgstr ""
 344
 345 #. type: Plain text
 346 #: ../dgit.1:152
 347 msgid ""
 348 "dgit's build operations access the the network, to get the -v option right.  "
 349 "See -v, below."
 350 msgstr ""
 351
 352 #. type: TP
 353 #: ../dgit.1:152
 354 #, no-wrap
 355 msgid "B<dgit build-source> ..."
 356 msgstr ""
 357
 358 #. type: Plain text
 359 #: ../dgit.1:161
 360 msgid ""
 361 "Builds the source package, and a changes file for a prospective source-only "
 362 "upload, using B<dpkg-source>.  The output is left in "
 363 "I<package>B<_>I<version>B<.dsc> and I<package>B<_>I<version>B<_source."
 364 "changes>."
 365 msgstr ""
 366
 367 #. type: Plain text
 368 #: ../dgit.1:164
 369 msgid ""
 370 "Tagging, signing and actually uploading should be left to dgit push-source, "
 371 "or dgit push."
 372 msgstr ""
 373
 374 #. type: TP
 375 #: ../dgit.1:164
 376 #, no-wrap
 377 msgid "B<dgit clean>"
 378 msgstr ""
 379
 380 #. type: Plain text
 381 #: ../dgit.1:168
 382 msgid ""
 383 "Cleans the current working tree (according to the --clean= option in force)."
 384 msgstr ""
 385
 386 #. type: TP
 387 #: ../dgit.1:168
 388 #, no-wrap
 389 msgid "B<dgit update-vcs-git> [I<suite>|B<.>] [B<-->] [I<git fetch options>]"
 390 msgstr ""
 391
 392 #. type: TQ
 393 #: ../dgit.1:170
 394 #, no-wrap
 395 msgid "B<dgit update-vcs-git> [I<suite|>B<.>] B<->"
 396 msgstr ""
 397
 398 #. type: Plain text
 399 #: ../dgit.1:175
 400 msgid ""
 401 "Sets up, or updates the url of, the vcs-git remote, and (unless B<-> was "
 402 "specified)  runs git fetch on it."
 403 msgstr ""
 404
 405 #. type: Plain text
 406 #: ../dgit.1:182
 407 msgid ""
 408 "By default, the Vcs-Git field of the .dsc from Debian sid is used, as that "
 409 "is probably most up to date.  Another suite may be specified, or B<.> to "
 410 "indicate that the Vcs-Git of the cwd's debian/control should be used instead."
 411 msgstr ""
 412
 413 #. type: TP
 414 #: ../dgit.1:182
 415 #, no-wrap
 416 msgid "B<dgit help>"
 417 msgstr ""
 418
 419 #. type: Plain text
 420 #: ../dgit.1:185 ../dgit.1:1123
 421 msgid "Print a usage summary."
 422 msgstr ""
 423
 424 #. type: TP
 425 #: ../dgit.1:185
 426 #, no-wrap
 427 msgid "B<dgit sbuild> ..."
 428 msgstr ""
 429
 430 #. type: Plain text
 431 #: ../dgit.1:194
 432 msgid ""
 433 "Constructs the source package, uses B<sbuild> to do a binary build, and uses "
 434 "mergechanges to merge the source and binary changes files.  Options and "
 435 "arguments after sbuild will be passed on to sbuild.  The output is left in "
 436 "I<package>B<_>I<version>B<_multi.changes>."
 437 msgstr ""
 438
 439 #. type: Plain text
 440 #: ../dgit.1:198
 441 msgid ""
 442 "Note that by default sbuild does not build arch-independent packages.  You "
 443 "probably want to pass -A, to request those."
 444 msgstr ""
 445
 446 #. type: TP
 447 #: ../dgit.1:200
 448 #, no-wrap
 449 msgid "B<dgit pbuilder> [I<debbuildopts>]"
 450 msgstr ""
 451
 452 #. type: Plain text
 453 #: ../dgit.1:208
 454 msgid ""
 455 "Constructs the source package, uses B<pbuilder> to do a binary build, and "
 456 "uses mergechanges to merge the source and binary changes files.  The output "
 457 "is left in I<package>B<_>I<version>B<_multi.changes>."
 458 msgstr ""
 459
 460 #. type: Plain text
 461 #: ../dgit.1:211
 462 msgid ""
 463 "You should ensure that your dgit --build-products-dir setting matches your "
 464 "pbuilder --buildresult."
 465 msgstr ""
 466
 467 #. type: Plain text
 468 #: ../dgit.1:217
 469 msgid ""
 470 "The I<debbuildopts> are passed to pbuilder using its --debbuildopts option.  "
 471 "If you want to pass other options to pbuilder, use the B<--pbuilder:> dgit "
 472 "option as described below (remember that dgit options should appear between "
 473 "B<dgit> and B<pbuilder>)."
 474 msgstr ""
 475
 476 #. type: Plain text
 477 #: ../dgit.1:223
 478 msgid ""
 479 "You should ensure that in your pbuilderrc you do B<not> have the setting "
 480 "B<SOURCE_ONLY_CHANGES=yes> as this may cause trouble."
 481 msgstr ""
 482
 483 #. type: TP
 484 #: ../dgit.1:223
 485 #, no-wrap
 486 msgid "B<dgit cowbuilder> [I<debbuildopts>]"
 487 msgstr ""
 488
 489 #. type: Plain text
 490 #: ../dgit.1:229
 491 msgid "Like B<dgit pbuilder>, but uses B<cowbuilder> instead of B<pbuilder.>"
 492 msgstr ""
 493
 494 #. type: TP
 495 #: ../dgit.1:229
 496 #, no-wrap
 497 msgid "B<dgit gbp-build> ..."
 498 msgstr ""
 499
 500 #. type: Plain text
 501 #: ../dgit.1:235
 502 msgid ""
 503 "Runs B<git-buildpackage> with some suitable options.  Options and arguments "
 504 "after gbp-build will be passed on to git-buildpackage."
 505 msgstr ""
 506
 507 #. type: Plain text
 508 #: ../dgit.1:238
 509 msgid ""
 510 "By default this uses --quilt=gbp, so HEAD should be a git-buildpackage style "
 511 "branch, not a patches-applied branch."
 512 msgstr ""
 513
 514 #. type: TP
 515 #: ../dgit.1:240
 516 #, no-wrap
 517 msgid "B<dgit push> [I<suite>]"
 518 msgstr ""
 519
 520 #. type: Plain text
 521 #: ../dgit.1:249
 522 msgid ""
 523 "Does an `upload', pushing the current HEAD to the archive (as a source "
 524 "package) and to dgit-repos (as git commits).  The package must already have "
 525 "been built ready for upload, with the .dsc and .changes left in the parent "
 526 "directory.  It is normally best to do the build with dgit too (eg with dgit "
 527 "sbuild): some existing build tools pass unhelpful options to dpkg-source et "
 528 "al by default, which can result in the built source package not being "
 529 "identical to the git tree."
 530 msgstr ""
 531
 532 #. type: Plain text
 533 #: ../dgit.1:259
 534 msgid ""
 535 "In more detail: dgit push checks that the current HEAD corresponds to the ."
 536 "dsc.  It then pushes the HEAD to the suite's dgit-repos branch, adjusts the ."
 537 "changes to include any .origs which the archive lacks and exclude .origs "
 538 "which the archive has (so -sa and -sd are not needed when building for dgit "
 539 "push), makes a signed git tag, edits the .dsc to contain the dgit metadata "
 540 "field, runs debsign to sign the upload (.dsc and .changes), pushes the "
 541 "signed tag, and finally uses dput to upload the .changes to the archive."
 542 msgstr ""
 543
 544 #. type: Plain text
 545 #: ../dgit.1:263
 546 msgid ""
 547 "dgit push always uses the package, suite and version specified in the debian/"
 548 "changelog and the .dsc, which must agree.  If the command line specifies a "
 549 "suite then that must match too."
 550 msgstr ""
 551
 552 #. type: Plain text
 553 #: ../dgit.1:268
 554 msgid ""
 555 "When used on a git-debrebase branch, dgit calls git-debrebase to prepare the "
 556 "branch for source package upload and push."
 557 msgstr ""
 558
 559 #. type: TP
 560 #: ../dgit.1:268
 561 #, no-wrap
 562 msgid "B<dgit push-source> [I<suite>]"
 563 msgstr ""
 564
 565 #. type: Plain text
 566 #: ../dgit.1:273
 567 msgid ""
 568 "Without B<-C>, builds a source package and dgit pushes it.  Saying B<dgit "
 569 "push-source> is like saying \"update the source code in the archive to match "
 570 "my git HEAD, and let the autobuilders do the rest.\""
 571 msgstr ""
 572
 573 #. type: Plain text
 574 #: ../dgit.1:276
 575 msgid ""
 576 "With B<-C>, performs a dgit push, additionally ensuring that no binary "
 577 "packages are uploaded."
 578 msgstr ""
 579
 580 #. type: TP
 581 #: ../dgit.1:276
 582 #, no-wrap
 583 msgid "B<dgit rpush> I<build-host>B<:>I<build-dir> [I<push args...>]"
 584 msgstr ""
 585
 586 #. type: Plain text
 587 #: ../dgit.1:283
 588 msgid ""
 589 "Pushes the contents of the specified directory on a remote machine.  This is "
 590 "like running dgit push on build-host with build-dir as the current "
 591 "directory; however, signing operations are done on the invoking host.  This "
 592 "allows you to do a push when the system which has the source code and the "
 593 "build outputs has no access to the key:"
 594 msgstr ""
 595
 596 #. type: =item
 597 #: ../dgit.1:286 ../dgit-maint-merge.7.pod:446
 598 #, no-wrap
 599 msgid "1."
 600 msgstr ""
 601
 602 #. type: tbl table
 603 #: ../dgit.1:286
 604 #, no-wrap
 605 msgid "Clone on build host (dgit clone)"
 606 msgstr ""
 607
 608 #. type: =item
 609 #: ../dgit.1:287 ../dgit-maint-merge.7.pod:450
 610 #, no-wrap
 611 msgid "2."
 612 msgstr ""
 613
 614 #. type: tbl table
 615 #: ../dgit.1:287
 616 #, no-wrap
 617 msgid "Edit code on build host (edit, git commit)"
 618 msgstr ""
 619
 620 #. type: =item
 621 #: ../dgit.1:288 ../dgit-maint-merge.7.pod:455
 622 #, no-wrap
 623 msgid "3."
 624 msgstr ""
 625
 626 #. type: tbl table
 627 #: ../dgit.1:288
 628 #, no-wrap
 629 msgid "Build package on build host (dgit build)"
 630 msgstr ""
 631
 632 #. type: tbl table
 633 #: ../dgit.1:289
 634 #, no-wrap
 635 msgid "4."
 636 msgstr ""
 637
 638 #. type: tbl table
 639 #: ../dgit.1:289
 640 #, no-wrap
 641 msgid "Test package on build host or elsewhere (dpkg -i, test)"
 642 msgstr ""
 643
 644 #. type: tbl table
 645 #: ../dgit.1:290
 646 #, no-wrap
 647 msgid "5."
 648 msgstr ""
 649
 650 #. type: tbl table
 651 #: ../dgit.1:290
 652 #, no-wrap
 653 msgid "Upload by invoking dgit rpush on host with your GPG key."
 654 msgstr ""
 655
 656 #. type: Plain text
 657 #: ../dgit.1:296
 658 msgid ""
 659 "However, the build-host must be able to ssh to the dgit repos.  If this is "
 660 "not already the case, you must organise it separately, for example by the "
 661 "use of ssh agent forwarding."
 662 msgstr ""
 663
 664 #. type: Plain text
 665 #: ../dgit.1:299
 666 msgid ""
 667 "The remaining arguments are treated just as dgit push would handle them."
 668 msgstr ""
 669
 670 #. type: Plain text
 671 #: ../dgit.1:304
 672 msgid ""
 673 "build-host and build-dir can be passed as separate arguments; this is "
 674 "assumed to be the case if the first argument contains no : (except perhaps "
 675 "one in [ ], to support IPv6 address literals)."
 676 msgstr ""
 677
 678 #. type: Plain text
 679 #: ../dgit.1:308
 680 msgid ""
 681 "You will need similar enough versions of dgit on the build-host and the "
 682 "invocation host.  The build-host needs gnupg installed, with your public key "
 683 "in its keyring (but not your private key, obviously)."
 684 msgstr ""
 685
 686 #. type: TP
 687 #: ../dgit.1:308
 688 #, no-wrap
 689 msgid "B<dgit setup-new-tree>"
 690 msgstr ""
 691
 692 #. type: Plain text
 693 #: ../dgit.1:324
 694 msgid ""
 695 "Configure the current working tree the way that dgit clone would have set it "
 696 "up.  Like running B<dgit setup-useremail>, B<setup-mergechangelogs> and "
 697 "B<setup-gitattributes> (but only does each thing if dgit is configured to do "
 698 "it automatically).  You can use these in any git repository, not just ones "
 699 "used with the other dgit operations.  Does B<not> run B<update-vcs-git> (as "
 700 "that requires Debian packaging information)."
 701 msgstr ""
 702
 703 #. type: TP
 704 #: ../dgit.1:324
 705 #, no-wrap
 706 msgid "B<dgit setup-useremail>"
 707 msgstr ""
 708
 709 #. type: Plain text
 710 #: ../dgit.1:330
 711 msgid ""
 712 "Set the working tree's user.name and user.email from the distro-specific "
 713 "dgit configuration (B<dgit-distro.>I<distro>B<.user-name> and B<.user-"
 714 "email>), or DEBFULLNAME or DEBEMAIL."
 715 msgstr ""
 716
 717 #. type: TP
 718 #: ../dgit.1:330
 719 #, no-wrap
 720 msgid "B<dgit setup-mergechangelogs>"
 721 msgstr ""
 722
 723 #. type: Plain text
 724 #: ../dgit.1:336
 725 msgid ""
 726 "Configures a git merge helper for the file B<debian/changelog> which uses "
 727 "B<dpkg-mergechangelogs>."
 728 msgstr ""
 729
 730 #. type: TP
 731 #: ../dgit.1:336
 732 #, no-wrap
 733 msgid "B<dgit setup-gitattributes>"
 734 msgstr ""
 735
 736 #. type: Plain text
 737 #: ../dgit.1:351
 738 msgid ""
 739 "Set up the working tree's B<.git/info/attributes> to disable all "
 740 "transforming attributes for all files.  This is done by defining a macro "
 741 "attribute B<dgit-defuse-attrs> and applying it to B<*>.  For why, see "
 742 "B<GITATTRIBUTES> in B<dgit(7)>.  Note that only attributes affecting the "
 743 "working tree are suppressed.  git-archive may remain exciting."
 744 msgstr ""
 745
 746 #. type: Plain text
 747 #: ../dgit.1:359
 748 msgid ""
 749 "If there is an existing macro attribute line B<[attr]dgit-defuse-attrs> in ."
 750 "git/info/attributes, but it is insufficient, because it was made by an "
 751 "earlier version of dgit and git has since introduced new transforming "
 752 "attributes, modifies the macro to disable the newer transformations."
 753 msgstr ""
 754
 755 #. type: Plain text
 756 #: ../dgit.1:370
 757 msgid ""
 758 "(If there is already a macro attribute line B<[attr]dgit-defuse-attrs> in ."
 759 "git/info/attributes which does what dgit requires (whatever files it "
 760 "effects), this operation does nothing further.  This fact can be used to "
 761 "defeat or partially defeat dgit setup-gitattributes and hence dgit setup-new-"
 762 "tree.)"
 763 msgstr ""
 764
 765 #. type: TP
 766 #: ../dgit.1:370
 767 #, no-wrap
 768 msgid "B<dgit quilt-fixup>"
 769 msgstr ""
 770
 771 #. type: Plain text
 772 #: ../dgit.1:377
 773 msgid ""
 774 "`3.0 (quilt)' format source packages need changes representing not only in-"
 775 "tree but also as patches in debian/patches.  dgit quilt-fixup checks whether "
 776 "this has been done; if not, dgit will make appropriate patches in debian/"
 777 "patches and also commit the resulting changes to git."
 778 msgstr ""
 779
 780 #. type: Plain text
 781 #: ../dgit.1:379
 782 msgid "This is normally done automatically by dgit build and dgit push."
 783 msgstr ""
 784
 785 #. type: Plain text
 786 #: ../dgit.1:385
 787 msgid ""
 788 "dgit will try to turn each relevant commit in your git history into a new "
 789 "quilt patch.  dgit cannot convert nontrivial merges, or certain other kinds "
 790 "of more exotic history.  If dgit can't find a suitable linearisation of your "
 791 "history, by default it will fail, but you can ask it to generate a single "
 792 "squashed patch instead."
 793 msgstr ""
 794
 795 #. type: Plain text
 796 #: ../dgit.1:394
 797 msgid ""
 798 "When used with a git-debrebase branch, dgit will ask git-debrebase to "
 799 "prepare patches.  However, dgit can make patches in some situations where "
 800 "git-debrebase fails, so dgit quilt-fixup can be useful in its own right.  To "
 801 "always use dgit's own patch generator instead of git-debrebase make-patches, "
 802 "pass --git-debrebase=true to dgit."
 803 msgstr ""
 804
 805 #. type: Plain text
 806 #: ../dgit.1:399
 807 msgid "See B<FORMAT 3.0 (QUILT)> in B<dgit(7)>."
 808 msgstr ""
 809
 810 #. type: TP
 811 #: ../dgit.1:399
 812 #, no-wrap
 813 msgid "B<dgit import-dsc> [I<sub-options>] I<../path/to/.dsc> [B<+>|B<..>]branch"
 814 msgstr ""
 815
 816 #. type: Plain text
 817 #: ../dgit.1:405
 818 msgid ""
 819 "Import a Debian-format source package, specified by its .dsc, into git, the "
 820 "way dgit fetch would do."
 821 msgstr ""
 822
 823 #. type: Plain text
 824 #: ../dgit.1:416
 825 msgid ""
 826 "This does about half the work of dgit fetch: it will convert the .dsc into a "
 827 "new, orphan git branch.  Since dgit has no access to a corresponding source "
 828 "package archive or knowledge of the history it does not consider whether "
 829 "this version is newer than any previous import or corresponding git "
 830 "branches; and it therefore does not make a pseudomerge to bind the import "
 831 "into any existing git history."
 832 msgstr ""
 833
 834 #. type: Plain text
 835 #: ../dgit.1:426
 836 msgid ""
 837 "Because a .dsc can contain a Dgit field naming a git commit (which you might "
 838 "not have), and specifying where to find that commit (and any history rewrite "
 839 "table), import-dsc might need online access.  If this is a problem (or "
 840 "dgit's efforts to find the commit fail), consider --no-chase-dsc-distro or --"
 841 "force-import-dsc-with-dgit-field."
 842 msgstr ""
 843
 844 #. type: Plain text
 845 #: ../dgit.1:428
 846 msgid "There is only only sub-option:"
 847 msgstr ""
 848
 849 #. type: Plain text
 850 #: ../dgit.1:434
 851 msgid ""
 852 "B<--require-valid-signature> causes dgit to insist that the signature on "
 853 "the .dsc is valid (using the same criteria as dpkg-source -x).  Otherwise, "
 854 "dgit tries to verify the signature but the outcome is reported only as "
 855 "messages to stderr."
 856 msgstr ""
 857
 858 #. type: Plain text
 859 #: ../dgit.1:453
 860 msgid ""
 861 "If I<branch> is prefixed with B<+> then if it already exists, it will be "
 862 "simply ovewritten, no matter its existing contents.  If I<branch> is "
 863 "prefixed with B<..> then if it already exists and dgit actually imports the "
 864 "dsc (rather than simply reading the git commit out of the Dgit field), dgit "
 865 "will make a pseudomerge so that the result is necessarily fast forward from "
 866 "the existing branch.  Otherwise, if branch already exists, dgit will stop "
 867 "with an error message."
 868 msgstr ""
 869
 870 #. type: Plain text
 871 #: ../dgit.1:457
 872 msgid "If I<branch> does not start with refs/, refs/heads/ is prepended."
 873 msgstr ""
 874
 875 #. type: TP
 876 #: ../dgit.1:457
 877 #, no-wrap
 878 msgid "B<dgit version>"
 879 msgstr ""
 880
 881 #. type: Plain text
 882 #: ../dgit.1:460
 883 msgid "Prints version information and exits."
 884 msgstr ""
 885
 886 #. type: TP
 887 #: ../dgit.1:460
 888 #, no-wrap
 889 msgid "B<dgit clone-dgit-repos-server>I< destdir>"
 890 msgstr ""
 891
 892 #. type: Plain text
 893 #: ../dgit.1:464
 894 msgid ""
 895 "Tries to fetch a copy of the source code for the dgit-repos-server, as "
 896 "actually being used on the dgit git server, as a git tree."
 897 msgstr ""
 898
 899 #. type: TP
 900 #: ../dgit.1:464
 901 #, no-wrap
 902 msgid "B<dgit print-dgit-repos-server-source-url>"
 903 msgstr ""
 904
 905 #. type: Plain text
 906 #: ../dgit.1:469
 907 msgid ""
 908 "Prints the url used by dgit clone-dgit-repos-server.  This is hopefully "
 909 "suitable for use as a git remote url.  It may not be useable in a browser."
 910 msgstr ""
 911
 912 #. type: TP
 913 #: ../dgit.1:469
 914 #, no-wrap
 915 msgid "B<dgit print-dpkg-source-ignores>"
 916 msgstr ""
 917
 918 #. type: Plain text
 919 #: ../dgit.1:476
 920 msgid ""
 921 "Prints the -i and -I arguments which must be passed to dpkg-souce to cause "
 922 "it to exclude exactly the .git diredcory and nothing else.  The separate "
 923 "arguments are unquoted, separated by spaces, and do not contain spaces."
 924 msgstr ""
 925
 926 #. type: TP
 927 #: ../dgit.1:476
 928 #, no-wrap
 929 msgid "B<dgit print-unapplied-treeish>"
 930 msgstr ""
 931
 932 #. type: Plain text
 933 #: ../dgit.1:487
 934 msgid ""
 935 "Constructs a tree-ish approximating the patches-unapplied state of your 3.0 "
 936 "(quilt) package, and prints the git object name to stdout.  This requires "
 937 "appropriate .orig tarballs.  This tree object is identical to your .origs as "
 938 "regards upstream files.  The contents of the debian subdirectory is not "
 939 "interesting and should not be inspected; except that debian/patches will be "
 940 "identical to your HEAD."
 941 msgstr ""
 942
 943 #. type: Plain text
 944 #: ../dgit.1:494
 945 msgid ""
 946 "To make this operate off-line, the access configuration key which is used to "
 947 "determine the build-products-dir is the uncanonicalised version of the suite "
 948 "name from the changelog, or (of course) dgit.default.build-products-dir.  "
 949 "See ACCESS CONFIGURATION, below."
 950 msgstr ""
 951
 952 #. type: Plain text
 953 #: ../dgit.1:496
 954 msgid "This function is primarily provided for the benefit of git-debrebase."
 955 msgstr ""
 956
 957 #. type: =head1
 958 #: ../dgit.1:496 ../git-debrebase.1.pod:441
 959 #, no-wrap
 960 msgid "OPTIONS"
 961 msgstr ""
 962
 963 #. type: TP
 964 #: ../dgit.1:497
 965 #, no-wrap
 966 msgid "B<--dry-run> | B<-n>"
 967 msgstr ""
 968
 969 #. type: Plain text
 970 #: ../dgit.1:503
 971 msgid ""
 972 "Go through the motions, fetching all information needed, but do not actually "
 973 "update the output(s).  For push, dgit does the required checks and leaves "
 974 "the new .dsc in a temporary file, but does not sign, tag, push or upload."
 975 msgstr ""
 976
 977 #. type: TP
 978 #: ../dgit.1:503
 979 #, no-wrap
 980 msgid "B<--damp-run> | B<-L>"
 981 msgstr ""
 982
 983 #. type: Plain text
 984 #: ../dgit.1:508
 985 msgid ""
 986 "Go through many more of the motions: do everything that doesn't involve "
 987 "either signing things, or making changes on the public servers."
 988 msgstr ""
 989
 990 #. type: TP
 991 #: ../dgit.1:508
 992 #, no-wrap
 993 msgid "B<-k>I<keyid>"
 994 msgstr ""
 995
 996 #. type: Plain text
 997 #: ../dgit.1:517
 998 msgid ""
 999 "Use I<keyid> for signing the tag and the upload.  The default comes from the "
1000 "distro's B<keyid> config setting (see CONFIGURATION, below), or failing "
1001 "that, the uploader trailer line in debian/changelog."
1002 msgstr ""
1003
1004 #. type: TP
1005 #: ../dgit.1:517
1006 #, no-wrap
1007 msgid "B<--no-sign>"
1008 msgstr ""
1009
1010 #. type: Plain text
1011 #: ../dgit.1:520
1012 msgid "does not sign tags or uploads (meaningful only with push)."
1013 msgstr ""
1014
1015 #. type: TP
1016 #: ../dgit.1:521
1017 #, no-wrap
1018 msgid "B<-p>I<package>"
1019 msgstr ""
1020
1021 #. type: Plain text
1022 #: ../dgit.1:527
1023 msgid ""
1024 "Specifies that we should process source package I<package> rather than "
1025 "looking in debian/control or debian/changelog.  Valid with dgit fetch and "
1026 "dgit pull, only."
1027 msgstr ""
1028
1029 #. type: TP
1030 #: ../dgit.1:527
1031 #, no-wrap
1032 msgid "B<--clean=git> | B<-wg>"
1033 msgstr ""
1034
1035 #. type: Plain text
1036 #: ../dgit.1:533
1037 msgid ""
1038 "Use B<git clean -xdf> to clean the working tree, rather than running the "
1039 "package's rules clean target."
1040 msgstr ""
1041
1042 #. type: Plain text
1043 #: ../dgit.1:536
1044 msgid ""
1045 "This will delete all files which are not tracked by git.  (Including any "
1046 "files you forgot to git add.)"
1047 msgstr ""
1048
1049 #. type: Plain text
1050 #: ../dgit.1:541
1051 msgid ""
1052 "B<--clean=>I<...> options other than dpkg-source are useful when the "
1053 "package's clean target is troublesome, or to avoid needing the build-"
1054 "dependencies."
1055 msgstr ""
1056
1057 #. type: TP
1058 #: ../dgit.1:541
1059 #, no-wrap
1060 msgid "B<--clean=git-ff> | B<-wgf>"
1061 msgstr ""
1062
1063 #. type: Plain text
1064 #: ../dgit.1:550
1065 msgid ""
1066 "Use B<git clean -xdff> to clean the working tree.  Like git clean -xdf but "
1067 "it also removes any subdirectories containing different git trees (which "
1068 "only unusual packages are likely to create)."
1069 msgstr ""
1070
1071 #. type: TP
1072 #: ../dgit.1:550
1073 #, no-wrap
1074 msgid "B<--clean=check> | B<-wc>"
1075 msgstr ""
1076
1077 #. type: Plain text
1078 #: ../dgit.1:556
1079 msgid ""
1080 "Merely check that the tree is clean (does not contain uncommitted files).  "
1081 "Avoids running rules clean, and can avoid needing the build-dependencies."
1082 msgstr ""
1083
1084 #. type: TP
1085 #: ../dgit.1:556
1086 #, no-wrap
1087 msgid "B<--clean=none> | B<-wn>"
1088 msgstr ""
1089
1090 #. type: Plain text
1091 #: ../dgit.1:564
1092 msgid ""
1093 "Do not clean the tree, nor check that it is clean.  Avoids running rules "
1094 "clean, and can avoid needing the build-dependencies.  If there are files "
1095 "which are not in git, or if the build creates such files, a subsequent dgit "
1096 "push will fail."
1097 msgstr ""
1098
1099 #. type: TP
1100 #: ../dgit.1:564
1101 #, no-wrap
1102 msgid "B<--clean=dpkg-source> | B<-wd>"
1103 msgstr ""
1104
1105 #. type: Plain text
1106 #: ../dgit.1:570
1107 msgid ""
1108 "Use dpkg-buildpackage to do the clean, so that the source package is cleaned "
1109 "by dpkg-source running the package's clean target.  This is the default.  "
1110 "Requires the package's build dependencies."
1111 msgstr ""
1112
1113 #. type: TP
1114 #: ../dgit.1:570
1115 #, no-wrap
1116 msgid "B<--clean=dpkg-source-d> | B<-wdd>"
1117 msgstr ""
1118
1119 #. type: Plain text
1120 #: ../dgit.1:580
1121 msgid ""
1122 "Use B<dpkg-buildpackage -d> to do the clean, so that the source package is "
1123 "cleaned by dpkg-source running the package's clean target.  The build-"
1124 "dependencies are not checked (due to B<-d>), which violates policy, but may "
1125 "work in practice."
1126 msgstr ""
1127
1128 #. type: TP
1129 #: ../dgit.1:580
1130 #, no-wrap
1131 msgid "B<-N> | B<--new>"
1132 msgstr ""
1133
1134 #. type: Plain text
1135 #: ../dgit.1:586
1136 msgid ""
1137 "The package is or may be new in this suite.  Without this, dgit will refuse "
1138 "to push.  It may (for Debian, will) be unable to access the git history for "
1139 "any packages which have been newly pushed and have not yet been published."
1140 msgstr ""
1141
1142 #. type: TP
1143 #: ../dgit.1:586
1144 #, no-wrap
1145 msgid "B<--include-dirty>"
1146 msgstr ""
1147
1148 #. type: Plain text
1149 #: ../dgit.1:594
1150 msgid ""
1151 "Do not complain if the working tree does not match your git HEAD, and when "
1152 "building, include the changes from your working tree.  This can be useful "
1153 "with build, if you plan to commit later.  (dgit push will still ensure that "
1154 "the .dsc you upload and the git tree you push are identical, so this option "
1155 "won't make broken pushes.)"
1156 msgstr ""
1157
1158 #. type: TP
1159 #: ../dgit.1:594
1160 #, no-wrap
1161 msgid "B<--ignore-dirty>"
1162 msgstr ""
1163
1164 #. type: Plain text
1165 #: ../dgit.1:597
1166 msgid "Deprecated alias for --include-dirty."
1167 msgstr ""
1168
1169 #. type: TP
1170 #: ../dgit.1:597
1171 #, no-wrap
1172 msgid "B<--overwrite>[=I<previous-version>]"
1173 msgstr ""
1174
1175 #. type: Plain text
1176 #: ../dgit.1:608
1177 msgid ""
1178 "Declare that your HEAD really does contain all the (wanted) changes from all "
1179 "versions listed in its changelog; or, all (wanted) changes from I<previous-"
1180 "version>.  This promise is needed when your git branch is not a descendant "
1181 "of the version in the archive according to the git revision history."
1182 msgstr ""
1183
1184 #. type: Plain text
1185 #: ../dgit.1:615
1186 msgid ""
1187 "It is safer not to specify I<previous-version>, and usually it's not "
1188 "needed.  Just say B<--overwrite>, unless you know what you are doing."
1189 msgstr ""
1190
1191 #. type: Plain text
1192 #: ../dgit.1:619
1193 msgid ""
1194 "This option is useful if you are the maintainer, and you have incorporated "
1195 "NMU changes into your own git workflow in a way that doesn't make your "
1196 "branch a fast forward from the NMU."
1197 msgstr ""
1198
1199 #. type: Plain text
1200 #: ../dgit.1:625
1201 msgid ""
1202 "This option is also usually necessary the first time a package is pushed "
1203 "with dgit push to a particular suite.  See B<dgit-maint->I<*>B<(7)>."
1204 msgstr ""
1205
1206 #. type: Plain text
1207 #: ../dgit.1:639
1208 msgid ""
1209 "If I<previous-version> is not specified, dgit will check that the version in "
1210 "the archive is mentioned in your debian/changelog.  (This will avoid losing "
1211 "changes, even with B<--overwrite>, unless someone committed to git a "
1212 "finalised changelog entry, and then made later changes to that version.)  If "
1213 "I<previous-version> is specified, it ought to be the version currently in "
1214 "the archive."
1215 msgstr ""
1216
1217 #. type: Plain text
1218 #: ../dgit.1:645
1219 msgid ""
1220 "dgit push --overwrite will, if necessary, make a pseudo-merge (that is, "
1221 "something that looks like the result of git merge -s ours) to stitch the "
1222 "archive's version into your own git history, so that your push is a fast "
1223 "forward from the archive."
1224 msgstr ""
1225
1226 #. type: Plain text
1227 #: ../dgit.1:650
1228 msgid ""
1229 "(In quilt mode B<gbp>, B<dpm> or B<unpatched>, implying a split between the "
1230 "dgit view and the maintainer view, the pseudo-merge will appear only in the "
1231 "dgit view.)"
1232 msgstr ""
1233
1234 #. type: TP
1235 #: ../dgit.1:650
1236 #, no-wrap
1237 msgid "B<--delayed>=I<days>"
1238 msgstr ""
1239
1240 #. type: Plain text
1241 #: ../dgit.1:653
1242 msgid "Upload to a DELAYED queue."
1243 msgstr ""
1244
1245 #. type: Plain text
1246 #: ../dgit.1:663
1247 msgid ""
1248 "B<WARNING:> If the maintainer responds by cancelling your upload from the "
1249 "queue, and does not make an upload of their own, this will not rewind the "
1250 "git branch on the dgit git server.  Other dgit users will then see your push "
1251 "(with a warning message from dgit)  even though the maintainer wanted to "
1252 "abolish it.  Such users might unwittingly reintroduce your changes."
1253 msgstr ""
1254
1255 #. type: Plain text
1256 #: ../dgit.1:668
1257 msgid ""
1258 "If this situation arises, someone should make a suitable dgit push to update "
1259 "the contents of dgit-repos to a version without the controversial changes."
1260 msgstr ""
1261
1262 #. type: TP
1263 #: ../dgit.1:668
1264 #, no-wrap
1265 msgid "B<--no-chase-dsc-distro>"
1266 msgstr ""
1267
1268 #. type: Plain text
1269 #: ../dgit.1:674
1270 msgid ""
1271 "Tells dgit not to look online for additional git repositories containing "
1272 "information about a particular .dsc being imported.  Chasing is the default."
1273 msgstr ""
1274
1275 #. type: Plain text
1276 #: ../dgit.1:684
1277 msgid ""
1278 "For most operations (such as fetch and pull), disabling chasing means dgit "
1279 "will access only the git server for the distro you are directly working "
1280 "with, even if the .dsc was copied verbatim from another distro.  For import-"
1281 "dsc, disabling chasing means dgit will work completely offline."
1282 msgstr ""
1283
1284 #. type: Plain text
1285 #: ../dgit.1:692
1286 msgid ""
1287 "Disabling chasing can be hazardous: if the .dsc names a git commit which has "
1288 "been rewritten by those in charge of the distro, this option may prevent "
1289 "that rewrite from being effective.  Also, it can mean that dgit fails to "
1290 "find necessary git commits."
1291 msgstr ""
1292
1293 #. type: TP
1294 #: ../dgit.1:692
1295 #, no-wrap
1296 msgid "B<--save-dgit-view=>I<branch>|I<ref>"
1297 msgstr ""
1298
1299 #. type: Plain text
1300 #: ../dgit.1:702
1301 msgid ""
1302 "Specifies that when a split view quilt mode is in operation, and dgit "
1303 "calculates (or looks up in its cache)  a dgit view corresponding to your "
1304 "HEAD, the dgit view will be left in I<ref>.  The specified ref is "
1305 "unconditionally overwritten, so don't specify a branch you want to keep."
1306 msgstr ""
1307
1308 #. type: Plain text
1309 #: ../dgit.1:709
1310 msgid ""
1311 "This option is effective only with the following operations: quilt-fixup; "
1312 "push; all builds.  And it is only effective with --[quilt=]gbp, --"
1313 "[quilt=]dpm, --quilt=unpatched."
1314 msgstr ""
1315
1316 #. type: Plain text
1317 #: ../dgit.1:713
1318 msgid ""
1319 "If ref does not start with refs/ it is taken to to be a branch - i.e. refs/"
1320 "heads/ is prepended."
1321 msgstr ""
1322
1323 #. type: Plain text
1324 #: ../dgit.1:717
1325 msgid "B<--dgit-view-save> is a deprecated alias for --save-dgit-view."
1326 msgstr ""
1327
1328 #. type: TP
1329 #: ../dgit.1:717
1330 #, no-wrap
1331 msgid "B<--deliberately->I<something>"
1332 msgstr ""
1333
1334 #. type: Plain text
1335 #: ../dgit.1:731
1336 msgid ""
1337 "Declare that you are deliberately doing I<something>.  This can be used to "
1338 "override safety catches, including safety catches which relate to distro-"
1339 "specific policies.  The use of --deliberately is declared and published in "
1340 "the signed tags generated for you by dgit, so that the archive software can "
1341 "give effect to your intent, and for the benefit humans looking at the "
1342 "history.  The meanings of I<something>s understood in the context of Debian "
1343 "are discussed below:"
1344 msgstr ""
1345
1346 #. type: TP
1347 #: ../dgit.1:731
1348 #, no-wrap
1349 msgid "B<--deliberately-not-fast-forward>"
1350 msgstr ""
1351
1352 #. type: Plain text
1353 #: ../dgit.1:737
1354 msgid ""
1355 "Declare that you are deliberately rewinding history.  When pushing to "
1356 "Debian, use this when you are making a renewed upload of an entirely new "
1357 "source package whose previous version was not accepted for release from NEW "
1358 "because of problems with copyright or redistributibility."
1359 msgstr ""
1360
1361 #. type: Plain text
1362 #: ../dgit.1:748
1363 msgid ""
1364 "In split view quilt modes, this also prevents the construction by dgit of a "
1365 "pseudomerge to make the dgit view fast forwarding.  Normally only one of --"
1366 "overwrite (which creates a suitable pseudomerge)  and --deliberately-not-"
1367 "fast-forward (which suppresses the pseudomerge and the fast forward checks)  "
1368 "should be needed; --overwrite is usually better."
1369 msgstr ""
1370
1371 #. type: TP
1372 #: ../dgit.1:748
1373 #, no-wrap
1374 msgid "B<--deliberately-include-questionable-history>"
1375 msgstr ""
1376
1377 #. type: Plain text
1378 #: ../dgit.1:757
1379 msgid ""
1380 "Declare that you are deliberately including, in the git history of your "
1381 "current push, history which contains a previously-submitted version of this "
1382 "package which was not approved (or has not yet been approved) by the "
1383 "ftpmasters.  When pushing to Debian, only use this option after verifying "
1384 "that: none of the rejected-from-NEW (or never-accepted) versions in the git "
1385 "history of your current push, were rejected by ftpmaster for copyright or "
1386 "redistributability reasons."
1387 msgstr ""
1388
1389 #. type: TP
1390 #: ../dgit.1:757
1391 #, no-wrap
1392 msgid "B<--deliberately-fresh-repo>"
1393 msgstr ""
1394
1395 #. type: Plain text
1396 #: ../dgit.1:762
1397 msgid ""
1398 "Declare that you are deliberately rewinding history and want to throw away "
1399 "the existing repo.  Not relevant when pushing to Debian, as the Debian "
1400 "server will do this automatically when necessary."
1401 msgstr ""
1402
1403 #. type: TP
1404 #: ../dgit.1:762
1405 #, no-wrap
1406 msgid "B<--quilt=linear>"
1407 msgstr ""
1408
1409 #. type: Plain text
1410 #: ../dgit.1:769
1411 msgid ""
1412 "When fixing up source format `3.0 (quilt)' metadata, insist on generating a "
1413 "linear patch stack: one new patch for each relevant commit.  If such a stack "
1414 "cannot be generated, fail.  This is the default for Debian."
1415 msgstr ""
1416
1417 #. type: Plain text
1418 #: ../dgit.1:774
1419 msgid ""
1420 "HEAD should be a series of plain commits (not touching debian/patches/), and "
1421 "pseudomerges, with as ancestor a patches-applied branch."
1422 msgstr ""
1423
1424 #. type: TP
1425 #: ../dgit.1:774
1426 #, no-wrap
1427 msgid "B<--quilt=auto>"
1428 msgstr ""
1429
1430 #. type: Plain text
1431 #: ../dgit.1:783
1432 msgid ""
1433 "When fixing up source format `3.0 (quilt)' metadata, prefer to generate a "
1434 "linear patch stack (as with --quilt=auto)  but if that doesn't seem "
1435 "possible, try to generate a single squashed patch for all the changes made "
1436 "in git (as with --quilt=smash).  This is not a good idea for an NMU in "
1437 "Debian."
1438 msgstr ""
1439
1440 #. type: TP
1441 #: ../dgit.1:783
1442 #, no-wrap
1443 msgid "B<--quilt=smash>"
1444 msgstr ""
1445
1446 #. type: Plain text
1447 #: ../dgit.1:788
1448 msgid ""
1449 "When fixing up source format `3.0 (quilt)' metadata, generate a single "
1450 "additional patch for all the changes made in git.  This is not a good idea "
1451 "for an NMU in Debian."
1452 msgstr ""
1453
1454 #. type: Plain text
1455 #: ../dgit.1:794
1456 msgid ""
1457 "(If HEAD has any in-tree patches already, they must apply cleanly.  This "
1458 "will be the case for any trees produced by dgit fetch or clone; if you do "
1459 "not change the upstream version nor make changes in debian/patches, it will "
1460 "remain true.)"
1461 msgstr ""
1462
1463 #. type: TP
1464 #: ../dgit.1:794
1465 #, no-wrap
1466 msgid "B<--quilt=nofix>"
1467 msgstr ""
1468
1469 #. type: Plain text
1470 #: ../dgit.1:802
1471 msgid ""
1472 "Check whether source format `3.0 (quilt)' metadata would need fixing up, "
1473 "but, if it does, fail.  You must then fix the metadata yourself somehow "
1474 "before pushing.  (NB that dpkg-source --commit will not work because the "
1475 "dgit git tree does not have a B<.pc> directory.)"
1476 msgstr ""
1477
1478 #. type: TP
1479 #: ../dgit.1:802
1480 #, no-wrap
1481 msgid "B<--quilt=nocheck> | B<--no-quilt-fixup>"
1482 msgstr ""
1483
1484 #. type: Plain text
1485 #: ../dgit.1:807
1486 msgid ""
1487 "Do not check whether up source format `3.0 (quilt)' metadata needs fixing "
1488 "up.  If you use this option and the metadata did in fact need fixing up, "
1489 "dgit push will fail."
1490 msgstr ""
1491
1492 #. type: TP
1493 #: ../dgit.1:807
1494 #, no-wrap
1495 msgid "B<-->[B<quilt=>]B<gbp> | B<-->[B<quilt=>]B<dpm> | B<--quilt=unapplied>"
1496 msgstr ""
1497
1498 #. type: Plain text
1499 #: ../dgit.1:814
1500 msgid ""
1501 "Tell dgit that you are using a nearly-dgit-compatible git branch, aka a "
1502 "B<maintainer view>, and do not want your branch changed by dgit."
1503 msgstr ""
1504
1505 #. type: Plain text
1506 #: ../dgit.1:822
1507 msgid ""
1508 "B<--gbp> (short for B<--quilt=gbp>)  is for use with git-buildpackage.  Your "
1509 "HEAD is expected to be a patches-unapplied git branch, except that it might "
1510 "contain changes to upstream .gitignore files.  This is the default for dgit "
1511 "gbp-build."
1512 msgstr ""
1513
1514 #. type: Plain text
1515 #: ../dgit.1:830
1516 msgid ""
1517 "B<--dpm> (short for B<--quilt=dpm>)  is for use with git-dpm.  Your HEAD is "
1518 "expected to be a patches-applied git branch, except that it might contain "
1519 "changes to upstream .gitignore files."
1520 msgstr ""
1521
1522 #. type: Plain text
1523 #: ../dgit.1:835
1524 msgid ""
1525 "B<--quilt=unapplied> specifies that your HEAD is a patches-unapplied git "
1526 "branch (and that any changes to upstream .gitignore files are represented as "
1527 "patches in debian/patches)."
1528 msgstr ""
1529
1530 #. type: Plain text
1531 #: ../dgit.1:853
1532 msgid ""
1533 "With --quilt=gbp|dpm|unapplied, dgit push (or precursors like quilt-fixup "
1534 "and build) will automatically generate a conversion of your git branch into "
1535 "the right form.  dgit push will push the dgit-compatible form (the B<dgit "
1536 "view>)  to the dgit git server.  The dgit view will be visible to you in the "
1537 "dgit remote tracking branches, but your own branch will not be modified.  "
1538 "dgit push will create a tag B<debian/>I<version> for the maintainer view, "
1539 "and the dgit tag B<archive/debian/>I<version> for the dgit view.  dgit quilt-"
1540 "fixup will merely do some checks, and cache the maintainer view."
1541 msgstr ""
1542
1543 #. type: Plain text
1544 #: ../dgit.1:862
1545 msgid ""
1546 "B<If you have a branch like this it is essential to specify the appropriate "
1547 "--quilt= option!> This is because it is not always possible to tell: a "
1548 "patches-unapplied git branch of a package with one patch, for example, looks "
1549 "very like a patches-applied branch where the user has used git revert to "
1550 "undo the patch, expecting to actually revert it.  However, if you fail to "
1551 "specify the right --quilt option, and you aren't too lucky, dgit will notice "
1552 "the problem and stop, with a useful hint."
1553 msgstr ""
1554
1555 #. type: TP
1556 #: ../dgit.1:862
1557 #, no-wrap
1558 msgid "B<-d>I<distro> | B<--distro=>I<distro>"
1559 msgstr ""
1560
1561 #. type: Plain text
1562 #: ../dgit.1:871
1563 msgid ""
1564 "Specifies that the suite to be operated on is part of distro I<distro>.  "
1565 "This overrides the default value found from the git config option B<dgit-"
1566 "suite.>I<suite>B<.distro>.  The only effect is that other configuration "
1567 "variables (used for accessing the archive and dgit-repos) used are B<dgit-"
1568 "distro.>I<distro>B<.*>."
1569 msgstr ""
1570
1571 #. type: Plain text
1572 #: ../dgit.1:877
1573 msgid ""
1574 "If your suite is part of a distro that dgit already knows about, you can use "
1575 "this option to make dgit work even if your dgit doesn't know about the "
1576 "suite.  For example, specifying B<-ddebian> will work when the suite is an "
1577 "unknown suite in the Debian archive."
1578 msgstr ""
1579
1580 #. type: Plain text
1581 #: ../dgit.1:882
1582 msgid ""
1583 "To define a new distro it is necessary to define methods and URLs for "
1584 "fetching (and, for dgit push, altering) a variety of information both in the "
1585 "archive and in dgit-repos.  How to set this up is not yet documented."
1586 msgstr ""
1587
1588 #. type: TP
1589 #: ../dgit.1:882
1590 #, no-wrap
1591 msgid "B<-C>I<changesfile>"
1592 msgstr ""
1593
1594 #. type: Plain text
1595 #: ../dgit.1:887
1596 msgid ""
1597 "Specifies the .changes file which is to be uploaded.  By default dgit push "
1598 "looks for single .changes file in the parent directory whose filename "
1599 "suggests it is for the right package and version."
1600 msgstr ""
1601
1602 #. type: Plain text
1603 #: ../dgit.1:896
1604 msgid ""
1605 "If the specified I<changesfile> pathname contains slashes, the directory "
1606 "part is also used as the value for B<--build-products-dir>; otherwise, the "
1607 "changes file is expected in that directory (by default, in B<..>)."
1608 msgstr ""
1609
1610 #. type: TP
1611 #: ../dgit.1:896
1612 #, no-wrap
1613 msgid "B<--rm-old-changes>"
1614 msgstr ""
1615
1616 #. type: Plain text
1617 #: ../dgit.1:908
1618 msgid ""
1619 "When doing a build, delete any changes files matching "
1620 "I<package>B<_>I<version>B<_*.changes> before starting.  This ensures that "
1621 "dgit push (and dgit sbuild) will be able to unambigously identify the "
1622 "relevant changes files from the most recent build, even if there have been "
1623 "previous builds with different tools or options.  The default is not to "
1624 "remove, but B<--no-rm-old-changes> can be used to override a previous --rm-"
1625 "old-changes or the .rm-old-changes configuration setting."
1626 msgstr ""
1627
1628 #. type: Plain text
1629 #: ../dgit.1:911
1630 msgid ""
1631 "Note that B<dgit push-source> will always find the right .changes, "
1632 "regardless of this option."
1633 msgstr ""
1634
1635 #. type: TP
1636 #: ../dgit.1:911
1637 #, no-wrap
1638 msgid "B<--build-products-dir=>I<directory>"
1639 msgstr ""
1640
1641 #. type: Plain text
1642 #: ../dgit.1:915
1643 msgid ""
1644 "Specifies where to find and create tarballs, binry packages, source "
1645 "packages, .changes files, and so on."
1646 msgstr ""
1647
1648 #. type: Plain text
1649 #: ../dgit.1:918
1650 msgid "By default, dgit uses the parent directory (B<..>)."
1651 msgstr ""
1652
1653 #. type: Plain text
1654 #: ../dgit.1:927
1655 msgid ""
1656 "Changing this setting may necessitate moving .orig tarballs to the new "
1657 "directory, so it is probably best to use the B<dgit.default.build-products-"
1658 "dir> configuration setting (see CONFIGURATION, below)  which this command "
1659 "line option overrides)."
1660 msgstr ""
1661
1662 #. type: TP
1663 #: ../dgit.1:927
1664 #, no-wrap
1665 msgid "B<--no-rm-on-error>"
1666 msgstr ""
1667
1668 #. type: Plain text
1669 #: ../dgit.1:930
1670 msgid "Do not delete the destination directory if clone fails."
1671 msgstr ""
1672
1673 #. type: TP
1674 #: ../dgit.1:930
1675 #, no-wrap
1676 msgid "B<--dep14tag>"
1677 msgstr ""
1678
1679 #. type: Plain text
1680 #: ../dgit.1:937
1681 msgid ""
1682 "Generates a DEP-14 tag (eg B<debian/>I<version>)  as well as a dgit tag (eg "
1683 "B<archive/debian/>I<version>)  where possible.  This is the default."
1684 msgstr ""
1685
1686 #. type: TP
1687 #: ../dgit.1:937
1688 #, no-wrap
1689 msgid "B<--no-dep14tag>"
1690 msgstr ""
1691
1692 #. type: Plain text
1693 #: ../dgit.1:943
1694 msgid ""
1695 "Do not generate a DEP-14 tag, except in split quilt view mode.  (On servers "
1696 "where only the old tag format is supported, the dgit tag will have the "
1697 "DEP-14 name.  This option does not prevent that.)"
1698 msgstr ""
1699
1700 #. type: TP
1701 #: ../dgit.1:943
1702 #, no-wrap
1703 msgid "B<--dep14tag-always>"
1704 msgstr ""
1705
1706 #. type: Plain text
1707 #: ../dgit.1:948
1708 msgid ""
1709 "Insist on generating a DEP-14 tag as well as a dgit tag.  If the server does "
1710 "not support that, dgit push will fail."
1711 msgstr ""
1712
1713 #. type: TP
1714 #: ../dgit.1:948
1715 #, no-wrap
1716 msgid "B<-D>"
1717 msgstr ""
1718
1719 #. type: Plain text
1720 #: ../dgit.1:952
1721 msgid ""
1722 "Prints debugging information to stderr.  Repeating the option produces more "
1723 "output (currently, up to -DDDD is meaningfully different)."
1724 msgstr ""
1725
1726 #. type: TP
1727 #: ../dgit.1:952
1728 #, no-wrap
1729 msgid "B<-c>I<name>B<=>I<value>"
1730 msgstr ""
1731
1732 #. type: Plain text
1733 #: ../dgit.1:956
1734 msgid ""
1735 "Specifies a git configuration option, to be used for this run.  dgit itself "
1736 "is also controlled by git configuration options."
1737 msgstr ""
1738
1739 #. type: TP
1740 #: ../dgit.1:956
1741 #, no-wrap
1742 msgid "B<-v>I<version>|B<_> | B<--since-version=>versionI<|>B<_>"
1743 msgstr ""
1744
1745 #. type: Plain text
1746 #: ../dgit.1:965
1747 msgid ""
1748 "Specifies the B<-v>I<version> option to pass to dpkg-genchanges, during "
1749 "builds.  Changes (from debian/changelog) since this version will be included "
1750 "in the built changes file, and hence in the upload.  If this option is not "
1751 "specified, dgit will query the archive and use the latest version uploaded "
1752 "to the intended suite."
1753 msgstr ""
1754
1755 #. type: Plain text
1756 #: ../dgit.1:971
1757 msgid ""
1758 "Specifying B<_> inhibits this, so that no -v option will be passed to dpkg-"
1759 "genchanges (and as a result, only the last stanza from debian/changelog will "
1760 "be used for the build and upload)."
1761 msgstr ""
1762
1763 #. type: TP
1764 #: ../dgit.1:971
1765 #, no-wrap
1766 msgid "B<-m>I<maintaineraddress>"
1767 msgstr ""
1768
1769 #. type: Plain text
1770 #: ../dgit.1:974
1771 msgid "Passed to dpkg-genchanges (eventually)."
1772 msgstr ""
1773
1774 #. type: TP
1775 #: ../dgit.1:974
1776 #, no-wrap
1777 msgid "B<--ch:>I<option>"
1778 msgstr ""
1779
1780 #. type: Plain text
1781 #: ../dgit.1:978
1782 msgid ""
1783 "Specifies a single additional option to pass, eventually, to dpkg-genchanges."
1784 msgstr ""
1785
1786 #. type: Plain text
1787 #: ../dgit.1:985
1788 msgid ""
1789 "Options which are safe to pass include B<-C> (and also B<-si -sa -sd> "
1790 "although these should never be necessary with Debian since dgit "
1791 "automatically calculates whether .origs need to be uploaded.)"
1792 msgstr ""
1793
1794 #. type: Plain text
1795 #: ../dgit.1:987
1796 msgid "For other options the caveat below applies."
1797 msgstr ""
1798
1799 #. type: TP
1800 #: ../dgit.1:987
1801 #, no-wrap
1802 msgid "B<--curl:>I<option> | B<--dput:>I<option> |..."
1803 msgstr ""
1804
1805 #. type: Plain text
1806 #: ../dgit.1:1009
1807 msgid ""
1808 "Specifies a single additional option to pass to B<curl>, B<dput>, "
1809 "B<debsign>, B<dpkg-source>, B<dpkg-buildpackage>, B<dpkg-genchanges>, "
1810 "B<sbuild>, B<pbuilder>, B<cowbuilder>, B<ssh>, B<dgit>, B<git-debrebase>, "
1811 "B<apt-get>, B<apt-cache>, B<gbp-pq>, B<gbp-build>, or B<mergechanges>.  Can "
1812 "be repeated as necessary."
1813 msgstr ""
1814
1815 #. type: Plain text
1816 #: ../dgit.1:1017
1817 msgid ""
1818 "Use of this ability should not normally be necessary.  It is provided for "
1819 "working around bugs, or other unusual situations.  If you use these options, "
1820 "you may violate dgit's assumptions about the behaviour of its subprograms "
1821 "and cause lossage."
1822 msgstr ""
1823
1824 #. type: Plain text
1825 #: ../dgit.1:1022
1826 msgid ""
1827 "For dpkg-buildpackage, dpkg-genchanges, mergechanges and sbuild, the option "
1828 "applies only when the program is invoked directly by dgit.  Usually, for "
1829 "passing options to dpkg-genchanges, you should use B<--ch:>I<option>."
1830 msgstr ""
1831
1832 #. type: Plain text
1833 #: ../dgit.1:1026
1834 msgid ""
1835 "Specifying --git is not effective for some lower-level read-only git "
1836 "operations performed by dgit, and also not when git is invoked by another "
1837 "program run by dgit."
1838 msgstr ""
1839
1840 #. type: Plain text
1841 #: ../dgit.1:1028
1842 msgid "See notes below regarding ssh and dgit."
1843 msgstr ""
1844
1845 #. type: Plain text
1846 #: ../dgit.1:1036
1847 msgid ""
1848 "NB that --gpg:option is not supported (because debsign does not have that "
1849 "facility).  But see B<-k> and the B<keyid> distro config setting."
1850 msgstr ""
1851
1852 #. type: TP
1853 #: ../dgit.1:1036
1854 #, no-wrap
1855 msgid "B<--curl=>I<program> | B<--dput=>I<program> |..."
1856 msgstr ""
1857
1858 #. type: Plain text
1859 #: ../dgit.1:1059
1860 msgid ""
1861 "Specifies alternative programs to use instead of B<curl>, B<dput>, "
1862 "B<debsign>, B<dpkg-source>, B<dpkg-buildpackage>, B<dpkg-genchanges>, "
1863 "B<sbuild>, B<pbuilder>, B<cowbuilder>, B<gpg>, B<ssh>, B<dgit>, B<git-"
1864 "debrebase>, B<apt-get>, B<apt-cache>, B<git>, B<gbp-pq>, B<gbp-build>, or "
1865 "B<mergechanges>."
1866 msgstr ""
1867
1868 #. type: Plain text
1869 #: ../dgit.1:1067
1870 msgid ""
1871 "For B<dpkg-buildpackage>, B<dpkg-genchanges>, B<mergechanges> and B<sbuild>, "
1872 "this applies only when the program is invoked directly by dgit."
1873 msgstr ""
1874
1875 #. type: Plain text
1876 #: ../dgit.1:1074
1877 msgid ""
1878 "For B<dgit>, specifies the command to run on the remote host when dgit rpush "
1879 "needs to invoke a remote copy of itself.  (dgit also reinvokes itself as the "
1880 "EDITOR for dpkg-source --commit; this is done using argv[0], and is not "
1881 "affected by --dgit=)."
1882 msgstr ""
1883
1884 #. type: Plain text
1885 #: ../dgit.1:1085
1886 msgid ""
1887 "B<gbp-build>'s value is used instead of gbp build or git-buildpackage.  (The "
1888 "default is the latter unless the former exists on PATH.)  B<gbp-pq>'s value "
1889 "is used instead of gbp pq.  In both cases, unusually, the specified value is "
1890 "split on whitespace to produce a command and possibly some options and/or "
1891 "arguments."
1892 msgstr ""
1893
1894 #. type: Plain text
1895 #: ../dgit.1:1093
1896 msgid ""
1897 "For pbuilder and cowbuilder, the defaults are B<sudo -E pbuilder> and B<sudo "
1898 "-E cowbuilder> respectively.  Like with gbp-build and gbp pq, the specified "
1899 "value is split on whitespace."
1900 msgstr ""
1901
1902 #. type: Plain text
1903 #: ../dgit.1:1110
1904 msgid ""
1905 "For B<ssh>, the default value is taken from the B<DGIT_SSH> or B<GIT_SSH> "
1906 "environment variables, if set (see below).  And, for ssh, when accessing the "
1907 "archive and dgit-repos, this command line setting is overridden by the git "
1908 "config variables B<dgit-distro.>I<distro>B<.ssh> and B<.dgit.default.ssh> "
1909 "(which can in turn be overridden with -c).  Also, when dgit is using git to "
1910 "access dgit-repos, only git's idea of what ssh to use (eg, B<GIT_SSH>)  is "
1911 "relevant."
1912 msgstr ""
1913
1914 #. type: TP
1915 #: ../dgit.1:1110
1916 #, no-wrap
1917 msgid "B<--existing-package=>I<package>"
1918 msgstr ""
1919
1920 #. type: Plain text
1921 #: ../dgit.1:1120
1922 msgid ""
1923 "dgit push needs to canonicalise the suite name.  Sometimes, dgit lacks a way "
1924 "to ask the archive to do this without knowing the name of an existing "
1925 "package.  Without --new we can just use the package we are trying to push.  "
1926 "But with --new that will not work, so we guess B<dpkg> or use the value of "
1927 "this option.  This option is not needed with the default mechanisms for "
1928 "accessing the archive."
1929 msgstr ""
1930
1931 #. type: TP
1932 #: ../dgit.1:1120
1933 #, no-wrap
1934 msgid "B<-h>|B<--help>"
1935 msgstr ""
1936
1937 #. type: TP
1938 #: ../dgit.1:1123
1939 #, no-wrap
1940 msgid "B<--initiator-tempdir=>I<directory>"
1941 msgstr ""
1942
1943 #. type: Plain text
1944 #: ../dgit.1:1132
1945 msgid ""
1946 "dgit rpush uses a temporary directory on the invoking (signing) host.  This "
1947 "option causes dgit to use I<directory> instead.  Furthermore, the specified "
1948 "directory will be emptied, removed and recreated before dgit starts, rather "
1949 "than removed after dgit finishes.  The directory specified must be an "
1950 "absolute pathname."
1951 msgstr ""
1952
1953 #. type: TP
1954 #: ../dgit.1:1132
1955 #, no-wrap
1956 msgid "B<--force->I<something>"
1957 msgstr ""
1958
1959 #. type: Plain text
1960 #: ../dgit.1:1140
1961 msgid ""
1962 "Instructs dgit to try to proceed despite detecting what it thinks is going "
1963 "to be a fatal problem.  B<This is probably not going to work.> These options "
1964 "are provided as an escape hatch, in case dgit is confused.  (They might also "
1965 "be useful for testing error cases.)"
1966 msgstr ""
1967
1968 #. type: TP
1969 #: ../dgit.1:1140
1970 #, no-wrap
1971 msgid "B<--force-import-dsc-with-dgit-field>"
1972 msgstr ""
1973
1974 #. type: Plain text
1975 #: ../dgit.1:1147
1976 msgid ""
1977 "Tell dgit import-dsc to treat a .dsc with a Dgit field like one without it.  "
1978 "The result is a fresh import, discarding the git history that the person who "
1979 "pushed that .dsc was working with."
1980 msgstr ""
1981
1982 #. type: TP
1983 #: ../dgit.1:1147
1984 #, no-wrap
1985 msgid "B<--force-uploading-binaries>"
1986 msgstr ""
1987
1988 #. type: Plain text
1989 #: ../dgit.1:1152
1990 msgid ""
1991 "Carry on and upload binaries even though dgit thinks your distro does not "
1992 "permit that."
1993 msgstr ""
1994
1995 #. type: TP
1996 #: ../dgit.1:1152
1997 #, no-wrap
1998 msgid "B<--force-uploading-source-only>"
1999 msgstr ""
2000
2001 #. type: Plain text
2002 #: ../dgit.1:1158
2003 msgid ""
2004 "Carry on and do a source-only upload, without any binaries, even though dgit "
2005 "thinks your distro does not permit that, or does not permit that in this "
2006 "situation."
2007 msgstr ""
2008
2009 #. type: TP
2010 #: ../dgit.1:1158
2011 #, no-wrap
2012 msgid "B<--force-unrepresentable>"
2013 msgstr ""
2014
2015 #. type: Plain text
2016 #: ../dgit.1:1165
2017 msgid ""
2018 "Carry on even if dgit thinks that your git tree contains changes (relative "
2019 "to your .orig tarballs)  which dpkg-source is not able to represent.  Your "
2020 "build or push will probably fail later."
2021 msgstr ""
2022
2023 #. type: TP
2024 #: ../dgit.1:1165
2025 #, no-wrap
2026 msgid "B<--force-changes-origs-exactly>"
2027 msgstr ""
2028
2029 #. type: Plain text
2030 #: ../dgit.1:1170
2031 msgid ""
2032 "Use the set of .origs specified in your .changes, exactly, without regard to "
2033 "what is in the archive already.  The archive may well reject your upload."
2034 msgstr ""
2035
2036 #. type: TP
2037 #: ../dgit.1:1170
2038 #, no-wrap
2039 msgid "B<--force-unsupported-source-format>"
2040 msgstr ""
2041
2042 #. type: Plain text
2043 #: ../dgit.1:1174
2044 msgid ""
2045 "Carry on despite dgit not understanding your source package format.  dgit "
2046 "will probably mishandle it."
2047 msgstr ""
2048
2049 #. type: TP
2050 #: ../dgit.1:1174
2051 #, no-wrap
2052 msgid "B<--force-dsc-changes-mismatch>"
2053 msgstr ""
2054
2055 #. type: Plain text
2056 #: ../dgit.1:1178
2057 msgid ""
2058 "Do not check whether .dsc and .changes match.  The archive will probably "
2059 "reject your upload."
2060 msgstr ""
2061
2062 #. type: TP
2063 #: ../dgit.1:1178
2064 #, no-wrap
2065 msgid "B<--force-import-gitapply-absurd> | B<--force-import-gitapply-no-absurd>"
2066 msgstr ""
2067
2068 #. type: Plain text
2069 #: ../dgit.1:1184
2070 msgid ""
2071 "Force on or off the use of the absurd git-apply emulation when running gbp "
2072 "pq import when importing a package from a .dsc.  See Debian bug #841867."
2073 msgstr ""
2074
2075 #. type: =head1
2076 #: ../dgit.1:1184 ../dgit-downstream-dsc.7.pod:150
2077 #, no-wrap
2078 msgid "CONFIGURATION"
2079 msgstr ""
2080
2081 #. type: Plain text
2082 #: ../dgit.1:1190
2083 msgid ""
2084 "dgit can be configured via the git config system.  You may set keys with git-"
2085 "config (either in system-global or per-tree configuration), or provide B<-"
2086 "c>I<key>B<=>I<value> on the dgit command line."
2087 msgstr ""
2088
2089 #. type: Plain text
2090 #: ../dgit.1:1192
2091 msgid "Settings likely to be useful for an end user include:"
2092 msgstr ""
2093
2094 #. type: TP
2095 #: ../dgit.1:1192
2096 #, no-wrap
2097 msgid "B<dgit.default.build-products-dir>"
2098 msgstr ""
2099
2100 #. type: Plain text
2101 #: ../dgit.1:1198
2102 msgid ""
2103 "Specifies where to find the built files to be uploaded, when --build-"
2104 "products-dir is not specified.  The default is the parent directory (B<..>)."
2105 msgstr ""
2106
2107 #. type: =item
2108 #: ../dgit.1:1198 ../dgit-downstream-dsc.7.pod:286
2109 #, no-wrap
2110 msgid "B<dgit-suite.>I<suite>B<.distro> I<distro>"
2111 msgstr ""
2112
2113 #. type: Plain text
2114 #: ../dgit.1:1203
2115 msgid ""
2116 "Specifies the distro for a suite.  dgit keys off the suite name (which "
2117 "appears in changelogs etc.), and uses that to determine the distro which is "
2118 "involved.  The config used is thereafter that for the distro."
2119 msgstr ""
2120
2121 #. type: Plain text
2122 #: ../dgit.1:1206
2123 msgid "I<suite> may be a glob pattern."
2124 msgstr ""
2125
2126 #. type: TP
2127 #: ../dgit.1:1206
2128 #, no-wrap
2129 msgid "B<dgit.default.distro>I< distro>"
2130 msgstr ""
2131
2132 #. type: Plain text
2133 #: ../dgit.1:1209
2134 msgid "The default distro for an unknown suite."
2135 msgstr ""
2136
2137 #. type: TP
2138 #: ../dgit.1:1209
2139 #, no-wrap
2140 msgid "B<dgit.default.default-suite>I< suite>"
2141 msgstr ""
2142
2143 #. type: Plain text
2144 #: ../dgit.1:1212
2145 msgid "The default suite (eg for clone)."
2146 msgstr ""
2147
2148 #. type: TP
2149 #: ../dgit.1:1212
2150 #, no-wrap
2151 msgid "B<dgit.default.>*"
2152 msgstr ""
2153
2154 #. type: Plain text
2155 #: ../dgit.1:1217
2156 msgid ""
2157 "for each B<dgit-distro.>I<distro>B<.>*, the default value used if there is "
2158 "no distro-specific setting."
2159 msgstr ""
2160
2161 #. type: TP
2162 #: ../dgit.1:1217
2163 #, no-wrap
2164 msgid "B<dgit-distro.>I<distro>B<.clean-mode>"
2165 msgstr ""
2166
2167 #. type: Plain text
2168 #: ../dgit.1:1221
2169 msgid ""
2170 "One of the values for the command line --clean= option; used if --clean is "
2171 "not specified."
2172 msgstr ""
2173
2174 #. type: TP
2175 #: ../dgit.1:1221
2176 #, no-wrap
2177 msgid "B<dgit-distro.>I<distro>B<.quilt-mode>"
2178 msgstr ""
2179
2180 #. type: Plain text
2181 #: ../dgit.1:1225
2182 msgid ""
2183 "One of the values for the command line --quilt= option; used if --quilt is "
2184 "not specified."
2185 msgstr ""
2186
2187 #. type: TP
2188 #: ../dgit.1:1225
2189 #, no-wrap
2190 msgid "B<dgit-distro.>I<distro>B<.rm-old-changes>"
2191 msgstr ""
2192
2193 #. type: Plain text
2194 #: ../dgit.1:1229
2195 msgid ""
2196 "Boolean, used if neither --rm-old-changes nor --no-rm-old-changes is "
2197 "specified.  The default is not to remove."
2198 msgstr ""
2199
2200 #. type: TP
2201 #: ../dgit.1:1229
2202 #, no-wrap
2203 msgid "B<dgit-distro.>I<distro>B<.readonly> B<auto>|B<a> | B<true>|B<t>|B<y>|B<1> | B<false>|B<f>|B<n>|B<0>"
2204 msgstr ""
2205
2206 #. type: Plain text
2207 #: ../dgit.1:1236
2208 msgid ""
2209 "Whether you have push access to the distro.  For Debian, it is OK to use "
2210 "auto, which uses readonly mode if you are not pushing right now; but, "
2211 "setting this to false will avoid relying on the mirror of the dgit git "
2212 "repository server."
2213 msgstr ""
2214
2215 #. type: TP
2216 #: ../dgit.1:1236
2217 #, no-wrap
2218 msgid "B<dgit-distro.>I<distro>B<.keyid>"
2219 msgstr ""
2220
2221 #. type: Plain text
2222 #: ../dgit.1:1240
2223 msgid "See also B<-k>."
2224 msgstr ""
2225
2226 #. type: TP
2227 #: ../dgit.1:1240
2228 #, no-wrap
2229 msgid "B<dgit-distro.>I<distro>B<.mirror>I< url>"
2230 msgstr ""
2231
2232 #. type: TP
2233 #: ../dgit.1:1242
2234 #, no-wrap
2235 msgid "B<dgit-distro.>I<distro>B<.username>"
2236 msgstr ""
2237
2238 #. type: Plain text
2239 #: ../dgit.1:1245
2240 msgid "Not relevant for Debian."
2241 msgstr ""
2242
2243 #. type: =item
2244 #: ../dgit.1:1245 ../dgit-downstream-dsc.7.pod:242
2245 #, no-wrap
2246 msgid "B<dgit-distro.>I<distro>B<.upload-host>"
2247 msgstr ""
2248
2249 #. type: Plain text
2250 #: ../dgit.1:1248
2251 msgid "Might be useful if you have an intermediate queue server."
2252 msgstr ""
2253
2254 #. type: TP
2255 #: ../dgit.1:1248
2256 #, no-wrap
2257 msgid "B<dgit-distro.>I<distro>B<.user-name>I< >B<dgit-distro.>I<distro>B<.user-email>"
2258 msgstr ""
2259
2260 #. type: Plain text
2261 #: ../dgit.1:1253
2262 msgid ""
2263 "Values to configure for user.name and user.email in new git trees.  If not "
2264 "specified, the DEBFULLNAME and DEBEMAIL environment variables are used, "
2265 "respectively.  Only used if .setup-usermail is not disabled."
2266 msgstr ""
2267
2268 #. type: TP
2269 #: ../dgit.1:1253
2270 #, no-wrap
2271 msgid "B<dgit-distro.>I<distro>B<.setup-useremail>"
2272 msgstr ""
2273
2274 #. type: Plain text
2275 #: ../dgit.1:1257
2276 msgid ""
2277 "Whether to set user.name and user.email in new git trees.  True by default.  "
2278 "Ignored for dgit setup-setup-useremail, which does it anyway."
2279 msgstr ""
2280
2281 #. type: TP
2282 #: ../dgit.1:1257
2283 #, no-wrap
2284 msgid "B<dgit-distro.>I<distro>B<.setup-mergechangelogs>"
2285 msgstr ""
2286
2287 #. type: Plain text
2288 #: ../dgit.1:1262
2289 msgid ""
2290 "Whether to setup a merge driver which uses dpkg-mergechangelogs for debian/"
2291 "changelog.  True by default.  Ignored for dgit setup-mergechangelogs, which "
2292 "does it anyway."
2293 msgstr ""
2294
2295 #. type: TP
2296 #: ../dgit.1:1262
2297 #, no-wrap
2298 msgid "B<dgit-distro.>I<distro>B<.setup-gitattributes>"
2299 msgstr ""
2300
2301 #. type: Plain text
2302 #: ../dgit.1:1268
2303 msgid ""
2304 "Whether to configure .git/info/attributes to suppress checkin/checkout file "
2305 "content transformations in new git trees.  True by default.  Ignored for "
2306 "dgit setup-gitattributes, which does it anyway."
2307 msgstr ""
2308
2309 #. type: TP
2310 #: ../dgit.1:1268
2311 #, no-wrap
2312 msgid "B<dgit-distro.>I<distro>B<.cmd->I<cmd>"
2313 msgstr ""
2314
2315 #. type: Plain text
2316 #: ../dgit.1:1274
2317 msgid "Program to use instead of I<cmd>.  Works like B<-->I<cmd>B<=>... ."
2318 msgstr ""
2319
2320 #. type: TP
2321 #: ../dgit.1:1274
2322 #, no-wrap
2323 msgid "B<dgit-distro.>I<distro>B<.opts->I<cmd>"
2324 msgstr ""
2325
2326 #. type: Plain text
2327 #: ../dgit.1:1285
2328 msgid ""
2329 "Extra options to pass to I<cmd>.  Works like B<-->I<cmd>B<:>... .  To pass "
2330 "several options, configure multiple values in git config (with git config --"
2331 "add).  The options for B<dgit.default.opts->I<cmd> B<dgit-distro."
2332 ">I<distro>B</push.opts->I<cmd> and are all used, followed by options from "
2333 "dgit's command line."
2334 msgstr ""
2335
2336 #. type: SH
2337 #: ../dgit.1:1285
2338 #, no-wrap
2339 msgid "ACCESS CONFIGURATION"
2340 msgstr ""
2341
2342 #. type: Plain text
2343 #: ../dgit.1:1290
2344 msgid ""
2345 "There are many other settings which specify how a particular distro's "
2346 "services (archive and git) are provided.  These should not normally be "
2347 "adjusted, but are documented for the benefit of distros who wish to adopt "
2348 "dgit."
2349 msgstr ""
2350
2351 #. type: TP
2352 #: ../dgit.1:1290
2353 #, no-wrap
2354 msgid "B<dgit-distro.>I<distro>B<.nominal-distro>"
2355 msgstr ""
2356
2357 #. type: Plain text
2358 #: ../dgit.1:1293
2359 msgid "Shown in git tags, Dgit fields, and so on."
2360 msgstr ""
2361
2362 #. type: TP
2363 #: ../dgit.1:1293
2364 #, no-wrap
2365 msgid "B<dgit-distro.>I<distro>B<.alias-canon>"
2366 msgstr ""
2367
2368 #. type: Plain text
2369 #: ../dgit.1:1296
2370 msgid "Used for all access configuration lookup."
2371 msgstr ""
2372
2373 #. type: TP
2374 #: ../dgit.1:1296
2375 #, no-wrap
2376 msgid "B<dgit-distro.>I<distro>B</push.>*"
2377 msgstr ""
2378
2379 #. type: Plain text
2380 #: ../dgit.1:1302
2381 msgid ""
2382 "If set, overrides corresponding non B</push> config when B<readonly=false>, "
2383 "or when pushing and B<readonly=auto>."
2384 msgstr ""
2385
2386 #. type: TP
2387 #: ../dgit.1:1302
2388 #, no-wrap
2389 msgid "B<dgit-distro.>I<distro>B<.git-url>"
2390 msgstr ""
2391
2392 #. type: TP
2393 #: ../dgit.1:1304
2394 #, no-wrap
2395 msgid "B<dgit-distro.>I<distro>B<.git-url>[B<-suffix>]"
2396 msgstr ""
2397
2398 #. type: TP
2399 #: ../dgit.1:1306
2400 #, no-wrap
2401 msgid "B<dgit-distro.>I<distro>B<.git-proto>"
2402 msgstr ""
2403
2404 #. type: TP
2405 #: ../dgit.1:1308
2406 #, no-wrap
2407 msgid "B<dgit-distro.>I<distro>B<.git-path>"
2408 msgstr ""
2409
2410 #. type: TP
2411 #: ../dgit.1:1310
2412 #, no-wrap
2413 msgid "B<dgit-distro.>I<distro>B<.git-check> B<true>|B<false>|B<url>|B<ssh-cmd>"
2414 msgstr ""
2415
2416 #. type: TP
2417 #: ../dgit.1:1312
2418 #, no-wrap
2419 msgid "B<dgit-distro.>I<distro>B<.git-check-suffix>"
2420 msgstr ""
2421
2422 #. type: TP
2423 #: ../dgit.1:1314
2424 #, no-wrap
2425 msgid "B<dgit-distro.>I<distro>B<.diverts.divert> B<new-distro>|B</>I<distro-suffix>"
2426 msgstr ""
2427
2428 #. type: TP
2429 #: ../dgit.1:1316
2430 #, no-wrap
2431 msgid "B<dgit-distro.>I<distro>B<.git-create>I< >B<ssh-cmd>I<|>B<true>"
2432 msgstr ""
2433
2434 #. type: TP
2435 #: ../dgit.1:1318
2436 #, no-wrap
2437 msgid "B<dgit-distro.>I<distro>B<.archive-query> B<ftpmasterapi:> | B<madison:>I<distro> | B<dummycat:>I</path>  | B<sshpsql:>I<user>B<@>I<host>B<:>I<dbname>"
2438 msgstr ""
2439
2440 #. type: TP
2441 #: ../dgit.1:1320
2442 #, no-wrap
2443 msgid "B<dgit-distro.>I<distro>B<.archive-query->(B<url>|B<tls-key>|B<curl-ca-args>)"
2444 msgstr ""
2445
2446 #. type: TP
2447 #: ../dgit.1:1322
2448 #, no-wrap
2449 msgid "B<dgit-distro.>I<distro>B<.madison-distro>"
2450 msgstr ""
2451
2452 #. type: TP
2453 #: ../dgit.1:1324
2454 #, no-wrap
2455 msgid "B<dgit-distro.>I<distro>B<.archive-query-default-component>"
2456 msgstr ""
2457
2458 #. type: TP
2459 #: ../dgit.1:1326
2460 #, no-wrap
2461 msgid "B<dgit-distro.>I<distro>B<.dgit-tag-format>"
2462 msgstr ""
2463
2464 #. type: TP
2465 #: ../dgit.1:1328
2466 #, no-wrap
2467 msgid "B<dgit-distro.>I<distro>B<.dep14tag> B<want>|B<no>|B<always>"
2468 msgstr ""
2469
2470 #. type: TP
2471 #: ../dgit.1:1330
2472 #, no-wrap
2473 msgid "B<dgit-distro.>I<distro>B<.ssh>"
2474 msgstr ""
2475
2476 #. type: TP
2477 #: ../dgit.1:1332
2478 #, no-wrap
2479 msgid "B<dgit-distro.>I<distro>B<.sshpsql-dbname>"
2480 msgstr ""
2481
2482 #. type: TP
2483 #: ../dgit.1:1334
2484 #, no-wrap
2485 msgid "B<dgit-distro.>I<distro>B<.>(B<git>|B<sshpsql>)B<->(B<user>|B<host>|B<user-force>)"
2486 msgstr ""
2487
2488 #. type: TP
2489 #: ../dgit.1:1336
2490 #, no-wrap
2491 msgid "B<dgit-distro.>I<distro>B<.backports-quirk>"
2492 msgstr ""
2493
2494 #. type: TP
2495 #: ../dgit.1:1338
2496 #, no-wrap
2497 msgid "B<dgit-distro.>I<distro>B<.rewrite-map-enable>"
2498 msgstr ""
2499
2500 #. type: TP
2501 #: ../dgit.1:1340
2502 #, no-wrap
2503 msgid "B<dgit-distro.>I<distro>B<.source-only-uploads> B<ok>|B<always>|B<never>|B<not-wholly-new>"
2504 msgstr ""
2505
2506 #. type: TP
2507 #: ../dgit.1:1342
2508 #, no-wrap
2509 msgid "B<dgit.default.old-dsc-distro>"
2510 msgstr ""
2511
2512 #. type: TP
2513 #: ../dgit.1:1344
2514 #, no-wrap
2515 msgid "B<dgit.dsc-url-proto-ok.>I<protocol>"
2516 msgstr ""
2517
2518 #. type: TP
2519 #: ../dgit.1:1346
2520 #, no-wrap
2521 msgid "B<dgit.dsc-url-proto-ok.bad-syntax>"
2522 msgstr ""
2523
2524 #. type: TP
2525 #: ../dgit.1:1348
2526 #, no-wrap
2527 msgid "B<dgit.default.dsc-url-proto-ok>"
2528 msgstr ""
2529
2530 #. type: TP
2531 #: ../dgit.1:1350
2532 #, no-wrap
2533 msgid "B<dgit.vcs-git.suites> I<suite>[B<;>...]"
2534 msgstr ""
2535
2536 #. type: SH
2537 #: ../dgit.1:1352
2538 #, no-wrap
2539 msgid "ENVIRONMENT VARIABLES"
2540 msgstr ""
2541
2542 #. type: TP
2543 #: ../dgit.1:1353
2544 #, no-wrap
2545 msgid "B<DGIT_SSH>, B<GIT_SSH>"
2546 msgstr ""
2547
2548 #. type: Plain text
2549 #: ../dgit.1:1362
2550 msgid ""
2551 "specify an alternative default program (and perhaps arguments) to use "
2552 "instead of ssh.  DGIT_SSH is consulted first and may contain arguments; if "
2553 "it contains any whitespace will be passed to the shell.  GIT_SSH specifies "
2554 "just the program; no arguments can be specified, so dgit interprets it the "
2555 "same way as git does.  See also the --ssh= and --ssh: options."
2556 msgstr ""
2557
2558 #. type: TP
2559 #: ../dgit.1:1362
2560 #, no-wrap
2561 msgid "B<DEBEMAIL>, B<DEBFULLNAME>"
2562 msgstr ""
2563
2564 #. type: Plain text
2565 #: ../dgit.1:1366
2566 msgid ""
2567 "Default git user.email and user.name for new trees.  See B<dgit setup-new-"
2568 "tree>."
2569 msgstr ""
2570
2571 #. type: TP
2572 #: ../dgit.1:1366
2573 #, no-wrap
2574 msgid "B<gpg>, B<dpkg->..., B<debsign>, B<git>, B<curl>, B<dput>, B<LWP::UserAgent>"
2575 msgstr ""
2576
2577 #. type: Plain text
2578 #: ../dgit.1:1371
2579 msgid ""
2580 "and other subprograms and modules used by dgit are affected by various "
2581 "environment variables.  Consult the documentaton for those programs for "
2582 "details."
2583 msgstr ""
2584
2585 #. type: SH
2586 #: ../dgit.1:1371
2587 #, no-wrap
2588 msgid "BUGS"
2589 msgstr ""
2590
2591 #. type: Plain text
2592 #: ../dgit.1:1378
2593 msgid ""
2594 "There should be a `dgit rebase-prep' command or some such to turn a fast-"
2595 "forwarding branch containing pseudo-merges back into a rebasing patch "
2596 "stack.  It might have to leave a note for a future dgit push."
2597 msgstr ""
2598
2599 #. type: Plain text
2600 #: ../dgit.1:1384
2601 msgid ""
2602 "If the dgit push fails halfway through, it is not necessarily restartable "
2603 "and idempotent.  It would be good to check that the proposed signing key is "
2604 "available before starting work."
2605 msgstr ""
2606
2607 #. type: Plain text
2608 #: ../dgit.1:1389
2609 msgid ""
2610 "dgit's build functions, and dgit push, may make changes to your current "
2611 "HEAD.  Sadly this is necessary for packages in the `3.0 (quilt)' source "
2612 "format.  This is ultimately due to what I consider design problems in quilt "
2613 "and dpkg-source."
2614 msgstr ""
2615
2616 #. type: Plain text
2617 #: ../dgit.1:1394
2618 msgid ""
2619 "--dry-run does not always work properly, as not doing some of the git "
2620 "fetches may result in subsequent actions being different.  Doing a non-dry-"
2621 "run dgit fetch first will help.  --damp-run is likely to work much better."
2622 msgstr ""
2623
2624 #. type: =head1
2625 #: ../dgit.1:1394 ../dgit.7:23 ../dgit-user.7.pod:447
2626 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
2627 #: ../dgit-maint-merge.7.pod:491 ../dgit-maint-gbp.7.pod:136
2628 #: ../dgit-maint-debrebase.7.pod:722 ../dgit-downstream-dsc.7.pod:352
2629 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:601
2630 #: ../git-debrebase.5.pod:678
2631 #, no-wrap
2632 msgid "SEE ALSO"
2633 msgstr ""
2634
2635 #. type: Plain text
2636 #: ../dgit.1:1403
2637 msgid ""
2638 "B<dgit>(7), B<dgit-*>(7), B<curl>(1), B<dput>(1), B<debsign>(1), B<git-"
2639 "config>(1), B<git-buildpackage>(1), B<dpkg-buildpackage>(1),"
2640 msgstr ""
2641
2642 #. type: Plain text
2643 #: ../dgit.1:1404
2644 msgid "https://browse.dgit.debian.org/"
2645 msgstr ""