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