po4a/git-debrebase_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-07-21 01:37+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: =head1
  20 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
  21 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
  22 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
  23 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
  24 #: ../dgit-maint-bpo.7.pod:1 ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
  25 #: ../git-debpush.1.pod:1
  26 #, no-wrap
  27 msgid "NAME"
  28 msgstr ""
  29
  30 #. type: =head1
  31 #: ../dgit.1:496 ../git-debrebase.1.pod:462
  32 #, no-wrap
  33 msgid "OPTIONS"
  34 msgstr ""
  35
  36 #. type: =head1
  37 #: ../dgit.1:1549 ../dgit.7:23 ../dgit-user.7.pod:447
  38 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
  39 #: ../dgit-maint-merge.7.pod:521 ../dgit-maint-gbp.7.pod:136
  40 #: ../dgit-maint-debrebase.7.pod:778 ../dgit-downstream-dsc.7.pod:352
  41 #: ../dgit-sponsorship.7.pod:321 ../dgit-maint-bpo.7.pod:134
  42 #: ../git-debrebase.1.pod:619 ../git-debrebase.5.pod:678
  43 #: ../git-debpush.1.pod:223
  44 #, no-wrap
  45 msgid "SEE ALSO"
  46 msgstr ""
  47
  48 #. type: =head1
  49 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
  50 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
  51 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
  52 #: ../dgit-maint-bpo.7.pod:5 ../git-debrebase.1.pod:10 ../git-debrebase.5.pod:5
  53 msgid "INTRODUCTION"
  54 msgstr ""
  55
  56 #. type: textblock
  57 #: ../git-debrebase.1.pod:3
  58 msgid "git-debrebase - delta queue rebase tool for Debian packaging"
  59 msgstr ""
  60
  61 #. type: =head1
  62 #: ../git-debrebase.1.pod:5
  63 msgid "SYNOPSYS"
  64 msgstr ""
  65
  66 #. type: verbatim
  67 #: ../git-debrebase.1.pod:7
  68 #, no-wrap
  69 msgid ""
  70 " git-debrebase [<options...>] [-- <git-rebase options...>]\n"
  71 " git-debrebase [<options...>] <operation> [<operation options...>\n"
  72 "\n"
  73 msgstr ""
  74
  75 #. type: textblock
  76 #: ../git-debrebase.1.pod:12 ../git-debrebase.5.pod:7
  77 msgid ""
  78 "git-debrebase is a tool for representing in git, and manpulating, Debian "
  79 "packages based on upstream source code."
  80 msgstr ""
  81
  82 #. type: textblock
  83 #: ../git-debrebase.1.pod:16
  84 msgid ""
  85 "This is the command line reference.  Please read the tutorial L<dgit-maint-"
  86 "debrebase(7)>.  For background, theory of operation, and definitions see "
  87 "L<git-debrebase(5)>."
  88 msgstr ""
  89
  90 #. type: textblock
  91 #: ../git-debrebase.1.pod:22
  92 msgid ""
  93 "You should read this manpage in conjunction with L<git-debrebase(5)/"
  94 "TERMINOLOGY>, which defines many important terms used here."
  95 msgstr ""
  96
  97 #. type: =head1
  98 #: ../git-debrebase.1.pod:26
  99 msgid "PRINCIPAL OPERATIONS"
 100 msgstr ""
 101
 102 #. type: =item
 103 #: ../git-debrebase.1.pod:30
 104 msgid "git-debrebase [-- <git-rebase options...>]"
 105 msgstr ""
 106
 107 #. type: =item
 108 #: ../git-debrebase.1.pod:32
 109 msgid "git-debrebase [-i <further git-rebase options...>]"
 110 msgstr ""
 111
 112 #. type: textblock
 113 #: ../git-debrebase.1.pod:34
 114 msgid ""
 115 "Unstitches and launders the branch.  (See L</UNSTITCHING AND LAUNDERING> "
 116 "below.)"
 117 msgstr ""
 118
 119 #. type: textblock
 120 #: ../git-debrebase.1.pod:37
 121 msgid ""
 122 "Then, if any git-rebase options were supplied, edits the Debian delta queue, "
 123 "using git-rebase, by running"
 124 msgstr ""
 125
 126 #. type: verbatim
 127 #: ../git-debrebase.1.pod:41
 128 #, no-wrap
 129 msgid ""
 130 "    git rebase <git-rebase options> <breakwater-tip>\n"
 131 "\n"
 132 msgstr ""
 133
 134 #. type: textblock
 135 #: ../git-debrebase.1.pod:43
 136 msgid ""
 137 "Do not pass a base branch argument: git-debrebase will supply that.  Do not "
 138 "use --onto, or --fork-point.  Useful git-rebase options include -i and --"
 139 "autosquash."
 140 msgstr ""
 141
 142 #. type: textblock
 143 #: ../git-debrebase.1.pod:48
 144 msgid ""
 145 "If git-rebase stops for any reason, you may git-rebase --abort, --continue, "
 146 "or --skip, as usual.  If you abort the git-rebase, the branch will still "
 147 "have been laundered, but everything in the rebase will be undone."
 148 msgstr ""
 149
 150 #. type: textblock
 151 #: ../git-debrebase.1.pod:54
 152 msgid ""
 153 "The options for git-rebase must either start with C<-i>, or be prececded by "
 154 "C<-->, to distinguish them from options for git-debrebase."
 155 msgstr ""
 156
 157 #. type: textblock
 158 #: ../git-debrebase.1.pod:58
 159 msgid ""
 160 "It is hazardous to use plain git-rebase on a git-debrebase branch, because "
 161 "git-rebase has a tendency to start the rebase too far back in history, and "
 162 "then drop important commits.  See L<git-debrebase(5)/ILLEGAL OPERATIONS>"
 163 msgstr ""
 164
 165 #. type: =item
 166 #: ../git-debrebase.1.pod:64
 167 msgid "git-debrebase status"
 168 msgstr ""
 169
 170 #. type: textblock
 171 #: ../git-debrebase.1.pod:66
 172 msgid ""
 173 "Analyses the current branch, both in terms of its contents, and the refs "
 174 "which are relevant to git-debrebase, and prints a human-readable summary."
 175 msgstr ""
 176
 177 #. type: textblock
 178 #: ../git-debrebase.1.pod:71
 179 msgid ""
 180 "Please do not attempt to parse the output; it may be reformatted or "
 181 "reorganised in the future.  Instead, use one of the L<UNDERLYING AND "
 182 "SUPPLEMENTARY OPERATIONS> described below."
 183 msgstr ""
 184
 185 #. type: =item
 186 #: ../git-debrebase.1.pod:77
 187 msgid "git-debrebase conclude"
 188 msgstr ""
 189
 190 #. type: textblock
 191 #: ../git-debrebase.1.pod:79
 192 msgid ""
 193 "Finishes a git-debrebase session, tidying up the branch and making it fast "
 194 "forward again."
 195 msgstr ""
 196
 197 #. type: textblock
 198 #: ../git-debrebase.1.pod:82
 199 msgid ""
 200 "Specifically: if the branch is unstitched, launders and restitches it, "
 201 "making a new pseudomerge.  Otherwise, it is an error, unless --noop-ok."
 202 msgstr ""
 203
 204 #. type: =item
 205 #: ../git-debrebase.1.pod:88
 206 msgid "git-debrebase quick"
 207 msgstr ""
 208
 209 #. type: textblock
 210 #: ../git-debrebase.1.pod:90
 211 msgid ""
 212 "Unconditionally launders and restitches the branch, consuming any ffq-prev "
 213 "and making a new pseudomerge."
 214 msgstr ""
 215
 216 #. type: textblock
 217 #: ../git-debrebase.1.pod:94
 218 msgid "If the branch is already laundered and stitched, does nothing."
 219 msgstr ""
 220
 221 #. type: =item
 222 #: ../git-debrebase.1.pod:96
 223 msgid "git-debrebase prepush [--prose=<for commit message>]"
 224 msgstr ""
 225
 226 #. type: textblock
 227 #: ../git-debrebase.1.pod:98
 228 msgid "If the branch is unstitched, stitches it, consuming ffq-prev."
 229 msgstr ""
 230
 231 #. type: textblock
 232 #: ../git-debrebase.1.pod:102
 233 msgid ""
 234 "This is a good command to run before pushing to a git server.  You should "
 235 "consider using B<conclude> instead, because that launders the branch too."
 236 msgstr ""
 237
 238 #. type: =item
 239 #: ../git-debrebase.1.pod:106
 240 msgid "git-debrebase stitch [--prose=<for commit message>]"
 241 msgstr ""
 242
 243 #. type: textblock
 244 #: ../git-debrebase.1.pod:108
 245 msgid "Stitches the branch, consuming ffq-prev."
 246 msgstr ""
 247
 248 #. type: textblock
 249 #: ../git-debrebase.1.pod:111
 250 msgid "If there is no ffq-prev, it is an error, unless --noop-ok."
 251 msgstr ""
 252
 253 #. type: textblock
 254 #: ../git-debrebase.1.pod:113
 255 msgid "You should consider using B<prepush> or B<conclude> instead."
 256 msgstr ""
 257
 258 #. type: =item
 259 #: ../git-debrebase.1.pod:115
 260 msgid "git-debrebase scrap"
 261 msgstr ""
 262
 263 #. type: textblock
 264 #: ../git-debrebase.1.pod:117
 265 msgid ""
 266 "Throws away all the work since the branch was last stitched.  This is done "
 267 "by rewinding you to ffq-prev."
 268 msgstr ""
 269
 270 #. type: textblock
 271 #: ../git-debrebase.1.pod:120
 272 msgid "If you are in the middle of a git-rebase, will abort that too."
 273 msgstr ""
 274
 275 #. type: =item
 276 #: ../git-debrebase.1.pod:122
 277 msgid "git-debrebase new-upstream <new-version> [<upstream-details>...]"
 278 msgstr ""
 279
 280 #. type: textblock
 281 #: ../git-debrebase.1.pod:124
 282 msgid "Rebases the delta queue onto a new upstream version.  In detail:"
 283 msgstr ""
 284
 285 #. type: textblock
 286 #: ../git-debrebase.1.pod:127
 287 msgid ""
 288 "Firstly, checks that the proposed rebase seems to make sense: It is a snag "
 289 "unless the new upstream(s)  are fast forward from the previous upstream(s)  "
 290 "as found in the current breakwater anchor.  And, in the case of a multi-"
 291 "piece upstream (a multi-component upstream, in dpkg-source terminology), if "
 292 "the pieces are not in the same order, with the same names."
 293 msgstr ""
 294
 295 #. type: textblock
 296 #: ../git-debrebase.1.pod:135
 297 msgid "If all seems well, unstitches and launders the branch."
 298 msgstr ""
 299
 300 #. type: textblock
 301 #: ../git-debrebase.1.pod:137
 302 msgid ""
 303 "Then, generates (in a private working area)  a new anchor merge commit, on "
 304 "top of the breakwater tip, and on top of that a commit to update the version "
 305 "number in debian/changelog."
 306 msgstr ""
 307
 308 #. type: textblock
 309 #: ../git-debrebase.1.pod:145
 310 msgid "Finally, starts a git-rebase of the delta queue onto these new commits."
 311 msgstr ""
 312
 313 #. type: textblock
 314 #: ../git-debrebase.1.pod:149
 315 msgid ""
 316 "That git-rebase may complete successfully, or it may require your "
 317 "assistance, just like a normal git-rebase."
 318 msgstr ""
 319
 320 #. type: textblock
 321 #: ../git-debrebase.1.pod:153
 322 msgid ""
 323 "If you git-rebase --abort, the whole new upstream operation is aborted, "
 324 "except for the laundering."
 325 msgstr ""
 326
 327 #. type: textblock
 328 #: ../git-debrebase.1.pod:157
 329 msgid ""
 330 "<new-version> may be a whole new Debian version, including revision, or just "
 331 "the upstream part, in which case -1 will be appended to make the new Debian "
 332 "version."
 333 msgstr ""
 334
 335 #. type: textblock
 336 #: ../git-debrebase.1.pod:163
 337 msgid "The <upstream-details> are, optionally, in order:"
 338 msgstr ""
 339
 340 #. type: =item
 341 #: ../git-debrebase.1.pod:167
 342 msgid "<upstream-commit-ish>"
 343 msgstr ""
 344
 345 #. type: textblock
 346 #: ../git-debrebase.1.pod:169
 347 msgid ""
 348 "The new upstream branch (or commit-ish).  The default is to look for one of "
 349 "these tags, in this order: U vU upstream/U; where U is the new upstream "
 350 "version.  (This is the same algorithm as L<git-deborig(1)>.)"
 351 msgstr ""
 352
 353 #. type: textblock
 354 #: ../git-debrebase.1.pod:175
 355 msgid ""
 356 "It is a snag if the upstream contains a debian/ directory; if forced to "
 357 "proceed, git-debrebase will disregard the upstream's debian/ and take (only) "
 358 "the packaging from the current breakwater."
 359 msgstr ""
 360
 361 #. type: =item
 362 #: ../git-debrebase.1.pod:180
 363 msgid "<piece-name> <piece-upstream-commit-ish>"
 364 msgstr ""
 365
 366 #. type: textblock
 367 #: ../git-debrebase.1.pod:182
 368 msgid "Specifies that this is a multi-piece upstream.  May be repeated."
 369 msgstr ""
 370
 371 #. type: textblock
 372 #: ../git-debrebase.1.pod:185
 373 msgid ""
 374 "When such a pair is specified, git-debrebase will first combine the pieces "
 375 "of the upstream together, and then use the result as the combined new "
 376 "upstream."
 377 msgstr ""
 378
 379 #. type: textblock
 380 #: ../git-debrebase.1.pod:190
 381 msgid ""
 382 "For each <piece-name>, the tree of the <piece-upstream-commit-ish> becomes "
 383 "the subdirectory <piece-name> in the combined new upstream (supplanting any "
 384 "subdirectory that might be there in the main upstream branch)."
 385 msgstr ""
 386
 387 #. type: textblock
 388 #: ../git-debrebase.1.pod:197
 389 msgid ""
 390 "<piece-name> has a restricted syntax: it may contain only ASCII "
 391 "alphanumerics and hyphens."
 392 msgstr ""
 393
 394 #. type: textblock
 395 #: ../git-debrebase.1.pod:200
 396 msgid ""
 397 "The combined upstream is itself recorded as a commit, with each of the "
 398 "upstream pieces' commits as parents.  The combined commit contains an "
 399 "annotation to allow a future git-debrebase new upstream operation to make "
 400 "the coherency checks described above."
 401 msgstr ""
 402
 403 #. type: =item
 404 #: ../git-debrebase.1.pod:206
 405 msgid "<git-rebase options>"
 406 msgstr ""
 407
 408 #. type: textblock
 409 #: ../git-debrebase.1.pod:208
 410 msgid "These will be passed to git rebase."
 411 msgstr ""
 412
 413 #. type: textblock
 414 #: ../git-debrebase.1.pod:210
 415 msgid ""
 416 "If the upstream rebase is troublesome, -i may be helpful.  As with plain git-"
 417 "debrebase, do not specify a base, or --onto, or --fork-point."
 418 msgstr ""
 419
 420 #. type: textblock
 421 #: ../git-debrebase.1.pod:216
 422 msgid ""
 423 "If you are planning to generate a .dsc, you will also need to have, or "
 424 "generate, actual orig tarball(s), which must be identical to the rev-"
 425 "spec(s)  passed to git-debrebase.  git-debrebase does not concern itself "
 426 "with source packages so neither helps with this, nor checks it.  L<git-"
 427 "deborig(1)>, L<git-archive(1)>, L<dgit(1)> and L<gbp-import-orig(1)> may be "
 428 "able to help."
 429 msgstr ""
 430
 431 #. type: =item
 432 #: ../git-debrebase.1.pod:227
 433 msgid "git-debrebase make-patches [--quiet-would-amend]"
 434 msgstr ""
 435
 436 #. type: textblock
 437 #: ../git-debrebase.1.pod:229
 438 msgid ""
 439 "Generate patches in debian/patches/ representing the changes made to "
 440 "upstream files."
 441 msgstr ""
 442
 443 #. type: textblock
 444 #: ../git-debrebase.1.pod:232
 445 msgid ""
 446 "It is not normally necessary to run this command explicitly.  When uploading "
 447 "to Debian, dgit and git-debrebase will cooperate to regenerate patches as "
 448 "necessary.  When working with pure git remotes, the patches are not needed."
 449 msgstr ""
 450
 451 #. type: textblock
 452 #: ../git-debrebase.1.pod:239
 453 msgid ""
 454 "Normally git-debrebase make-patches will require a laundered branch.  (A "
 455 "laundered branch does not contain any patches.)  But if there are already "
 456 "some patches made by git-debrebase make-patches, and all that has happened "
 457 "is that more changes to upstream files have been committed, running it again "
 458 "can add the missing patches."
 459 msgstr ""
 460
 461 #. type: textblock
 462 #: ../git-debrebase.1.pod:248
 463 msgid ""
 464 "If the patches implied by the current branch are not a simple superset of "
 465 "those already in debian/patches, make-patches will fail with exit status 7, "
 466 "and an error message.  (The message can be suppressed with --quiet-would-"
 467 "amend.)  If the problem is simply that the existing patches were not made by "
 468 "git-debrebase, using dgit quilt-fixup instead should succeed."
 469 msgstr ""
 470
 471 #. type: =item
 472 #: ../git-debrebase.1.pod:257
 473 msgid "git-debrebase convert-from-unapplied [<upstream-commit-ish>]"
 474 msgstr ""
 475
 476 #. type: =item
 477 #: ../git-debrebase.1.pod:259
 478 msgid "git-debrebase convert-from-gbp [<upstream-commit-ish>]"
 479 msgstr ""
 480
 481 #. type: textblock
 482 #: ../git-debrebase.1.pod:261
 483 msgid "Converts any of the following into a git-debrebase interchange branch:"
 484 msgstr ""
 485
 486 #. type: textblock
 487 #: ../git-debrebase.1.pod:267
 488 msgid "a gbp patches-unapplied branch (but not a gbp pq patch-queue branch)"
 489 msgstr ""
 490
 491 #. type: textblock
 492 #: ../git-debrebase.1.pod:271
 493 msgid ""
 494 "a patches-unapplied git packaging branch containing debian/patches, as used "
 495 "with quilt"
 496 msgstr ""
 497
 498 #. type: textblock
 499 #: ../git-debrebase.1.pod:276
 500 msgid ""
 501 "a git branch for a package which has no Debian delta - ie where upstream "
 502 "files are have not been modified in Debian, so there are no patches"
 503 msgstr ""
 504
 505 #. type: textblock
 506 #: ../git-debrebase.1.pod:282
 507 msgid "(These two commands operate identically and are simply aliases.)"
 508 msgstr ""
 509
 510 #. type: textblock
 511 #: ../git-debrebase.1.pod:284
 512 msgid ""
 513 "The conversion is done by generating a new anchor merge, converting any "
 514 "quilt patches as a delta queue, and dropping the patches from the tree."
 515 msgstr ""
 516
 517 #. type: textblock
 518 #: ../git-debrebase.1.pod:288
 519 msgid ""
 520 "The upstream commit-ish should correspond to the upstream branch or tag, if "
 521 "there is one.  It is a snag if it is not an ancestor of HEAD, or if the "
 522 "history between the upstream and HEAD contains commits which make changes to "
 523 "upstream files.  If it is not specified, the same algorithm is used as for "
 524 "git-debrebase new-upstream."
 525 msgstr ""
 526
 527 #. type: textblock
 528 #: ../git-debrebase.1.pod:296
 529 msgid ""
 530 "It is also a snag if the specified upstream has a debian/ subdirectory.  "
 531 "This check exists to detect certain likely user errors, but if this "
 532 "situation is true and expected, forcing it is fine."
 533 msgstr ""
 534
 535 #. type: textblock
 536 #: ../git-debrebase.1.pod:302
 537 msgid ""
 538 "git-debrebase will try to look for the dgit archive view of the most recent "
 539 "release, and if it finds it will make a pseduomerge so that your new git-"
 540 "debrebase view is appropriately fast forward."
 541 msgstr ""
 542
 543 #. type: textblock
 544 #: ../git-debrebase.1.pod:307
 545 msgid ""
 546 "The result is a well-formed git-debrebase interchange branch.  The result is "
 547 "also fast-forward from the original branch."
 548 msgstr ""
 549
 550 #. type: textblock
 551 #: ../git-debrebase.1.pod:310
 552 msgid ""
 553 "It is a snag if the new branch looks like it will have diverged, just as for "
 554 "a laundering/unstitching call to git-debrebase; See L</Establish the current "
 555 "branch's ffq-prev>, below."
 556 msgstr ""
 557
 558 #. type: textblock
 559 #: ../git-debrebase.1.pod:314
 560 msgid ""
 561 "Note that it is dangerous not to know whether you are dealing with a (gbp) "
 562 "patches-unapplied branch containing quilt patches, or a git-debrebase "
 563 "interchange branch.  At worst, using the wrong tool for the branch format "
 564 "might result in a dropped patch queue!"
 565 msgstr ""
 566
 567 #. type: =head1
 568 #: ../git-debrebase.1.pod:323
 569 msgid "UNDERLYING AND SUPPLEMENTARY OPERATIONS"
 570 msgstr ""
 571
 572 #. type: =item
 573 #: ../git-debrebase.1.pod:327
 574 msgid "git-debrebase breakwater"
 575 msgstr ""
 576
 577 #. type: textblock
 578 #: ../git-debrebase.1.pod:329
 579 msgid ""
 580 "Prints the breakwater tip commitid.  If your HEAD branch is not fully "
 581 "laundered, prints the tip of the so-far-laundered breakwater."
 582 msgstr ""
 583
 584 #. type: =item
 585 #: ../git-debrebase.1.pod:333
 586 msgid "git-debrebase anchor"
 587 msgstr ""
 588
 589 #. type: textblock
 590 #: ../git-debrebase.1.pod:335
 591 msgid "Prints the breakwater anchor commitid."
 592 msgstr ""
 593
 594 #. type: =item
 595 #: ../git-debrebase.1.pod:337
 596 msgid "git-debrebase analyse"
 597 msgstr ""
 598
 599 #. type: textblock
 600 #: ../git-debrebase.1.pod:339
 601 msgid ""
 602 "Walks the history of the current branch, most recent commit first, back "
 603 "until the most recent anchor, printing the commit object id, and commit type "
 604 "and info (ie the semantics in the git-debrebase model)  for each commit."
 605 msgstr ""
 606
 607 #. type: =item
 608 #: ../git-debrebase.1.pod:347
 609 msgid "git-debrebase record-ffq-prev"
 610 msgstr ""
 611
 612 #. type: textblock
 613 #: ../git-debrebase.1.pod:349
 614 msgid ""
 615 "Establishes the current branch's ffq-prev, as discussed in L</UNSTITCHING "
 616 "AND LAUNDERING>, but does not launder the branch or move HEAD."
 617 msgstr ""
 618
 619 #. type: textblock
 620 #: ../git-debrebase.1.pod:353
 621 msgid ""
 622 "It is an error if the ffq-prev could not be recorded.  It is also an error "
 623 "if an ffq-prev has already been recorded, unless --noop-ok."
 624 msgstr ""
 625
 626 #. type: =item
 627 #: ../git-debrebase.1.pod:357
 628 msgid "git-debrebase launder-v0"
 629 msgstr ""
 630
 631 #. type: textblock
 632 #: ../git-debrebase.1.pod:359
 633 msgid ""
 634 "Launders the branch without recording anything in ffq-prev.  Then prints "
 635 "some information about the current branch.  Do not use this operation; it "
 636 "will be withdrawn soon."
 637 msgstr ""
 638
 639 #. type: =item
 640 #: ../git-debrebase.1.pod:364
 641 msgid "git-debrebase convert-to-gbp"
 642 msgstr ""
 643
 644 #. type: textblock
 645 #: ../git-debrebase.1.pod:366
 646 msgid ""
 647 "Converts a laundered branch into a gbp patches-unapplied branch containing "
 648 "quilt patches.  The result is not fast forward from the interchange branch, "
 649 "and any ffq-prev is deleted."
 650 msgstr ""
 651
 652 #. type: textblock
 653 #: ../git-debrebase.1.pod:371
 654 msgid ""
 655 "This is provided mostly for the test suite and for unusual situations.  It "
 656 "should only be used with care and with a proper understanding of the "
 657 "underlying theory."
 658 msgstr ""
 659
 660 #. type: textblock
 661 #: ../git-debrebase.1.pod:376
 662 msgid ""
 663 "Be sure to not accidentally treat the result as a git-debrebase branch, or "
 664 "you will drop all the patches!"
 665 msgstr ""
 666
 667 #. type: =item
 668 #: ../git-debrebase.1.pod:380
 669 msgid "git-debrebase convert-from-dgit-view [<convert-options>] [upstream]"
 670 msgstr ""
 671
 672 #. type: textblock
 673 #: ../git-debrebase.1.pod:382
 674 msgid ""
 675 "Converts any dgit-compatible git branch corresponding to a (possibly "
 676 "hypothetical) 3.0 quilt dsc source package into a git-debrebase-compatible "
 677 "branch."
 678 msgstr ""
 679
 680 #. type: textblock
 681 #: ../git-debrebase.1.pod:386
 682 msgid ""
 683 "This operation should not be used if the branch is already in git-debrebase "
 684 "form.  Normally git-debrebase will refuse to continue in this case (or "
 685 "silently do nothing if the global --noop-ok option is used)."
 686 msgstr ""
 687
 688 #. type: textblock
 689 #: ../git-debrebase.1.pod:391
 690 msgid ""
 691 "Some representation of the original upstream source code will be needed.  If "
 692 "I<upstream> is supplied, that must be a suitable upstream commit.  By "
 693 "default, git-debrebase will look first for git tags (as for new-upstream), "
 694 "and then for orig tarballs which it will ask dgit to process."
 695 msgstr ""
 696
 697 #. type: textblock
 698 #: ../git-debrebase.1.pod:397
 699 msgid ""
 700 "The upstream source must be exactly right and all the patches in debian/"
 701 "patches must be up to date.  Applying the patches from debian/patches to the "
 702 "upstream source must result in exactly your HEAD."
 703 msgstr ""
 704
 705 #. type: textblock
 706 #: ../git-debrebase.1.pod:402
 707 msgid ""
 708 "The output is laundered and stitched.  The resulting history is not "
 709 "particularly pretty, especially if orig tarball(s) were imported to produce "
 710 "a synthetic upstream commit."
 711 msgstr ""
 712
 713 #. type: textblock
 714 #: ../git-debrebase.1.pod:407
 715 msgid ""
 716 "The available convert-options are as follows.  (These must come after "
 717 "convert-from-dgit-view.)"
 718 msgstr ""
 719
 720 #. type: =item
 721 #: ../git-debrebase.1.pod:412
 722 msgid "--[no-]diagnose"
 723 msgstr ""
 724
 725 #. type: textblock
 726 #: ../git-debrebase.1.pod:414
 727 msgid ""
 728 "Print additional error messages to help diagnose failure to find an "
 729 "appropriate upstream.  --no-diagnose is the default."
 730 msgstr ""
 731
 732 #. type: =item
 733 #: ../git-debrebase.1.pod:418
 734 msgid "--build-products-dir"
 735 msgstr ""
 736
 737 #. type: textblock
 738 #: ../git-debrebase.1.pod:420
 739 msgid ""
 740 "Directory to look in for orig tarballs.  The default is the git config "
 741 "option dgit.default.build-products-dir or failing that, C<..>.  Passed on to "
 742 "dgit, if git-debrebase invokes dgit."
 743 msgstr ""
 744
 745 #. type: =item
 746 #: ../git-debrebase.1.pod:426
 747 msgid "--[no-]origs"
 748 msgstr ""
 749
 750 #. type: textblock
 751 #: ../git-debrebase.1.pod:428
 752 msgid ""
 753 "Whether to try to look for or use any orig tarballs.  --origs is the default."
 754 msgstr ""
 755
 756 #. type: =item
 757 #: ../git-debrebase.1.pod:431
 758 msgid "--[no-]tags"
 759 msgstr ""
 760
 761 #. type: textblock
 762 #: ../git-debrebase.1.pod:433
 763 msgid ""
 764 "Whether to try to look for or use any upstream git tags.  --tags is the "
 765 "default."
 766 msgstr ""
 767
 768 #. type: =item
 769 #: ../git-debrebase.1.pod:436
 770 msgid "--always-convert-anyway"
 771 msgstr ""
 772
 773 #. type: textblock
 774 #: ../git-debrebase.1.pod:438
 775 msgid ""
 776 "Perform the conversion operation, producing unpleasant extra history, even "
 777 "if the branch seems to be in git-debrebase form already.  This should not be "
 778 "done unless necessary, and it should not be necessary."
 779 msgstr ""
 780
 781 #. type: =item
 782 #: ../git-debrebase.1.pod:446
 783 msgid "git-debrebase forget-was-ever-debrebase"
 784 msgstr ""
 785
 786 #. type: textblock
 787 #: ../git-debrebase.1.pod:448
 788 msgid ""
 789 "Deletes the ffq-prev and debrebase-last refs associated with this branch, "
 790 "that git-debrebase and dgit use to determine whether this branch is managed "
 791 "by git-debrebase, and what previous head may need to be stitched back in."
 792 msgstr ""
 793
 794 #. type: textblock
 795 #: ../git-debrebase.1.pod:454
 796 msgid ""
 797 "This can be useful if you were just playing with git-debrebase, and have "
 798 "used git-reset --hard to go back to a commit before your experiments."
 799 msgstr ""
 800
 801 #. type: textblock
 802 #: ../git-debrebase.1.pod:458
 803 msgid "Do not use this if you expect to run git-debrebase on the branch again."
 804 msgstr ""
 805
 806 #. type: textblock
 807 #: ../git-debrebase.1.pod:464
 808 msgid ""
 809 "This section documents the general options to git-debrebase (ie, the ones "
 810 "which immediately follow git-debrebase or git debrebase on the command "
 811 "line).  Individual operations may have their own options which are docuented "
 812 "under each operation."
 813 msgstr ""
 814
 815 #. type: =item
 816 #: ../git-debrebase.1.pod:476
 817 msgid "-f<snag-id>"
 818 msgstr ""
 819
 820 #. type: textblock
 821 #: ../git-debrebase.1.pod:478
 822 msgid "Turns snag(s) with id <snag-id> into warnings."
 823 msgstr ""
 824
 825 #. type: textblock
 826 #: ../git-debrebase.1.pod:480
 827 msgid ""
 828 "Some troublesome things which git-debrebase encounters are B<snag>s.  (The "
 829 "specific instances are discussed in the text for the relevant operation.)"
 830 msgstr ""
 831
 832 #. type: textblock
 833 #: ../git-debrebase.1.pod:485
 834 msgid ""
 835 "When a snag is detected, a message is printed to stderr containing the snag "
 836 "id (in the form C<-f<snag-idE<gt>>), along with some prose."
 837 msgstr ""
 838
 839 #. type: textblock
 840 #: ../git-debrebase.1.pod:490
 841 msgid ""
 842 "If snags are detected, git-debrebase does not continue, unless the relevant -"
 843 "f<snag-id> is specified, or --force is specified."
 844 msgstr ""
 845
 846 #. type: =item
 847 #: ../git-debrebase.1.pod:494
 848 msgid "--force"
 849 msgstr ""
 850
 851 #. type: textblock
 852 #: ../git-debrebase.1.pod:496
 853 msgid "Turns all snags into warnings.  See the -f<snag-id> option."
 854 msgstr ""
 855
 856 #. type: textblock
 857 #: ../git-debrebase.1.pod:499
 858 msgid ""
 859 "Do not invoke git-debrebase --force in scripts and aliases; instead, specify "
 860 "the particular -f<snag-id> for expected snags."
 861 msgstr ""
 862
 863 #. type: =item
 864 #: ../git-debrebase.1.pod:502
 865 msgid "--noop-ok"
 866 msgstr ""
 867
 868 #. type: textblock
 869 #: ../git-debrebase.1.pod:504
 870 msgid ""
 871 "Suppresses the error in some situations where git-debrebase does nothing, "
 872 "because there is nothing to do."
 873 msgstr ""
 874
 875 #. type: textblock
 876 #: ../git-debrebase.1.pod:508
 877 msgid ""
 878 "The specific instances are discussed in the text for the relvant operation."
 879 msgstr ""
 880
 881 #. type: =item
 882 #: ../git-debrebase.1.pod:511
 883 msgid "--anchor=<commit-ish>"
 884 msgstr ""
 885
 886 #. type: textblock
 887 #: ../git-debrebase.1.pod:513
 888 msgid ""
 889 "Treats <commit-ish> as an anchor.  This overrides the usual logic which "
 890 "automatically classifies commits as anchors, pseudomerges, delta queue "
 891 "commits, etc."
 892 msgstr ""
 893
 894 #. type: textblock
 895 #: ../git-debrebase.1.pod:517
 896 msgid ""
 897 "It also disables some coherency checks which depend on metadata extracted "
 898 "from its commit message, so it is a snag if <commit-ish> is the anchor for "
 899 "the previous upstream version in git-debrebase new-upstream operations."
 900 msgstr ""
 901
 902 #. type: =item
 903 #: ../git-debrebase.1.pod:524
 904 msgid "--dgit=<program>"
 905 msgstr ""
 906
 907 #. type: textblock
 908 #: ../git-debrebase.1.pod:526
 909 msgid ""
 910 "Run <program>, instead of dgit from PATH, when invocation of dgit is "
 911 "necessary.  This is provided mostly for the benefit of the test suite."
 912 msgstr ""
 913
 914 #. type: =item
 915 #: ../git-debrebase.1.pod:530
 916 msgid "-D"
 917 msgstr ""
 918
 919 #. type: textblock
 920 #: ../git-debrebase.1.pod:532
 921 msgid "Requests (more) debugging.  May be repeated."
 922 msgstr ""
 923
 924 #. type: =item
 925 #: ../git-debrebase.1.pod:534
 926 msgid "--experimental-merge-resolution"
 927 msgstr ""
 928
 929 #. type: textblock
 930 #: ../git-debrebase.1.pod:536
 931 msgid ""
 932 "Enable experimental code for handling general merges (see L<git-debrebase(5)/"
 933 "General merges>)."
 934 msgstr ""
 935
 936 #. type: textblock
 937 #: ../git-debrebase.1.pod:539
 938 msgid ""
 939 "This option may generate lossage of various kinds, including misleading "
 940 "error messages, references to nonexistent documentation, and you being "
 941 "handed an incomprehensible pile of multidimensional merge wreckage."
 942 msgstr ""
 943
 944 #. type: =head1
 945 #: ../git-debrebase.1.pod:547
 946 msgid "UNSTITCHING AND LAUNDERING"
 947 msgstr ""
 948
 949 #. type: textblock
 950 #: ../git-debrebase.1.pod:549
 951 msgid ""
 952 "Several operations unstitch and launder the branch first.  In detail this "
 953 "means:"
 954 msgstr ""
 955
 956 #. type: =head2
 957 #: ../git-debrebase.1.pod:552
 958 msgid "Establish the current branch's ffq-prev"
 959 msgstr ""
 960
 961 #. type: textblock
 962 #: ../git-debrebase.1.pod:554
 963 msgid ""
 964 "If ffq-prev is not yet recorded, git-debrebase checks that the current "
 965 "branch is ahead of relevant remote tracking branches.  The relevant branches "
 966 "depend on the current branch (and its git configuration)  and are as follows:"
 967 msgstr ""
 968
 969 #. type: textblock
 970 #: ../git-debrebase.1.pod:566
 971 msgid ""
 972 "The branch that git would merge from (remote.<branch>.merge, remote.<branch>."
 973 "remote);"
 974 msgstr ""
 975
 976 #. type: textblock
 977 #: ../git-debrebase.1.pod:571
 978 msgid ""
 979 "The branch git would push to, if different (remote.<branch>.pushRemote etc.);"
 980 msgstr ""
 981
 982 #. type: textblock
 983 #: ../git-debrebase.1.pod:576
 984 msgid "For local dgit suite branches, the corresponding tracking remote;"
 985 msgstr ""
 986
 987 #. type: textblock
 988 #: ../git-debrebase.1.pod:581
 989 msgid "If you are on C<master>, remotes/dgit/dgit/sid."
 990 msgstr ""
 991
 992 #. type: textblock
 993 #: ../git-debrebase.1.pod:586
 994 msgid ""
 995 "The apparently relevant ref names to check are filtered through branch."
 996 "<branch>.ffq-ffrefs, which is a semicolon-separated list of glob patterns, "
 997 "each optionally preceded by !; first match wins."
 998 msgstr ""
 999
