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-08-10 19:42+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:1269
 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:637
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:637
1218 #, no-wrap
1219 msgid "B<--include-dirty>"
1220 msgstr ""
1221
1222 #. type: Plain text
1223 #: ../dgit.1:645
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:657
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:657
1245 #, no-wrap
1246 msgid "B<--ignore-dirty>"
1247 msgstr ""
1248
1249 #. type: Plain text
1250 #: ../dgit.1:660
1251 msgid "Deprecated alias for --include-dirty."
1252 msgstr ""
1253
1254 #. type: TP
1255 #: ../dgit.1:660
1256 #, no-wrap
1257 msgid "B<--overwrite>[=I<previous-version>]"
1258 msgstr ""
1259
1260 #. type: Plain text
1261 #: ../dgit.1:671
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:678
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:682
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:688
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:702
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:708
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:713
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:713
1321 #, no-wrap
1322 msgid "B<--delayed>=I<days>"
1323 msgstr ""
1324
1325 #. type: Plain text
1326 #: ../dgit.1:716
1327 msgid "Upload to a DELAYED queue."
1328 msgstr ""
1329
1330 #. type: Plain text
1331 #: ../dgit.1:726
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:731
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:731
1349 #, no-wrap
1350 msgid "B<--no-chase-dsc-distro>"
1351 msgstr ""
1352
1353 #. type: Plain text
1354 #: ../dgit.1:737
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:747
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:755
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:755
1380 #, no-wrap
1381 msgid "B<--save-dgit-view=>I<branch>|I<ref>"
1382 msgstr ""
1383
1384 #. type: Plain text
1385 #: ../dgit.1:765
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:769
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:773
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:777
1410 msgid "B<--dgit-view-save> is a deprecated alias for --save-dgit-view."
1411 msgstr ""
1412
1413 #. type: TP
1414 #: ../dgit.1:777
1415 #, no-wrap
1416 msgid "B<--deliberately->I<something>"
1417 msgstr ""
1418
1419 #. type: Plain text
1420 #: ../dgit.1:791
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:791
1433 #, no-wrap
1434 msgid "B<--deliberately-not-fast-forward>"
1435 msgstr ""
1436
1437 #. type: Plain text
1438 #: ../dgit.1:797
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:808
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:808
1458 #, no-wrap
1459 msgid "B<--deliberately-include-questionable-history>"
1460 msgstr ""
1461
1462 #. type: Plain text
1463 #: ../dgit.1:817
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:817
1476 #, no-wrap
1477 msgid "B<--deliberately-fresh-repo>"
1478 msgstr ""
1479
1480 #. type: Plain text
1481 #: ../dgit.1:822
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:822 ../git-debpush.1.pod:112
1490 #, no-wrap
1491 msgid "B<--quilt=linear>"
1492 msgstr ""
1493
1494 #. type: Plain text
1495 #: ../dgit.1:829
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:834
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:834 ../git-debpush.1.pod:124
1511 #, no-wrap
1512 msgid "B<--quilt=auto>"
1513 msgstr ""
1514
1515 #. type: Plain text
1516 #: ../dgit.1:843
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:843 ../git-debpush.1.pod:118
1527 #, no-wrap
1528 msgid "B<--quilt=smash>"
1529 msgstr ""
1530
1531 #. type: Plain text
1532 #: ../dgit.1:848
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:854
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:854 ../git-debpush.1.pod:129
1550 #, no-wrap
1551 msgid "B<--quilt=nofix>"
1552 msgstr ""
1553
1554 #. type: Plain text
1555 #: ../dgit.1:862
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:862
1565 #, no-wrap
1566 msgid "B<--quilt=nocheck> | B<--no-quilt-fixup>"
1567 msgstr ""
1568
1569 #. type: Plain text
1570 #: ../dgit.1:867
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:867
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:874
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:878
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:886
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:894
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:899
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:913
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:924
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:942
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:951
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:951
1673 #, no-wrap
1674 msgid "B<-d>I<distro> | B<--distro=>I<distro>"
1675 msgstr ""
1676
1677 #. type: Plain text
1678 #: ../dgit.1:960
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:966
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:971
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:971
1706 #, no-wrap
1707 msgid "B<--split-view=auto>|B<always>|B<never>"
1708 msgstr ""
1709
1710 #. type: Plain text
1711 #: ../dgit.1:976
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:984
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:990
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:993
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:996
1743 msgid "B<never> will cause dgit to fail if split view is needed."
1744 msgstr ""
1745
1746 #. type: Plain text
1747 #: ../dgit.1:1004
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:1007
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:1007
1763 #, no-wrap
1764 msgid "B<-C>I<changesfile>"
1765 msgstr ""
1766
1767 #. type: Plain text
1768 #: ../dgit.1:1012
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:1021
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:1021
1785 #, no-wrap
1786 msgid "B<--upstream-commitish=>I<upstream>"
1787 msgstr ""
1788
1789 #. type: Plain text
1790 #: ../dgit.1:1029
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:1029
1800 #, no-wrap
1801 msgid "B<--rm-old-changes>"
1802 msgstr ""
1803
1804 #. type: Plain text
1805 #: ../dgit.1:1041
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:1044
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:1044
1825 #, no-wrap
1826 msgid "B<--build-products-dir=>I<directory>"
1827 msgstr ""
1828
1829 #. type: Plain text
1830 #: ../dgit.1:1048
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:1051
1838 msgid "By default, dgit uses the parent directory (B<..>)."
1839 msgstr ""
1840
1841 #. type: Plain text
1842 #: ../dgit.1:1060
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:1060
1852 #, no-wrap
1853 msgid "B<--no-rm-on-error>"
1854 msgstr ""
1855
1856 #. type: Plain text
1857 #: ../dgit.1:1063
1858 msgid "Do not delete the destination directory if clone fails."
1859 msgstr ""
1860
1861 #. type: TP
1862 #: ../dgit.1:1063
1863 #, no-wrap
1864 msgid "B<--dep14tag>"
1865 msgstr ""
1866
1867 #. type: Plain text
1868 #: ../dgit.1:1070
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:1070
1876 #, no-wrap
1877 msgid "B<--no-dep14tag>"
1878 msgstr ""
1879
1880 #. type: Plain text
1881 #: ../dgit.1:1073
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:1073
1887 #, no-wrap
1888 msgid "B<--always-dep14tag>"
1889 msgstr ""
1890
1891 #. type: Plain text
1892 #: ../dgit.1:1076
1893 msgid "Obsolete alias for --dep14tag, retained for compatibility."
1894 msgstr ""
1895
1896 #. type: TP
1897 #: ../dgit.1:1076
1898 #, no-wrap
1899 msgid "B<-D>"
1900 msgstr ""
1901
1902 #. type: Plain text
1903 #: ../dgit.1:1080
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:1080
1911 #, no-wrap
1912 msgid "B<-c>I<name>B<=>I<value>"
1913 msgstr ""
1914
1915 #. type: Plain text
1916 #: ../dgit.1:1084
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:1084
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:1093
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:1099
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:1099
1948 #, no-wrap
1949 msgid "B<-m>I<maintaineraddress>"
1950 msgstr ""
1951
1952 #. type: Plain text
1953 #: ../dgit.1:1102
1954 msgid "Passed to dpkg-genchanges (eventually)."
1955 msgstr ""
1956
1957 #. type: TP
1958 #: ../dgit.1:1102
1959 #, no-wrap
1960 msgid "B<--ch:>I<option>"
1961 msgstr ""
1962
1963 #. type: Plain text
1964 #: ../dgit.1:1106
1965 msgid ""
1966 "Specifies a single additional option to pass, eventually, to dpkg-genchanges."
1967 msgstr ""
1968
1969 #. type: Plain text
1970 #: ../dgit.1:1113
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:1115
1979 msgid "For other options the caveat below applies."
1980 msgstr ""
1981
1982 #. type: TP
1983 #: ../dgit.1:1115
1984 #, no-wrap
1985 msgid "B<--curl:>I<option> | B<--dput:>I<option> |..."
1986 msgstr ""
1987
1988 #. type: Plain text
1989 #: ../dgit.1:1137
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:1145
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:1150
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:1154
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:1156
2025 msgid "See notes below regarding ssh and dgit."
2026 msgstr ""
2027
2028 #. type: Plain text
2029 #: ../dgit.1:1164
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:1164
2037 #, no-wrap
2038 msgid "B<--curl!:>I<option> | B<--dput!:>I<option> |..."
2039 msgstr ""
2040
2041 #. type: Plain text
2042 #: ../dgit.1:1170
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:1175
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:1182
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:1182
2065 #, no-wrap
2066 msgid "B<--curl=>I<program> | B<--dput=>I<program> |..."
2067 msgstr ""
2068
2069 #. type: Plain text
2070 #: ../dgit.1:1205
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:1213
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:1220
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:1231
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:1239
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:1256
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:1256
2127 #, no-wrap
2128 msgid "B<--existing-package=>I<package>"
2129 msgstr ""
2130
2131 #. type: Plain text
2132 #: ../dgit.1:1266
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:1266
2144 #, no-wrap
2145 msgid "B<-h>|B<--help>"
2146 msgstr ""
2147
2148 #. type: TP
2149 #: ../dgit.1:1269
2150 #, no-wrap
2151 msgid "B<--initiator-tempdir=>I<directory>"
2152 msgstr ""
2153
2154 #. type: Plain text
2155 #: ../dgit.1:1278
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:1278
2166 #, no-wrap
2167 msgid "B<--force->I<something>"
2168 msgstr ""
2169
2170 #. type: Plain text
2171 #: ../dgit.1:1286
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:1286
2181 #, no-wrap
2182 msgid "B<--force-import-dsc-with-dgit-field>"
2183 msgstr ""
2184
2185 #. type: Plain text
2186 #: ../dgit.1:1293
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:1293
2195 #, no-wrap
2196 msgid "B<--force-uploading-binaries>"
2197 msgstr ""
2198
2199 #. type: Plain text
2200 #: ../dgit.1:1298
2201 msgid ""
2202 "Carry on and upload binaries even though dgit thinks your distro does not "
2203 "permit that."
2204 msgstr ""
2205
2206 #. type: TP
2207 #: ../dgit.1:1298
2208 #, no-wrap
2209 msgid "B<--force-uploading-source-only>"
2210 msgstr ""
2211
2212 #. type: Plain text
2213 #: ../dgit.1:1304
2214 msgid ""
2215 "Carry on and do a source-only upload, without any binaries, even though dgit "
2216 "thinks your distro does not permit that, or does not permit that in this "
2217 "situation."
2218 msgstr ""
2219
2220 #. type: TP
2221 #: ../dgit.1:1304
2222 #, no-wrap
2223 msgid "B<--force-unrepresentable>"
2224 msgstr ""
2225
2226 #. type: Plain text
2227 #: ../dgit.1:1311
2228 msgid ""
2229 "Carry on even if dgit thinks that your git tree contains changes (relative "
2230 "to your .orig tarballs)  which dpkg-source is not able to represent.  Your "
2231 "build or push will probably fail later."
2232 msgstr ""
2233
2234 #. type: TP
2235 #: ../dgit.1:1311
2236 #, no-wrap
2237 msgid "B<--force-changes-origs-exactly>"
2238 msgstr ""
2239
2240 #. type: Plain text
2241 #: ../dgit.1:1316
2242 msgid ""
2243 "Use the set of .origs specified in your .changes, exactly, without regard to "
2244 "what is in the archive already.  The archive may well reject your upload."
2245 msgstr ""
2246
2247 #. type: TP
2248 #: ../dgit.1:1316
2249 #, no-wrap
2250 msgid "B<--force-unsupported-source-format>"
2251 msgstr ""
2252
2253 #. type: Plain text
2254 #: ../dgit.1:1320
2255 msgid ""
2256 "Carry on despite dgit not understanding your source package format.  dgit "
2257 "will probably mishandle it."
2258 msgstr ""
2259
2260 #. type: TP
2261 #: ../dgit.1:1320
2262 #, no-wrap
2263 msgid "B<--force-dsc-changes-mismatch>"
2264 msgstr ""
2265
2266 #. type: Plain text
2267 #: ../dgit.1:1324
2268 msgid ""
2269 "Do not check whether .dsc and .changes match.  The archive will probably "
2270 "reject your upload."
2271 msgstr ""
2272
2273 #. type: TP
2274 #: ../dgit.1:1324
2275 #, no-wrap
2276 msgid "B<--force-import-gitapply-absurd> | B<--force-import-gitapply-no-absurd>"
2277 msgstr ""
2278
2279 #. type: Plain text
2280 #: ../dgit.1:1330
2281 msgid ""
2282 "Force on or off the use of the absurd git-apply emulation when running gbp "
2283 "pq import when importing a package from a .dsc.  See Debian bug #841867."
2284 msgstr ""
2285
2286 #. type: TP
2287 #: ../dgit.1:1330
2288 #, no-wrap
2289 msgid "B<--for-push>"
2290 msgstr ""
2291
2292 #. type: Plain text
2293 #: ../dgit.1:1336
2294 msgid ""
2295 "Override the dgit-distro.distro.readonly configuration setting, to specify "
2296 "that we have read/write access and should use the corresponding git and "
2297 "achive access approach even if the operation is a read-only one."
2298 msgstr ""
2299
2300 #. type: =head1
2301 #: ../dgit.1:1336 ../dgit-downstream-dsc.7.pod:150
2302 #, no-wrap
2303 msgid "CONFIGURATION"
2304 msgstr ""
2305
2306 #. type: Plain text
2307 #: ../dgit.1:1342
2308 msgid ""
2309 "dgit can be configured via the git config system.  You may set keys with git-"
2310 "config (either in system-global or per-tree configuration), or provide B<-"
2311 "c>I<key>B<=>I<value> on the dgit command line."
2312 msgstr ""
2313
2314 #. type: Plain text
2315 #: ../dgit.1:1344
2316 msgid "Settings likely to be useful for an end user include:"
2317 msgstr ""
2318
2319 #. type: TP
2320 #: ../dgit.1:1344
2321 #, no-wrap
2322 msgid "B<dgit.default.build-products-dir>"
2323 msgstr ""
2324
2325 #. type: Plain text
2326 #: ../dgit.1:1350
2327 msgid ""
2328 "Specifies where to find the built files to be uploaded, when --build-"
2329 "products-dir is not specified.  The default is the parent directory (B<..>)."
2330 msgstr ""
2331
2332 #. type: =item
2333 #: ../dgit.1:1350 ../dgit-downstream-dsc.7.pod:286
2334 #, no-wrap
2335 msgid "B<dgit-suite.>I<suite>B<.distro> I<distro>"
2336 msgstr ""
2337
2338 #. type: Plain text
2339 #: ../dgit.1:1355
2340 msgid ""
2341 "Specifies the distro for a suite.  dgit keys off the suite name (which "
2342 "appears in changelogs etc.), and uses that to determine the distro which is "
2343 "involved.  The config used is thereafter that for the distro."
2344 msgstr ""
2345
2346 #. type: Plain text
2347 #: ../dgit.1:1358
2348 msgid "I<suite> may be a glob pattern."
2349 msgstr ""
2350
2351 #. type: TP
2352 #: ../dgit.1:1358
2353 #, no-wrap
2354 msgid "B<dgit.default.distro>I< distro>"
2355 msgstr ""
2356
2357 #. type: Plain text
2358 #: ../dgit.1:1361
2359 msgid "The default distro for an unknown suite."
2360 msgstr ""
2361
2362 #. type: TP
2363 #: ../dgit.1:1361
2364 #, no-wrap
2365 msgid "B<dgit.default.default-suite>I< suite>"
2366 msgstr ""
2367
2368 #. type: Plain text
2369 #: ../dgit.1:1364
2370 msgid "The default suite (eg for clone)."
2371 msgstr ""
2372
2373 #. type: TP
2374 #: ../dgit.1:1364
2375 #, no-wrap
2376 msgid "B<dgit.default.>*"
2377 msgstr ""
2378
2379 #. type: Plain text
2380 #: ../dgit.1:1369
2381 msgid ""
2382 "for each B<dgit-distro.>I<distro>B<.>*, the default value used if there is "
2383 "no distro-specific setting."
2384 msgstr ""
2385
2386 #. type: TP
2387 #: ../dgit.1:1369
2388 #, no-wrap
2389 msgid "B<dgit-distro.>I<distro>B<.clean-mode>"
2390 msgstr ""
2391
2392 #. type: Plain text
2393 #: ../dgit.1:1373
2394 msgid ""
2395 "One of the values for the command line --clean= option; used if --clean is "
2396 "not specified."
2397 msgstr ""
2398
2399 #. type: TP
2400 #: ../dgit.1:1373
2401 #, no-wrap
2402 msgid "B<dgit-distro.>I<distro>B<.clean-mode-newer>"
2403 msgstr ""
2404
2405 #. type: Plain text
2406 #: ../dgit.1:1379
2407 msgid ""
2408 "Like .clean-mode, but ignored if the value is unknown to this version of "
2409 "dgit.  Setting both .clean-mode and .clean-mode-newer is useful to provide a "
2410 "single git config compatible with different dgit versions."
2411 msgstr ""
2412
2413 #. type: TP
2414 #: ../dgit.1:1379
2415 #, no-wrap
2416 msgid "B<dgit-distro.>I<distro>B<.quilt-mode>"
2417 msgstr ""
2418
2419 #. type: Plain text
2420 #: ../dgit.1:1383
2421 msgid ""
2422 "One of the values for the command line --quilt= option; used if --quilt is "
2423 "not specified."
2424 msgstr ""
2425
2426 #. type: TP
2427 #: ../dgit.1:1383
2428 #, no-wrap
2429 msgid "B<dgit-distro.>I<distro>B<.split-view>"
2430 msgstr ""
2431
2432 #. type: TP
2433 #: ../dgit.1:1385
2434 #, no-wrap
2435 msgid "B<dgit-distro.>I<distro>B<.rm-old-changes>"
2436 msgstr ""
2437
2438 #. type: Plain text
2439 #: ../dgit.1:1389
2440 msgid ""
2441 "Boolean, used if neither --rm-old-changes nor --no-rm-old-changes is "
2442 "specified.  The default is not to remove."
2443 msgstr ""
2444
2445 #. type: TP
2446 #: ../dgit.1:1389
2447 #, no-wrap
2448 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>"
2449 msgstr ""
2450
2451 #. type: Plain text
2452 #: ../dgit.1:1396
2453 msgid ""
2454 "Whether you have push access to the distro.  For Debian, it is OK to use "
2455 "auto, which uses readonly mode if you are not pushing right now; but, "
2456 "setting this to false will avoid relying on the mirror of the dgit git "
2457 "repository server."
2458 msgstr ""
2459
2460 #. type: TP
2461 #: ../dgit.1:1396
2462 #, no-wrap
2463 msgid "B<dgit-distro.>I<distro>B<.keyid>"
2464 msgstr ""
2465
2466 #. type: Plain text
2467 #: ../dgit.1:1400
2468 msgid "See also B<-k>."
2469 msgstr ""
2470
2471 #. type: TP
2472 #: ../dgit.1:1400
2473 #, no-wrap
2474 msgid "B<dgit-distro.>I<distro>B<.mirror>I< url>"
2475 msgstr ""
2476
2477 #. type: TP
2478 #: ../dgit.1:1402
2479 #, no-wrap
2480 msgid "B<dgit-distro.>I<distro>B<.username>"
2481 msgstr ""
2482
2483 #. type: Plain text
2484 #: ../dgit.1:1405
2485 msgid "Not relevant for Debian."
2486 msgstr ""
2487
2488 #. type: =item
2489 #: ../dgit.1:1405 ../dgit-downstream-dsc.7.pod:242
2490 #, no-wrap
2491 msgid "B<dgit-distro.>I<distro>B<.upload-host>"
2492 msgstr ""
2493
2494 #. type: Plain text
2495 #: ../dgit.1:1408
2496 msgid "Might be useful if you have an intermediate queue server."
2497 msgstr ""
2498
2499 #. type: TP
2500 #: ../dgit.1:1408
2501 #, no-wrap
2502 msgid "B<dgit-distro.>I<distro>B<.user-name>I< >B<dgit-distro.>I<distro>B<.user-email>"
2503 msgstr ""
2504
2505 #. type: Plain text
2506 #: ../dgit.1:1413
2507 msgid ""
2508 "Values to configure for user.name and user.email in new git trees.  If not "
2509 "specified, the DEBFULLNAME and DEBEMAIL environment variables are used, "
2510 "respectively.  Only used if .setup-usermail is not disabled."
2511 msgstr ""
2512
2513 #. type: TP
2514 #: ../dgit.1:1413
2515 #, no-wrap
2516 msgid "B<dgit-distro.>I<distro>B<.setup-useremail>"
2517 msgstr ""
2518
2519 #. type: Plain text
2520 #: ../dgit.1:1417
2521 msgid ""
2522 "Whether to set user.name and user.email in new git trees.  True by default.  "
2523 "Ignored for dgit setup-useremail, which does it anyway."
2524 msgstr ""
2525
2526 #. type: TP
2527 #: ../dgit.1:1417
2528 #, no-wrap
2529 msgid "B<dgit-distro.>I<distro>B<.setup-mergechangelogs>"
2530 msgstr ""
2531
2532 #. type: Plain text
2533 #: ../dgit.1:1422
2534 msgid ""
2535 "Whether to set up a merge driver which uses dpkg-mergechangelogs for debian/"
2536 "changelog.  True by default.  Ignored for dgit setup-mergechangelogs, which "
2537 "does it anyway."
2538 msgstr ""
2539
2540 #. type: TP
2541 #: ../dgit.1:1422
2542 #, no-wrap
2543 msgid "B<dgit-distro.>I<distro>B<.setup-gitattributes>"
2544 msgstr ""
2545
2546 #. type: Plain text
2547 #: ../dgit.1:1428
2548 msgid ""
2549 "Whether to configure .git/info/attributes to suppress checkin/checkout file "
2550 "content transformations in new git trees.  True by default.  Ignored for "
2551 "dgit setup-gitattributes, which does it anyway."
2552 msgstr ""
2553
2554 #. type: TP
2555 #: ../dgit.1:1428
2556 #, no-wrap
2557 msgid "B<dgit-distro.>I<distro>B<.cmd->I<cmd>"
2558 msgstr ""
2559
2560 #. type: Plain text
2561 #: ../dgit.1:1434
2562 msgid "Program to use instead of I<cmd>.  Works like B<-->I<cmd>B<=>... ."
2563 msgstr ""
2564
2565 #. type: TP
2566 #: ../dgit.1:1434
2567 #, no-wrap
2568 msgid "B<dgit-distro.>I<distro>B<.opts->I<cmd>"
2569 msgstr ""
2570
2571 #. type: Plain text
2572 #: ../dgit.1:1446
2573 msgid ""
2574 "Extra options to pass to I<cmd>.  Works like B<-->I<cmd>B<:>... .  To pass "
2575 "several options, configure multiple values in git config (with git config --"
2576 "add).  The options for B<dgit.default.opts->I<cmd> and B<dgit-distro."
2577 ">I<distro>B</push.opts->I<cmd> are all used, followed by options from dgit's "
2578 "command line."
2579 msgstr ""
2580
2581 #. type: SH
2582 #: ../dgit.1:1446
2583 #, no-wrap
2584 msgid "ACCESS CONFIGURATION"
2585 msgstr ""
2586
2587 #. type: Plain text
2588 #: ../dgit.1:1451
2589 msgid ""
2590 "There are many other settings which specify how a particular distro's "
2591 "services (archive and git) are provided.  These should not normally be "
2592 "adjusted, but are documented for the benefit of distros who wish to adopt "
2593 "dgit."
2594 msgstr ""
2595
2596 #. type: TP
2597 #: ../dgit.1:1451
2598 #, no-wrap
2599 msgid "B<dgit-distro.>I<distro>B<.nominal-distro>"
2600 msgstr ""
2601
2602 #. type: Plain text
2603 #: ../dgit.1:1454
2604 msgid "Shown in git tags, Dgit fields, and so on."
2605 msgstr ""
2606
2607 #. type: TP
2608 #: ../dgit.1:1454
2609 #, no-wrap
2610 msgid "B<dgit-distro.>I<distro>B<.alias-canon>"
2611 msgstr ""
2612
2613 #. type: Plain text
2614 #: ../dgit.1:1457
2615 msgid "Used for all access configuration lookup."
2616 msgstr ""
2617
2618 #. type: TP
2619 #: ../dgit.1:1457
2620 #, no-wrap
2621 msgid "B<dgit-distro.>I<distro>B</push.>*"
2622 msgstr ""
2623
2624 #. type: Plain text
2625 #: ../dgit.1:1463
2626 msgid ""
2627 "If set, overrides corresponding non B</push> config when B<readonly=false>, "
2628 "or when pushing and B<readonly=auto>."
2629 msgstr ""
2630
2631 #. type: TP
2632 #: ../dgit.1:1463
2633 #, no-wrap
2634 msgid "B<dgit-distro.>I<distro>B<.git-url>"
2635 msgstr ""
2636
2637 #. type: TP
2638 #: ../dgit.1:1465
2639 #, no-wrap
2640 msgid "B<dgit-distro.>I<distro>B<.git-url>[B<-suffix>]"
2641 msgstr ""
2642
2643 #. type: TP
2644 #: ../dgit.1:1467
2645 #, no-wrap
2646 msgid "B<dgit-distro.>I<distro>B<.git-proto>"
2647 msgstr ""
2648
2649 #. type: TP
2650 #: ../dgit.1:1469
2651 #, no-wrap
2652 msgid "B<dgit-distro.>I<distro>B<.git-path>"
2653 msgstr ""
2654
2655 #. type: TP
2656 #: ../dgit.1:1471
2657 #, no-wrap
2658 msgid "B<dgit-distro.>I<distro>B<.git-check> B<true>|B<false>|B<url>|B<ssh-cmd>"
2659 msgstr ""
2660
2661 #. type: TP
2662 #: ../dgit.1:1473
2663 #, no-wrap
2664 msgid "B<dgit-distro.>I<distro>B<.git-check-suffix>"
2665 msgstr ""
2666
2667 #. type: TP
2668 #: ../dgit.1:1475
2669 #, no-wrap
2670 msgid "B<dgit-distro.>I<distro>B<.diverts.divert> B<new-distro>|B</>I<distro-suffix>"
2671 msgstr ""
2672
2673 #. type: TP
2674 #: ../dgit.1:1477
2675 #, no-wrap
2676 msgid "B<dgit-distro.>I<distro>B<.git-create>I< >B<ssh-cmd>I<|>B<true>"
2677 msgstr ""
2678
2679 #. type: TP
2680 #: ../dgit.1:1479
2681 #, no-wrap
2682 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:>"
2683 msgstr ""
2684
2685 #. type: TP
2686 #: ../dgit.1:1481
2687 #, no-wrap
2688 msgid "B<dgit-distro.>I<distro>B<.archive-query->(B<url>|B<tls-key>|B<curl-ca-args>)"
2689 msgstr ""
2690
2691 #. type: TP
2692 #: ../dgit.1:1483
2693 #, no-wrap
2694 msgid "B<dgit-distro.>I<distro>B<.madison-distro>"
2695 msgstr ""
2696
2697 #. type: TP
2698 #: ../dgit.1:1485
2699 #, no-wrap
2700 msgid "B<dgit-distro.>I<distro>B<.archive-query-default-component>"
2701 msgstr ""
2702
2703 #. type: TP
2704 #: ../dgit.1:1487
2705 #, no-wrap
2706 msgid "B<dgit-distro.>I<distro>B<.dgit-tag-format>"
2707 msgstr ""
2708
2709 #. type: TP
2710 #: ../dgit.1:1489
2711 #, no-wrap
2712 msgid "B<dgit-distro.>I<distro>B<.dep14tag> B<want>|B<no>[|B<always>]"
2713 msgstr ""
2714
2715 #. type: TP
2716 #: ../dgit.1:1491
2717 #, no-wrap
2718 msgid "B<dgit-distro.>I<distro>B<.ssh>"
2719 msgstr ""
2720
2721 #. type: TP
2722 #: ../dgit.1:1493
2723 #, no-wrap
2724 msgid "B<dgit-distro.>I<distro>B<.sshpsql-dbname>"
2725 msgstr ""
2726
2727 #. type: TP
2728 #: ../dgit.1:1495
2729 #, no-wrap
2730 msgid "B<dgit-distro.>I<distro>B<.>(B<git>|B<sshpsql>)B<->(B<user>|B<host>|B<user-force>)"
2731 msgstr ""
2732
2733 #. type: TP
2734 #: ../dgit.1:1497
2735 #, no-wrap
2736 msgid "B<dgit-distro.>I<distro>B<.backports-quirk>"
2737 msgstr ""
2738
2739 #. type: TP
2740 #: ../dgit.1:1499
2741 #, no-wrap
2742 msgid "B<dgit-distro.>I<distro>B<.rewrite-map-enable>"
2743 msgstr ""
2744
2745 #. type: TP
2746 #: ../dgit.1:1501
2747 #, no-wrap
2748 msgid "B<dgit-distro.>I<distro>B<.source-only-uploads> B<ok>|B<always>|B<never>|B<not-wholly-new>"
2749 msgstr ""
2750
2751 #. type: TP
2752 #: ../dgit.1:1503
2753 #, no-wrap
2754 msgid "B<dgit.default.old-dsc-distro>"
2755 msgstr ""
2756
2757 #. type: TP
2758 #: ../dgit.1:1505
2759 #, no-wrap
2760 msgid "B<dgit.dsc-url-proto-ok.>I<protocol>"
2761 msgstr ""
2762
2763 #. type: TP
2764 #: ../dgit.1:1507
2765 #, no-wrap
2766 msgid "B<dgit.dsc-url-proto-ok.bad-syntax>"
2767 msgstr ""
2768
2769 #. type: TP
2770 #: ../dgit.1:1509
2771 #, no-wrap
2772 msgid "B<dgit.default.dsc-url-proto-ok>"
2773 msgstr ""
2774
2775 #. type: TP
2776 #: ../dgit.1:1511
2777 #, no-wrap
2778 msgid "B<dgit.vcs-git.suites> I<suite>[B<;>...]"
2779 msgstr ""
2780
2781 #. type: SH
2782 #: ../dgit.1:1513
2783 #, no-wrap
2784 msgid "ENVIRONMENT VARIABLES"
2785 msgstr ""
2786
2787 #. type: TP
2788 #: ../dgit.1:1514
2789 #, no-wrap
2790 msgid "B<DGIT_SSH>, B<GIT_SSH>"
2791 msgstr ""
2792
2793 #. type: Plain text
2794 #: ../dgit.1:1523
2795 msgid ""
2796 "specify an alternative default program (and perhaps arguments) to use "
2797 "instead of ssh.  DGIT_SSH is consulted first and may contain arguments; if "
2798 "it contains any whitespace will be passed to the shell.  GIT_SSH specifies "
2799 "just the program; no arguments can be specified, so dgit interprets it the "
2800 "same way as git does.  See also the --ssh= and --ssh: options."
2801 msgstr ""
2802
2803 #. type: TP
2804 #: ../dgit.1:1523
2805 #, no-wrap
2806 msgid "B<DEBEMAIL>, B<DEBFULLNAME>"
2807 msgstr ""
2808
2809 #. type: Plain text
2810 #: ../dgit.1:1527
2811 msgid ""
2812 "Default git user.email and user.name for new trees.  See B<dgit setup-new-"
2813 "tree>."
2814 msgstr ""
2815
2816 #. type: TP
2817 #: ../dgit.1:1527
2818 #, no-wrap
2819 msgid "B<gpg>, B<dpkg->..., B<debsign>, B<git>, [B<lib>]B<curl>, B<dput>"
2820 msgstr ""
2821
2822 #. type: Plain text
2823 #: ../dgit.1:1532
2824 msgid ""
2825 "and other subprograms and modules used by dgit are affected by various "
2826 "environment variables.  Consult the documentation for those programs for "
2827 "details."
2828 msgstr ""
2829
2830 #. type: SH
2831 #: ../dgit.1:1532
2832 #, no-wrap
2833 msgid "BUGS"
2834 msgstr ""
2835
2836 #. type: Plain text
2837 #: ../dgit.1:1539
2838 msgid ""
2839 "There should be a `dgit rebase-prep' command or some such to turn a fast-"
2840 "forwarding branch containing pseudo-merges back into a rebasing patch "
2841 "stack.  It might have to leave a note for a future dgit push."
2842 msgstr ""
2843
2844 #. type: Plain text
2845 #: ../dgit.1:1545
2846 msgid ""
2847 "If the dgit push fails halfway through, it is not necessarily restartable "
2848 "and idempotent.  It would be good to check that the proposed signing key is "
2849 "available before starting work."
2850 msgstr ""
2851
2852 #. type: Plain text
2853 #: ../dgit.1:1550
2854 msgid ""
2855 "dgit's build functions, and dgit push, may make changes to your current "
2856 "HEAD.  Sadly this is necessary for packages in the `3.0 (quilt)' source "
2857 "format.  This is ultimately due to what I consider design problems in quilt "
2858 "and dpkg-source."
2859 msgstr ""
2860
2861 #. type: Plain text
2862 #: ../dgit.1:1555
2863 msgid ""
2864 "--dry-run does not always work properly, as not doing some of the git "
2865 "fetches may result in subsequent actions being different.  Doing a non-dry-"
2866 "run dgit fetch first will help.  --damp-run is likely to work much better."
2867 msgstr ""
2868
2869 #. type: =head1
2870 #: ../dgit.1:1555 ../dgit.7:23 ../dgit-user.7.pod:447
2871 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
2872 #: ../dgit-maint-merge.7.pod:521 ../dgit-maint-gbp.7.pod:136
2873 #: ../dgit-maint-debrebase.7.pod:778 ../dgit-downstream-dsc.7.pod:352
2874 #: ../dgit-sponsorship.7.pod:321 ../dgit-maint-bpo.7.pod:134
2875 #: ../git-debrebase.1.pod:633 ../git-debrebase.5.pod:678
2876 #: ../git-debpush.1.pod:254
2877 #, no-wrap
2878 msgid "SEE ALSO"
2879 msgstr ""
2880
2881 #. type: Plain text
2882 #: ../dgit.1:1564
2883 msgid ""
2884 "B<dgit>(7), B<dgit-*>(7), B<curl>(1), B<dput>(1), B<debsign>(1), B<git-"
2885 "config>(1), B<git-buildpackage>(1), B<dpkg-buildpackage>(1),"
2886 msgstr ""
2887
2888 #. type: Plain text
2889 #: ../dgit.1:1565
2890 msgid "https://browse.dgit.debian.org/"
2891 msgstr ""