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