1000 #. type: textblock
1001 #: ../git-debrebase.1.pod:591
1002 msgid ""
1003 "In each case it is a snag if the local HEAD is behind the checked remote, or "
1004 "if local HEAD has diverged from it.  All the checks are done locally using "
1005 "the remote tracking refs: git-debrebase does not fetch anything from "
1006 "anywhere."
1007 msgstr ""
1008
1009 #. type: textblock
1010 #: ../git-debrebase.1.pod:597
1011 msgid ""
1012 "If these checks pass, or are forced, git-debrebse then records the current "
1013 "tip as ffq-prev."
1014 msgstr ""
1015
1016 #. type: =head2
1017 #: ../git-debrebase.1.pod:601
1018 msgid "Examine the branch"
1019 msgstr ""
1020
1021 #. type: textblock
1022 #: ../git-debrebase.1.pod:603
1023 msgid ""
1024 "git-debrebase analyses the current HEAD's history to find the anchor in its "
1025 "breakwater, and the most recent breakwater tip."
1026 msgstr ""
1027
1028 #. type: =head2
1029 #: ../git-debrebase.1.pod:608
1030 msgid "Rewrite the commits into laundered form"
1031 msgstr ""
1032
1033 #. type: textblock
1034 #: ../git-debrebase.1.pod:610
1035 msgid ""
1036 "Mixed debian+upstream commits are split into two commits each.  Delta queue "
1037 "(upstream files) commits bubble to the top.  Pseudomerges, and quilt patch "
1038 "additions, are dropped."
1039 msgstr ""
1040
1041 #. type: textblock
1042 #: ../git-debrebase.1.pod:616
1043 msgid ""
1044 "This rewrite will always succeed, by construction.  The result is the "
1045 "laundered branch."
1046 msgstr ""
1047
1048 #. type: textblock
1049 #: ../git-debrebase.1.pod:621
1050 msgid "git-debrebase(1), dgit-maint-debrebase(7), dgit(1), gitglossary(7)"
1051 msgstr ""