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: 2020-02-02 16:50+0000\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:1278
 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:479
 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:483
 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:488
 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:477
 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:685
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.  It can also be useful when there was an "
1282 "upload made without dgit since the most recent upload made with dgit."
1283 msgstr ""
1284
1285 #. type: Plain text
1286 #: ../dgit.1:691
1287 msgid ""
1288 "This option is also usually necessary the first time a package is pushed "
1289 "with dgit push to a particular suite.  See B<dgit-maint->I<*>B<(7)>."
1290 msgstr ""
1291
1292 #. type: Plain text
1293 #: ../dgit.1:705
1294 msgid ""
1295 "If I<previous-version> is not specified, dgit will check that the version in "
1296 "the archive is mentioned in your debian/changelog.  (This will avoid losing "
1297 "changes, even with B<--overwrite>, unless someone committed to git a "
1298 "finalised changelog entry, and then made later changes to that version.)  If "
1299 "I<previous-version> is specified, it ought to be the version currently in "
1300 "the archive."
1301 msgstr ""
1302
1303 #. type: Plain text
1304 #: ../dgit.1:711
1305 msgid ""
1306 "dgit push --overwrite will, if necessary, make a pseudo-merge (that is, "
1307 "something that looks like the result of git merge -s ours) to stitch the "
1308 "archive's version into your own git history, so that your push is a fast "
1309 "forward from the archive."
1310 msgstr ""
1311
1312 #. type: Plain text
1313 #: ../dgit.1:716
1314 msgid ""
1315 "(In quilt mode B<gbp>, B<dpm>, B<unpatched> or B<baredebian>*, implying a "
1316 "split between the dgit view and the maintainer view, the pseudo-merge will "
1317 "appear only in the dgit view.)"
1318 msgstr ""
1319
1320 #. type: TP
1321 #: ../dgit.1:716
1322 #, no-wrap
1323 msgid "B<--delayed>=I<days>"
1324 msgstr ""
1325
1326 #. type: Plain text
1327 #: ../dgit.1:719
1328 msgid "Upload to a DELAYED queue."
1329 msgstr ""
1330
1331 #. type: Plain text
1332 #: ../dgit.1:729
1333 msgid ""
1334 "B<WARNING:> If the maintainer responds by cancelling your upload from the "
1335 "queue, and does not make an upload of their own, this will not rewind the "
1336 "git branch on the dgit git server.  Other dgit users will then see your push "
1337 "(with a warning message from dgit)  even though the maintainer wanted to "
1338 "abolish it.  Such users might unwittingly reintroduce your changes."
1339 msgstr ""
1340
1341 #. type: Plain text
1342 #: ../dgit.1:734
1343 msgid ""
1344 "If this situation arises, someone should make a suitable dgit push to update "
1345 "the contents of dgit-repos to a version without the controversial changes."
1346 msgstr ""
1347
1348 #. type: TP
1349 #: ../dgit.1:734
1350 #, no-wrap
1351 msgid "B<--no-chase-dsc-distro>"
1352 msgstr ""
1353
1354 #. type: Plain text
1355 #: ../dgit.1:740
1356 msgid ""
1357 "Tells dgit not to look online for additional git repositories containing "
1358 "information about a particular .dsc being imported.  Chasing is the default."
1359 msgstr ""
1360
1361 #. type: Plain text
1362 #: ../dgit.1:750
1363 msgid ""
1364 "For most operations (such as fetch and pull), disabling chasing means dgit "
1365 "will access only the git server for the distro you are directly working "
1366 "with, even if the .dsc was copied verbatim from another distro.  For import-"
1367 "dsc, disabling chasing means dgit will work completely offline."
1368 msgstr ""
1369
1370 #. type: Plain text
1371 #: ../dgit.1:758
1372 msgid ""
1373 "Disabling chasing can be hazardous: if the .dsc names a git commit which has "
1374 "been rewritten by those in charge of the distro, this option may prevent "
1375 "that rewrite from being effective.  Also, it can mean that dgit fails to "
1376 "find necessary git commits."
1377 msgstr ""
1378
1379 #. type: TP
1380 #: ../dgit.1:758
1381 #, no-wrap
1382 msgid "B<--save-dgit-view=>I<branch>|I<ref>"
1383 msgstr ""
1384
1385 #. type: Plain text
1386 #: ../dgit.1:768
1387 msgid ""
1388 "Specifies that when split view is in operation, and dgit calculates (or "
1389 "looks up in its cache)  a dgit view corresponding to your HEAD, the dgit "
1390 "view will be left in I<ref>.  The specified ref is unconditionally "
1391 "overwritten, so don't specify a branch you want to keep."
1392 msgstr ""
1393
1394 #. type: Plain text
1395 #: ../dgit.1:772
1396 msgid ""
1397 "This option is effective only with the following operations: quilt-fixup; "
1398 "push; all builds.  And it is only effective when split view is actually in "
1399 "operation."
1400 msgstr ""
1401
1402 #. type: Plain text
1403 #: ../dgit.1:776
1404 msgid ""
1405 "If ref does not start with refs/ it is taken to be a branch - i.e. refs/"
1406 "heads/ is prepended."
1407 msgstr ""
1408
1409 #. type: Plain text
1410 #: ../dgit.1:780
1411 msgid "B<--dgit-view-save> is a deprecated alias for --save-dgit-view."
1412 msgstr ""
1413
1414 #. type: TP
1415 #: ../dgit.1:780
1416 #, no-wrap
1417 msgid "B<--deliberately->I<something>"
1418 msgstr ""
1419
1420 #. type: Plain text
1421 #: ../dgit.1:794
1422 msgid ""
1423 "Declare that you are deliberately doing I<something>.  This can be used to "
1424 "override safety catches, including safety catches which relate to distro-"
1425 "specific policies.  The use of --deliberately is declared and published in "
1426 "the signed tags generated for you by dgit, so that the archive software can "
1427 "give effect to your intent, and for the benefit of humans looking at the "
1428 "history.  The meanings of I<something>s understood in the context of Debian "
1429 "are discussed below:"
1430 msgstr ""
1431
1432 #. type: TP
1433 #: ../dgit.1:794
1434 #, no-wrap
1435 msgid "B<--deliberately-not-fast-forward>"
1436 msgstr ""
1437
1438 #. type: Plain text
1439 #: ../dgit.1:800
1440 msgid ""
1441 "Declare that you are deliberately rewriting history.  This could be because "
1442 "your branch is not fast forward from the dgit server history, or not fast "
1443 "forward from a locally-synthesised dsc import."
1444 msgstr ""
1445
1446 #. type: Plain text
1447 #: ../dgit.1:806
1448 msgid ""
1449 "When pushing to Debian, use this only when you are making a renewed upload "
1450 "of an entirely new source package whose previous version was not accepted "
1451 "for release from NEW because of problems with copyright or "
1452 "redistributibility; or, exceptionally, for the very first upload with dgit."
1453 msgstr ""
1454
1455 #. type: Plain text
1456 #: ../dgit.1:817
1457 msgid ""
1458 "When split view is in operation, this also prevents the construction by dgit "
1459 "of a pseudomerge to make the dgit view fast forwarding.  Normally only one "
1460 "of --overwrite (which creates a suitable pseudomerge)  and --deliberately-"
1461 "not-fast-forward (which suppresses the pseudomerge and the fast forward "
1462 "checks)  should be needed; --overwrite is usually better."
1463 msgstr ""
1464
1465 #. type: TP
1466 #: ../dgit.1:817
1467 #, no-wrap
1468 msgid "B<--deliberately-include-questionable-history>"
1469 msgstr ""
1470
1471 #. type: Plain text
1472 #: ../dgit.1:826
1473 msgid ""
1474 "Declare that you are deliberately including, in the git history of your "
1475 "current push, history which contains a previously-submitted version of this "
1476 "package which was not approved (or has not yet been approved) by the "
1477 "ftpmasters.  When pushing to Debian, only use this option after verifying "
1478 "that: none of the rejected-from-NEW (or never-accepted) versions in the git "
1479 "history of your current push, were rejected by ftpmaster for copyright or "
1480 "redistributability reasons."
1481 msgstr ""
1482
1483 #. type: TP
1484 #: ../dgit.1:826
1485 #, no-wrap
1486 msgid "B<--deliberately-fresh-repo>"
1487 msgstr ""
1488
1489 #. type: Plain text
1490 #: ../dgit.1:831
1491 msgid ""
1492 "Declare that you are deliberately rewriting history and want to throw away "
1493 "the existing repo.  Not relevant when pushing to Debian, as the Debian "
1494 "server will do this automatically when necessary."
1495 msgstr ""
1496
1497 #. type: =item
1498 #: ../dgit.1:831 ../git-debpush.1.pod:114
1499 #, no-wrap
1500 msgid "B<--quilt=linear>"
1501 msgstr ""
1502
1503 #. type: Plain text
1504 #: ../dgit.1:838
1505 msgid ""
1506 "When fixing up source format `3.0 (quilt)' metadata, insist on generating a "
1507 "linear patch stack: one new patch for each relevant commit.  If such a stack "
1508 "cannot be generated, fail.  This is the default for Debian."
1509 msgstr ""
1510
1511 #. type: Plain text
1512 #: ../dgit.1:843
1513 msgid ""
1514 "HEAD should be a series of plain commits (not touching debian/patches/), and "
1515 "pseudomerges, with as ancestor a patches-applied branch."
1516 msgstr ""
1517
1518 #. type: =item
1519 #: ../dgit.1:843 ../git-debpush.1.pod:126
1520 #, no-wrap
1521 msgid "B<--quilt=auto>"
1522 msgstr ""
1523
1524 #. type: Plain text
1525 #: ../dgit.1:852
1526 msgid ""
1527 "When fixing up source format `3.0 (quilt)' metadata, prefer to generate a "
1528 "linear patch stack (as with --quilt=linear)  but if that doesn't seem "
1529 "possible, try to generate a single squashed patch for all the changes made "
1530 "in git (as with --quilt=smash).  This is not a good idea for an NMU in "
1531 "Debian."
1532 msgstr ""
1533
1534 #. type: =item
1535 #: ../dgit.1:852 ../git-debpush.1.pod:120
1536 #, no-wrap
1537 msgid "B<--quilt=smash>"
1538 msgstr ""
1539
1540 #. type: Plain text
1541 #: ../dgit.1:857
1542 msgid ""
1543 "When fixing up source format `3.0 (quilt)' metadata, generate a single "
1544 "additional patch for all the changes made in git.  This is not a good idea "
1545 "for an NMU in Debian."
1546 msgstr ""
1547
1548 #. type: Plain text
1549 #: ../dgit.1:863
1550 msgid ""
1551 "(If HEAD has any in-tree patches already, they must apply cleanly.  This "
1552 "will be the case for any trees produced by dgit fetch or clone; if you do "
1553 "not change the upstream version nor make changes in debian/patches, it will "
1554 "remain true.)"
1555 msgstr ""
1556
1557 #. type: =item
1558 #: ../dgit.1:863 ../git-debpush.1.pod:131
1559 #, no-wrap
1560 msgid "B<--quilt=nofix>"
1561 msgstr ""
1562
1563 #. type: Plain text
1564 #: ../dgit.1:871
1565 msgid ""
1566 "Check whether source format `3.0 (quilt)' metadata would need fixing up, "
1567 "but, if it does, fail.  You must then fix the metadata yourself somehow "
1568 "before pushing.  (NB that dpkg-source --commit will not work because the "
1569 "dgit git tree does not have a B<.pc> directory.)"
1570 msgstr ""
1571
1572 #. type: TP
1573 #: ../dgit.1:871
1574 #, no-wrap
1575 msgid "B<--quilt=nocheck> | B<--no-quilt-fixup>"
1576 msgstr ""
1577
1578 #. type: Plain text
1579 #: ../dgit.1:876
1580 msgid ""
1581 "Do not check whether source format `3.0 (quilt)' metadata needs fixing up.  "
1582 "If you use this option and the metadata did in fact need fixing up, dgit "
1583 "push will fail."
1584 msgstr ""
1585
1586 #. type: TP
1587 #: ../dgit.1:876
1588 #, no-wrap
1589 msgid "B<-->[B<quilt=>]B<gbp> | B<-->[B<quilt=>]B<dpm> | B<--quilt=unapplied> | B<-->[B<quilt=>]B<baredebian>[B<+git>|B<+tarball>]"
1590 msgstr ""
1591
1592 #. type: Plain text
1593 #: ../dgit.1:883
1594 msgid ""
1595 "Tell dgit that you are using a nearly-dgit-compatible git branch, aka a "
1596 "B<maintainer view>, and do not want your branch changed by dgit."
1597 msgstr ""
1598
1599 #. type: Plain text
1600 #: ../dgit.1:887
1601 msgid ""
1602 "These quilt modes are known as B<splitting quilt modes>.  See --split-view, "
1603 "below."
1604 msgstr ""
1605
1606 #. type: Plain text
1607 #: ../dgit.1:895
1608 msgid ""
1609 "B<--gbp> (short for B<--quilt=gbp>)  is for use with git-buildpackage.  Your "
1610 "HEAD is expected to be a patches-unapplied git branch, except that it might "
1611 "contain changes to upstream .gitignore files.  This is the default for dgit "
1612 "gbp-build."
1613 msgstr ""
1614
1615 #. type: Plain text
1616 #: ../dgit.1:903
1617 msgid ""
1618 "B<--dpm> (short for B<--quilt=dpm>)  is for use with git-dpm.  Your HEAD is "
1619 "expected to be a patches-applied git branch, except that it might contain "
1620 "changes to upstream .gitignore files."
1621 msgstr ""
1622
1623 #. type: Plain text
1624 #: ../dgit.1:908
1625 msgid ""
1626 "B<--quilt=unapplied> specifies that your HEAD is a patches-unapplied git "
1627 "branch (and that any changes to upstream .gitignore files are represented as "
1628 "patches in debian/patches)."
1629 msgstr ""
1630
1631 #. type: Plain text
1632 #: ../dgit.1:922
1633 msgid ""
1634 "B<--quilt=baredebian> (or its alias B<--quilt=baredebian+git>)  specifies "
1635 "that your HEAD contains only a debian/ directory, with any changes to "
1636 "upstream files represented as patches in debian/patches.  The upstream "
1637 "source must be available in git, by default, in a suitably named git tag; "
1638 "see --upstream-commitish.  In this mode, dgit cannot check that all edited "
1639 "upstream files are properly represented as patches: dgit relies on debian/"
1640 "patches being correct."
1641 msgstr ""
1642
1643 #. type: Plain text
1644 #: ../dgit.1:933
1645 msgid ""
1646 "B<--quilt=baredebian+tarball> is like --quilt=baredebian, but is used when "
1647 "there is no appropriate upstream git history.  To construct the dgit view, "
1648 "dgit will import your orig tarballs' contents into git.  In this mode, dgit "
1649 "cannot check that the upstream parts of your upload correspond to what you "
1650 "intend: dgit relies on the right orig tarball(s) existing, and debian/"
1651 "patches being correct."
1652 msgstr ""
1653
1654 #. type: Plain text
1655 #: ../dgit.1:951
1656 msgid ""
1657 "With --quilt=gbp|dpm|unapplied|baredebian*, dgit push (or precursors like "
1658 "quilt-fixup and build) will automatically generate a conversion of your git "
1659 "branch into the right form.  dgit push will push the dgit-compatible form "
1660 "(the B<dgit view>)  to the dgit git server.  The dgit view will be visible "
1661 "to you in the dgit remote tracking branches, but your own branch will not be "
1662 "modified.  dgit push will create a tag B<debian/>I<version> for the "
1663 "maintainer view, and the dgit tag B<archive/debian/>I<version> for the dgit "
1664 "view.  dgit quilt-fixup will merely do some checks, and cache the maintainer "
1665 "view."
1666 msgstr ""
1667
1668 #. type: Plain text
1669 #: ../dgit.1:960
1670 msgid ""
1671 "B<If you have a branch like this it is essential to specify the appropriate "
1672 "--quilt= option!> This is because it is not always possible to tell: a "
1673 "patches-unapplied git branch of a package with one patch, for example, looks "
1674 "very like a patches-applied branch where the user has used git revert to "
1675 "undo the patch, expecting to actually revert it.  However, if you fail to "
1676 "specify the right --quilt option, and you aren't too lucky, dgit will notice "
1677 "the problem and stop, with a useful hint."
1678 msgstr ""
1679
1680 #. type: TP
1681 #: ../dgit.1:960
1682 #, no-wrap
1683 msgid "B<-d>I<distro> | B<--distro=>I<distro>"
1684 msgstr ""
1685
1686 #. type: Plain text
1687 #: ../dgit.1:969
1688 msgid ""
1689 "Specifies that the suite to be operated on is part of distro I<distro>.  "
1690 "This overrides the default value found from the git config option B<dgit-"
1691 "suite.>I<suite>B<.distro>.  The only effect is that other configuration "
1692 "variables (used for accessing the archive and dgit-repos) used are B<dgit-"
1693 "distro.>I<distro>B<.*>."
1694 msgstr ""
1695
1696 #. type: Plain text
1697 #: ../dgit.1:975
1698 msgid ""
1699 "If your suite is part of a distro that dgit already knows about, you can use "
1700 "this option to make dgit work even if your dgit doesn't know about the "
1701 "suite.  For example, specifying B<-ddebian> will work when the suite is an "
1702 "unknown suite in the Debian archive."
1703 msgstr ""
1704
1705 #. type: Plain text
1706 #: ../dgit.1:980
1707 msgid ""
1708 "To define a new distro it is necessary to define methods and URLs for "
1709 "fetching (and, for dgit push, altering) a variety of information both in the "
1710 "archive and in dgit-repos.  How to set this up is not yet documented."
1711 msgstr ""
1712
1713 #. type: TP
1714 #: ../dgit.1:980
1715 #, no-wrap
1716 msgid "B<--split-view=auto>|B<always>|B<never>"
1717 msgstr ""
1718
1719 #. type: Plain text
1720 #: ../dgit.1:985
1721 msgid ""
1722 "Controls whether dgit operates a split view, separating your own branch (as "
1723 "Debian maintainer)  from that shown to users of dgit clone and dgit fetch."
1724 msgstr ""
1725
1726 #. type: Plain text
1727 #: ../dgit.1:993
1728 msgid ""
1729 "When split view is in operation dgit will not make or merge any commits onto "
1730 "your own branch.  Specifically, only the dgit view will contain dgit's "
1731 "pseudomerges, which bring into the git history previous uploads made with "
1732 "dgit push, and any commits in debian/patches required to make a correct `3.0 "
1733 "(quilt)' source package."
1734 msgstr ""
1735
1736 #. type: Plain text
1737 #: ../dgit.1:999
1738 msgid ""
1739 "B<auto> is the default, and splits the view only when needed: i.e., when you "
1740 "are working with a `3.0 (quilt)' source package and a splitting quilt mode: "
1741 "--[quilt=]gbp, dpm, unpatched or baredebian*."
1742 msgstr ""
1743
1744 #. type: Plain text
1745 #: ../dgit.1:1002
1746 msgid ""
1747 "B<always> splits the view regardless of the source format and the quilt mode."
1748 msgstr ""
1749
1750 #. type: Plain text
1751 #: ../dgit.1:1005
1752 msgid "B<never> will cause dgit to fail if split view is needed."
1753 msgstr ""
1754
1755 #. type: Plain text
1756 #: ../dgit.1:1013
1757 msgid ""
1758 "When split view is in operation, the dgit view is visible in your local git "
1759 "clone, but only in refs specific to dgit: notably B<remotes/dgit/dgit/"
1760 ">I<suite> and B<archive/>I<distro>B</>I<version>."
1761 msgstr ""
1762
1763 #. type: Plain text
1764 #: ../dgit.1:1016
1765 msgid ""
1766 "Note that split view does not affect dgit fetch, and is not compatible with "
1767 "dgit pull."
1768 msgstr ""
1769
1770 #. type: TP
1771 #: ../dgit.1:1016
1772 #, no-wrap
1773 msgid "B<-C>I<changesfile>"
1774 msgstr ""
1775
1776 #. type: Plain text
1777 #: ../dgit.1:1021
1778 msgid ""
1779 "Specifies the .changes file which is to be uploaded.  By default dgit push "
1780 "looks for a single .changes file in the parent directory whose filename "
1781 "suggests it is for the right package and version."
1782 msgstr ""
1783
1784 #. type: Plain text
1785 #: ../dgit.1:1030
1786 msgid ""
1787 "If the specified I<changesfile> pathname contains slashes, the directory "
1788 "part is also used as the value for B<--build-products-dir>; otherwise, the "
1789 "changes file is expected in that directory (by default, in B<..>)."
1790 msgstr ""
1791
1792 #. type: TP
1793 #: ../dgit.1:1030
1794 #, no-wrap
1795 msgid "B<--upstream-commitish=>I<upstream>"
1796 msgstr ""
1797
1798 #. type: Plain text
1799 #: ../dgit.1:1038
1800 msgid ""
1801 "For use with --quilt=baredebian only.  Specifies the commit containing the "
1802 "upstream source.  This commit must be identical to your .orig tarball.  The "
1803 "default is to look for one of the git tags I<U>B< v>I<U>B< upstream/>I<U> "
1804 "(in that order), where U is the upstream version."
1805 msgstr ""
1806
1807 #. type: TP
1808 #: ../dgit.1:1038
1809 #, no-wrap
1810 msgid "B<--rm-old-changes>"
1811 msgstr ""
1812
1813 #. type: Plain text
1814 #: ../dgit.1:1050
1815 msgid ""
1816 "When doing a build, delete any changes files matching "
1817 "I<package>B<_>I<version>B<_*.changes> before starting.  This ensures that "
1818 "dgit push (and dgit sbuild) will be able to unambiguously identify the "
1819 "relevant changes files from the most recent build, even if there have been "
1820 "previous builds with different tools or options.  The default is not to "
1821 "remove, but B<--no-rm-old-changes> can be used to override a previous --rm-"
1822 "old-changes or the .rm-old-changes configuration setting."
1823 msgstr ""
1824
1825 #. type: Plain text
1826 #: ../dgit.1:1053
1827 msgid ""
1828 "Note that B<dgit push-source> will always find the right .changes, "
1829 "regardless of this option."
1830 msgstr ""
1831
1832 #. type: TP
1833 #: ../dgit.1:1053
1834 #, no-wrap
1835 msgid "B<--build-products-dir=>I<directory>"
1836 msgstr ""
1837
1838 #. type: Plain text
1839 #: ../dgit.1:1057
1840 msgid ""
1841 "Specifies where to find and create tarballs, binary packages, source "
1842 "packages, .changes files, and so on."
1843 msgstr ""
1844
1845 #. type: Plain text
1846 #: ../dgit.1:1060
1847 msgid "By default, dgit uses the parent directory (B<..>)."
1848 msgstr ""
1849
1850 #. type: Plain text
1851 #: ../dgit.1:1069
1852 msgid ""
1853 "Changing this setting may necessitate moving .orig tarballs to the new "
1854 "directory, so it is probably best to use the B<dgit.default.build-products-"
1855 "dir> configuration setting (see CONFIGURATION, below)  which this command "
1856 "line option overrides)."
1857 msgstr ""
1858
1859 #. type: TP
1860 #: ../dgit.1:1069
1861 #, no-wrap
1862 msgid "B<--no-rm-on-error>"
1863 msgstr ""
1864
1865 #. type: Plain text
1866 #: ../dgit.1:1072
1867 msgid "Do not delete the destination directory if clone fails."
1868 msgstr ""
1869
1870 #. type: TP
1871 #: ../dgit.1:1072
1872 #, no-wrap
1873 msgid "B<--dep14tag>"
1874 msgstr ""
1875
1876 #. type: Plain text
1877 #: ../dgit.1:1079
1878 msgid ""
1879 "Generates a DEP-14 tag (eg B<debian/>I<version>)  as well as a dgit tag (eg "
1880 "B<archive/debian/>I<version>).  This is the default."
1881 msgstr ""
1882
1883 #. type: TP
1884 #: ../dgit.1:1079
1885 #, no-wrap
1886 msgid "B<--no-dep14tag>"
1887 msgstr ""
1888
1889 #. type: Plain text
1890 #: ../dgit.1:1082
1891 msgid "Do not generate a DEP-14 tag, except when split view is in operation."
1892 msgstr ""
1893
1894 #. type: TP
1895 #: ../dgit.1:1082
1896 #, no-wrap
1897 msgid "B<--always-dep14tag>"
1898 msgstr ""
1899
1900 #. type: Plain text
1901 #: ../dgit.1:1085
1902 msgid "Obsolete alias for --dep14tag, retained for compatibility."
1903 msgstr ""
1904
1905 #. type: TP
1906 #: ../dgit.1:1085
1907 #, no-wrap
1908 msgid "B<-D>"
1909 msgstr ""
1910
1911 #. type: Plain text
1912 #: ../dgit.1:1089
1913 msgid ""
1914 "Prints debugging information to stderr.  Repeating the option produces more "
1915 "output (currently, up to -DDDD is meaningfully different)."
1916 msgstr ""
1917
1918 #. type: TP
1919 #: ../dgit.1:1089
1920 #, no-wrap
1921 msgid "B<-c>I<name>B<=>I<value>"
1922 msgstr ""
1923
1924 #. type: Plain text
1925 #: ../dgit.1:1093
1926 msgid ""
1927 "Specifies a git configuration option, to be used for this run.  dgit itself "
1928 "is also controlled by git configuration options."
1929 msgstr ""
1930
1931 #. type: TP
1932 #: ../dgit.1:1093
1933 #, no-wrap
1934 msgid "B<-v>I<version>|B<_> | B<--since-version=>versionI<|>B<_>"
1935 msgstr ""
1936
1937 #. type: Plain text
1938 #: ../dgit.1:1102
1939 msgid ""
1940 "Specifies the B<-v>I<version> option to pass to dpkg-genchanges, during "
1941 "builds.  Changes (from debian/changelog) since this version will be included "
1942 "in the built changes file, and hence in the upload.  If this option is not "
1943 "specified, dgit will query the archive and use the latest version uploaded "
1944 "to the intended suite."
1945 msgstr ""
1946
1947 #. type: Plain text
1948 #: ../dgit.1:1108
1949 msgid ""
1950 "Specifying B<_> inhibits this, so that no -v option will be passed to dpkg-"
1951 "genchanges (and as a result, only the last stanza from debian/changelog will "
1952 "be used for the build and upload)."
1953 msgstr ""
1954
1955 #. type: TP
1956 #: ../dgit.1:1108
1957 #, no-wrap
1958 msgid "B<-m>I<maintaineraddress>"
1959 msgstr ""
1960
1961 #. type: Plain text
1962 #: ../dgit.1:1111
1963 msgid "Passed to dpkg-genchanges (eventually)."
1964 msgstr ""
1965
1966 #. type: TP
1967 #: ../dgit.1:1111
1968 #, no-wrap
1969 msgid "B<--ch:>I<option>"
1970 msgstr ""
1971
1972 #. type: Plain text
1973 #: ../dgit.1:1115
1974 msgid ""
1975 "Specifies a single additional option to pass, eventually, to dpkg-genchanges."
1976 msgstr ""
1977
1978 #. type: Plain text
1979 #: ../dgit.1:1122
1980 msgid ""
1981 "Options which are safe to pass include B<-C> (and also B<-si -sa -sd> "
1982 "although these should never be necessary with Debian since dgit "
1983 "automatically calculates whether .origs need to be uploaded.)"
1984 msgstr ""
1985
1986 #. type: Plain text
1987 #: ../dgit.1:1124
1988 msgid "For other options the caveat below applies."
1989 msgstr ""
1990
1991 #. type: TP
1992 #: ../dgit.1:1124
1993 #, no-wrap
1994 msgid "B<--curl:>I<option> | B<--dput:>I<option> |..."
1995 msgstr ""
1996
1997 #. type: Plain text
1998 #: ../dgit.1:1146
1999 msgid ""
2000 "Specifies a single additional option to pass to B<curl>, B<dput>, "
2001 "B<debsign>, B<dpkg-source>, B<dpkg-buildpackage>, B<dpkg-genchanges>, "
2002 "B<sbuild>, B<pbuilder>, B<cowbuilder>, B<ssh>, B<dgit>, B<git-debrebase>, "
2003 "B<apt-get>, B<apt-cache>, B<gbp-pq>, B<gbp-build>, or B<mergechanges>.  Can "
2004 "be repeated as necessary."
2005 msgstr ""
2006
2007 #. type: Plain text
2008 #: ../dgit.1:1154
2009 msgid ""
2010 "Use of this ability should not normally be necessary.  It is provided for "
2011 "working around bugs, or other unusual situations.  If you use these options, "
2012 "you may violate dgit's assumptions about the behaviour of its subprograms "
2013 "and cause lossage."
2014 msgstr ""
2015
2016 #. type: Plain text
2017 #: ../dgit.1:1159
2018 msgid ""
2019 "For dpkg-buildpackage, dpkg-genchanges, mergechanges and sbuild, the option "
2020 "applies only when the program is invoked directly by dgit.  Usually, for "
2021 "passing options to dpkg-genchanges, you should use B<--ch:>I<option>."
2022 msgstr ""
2023
2024 #. type: Plain text
2025 #: ../dgit.1:1163
2026 msgid ""
2027 "Specifying --git is not effective for some lower-level read-only git "
2028 "operations performed by dgit, and also not when git is invoked by another "
2029 "program run by dgit."
2030 msgstr ""
2031
2032 #. type: Plain text
2033 #: ../dgit.1:1165
2034 msgid "See notes below regarding ssh and dgit."
2035 msgstr ""
2036
2037 #. type: Plain text
2038 #: ../dgit.1:1173
2039 msgid ""
2040 "NB that --gpg:option is not supported (because debsign does not have that "
2041 "facility).  But see B<-k> and the B<keyid> distro config setting."
2042 msgstr ""
2043
2044 #. type: TP
2045 #: ../dgit.1:1173
2046 #, no-wrap
2047 msgid "B<--curl!:>I<option> | B<--dput!:>I<option> |..."
2048 msgstr ""
2049
2050 #. type: Plain text
2051 #: ../dgit.1:1179
2052 msgid ""
2053 "Specifies an option to remove from the command line for a program called by "
2054 "dgit, as for B<-->I<program>B<:>I<option> (and the same caveats apply)."
2055 msgstr ""
2056
2057 #. type: Plain text
2058 #: ../dgit.1:1184
2059 msgid ""
2060 "Any options or arguments exactly identical to I<option> are removed.  (It is "
2061 "not an error if there were none.)"
2062 msgstr ""
2063
2064 #. type: Plain text
2065 #: ../dgit.1:1191
2066 msgid ""
2067 "This can only be used to delete options which are always passed by default "
2068 "by dgit, or to undo a previous B<-->I<program>B<:>I<option>.  It cannot be "
2069 "used to override option(s) dynamically decided on by dgit."
2070 msgstr ""
2071
2072 #. type: TP
2073 #: ../dgit.1:1191
2074 #, no-wrap
2075 msgid "B<--curl=>I<program> | B<--dput=>I<program> |..."
2076 msgstr ""
2077
2078 #. type: Plain text
2079 #: ../dgit.1:1214
2080 msgid ""
2081 "Specifies alternative programs to use instead of B<curl>, B<dput>, "
2082 "B<debsign>, B<dpkg-source>, B<dpkg-buildpackage>, B<dpkg-genchanges>, "
2083 "B<sbuild>, B<pbuilder>, B<cowbuilder>, B<gpg>, B<ssh>, B<dgit>, B<git-"
2084 "debrebase>, B<apt-get>, B<apt-cache>, B<git>, B<gbp-pq>, B<gbp-build>, or "
2085 "B<mergechanges>."
2086 msgstr ""
2087
2088 #. type: Plain text
2089 #: ../dgit.1:1222
2090 msgid ""
2091 "For B<dpkg-buildpackage>, B<dpkg-genchanges>, B<mergechanges> and B<sbuild>, "
2092 "this applies only when the program is invoked directly by dgit."
2093 msgstr ""
2094
2095 #. type: Plain text
2096 #: ../dgit.1:1229
2097 msgid ""
2098 "For B<dgit>, specifies the command to run on the remote host when dgit rpush "
2099 "needs to invoke a remote copy of itself.  (dgit also reinvokes itself as the "
2100 "EDITOR for dpkg-source --commit; this is done using argv[0], and is not "
2101 "affected by --dgit=)."
2102 msgstr ""
2103
2104 #. type: Plain text
2105 #: ../dgit.1:1240
2106 msgid ""
2107 "B<gbp-build>'s value is used instead of gbp build or git-buildpackage.  (The "
2108 "default is the latter unless the former exists on PATH.)  B<gbp-pq>'s value "
2109 "is used instead of gbp pq.  In both cases, unusually, the specified value is "
2110 "split on whitespace to produce a command and possibly some options and/or "
2111 "arguments."
2112 msgstr ""
2113
2114 #. type: Plain text
2115 #: ../dgit.1:1248
2116 msgid ""
2117 "For pbuilder and cowbuilder, the defaults are B<sudo -E pbuilder> and B<sudo "
2118 "-E cowbuilder> respectively.  Like with gbp-build and gbp pq, the specified "
2119 "value is split on whitespace."
2120 msgstr ""
2121
2122 #. type: Plain text
2123 #: ../dgit.1:1265
2124 msgid ""
2125 "For B<ssh>, the default value is taken from the B<DGIT_SSH> or B<GIT_SSH> "
2126 "environment variables, if set (see below).  And, for ssh, when accessing the "
2127 "archive and dgit-repos, this command line setting is overridden by the git "
2128 "config variables B<dgit-distro.>I<distro>B<.ssh> and B<.dgit.default.ssh> "
2129 "(which can in turn be overridden with -c).  Also, when dgit is using git to "
2130 "access dgit-repos, only git's idea of what ssh to use (eg, B<GIT_SSH>)  is "
2131 "relevant."
2132 msgstr ""
2133
2134 #. type: TP
2135 #: ../dgit.1:1265
2136 #, no-wrap
2137 msgid "B<--existing-package=>I<package>"
2138 msgstr ""
2139
2140 #. type: Plain text
2141 #: ../dgit.1:1275
2142 msgid ""
2143 "dgit push needs to canonicalise the suite name.  Sometimes, dgit lacks a way "
2144 "to ask the archive to do this without knowing the name of an existing "
2145 "package.  Without --new we can just use the package we are trying to push.  "
2146 "But with --new that will not work, so we guess B<dpkg> or use the value of "
2147 "this option.  This option is not needed with the default mechanisms for "
2148 "accessing the archive."
2149 msgstr ""
2150
2151 #. type: TP
2152 #: ../dgit.1:1275
2153 #, no-wrap
2154 msgid "B<-h>|B<--help>"
2155 msgstr ""
2156
2157 #. type: TP
2158 #: ../dgit.1:1278
2159 #, no-wrap
2160 msgid "B<--initiator-tempdir=>I<directory>"
2161 msgstr ""
2162
2163 #. type: Plain text
2164 #: ../dgit.1:1287
2165 msgid ""
2166 "dgit rpush uses a temporary directory on the invoking (signing) host.  This "
2167 "option causes dgit to use I<directory> instead.  Furthermore, the specified "
2168 "directory will be emptied, removed and recreated before dgit starts, rather "
2169 "than removed after dgit finishes.  The directory specified must be an "
2170 "absolute pathname."
2171 msgstr ""
2172
2173 #. type: TP
2174 #: ../dgit.1:1287
2175 #, no-wrap
2176 msgid "B<--force->I<something>"
2177 msgstr ""
2178
2179 #. type: Plain text
2180 #: ../dgit.1:1295
2181 msgid ""
2182 "Instructs dgit to try to proceed despite detecting what it thinks is going "
2183 "to be a fatal problem.  B<This is probably not going to work.> These options "
2184 "are provided as an escape hatch, in case dgit is confused.  (They might also "
2185 "be useful for testing error cases.)"
2186 msgstr ""
2187
2188 #. type: TP
2189 #: ../dgit.1:1295
2190 #, no-wrap
2191 msgid "B<--force-import-dsc-with-dgit-field>"
2192 msgstr ""
2193
2194 #. type: Plain text
2195 #: ../dgit.1:1302
2196 msgid ""
2197 "Tell dgit import-dsc to treat a .dsc with a Dgit field like one without it.  "
2198 "The result is a fresh import, discarding the git history that the person who "
2199 "pushed that .dsc was working with."
2200 msgstr ""
2201
2202 #. type: TP
2203 #: ../dgit.1:1302
2204 #, no-wrap
2205 msgid "B<--force-reusing-version>"
2206 msgstr ""
2207
2208 #. type: Plain text
2209 #: ../dgit.1:1309
2210 msgid ""
2211 "Carry on even though this involves reusing a version number of a previous "
2212 "push or upload.  It is normally best to give different versions different "
2213 "numbers.  Some servers (including, usually, the Debian server)  will reject "
2214 "attempts to reuse or replace already-pushed versions."
2215 msgstr ""
2216
2217 #. type: TP
2218 #: ../dgit.1:1309
2219 #, no-wrap
2220 msgid "B<--force-uploading-binaries>"
2221 msgstr ""
2222
2223 #. type: Plain text
2224 #: ../dgit.1:1314
2225 msgid ""
2226 "Carry on and upload binaries even though dgit thinks your distro does not "
2227 "permit that."
2228 msgstr ""
2229
2230 #. type: TP
2231 #: ../dgit.1:1314
2232 #, no-wrap
2233 msgid "B<--force-uploading-source-only>"
2234 msgstr ""
2235
2236 #. type: Plain text
2237 #: ../dgit.1:1320
2238 msgid ""
2239 "Carry on and do a source-only upload, without any binaries, even though dgit "
2240 "thinks your distro does not permit that, or does not permit that in this "
2241 "situation."
2242 msgstr ""
2243
2244 #. type: TP
2245 #: ../dgit.1:1320
2246 #, no-wrap
2247 msgid "B<--force-unrepresentable>"
2248 msgstr ""
2249
2250 #. type: Plain text
2251 #: ../dgit.1:1327
2252 msgid ""
2253 "Carry on even if dgit thinks that your git tree contains changes (relative "
2254 "to your .orig tarballs)  which dpkg-source is not able to represent.  Your "
2255 "build or push will probably fail later."
2256 msgstr ""
2257
2258 #. type: TP
2259 #: ../dgit.1:1327
2260 #, no-wrap
2261 msgid "B<--force-changes-origs-exactly>"
2262 msgstr ""
2263
2264 #. type: Plain text
2265 #: ../dgit.1:1332
2266 msgid ""
2267 "Use the set of .origs specified in your .changes, exactly, without regard to "
2268 "what is in the archive already.  The archive may well reject your upload."
2269 msgstr ""
2270
2271 #. type: TP
2272 #: ../dgit.1:1332
2273 #, no-wrap
2274 msgid "B<--force-unsupported-source-format>"
2275 msgstr ""
2276
2277 #. type: Plain text
2278 #: ../dgit.1:1336
2279 msgid ""
2280 "Carry on despite dgit not understanding your source package format.  dgit "
2281 "will probably mishandle it."
2282 msgstr ""
2283
2284 #. type: TP
2285 #: ../dgit.1:1336
2286 #, no-wrap
2287 msgid "B<--force-dsc-changes-mismatch>"
2288 msgstr ""
2289
2290 #. type: Plain text
2291 #: ../dgit.1:1340
2292 msgid ""
2293 "Do not check whether .dsc and .changes match.  The archive will probably "
2294 "reject your upload."
2295 msgstr ""
2296
2297 #. type: TP
2298 #: ../dgit.1:1340
2299 #, no-wrap
2300 msgid "B<--force-import-gitapply-absurd> | B<--force-import-gitapply-no-absurd>"
2301 msgstr ""
2302
2303 #. type: Plain text
2304 #: ../dgit.1:1346
2305 msgid ""
2306 "Force on or off the use of the absurd git-apply emulation when running gbp "
2307 "pq import when importing a package from a .dsc.  See Debian bug #841867."
2308 msgstr ""
2309
2310 #. type: TP
2311 #: ../dgit.1:1346
2312 #, no-wrap
2313 msgid "B<--for-push>"
2314 msgstr ""
2315
2316 #. type: Plain text
2317 #: ../dgit.1:1352
2318 msgid ""
2319 "Override the dgit-distro.distro.readonly configuration setting, to specify "
2320 "that we have read/write access and should use the corresponding git and "
2321 "achieve access approach even if the operation is a read-only one."
2322 msgstr ""
2323
2324 #. type: =head1
2325 #: ../dgit.1:1352 ../dgit-downstream-dsc.7.pod:150
2326 #, no-wrap
2327 msgid "CONFIGURATION"
2328 msgstr ""
2329
2330 #. type: Plain text
2331 #: ../dgit.1:1358
2332 msgid ""
2333 "dgit can be configured via the git config system.  You may set keys with git-"
2334 "config (either in system-global or per-tree configuration), or provide B<-"
2335 "c>I<key>B<=>I<value> on the dgit command line."
2336 msgstr ""
2337
2338 #. type: Plain text
2339 #: ../dgit.1:1360
2340 msgid "Settings likely to be useful for an end user include:"
2341 msgstr ""
2342
2343 #. type: TP
2344 #: ../dgit.1:1360
2345 #, no-wrap
2346 msgid "B<dgit.default.build-products-dir>"
2347 msgstr ""
2348
2349 #. type: Plain text
2350 #: ../dgit.1:1366
2351 msgid ""
2352 "Specifies where to find the built files to be uploaded, when --build-"
2353 "products-dir is not specified.  The default is the parent directory (B<..>)."
2354 msgstr ""
2355
2356 #. type: =item
2357 #: ../dgit.1:1366 ../dgit-downstream-dsc.7.pod:286
2358 #, no-wrap
2359 msgid "B<dgit-suite.>I<suite>B<.distro> I<distro>"
2360 msgstr ""
2361
2362 #. type: Plain text
2363 #: ../dgit.1:1371
2364 msgid ""
2365 "Specifies the distro for a suite.  dgit keys off the suite name (which "
2366 "appears in changelogs etc.), and uses that to determine the distro which is "
2367 "involved.  The config used is thereafter that for the distro."
2368 msgstr ""
2369
2370 #. type: Plain text
2371 #: ../dgit.1:1374
2372 msgid "I<suite> may be a glob pattern."
2373 msgstr ""
2374
2375 #. type: TP
2376 #: ../dgit.1:1374
2377 #, no-wrap
2378 msgid "B<dgit.default.distro>I< distro>"
2379 msgstr ""
2380
2381 #. type: Plain text
2382 #: ../dgit.1:1377
2383 msgid "The default distro for an unknown suite."
2384 msgstr ""
2385
2386 #. type: Plain text
2387 #: ../dgit.1:1381
2388 msgid ""
2389 "This is only used if no B</usr/share/distro-info/>I<somedistro>B<.csv> "
2390 "mentions the specified suite."
2391 msgstr ""
2392
2393 #. type: TP
2394 #: ../dgit.1:1381
2395 #, no-wrap
2396 msgid "B<dgit.default.default-suite>I< suite>"
2397 msgstr ""
2398
2399 #. type: Plain text
2400 #: ../dgit.1:1384
2401 msgid "The default suite (eg for clone)."
2402 msgstr ""
2403
2404 #. type: TP
2405 #: ../dgit.1:1384
2406 #, no-wrap
2407 msgid "B<dgit.default.>*"
2408 msgstr ""
2409
2410 #. type: Plain text
2411 #: ../dgit.1:1389
2412 msgid ""
2413 "for each B<dgit-distro.>I<distro>B<.>*, the default value used if there is "
2414 "no distro-specific setting."
2415 msgstr ""
2416
2417 #. type: TP
2418 #: ../dgit.1:1389
2419 #, no-wrap
2420 msgid "B<dgit-distro.>I<distro>B<.clean-mode>"
2421 msgstr ""
2422
2423 #. type: Plain text
2424 #: ../dgit.1:1393
2425 msgid ""
2426 "One of the values for the command line --clean= option; used if --clean is "
2427 "not specified."
2428 msgstr ""
2429
2430 #. type: TP
2431 #: ../dgit.1:1393
2432 #, no-wrap
2433 msgid "B<dgit-distro.>I<distro>B<.clean-mode-newer>"
2434 msgstr ""
2435
2436 #. type: Plain text
2437 #: ../dgit.1:1399
2438 msgid ""
2439 "Like .clean-mode, but ignored if the value is unknown to this version of "
2440 "dgit.  Setting both .clean-mode and .clean-mode-newer is useful to provide a "
2441 "single git config compatible with different dgit versions."
2442 msgstr ""
2443
2444 #. type: TP
2445 #: ../dgit.1:1399
2446 #, no-wrap
2447 msgid "B<dgit-distro.>I<distro>B<.quilt-mode>"
2448 msgstr ""
2449
2450 #. type: Plain text
2451 #: ../dgit.1:1403
2452 msgid ""
2453 "One of the values for the command line --quilt= option; used if --quilt is "
2454 "not specified."
2455 msgstr ""
2456
2457 #. type: TP
2458 #: ../dgit.1:1403
2459 #, no-wrap
2460 msgid "B<dgit-distro.>I<distro>B<.split-view>"
2461 msgstr ""
2462
2463 #. type: TP
2464 #: ../dgit.1:1405
2465 #, no-wrap
2466 msgid "B<dgit-distro.>I<distro>B<.rm-old-changes>"
2467 msgstr ""
2468
2469 #. type: Plain text
2470 #: ../dgit.1:1409
2471 msgid ""
2472 "Boolean, used if neither --rm-old-changes nor --no-rm-old-changes is "
2473 "specified.  The default is not to remove."
2474 msgstr ""
2475
2476 #. type: TP
2477 #: ../dgit.1:1409
2478 #, no-wrap
2479 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>"
2480 msgstr ""
2481
2482 #. type: Plain text
2483 #: ../dgit.1:1416
2484 msgid ""
2485 "Whether you have push access to the distro.  For Debian, it is OK to use "
2486 "auto, which uses readonly mode if you are not pushing right now; but, "
2487 "setting this to false will avoid relying on the mirror of the dgit git "
2488 "repository server."
2489 msgstr ""
2490
2491 #. type: TP
2492 #: ../dgit.1:1416
2493 #, no-wrap
2494 msgid "B<dgit-distro.>I<distro>B<.keyid>"
2495 msgstr ""
2496
2497 #. type: Plain text
2498 #: ../dgit.1:1420
2499 msgid "See also B<-k>."
2500 msgstr ""
2501
2502 #. type: TP
2503 #: ../dgit.1:1420
2504 #, no-wrap
2505 msgid "B<dgit-distro.>I<distro>B<.mirror>I< url>"
2506 msgstr ""
2507
2508 #. type: TP
2509 #: ../dgit.1:1422
2510 #, no-wrap
2511 msgid "B<dgit-distro.>I<distro>B<.username>"
2512 msgstr ""
2513
2514 #. type: Plain text
2515 #: ../dgit.1:1425
2516 msgid "Not relevant for Debian."
2517 msgstr ""
2518
2519 #. type: =item
2520 #: ../dgit.1:1425 ../dgit-downstream-dsc.7.pod:242
2521 #, no-wrap
2522 msgid "B<dgit-distro.>I<distro>B<.upload-host>"
2523 msgstr ""
2524
2525 #. type: Plain text
2526 #: ../dgit.1:1428
2527 msgid "Might be useful if you have an intermediate queue server."
2528 msgstr ""
2529
2530 #. type: TP
2531 #: ../dgit.1:1428
2532 #, no-wrap
2533 msgid "B<dgit-distro.>I<distro>B<.user-name>I< >B<dgit-distro.>I<distro>B<.user-email>"
2534 msgstr ""
2535
2536 #. type: Plain text
2537 #: ../dgit.1:1433
2538 msgid ""
2539 "Values to configure for user.name and user.email in new git trees.  If not "
2540 "specified, the DEBFULLNAME and DEBEMAIL environment variables are used, "
2541 "respectively.  Only used if .setup-usermail is not disabled."
2542 msgstr ""
2543
2544 #. type: TP
2545 #: ../dgit.1:1433
2546 #, no-wrap
2547 msgid "B<dgit-distro.>I<distro>B<.setup-useremail>"
2548 msgstr ""
2549
2550 #. type: Plain text
2551 #: ../dgit.1:1437
2552 msgid ""
2553 "Whether to set user.name and user.email in new git trees.  True by default.  "
2554 "Ignored for dgit setup-useremail, which does it anyway."
2555 msgstr ""
2556
2557 #. type: TP
2558 #: ../dgit.1:1437
2559 #, no-wrap
2560 msgid "B<dgit-distro.>I<distro>B<.setup-mergechangelogs>"
2561 msgstr ""
2562
2563 #. type: Plain text
2564 #: ../dgit.1:1442
2565 msgid ""
2566 "Whether to set up a merge driver which uses dpkg-mergechangelogs for debian/"
2567 "changelog.  True by default.  Ignored for dgit setup-mergechangelogs, which "
2568 "does it anyway."
2569 msgstr ""
2570
2571 #. type: TP
2572 #: ../dgit.1:1442
2573 #, no-wrap
2574 msgid "B<dgit-distro.>I<distro>B<.setup-gitattributes>"
2575 msgstr ""
2576
2577 #. type: Plain text
2578 #: ../dgit.1:1448
2579 msgid ""
2580 "Whether to configure .git/info/attributes to suppress checkin/checkout file "
2581 "content transformations in new git trees.  True by default.  Ignored for "
2582 "dgit setup-gitattributes, which does it anyway."
2583 msgstr ""
2584
2585 #. type: TP
2586 #: ../dgit.1:1448
2587 #, no-wrap
2588 msgid "B<dgit-distro.>I<distro>B<.cmd->I<cmd>"
2589 msgstr ""
2590
2591 #. type: Plain text
2592 #: ../dgit.1:1454
2593 msgid "Program to use instead of I<cmd>.  Works like B<-->I<cmd>B<=>... ."
2594 msgstr ""
2595
2596 #. type: TP
2597 #: ../dgit.1:1454
2598 #, no-wrap
2599 msgid "B<dgit-distro.>I<distro>B<.opts->I<cmd>"
2600 msgstr ""
2601
2602 #. type: Plain text
2603 #: ../dgit.1:1466
2604 msgid ""
2605 "Extra options to pass to I<cmd>.  Works like B<-->I<cmd>B<:>... .  To pass "
2606 "several options, configure multiple values in git config (with git config --"
2607 "add).  The options for B<dgit.default.opts->I<cmd> and B<dgit-distro."
2608 ">I<distro>B</push.opts->I<cmd> are all used, followed by options from dgit's "
2609 "command line."
2610 msgstr ""
2611
2612 #. type: SH
2613 #: ../dgit.1:1466
2614 #, no-wrap
2615 msgid "ACCESS CONFIGURATION"
2616 msgstr ""
2617
2618 #. type: Plain text
2619 #: ../dgit.1:1471
2620 msgid ""
2621 "There are many other settings which specify how a particular distro's "
2622 "services (archive and git) are provided.  These should not normally be "
2623 "adjusted, but are documented for the benefit of distros who wish to adopt "
2624 "dgit."
2625 msgstr ""
2626
2627 #. type: TP
2628 #: ../dgit.1:1471
2629 #, no-wrap
2630 msgid "B<dgit-distro.>I<distro>B<.nominal-distro>"
2631 msgstr ""
2632
2633 #. type: Plain text
2634 #: ../dgit.1:1474
2635 msgid "Shown in git tags, Dgit fields, and so on."
2636 msgstr ""
2637
2638 #. type: TP
2639 #: ../dgit.1:1474
2640 #, no-wrap
2641 msgid "B<dgit-distro.>I<distro>B<.alias-canon>"
2642 msgstr ""
2643
2644 #. type: Plain text
2645 #: ../dgit.1:1477
2646 msgid "Used for all access configuration lookup."
2647 msgstr ""
2648
2649 #. type: TP
2650 #: ../dgit.1:1477
2651 #, no-wrap
2652 msgid "B<dgit-distro.>I<distro>B</push.>*"
2653 msgstr ""
2654
2655 #. type: Plain text
2656 #: ../dgit.1:1483
2657 msgid ""
2658 "If set, overrides corresponding non B</push> config when B<readonly=false>, "
2659 "or when pushing and B<readonly=auto>."
2660 msgstr ""
2661
2662 #. type: TP
2663 #: ../dgit.1:1483
2664 #, no-wrap
2665 msgid "B<dgit-distro.>I<distro>B<.git-url>"
2666 msgstr ""
2667
2668 #. type: TP
2669 #: ../dgit.1:1485
2670 #, no-wrap
2671 msgid "B<dgit-distro.>I<distro>B<.git-url>[B<-suffix>]"
2672 msgstr ""
2673
2674 #. type: TP
2675 #: ../dgit.1:1487
2676 #, no-wrap
2677 msgid "B<dgit-distro.>I<distro>B<.git-proto>"
2678 msgstr ""
2679
2680 #. type: TP
2681 #: ../dgit.1:1489
2682 #, no-wrap
2683 msgid "B<dgit-distro.>I<distro>B<.git-path>"
2684 msgstr ""
2685
2686 #. type: TP
2687 #: ../dgit.1:1491
2688 #, no-wrap
2689 msgid "B<dgit-distro.>I<distro>B<.git-check> B<true>|B<false>|B<url>|B<ssh-cmd>"
2690 msgstr ""
2691
2692 #. type: TP
2693 #: ../dgit.1:1493
2694 #, no-wrap
2695 msgid "B<dgit-distro.>I<distro>B<.git-check-suffix>"
2696 msgstr ""
2697
2698 #. type: TP
2699 #: ../dgit.1:1495
2700 #, no-wrap
2701 msgid "B<dgit-distro.>I<distro>B<.diverts.divert> B<new-distro>|B</>I<distro-suffix>"
2702 msgstr ""
2703
2704 #. type: TP
2705 #: ../dgit.1:1497
2706 #, no-wrap
2707 msgid "B<dgit-distro.>I<distro>B<.git-create>I< >B<ssh-cmd>I<|>B<true>"
2708 msgstr ""
2709
2710 #. type: TP
2711 #: ../dgit.1:1499
2712 #, no-wrap
2713 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:>"
2714 msgstr ""
2715
2716 #. type: TP
2717 #: ../dgit.1:1501
2718 #, no-wrap
2719 msgid "B<dgit-distro.>I<distro>B<.archive-query->(B<url>|B<tls-key>|B<curl-ca-args>)"
2720 msgstr ""
2721
2722 #. type: TP
2723 #: ../dgit.1:1503
2724 #, no-wrap
2725 msgid "B<dgit-distro.>I<distro>B<.madison-distro>"
2726 msgstr ""
2727
2728 #. type: TP
2729 #: ../dgit.1:1505
2730 #, no-wrap
2731 msgid "B<dgit-distro.>I<distro>B<.archive-query-default-component>"
2732 msgstr ""
2733
2734 #. type: TP
2735 #: ../dgit.1:1507
2736 #, no-wrap
2737 msgid "B<dgit-distro.>I<distro>B<.dgit-tag-format>"
2738 msgstr ""
2739
2740 #. type: TP
2741 #: ../dgit.1:1509
2742 #, no-wrap
2743 msgid "B<dgit-distro.>I<distro>B<.dep14tag> B<want>|B<no>[|B<always>]"
2744 msgstr ""
2745
2746 #. type: TP
2747 #: ../dgit.1:1511
2748 #, no-wrap
2749 msgid "B<dgit-distro.>I<distro>B<.ssh>"
2750 msgstr ""
2751
2752 #. type: TP
2753 #: ../dgit.1:1513
2754 #, no-wrap
2755 msgid "B<dgit-distro.>I<distro>B<.sshpsql-dbname>"
2756 msgstr ""
2757
2758 #. type: TP
2759 #: ../dgit.1:1515
2760 #, no-wrap
2761 msgid "B<dgit-distro.>I<distro>B<.>(B<git>|B<sshpsql>)B<->(B<user>|B<host>|B<user-force>)"
2762 msgstr ""
2763
2764 #. type: TP
2765 #: ../dgit.1:1517
2766 #, no-wrap
2767 msgid "B<dgit-distro.>I<distro>B<.backports-quirk>"
2768 msgstr ""
2769
2770 #. type: TP
2771 #: ../dgit.1:1519
2772 #, no-wrap
2773 msgid "B<dgit-distro.>I<distro>B<.rewrite-map-enable>"
2774 msgstr ""
2775
2776 #. type: TP
2777 #: ../dgit.1:1521
2778 #, no-wrap
2779 msgid "B<dgit-distro.>I<distro>B<.source-only-uploads> B<ok>|B<always>|B<never>|B<not-wholly-new>"
2780 msgstr ""
2781
2782 #. type: TP
2783 #: ../dgit.1:1523
2784 #, no-wrap
2785 msgid "B<dgit.default.old-dsc-distro>"
2786 msgstr ""
2787
2788 #. type: TP
2789 #: ../dgit.1:1525
2790 #, no-wrap
2791 msgid "B<dgit.dsc-url-proto-ok.>I<protocol>"
2792 msgstr ""
2793
2794 #. type: TP
2795 #: ../dgit.1:1527
2796 #, no-wrap
2797 msgid "B<dgit.dsc-url-proto-ok.bad-syntax>"
2798 msgstr ""
2799
2800 #. type: TP
2801 #: ../dgit.1:1529
2802 #, no-wrap
2803 msgid "B<dgit.default.dsc-url-proto-ok>"
2804 msgstr ""
2805
2806 #. type: TP
2807 #: ../dgit.1:1531
2808 #, no-wrap
2809 msgid "B<dgit.vcs-git.suites> I<suite>[B<;>...]"
2810 msgstr ""
2811
2812 #. type: SH
2813 #: ../dgit.1:1533
2814 #, no-wrap
2815 msgid "ENVIRONMENT VARIABLES"
2816 msgstr ""
2817
2818 #. type: TP
2819 #: ../dgit.1:1534
2820 #, no-wrap
2821 msgid "B<DGIT_SSH>, B<GIT_SSH>"
2822 msgstr ""
2823
2824 #. type: Plain text
2825 #: ../dgit.1:1543
2826 msgid ""
2827 "specify an alternative default program (and perhaps arguments) to use "
2828 "instead of ssh.  DGIT_SSH is consulted first and may contain arguments; if "
2829 "it contains any whitespace will be passed to the shell.  GIT_SSH specifies "
2830 "just the program; no arguments can be specified, so dgit interprets it the "
2831 "same way as git does.  See also the --ssh= and --ssh: options."
2832 msgstr ""
2833
2834 #. type: TP
2835 #: ../dgit.1:1543
2836 #, no-wrap
2837 msgid "B<DEBEMAIL>, B<DEBFULLNAME>"
2838 msgstr ""
2839
2840 #. type: Plain text
2841 #: ../dgit.1:1547
2842 msgid ""
2843 "Default git user.email and user.name for new trees.  See B<dgit setup-new-"
2844 "tree>."
2845 msgstr ""
2846
2847 #. type: TP
2848 #: ../dgit.1:1547
2849 #, no-wrap
2850 msgid "B<gpg>, B<dpkg->..., B<debsign>, B<git>, [B<lib>]B<curl>, B<dput>"
2851 msgstr ""
2852
2853 #. type: Plain text
2854 #: ../dgit.1:1552
2855 msgid ""
2856 "and other subprograms and modules used by dgit are affected by various "
2857 "environment variables.  Consult the documentation for those programs for "
2858 "details."
2859 msgstr ""
2860
2861 #. type: SH
2862 #: ../dgit.1:1552
2863 #, no-wrap
2864 msgid "BUGS"
2865 msgstr ""
2866
2867 #. type: Plain text
2868 #: ../dgit.1:1559
2869 msgid ""
2870 "There should be a `dgit rebase-prep' command or some such to turn a fast-"
2871 "forwarding branch containing pseudo-merges back into a rebasing patch "
2872 "stack.  It might have to leave a note for a future dgit push."
2873 msgstr ""
2874
2875 #. type: Plain text
2876 #: ../dgit.1:1565
2877 msgid ""
2878 "If the dgit push fails halfway through, it is not necessarily restartable "
2879 "and idempotent.  It would be good to check that the proposed signing key is "
2880 "available before starting work."
2881 msgstr ""
2882
2883 #. type: Plain text
2884 #: ../dgit.1:1570
2885 msgid ""
2886 "dgit's build functions, and dgit push, may make changes to your current "
2887 "HEAD.  Sadly this is necessary for packages in the `3.0 (quilt)' source "
2888 "format.  This is ultimately due to what I consider design problems in quilt "
2889 "and dpkg-source."
2890 msgstr ""
2891
2892 #. type: Plain text
2893 #: ../dgit.1:1575
2894 msgid ""
2895 "--dry-run does not always work properly, as not doing some of the git "
2896 "fetches may result in subsequent actions being different.  Doing a non-dry-"
2897 "run dgit fetch first will help.  --damp-run is likely to work much better."
2898 msgstr ""
2899
2900 #. type: =head1
2901 #: ../dgit.1:1575 ../dgit.7:23 ../dgit-user.7.pod:447
2902 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
2903 #: ../dgit-maint-merge.7.pod:524 ../dgit-maint-gbp.7.pod:136
2904 #: ../dgit-maint-debrebase.7.pod:782 ../dgit-downstream-dsc.7.pod:352
2905 #: ../dgit-sponsorship.7.pod:321 ../dgit-maint-bpo.7.pod:140
2906 #: ../git-debrebase.1.pod:634 ../git-debrebase.5.pod:678
2907 #: ../git-debpush.1.pod:261
2908 #, no-wrap
2909 msgid "SEE ALSO"
2910 msgstr ""
2911
2912 #. type: Plain text
2913 #: ../dgit.1:1584
2914 msgid ""
2915 "B<dgit>(7), B<dgit-*>(7), B<curl>(1), B<dput>(1), B<debsign>(1), B<git-"
2916 "config>(1), B<git-buildpackage>(1), B<dpkg-buildpackage>(1),"
2917 msgstr ""
2918
2919 #. type: Plain text
2920 #: ../dgit.1:1585
2921 msgid "https://browse.dgit.debian.org/"
2922 msgstr ""