po4a/git-debrebase_5.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2019-09-06 23:47+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:1568 ../dgit.7:23 ../dgit-user.7.pod:447
  32 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
  33 #: ../dgit-maint-merge.7.pod:521 ../dgit-maint-gbp.7.pod:136
  34 #: ../dgit-maint-debrebase.7.pod:778 ../dgit-downstream-dsc.7.pod:352
  35 #: ../dgit-sponsorship.7.pod:321 ../dgit-maint-bpo.7.pod:134
  36 #: ../git-debrebase.1.pod:633 ../git-debrebase.5.pod:678
  37 #: ../git-debpush.1.pod:254
  38 #, no-wrap
  39 msgid "SEE ALSO"
  40 msgstr ""
  41
  42 #. type: =head1
  43 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
  44 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
  45 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
  46 #: ../dgit-maint-bpo.7.pod:5 ../git-debrebase.5.pod:5
  47 msgid "INTRODUCTION"
  48 msgstr ""
  49
  50 #. type: =head1
  51 #: ../dgit-maint-bpo.7.pod:11 ../git-debrebase.5.pod:37
  52 msgid "TERMINOLOGY"
  53 msgstr ""
  54
  55 #. type: textblock
  56 #: ../git-debrebase.5.pod:3
  57 msgid "git-debrebase - git data model for Debian packaging"
  58 msgstr ""
  59
  60 #. type: textblock
  61 #: ../git-debrebase.5.pod:7
  62 msgid ""
  63 "git-debrebase is a tool for representing in git, and manpulating, Debian "
  64 "packages based on upstream source code."
  65 msgstr ""
  66
  67 #. type: textblock
  68 #: ../git-debrebase.5.pod:11
  69 msgid ""
  70 "The Debian packaging has a fast forwarding history.  The delta queue "
  71 "(changes to upstream files) is represented as a series of individual git "
  72 "commits, which can worked on with rebase, and also shared."
  73 msgstr ""
  74
  75 #. type: =head2
  76 #: ../git-debrebase.5.pod:18
  77 msgid "DISCUSSION"
  78 msgstr ""
  79
  80 #. type: textblock
  81 #: ../git-debrebase.5.pod:20
  82 msgid ""
  83 "git-debrebase is designed to work well with dgit.  git-debrebase can also be "
  84 "used in workflows without source packages, for example to work on Debian-"
  85 "format packages outside or alongside Debian."
  86 msgstr ""
  87
  88 #. type: textblock
  89 #: ../git-debrebase.5.pod:24
  90 msgid ""
  91 "git-debrebase itself is not very suitable for use by Debian derivatives, to "
  92 "work on packages inherited from Debian, because it assumes that you want to "
  93 "throw away any packaging provided by your upstream.  However, use of git-"
  94 "debrebase in Debian does not make anything harder for derivatives, and it "
  95 "can make some things easier."
  96 msgstr ""
  97
  98 #. type: textblock
  99 #: ../git-debrebase.5.pod:32
 100 msgid ""
 101 "When using gitk on branches managed by git-debrebase, B<gitk --date-order>, "
 102 "B<gitk --first-parent> and B<gitk -- :.> (or B<gitk .>)  produce more useful "
 103 "output than the default."
 104 msgstr ""
 105
 106 #. type: =item
 107 #: ../git-debrebase.5.pod:41
 108 msgid "Pseudomerge"
 109 msgstr ""
 110
 111 #. type: textblock
 112 #: ../git-debrebase.5.pod:43
 113 msgid ""
 114 "A merge which does not actually merge the trees; instead, it is constructed "
 115 "by taking the tree from one of the parents (ignoring the contents of the "
 116 "other parents).  These are used to make a rewritten history fast forward "
 117 "from a previous tip, so that it can be pushed and pulled normally.  Manual "
 118 "construction of pseudomerges can be done with C<git merge -s ours> but is "
 119 "not normally needed when using git-debrebase."
 120 msgstr ""
 121
 122 #. type: =item
 123 #: ../git-debrebase.5.pod:54
 124 msgid "Packaging files"
 125 msgstr ""
 126
 127 #. type: textblock
 128 #: ../git-debrebase.5.pod:56
 129 msgid ""
 130 "Files in the source tree within B<debian/>, excluding anything in B<debian/"
 131 "patches/>."
 132 msgstr ""
 133
 134 #. type: =item
 135 #: ../git-debrebase.5.pod:59
 136 msgid "Upstream"
 137 msgstr ""
 138
 139 #. type: textblock
 140 #: ../git-debrebase.5.pod:61
 141 msgid ""
 142 "The version of the package without Debian's packaging.  Typically provided "
 143 "by the actual upstream project, and sometimes tracked by Debian contributors "
 144 "in a branch C<upstream>."
 145 msgstr ""
 146
 147 #. type: textblock
 148 #: ../git-debrebase.5.pod:65
 149 msgid ""
 150 "Upstream contains upstream files, but some upstreams also contain packaging "
 151 "files in B<debian/>.  Any such non-upstream files found in upstream are "
 152 "thrown away by git-debrebase each time a new upstream version is "
 153 "incorporated."
 154 msgstr ""
 155
 156 #. type: =item
 157 #: ../git-debrebase.5.pod:71
 158 msgid "Upstream files"
 159 msgstr ""
 160
 161 #. type: textblock
 162 #: ../git-debrebase.5.pod:73
 163 msgid ""
 164 "Files in the source tree outside B<debian/>.  These may include unmodified "
 165 "source from upstream, but also files which have been modified or created for "
 166 "Debian."
 167 msgstr ""
 168
 169 #. type: =item
 170 #: ../git-debrebase.5.pod:77
 171 msgid "Delta queue"
 172 msgstr ""
 173
 174 #. type: textblock
 175 #: ../git-debrebase.5.pod:79
 176 msgid "Debian's changes to upstream files: a series of git commits."
 177 msgstr ""
 178
 179 #. type: =item
 180 #: ../git-debrebase.5.pod:82
 181 msgid "Quilt patches"
 182 msgstr ""
 183
 184 #. type: textblock
 185 #: ../git-debrebase.5.pod:84
 186 msgid ""
 187 "Files in B<debian/patches/> generated for the benefit of dpkg-source's 3.0 "
 188 "(quilt) .dsc source package format.  Not used, often deleted, and "
 189 "regenerated when needed (such as when uploading to Debian), by git-debrebase."
 190 msgstr ""
 191
 192 #. type: =item
 193 #: ../git-debrebase.5.pod:90
 194 msgid "Interchange branch; breakwater; stitched; laundered"
 195 msgstr ""
 196
 197 #. type: textblock
 198 #: ../git-debrebase.5.pod:92
 199 msgid "See L</BRANCHES AND BRANCH STATES - OVERVIEW>."
 200 msgstr ""
 201
 202 #. type: =item
 203 #: ../git-debrebase.5.pod:94
 204 msgid "Anchor; Packaging"
 205 msgstr ""
 206
 207 #. type: textblock
 208 #: ../git-debrebase.5.pod:96
 209 msgid "See L</BRANCH CONTENTS - DETAILED SPECIFICATION>."
 210 msgstr ""
 211
 212 #. type: =item
 213 #: ../git-debrebase.5.pod:98
 214 msgid "ffq-prev; debrebase-last"
 215 msgstr ""
 216
 217 #. type: textblock
 218 #: ../git-debrebase.5.pod:100
 219 msgid "See L</STITCHING, PSEUDO-MERGES, FFQ RECORD>."
 220 msgstr ""
 221
 222 #. type: =head1
 223 #: ../git-debrebase.5.pod:104
 224 msgid "DIAGRAM"
 225 msgstr ""
 226
 227 #. type: verbatim
 228 #: ../git-debrebase.5.pod:106
 229 #, no-wrap
 230 msgid ""
 231 "           ------/--A!----/--B3!--%--/--> interchange view\n"
 232 "                /        /          /      with debian/ directory\n"
 233 "               %        %          %       entire delta queue applied\n"
 234 "              /        /          /        3.0 (quilt) has debian/patches\n"
 235 "             /        /          3*       \"master\" on Debian git servers\n"
 236 "            /        /          /\n"
 237 "           2*       2*         2\n"
 238 "          /        /          /\n"
 239 "         1        1          1    breakwater branch, merging baseline\n"
 240 "        /        /          /     unmodified upstream code\n"
 241 "    ---@-----@--A----@--B--C      plus debian/ (but no debian/patches)\n"
 242 "      /     /       /                     no ref refers to this: we\n"
 243 "   --#-----#-------#-----> upstream        reconstruct its identity by\n"
 244 "                                           inspecting interchange branch\n"
 245 "    Key:\n"
 246 "\n"
 247 msgstr ""
 248
 249 #. type: verbatim
 250 #: ../git-debrebase.5.pod:122
 251 #, no-wrap
 252 msgid ""
 253 "      1,2,3   commits touching upstream files only\n"
 254 "      A,B,C   commits touching debian/ only\n"
 255 "      B3      mixed commit (eg made by an NMUer)\n"
 256 "      #       upstream releases\n"
 257 "\n"
 258 msgstr ""
 259
 260 #. type: verbatim
 261 #: ../git-debrebase.5.pod:127
 262 #, no-wrap
 263 msgid ""
 264 "     -@-      anchor merge, takes contents of debian/ from the\n"
 265 "     /         previous `breakwater' commit and rest from upstream\n"
 266 "\n"
 267 msgstr ""
 268
 269 #. type: verbatim
 270 #: ../git-debrebase.5.pod:130
 271 #, no-wrap
 272 msgid ""
 273 "     -/-      pseudomerge; contents are identical to\n"
 274 "     /         parent lower on diagram.\n"
 275 "\n"
 276 msgstr ""
 277
 278 #. type: verbatim
 279 #: ../git-debrebase.5.pod:133
 280 #, no-wrap
 281 msgid ""
 282 "      %       dgit- or git-debrebase- generated commit of debian/patches.\n"
 283 "              `3.0 (quilt)' only; generally dropped by git-debrebase.\n"
 284 "\n"
 285 msgstr ""
 286
 287 #. type: verbatim
 288 #: ../git-debrebase.5.pod:136
 289 #, no-wrap
 290 msgid ""
 291 "      *       Maintainer's HEAD was here while they were editing,\n"
 292 "              before they said they were done, at which point their\n"
 293 "              tools made -/- (and maybe %) to convert to\n"
 294 "              the fast-forwarding interchange branch.\n"
 295 "\n"
 296 msgstr ""
 297
 298 #. type: verbatim
 299 #: ../git-debrebase.5.pod:141
 300 #, no-wrap
 301 msgid ""
 302 "      !       NMUer's HEAD was here when they said `dgit push'.\n"
 303 "              Rebase branch launderer turns each ! into an\n"
 304 "              equivalent *.\n"
 305 "\n"
 306 msgstr ""
 307
 308 #. type: =head1
 309 #: ../git-debrebase.5.pod:145
 310 msgid "BRANCHES AND BRANCH STATES - OVERVIEW"
 311 msgstr ""
 312
 313 #. type: textblock
 314 #: ../git-debrebase.5.pod:147
 315 msgid ""
 316 "git-debrebase has one primary branch, the B<interchange branch>.  This "
 317 "branch is found on Debian contributors' workstations (typically, a "
 318 "maintainer would call it B<master>), in the Debian dgit git server as the "
 319 "suite branch (B<dgit/dgit/sid>)  and on other git servers which support "
 320 "Debian work (eg B<master> on salsa)."
 321 msgstr ""
 322
 323 #. type: textblock
 324 #: ../git-debrebase.5.pod:155
 325 msgid ""
 326 "The interchange branch is fast-forwarding (by virtue of pseudomerges, where "
 327 "necessary)."
 328 msgstr ""
 329
 330 #. type: textblock
 331 #: ../git-debrebase.5.pod:158
 332 msgid ""
 333 "It is possible to have multiple different interchange branches for the same "
 334 "package, stored as different local and remote git branches.  However, "
 335 "divergence should be avoided where possible - see L</OTHER MERGES>."
 336 msgstr ""
 337
 338 #. type: textblock
 339 #: ../git-debrebase.5.pod:164
 340 msgid ""
 341 "A suitable interchange branch can be used directly with dgit.  In this case "
 342 "each dgit archive suite branch is a separate interchange branch."
 343 msgstr ""
 344
 345 #. type: textblock
 346 #: ../git-debrebase.5.pod:168
 347 msgid ""
 348 "Within the ancestry of the interchange branch, there is another important, "
 349 "implicit branch, the B<breakwater>.  The breakwater contains unmodified "
 350 "upstream source, but with Debian's packaging superimposed (replacing any "
 351 "C<debian/> directory that may be in the upstream commits).  The breakwater "
 352 "does not contain any representation of the delta queue (not even debian/"
 353 "patches).  The part of the breakwater processed by git-debrebase is the part "
 354 "since the most recent B<anchor>, which is usually a special merge generated "
 355 "by git-debrebase."
 356 msgstr ""
 357
 358 #. type: textblock
 359 #: ../git-debrebase.5.pod:181
 360 msgid ""
 361 "When working, locally, the user's branch can be in a rebasing state, known "
 362 "as B<unstitched>.  While a branch is unstitched, it is not in interchange "
 363 "format.  The previous interchange branch tip is recorded, so that the "
 364 "previous history and the user's work can later be stitched into the fast-"
 365 "forwarding interchange form."
 366 msgstr ""
 367
 368 #. type: textblock
 369 #: ../git-debrebase.5.pod:193
 370 msgid ""
 371 "An unstitched branch may be in B<laundered> state, which means it has a more "
 372 "particular special form convenient for manipulating the delta queue."
 373 msgstr ""
 374
 375 #. type: =head1
 376 #: ../git-debrebase.5.pod:199
 377 msgid "BRANCH CONTENTS - DETAILED SPECIFICATION"
 378 msgstr ""
 379
 380 #. type: textblock
 381 #: ../git-debrebase.5.pod:201
 382 msgid ""
 383 "It is most convenient to describe the B<breakwater> branch first.  A "
 384 "breakwater is B<fast-forwarding>, but is not usually named by a ref.  It "
 385 "contains B<in this order> (ancestors first):"
 386 msgstr ""
 387
 388 #. type: =item
 389 #: ../git-debrebase.5.pod:210
 390 msgid "Anchor"
 391 msgstr ""
 392
 393 #. type: textblock
 394 #: ../git-debrebase.5.pod:212
 395 msgid "An B<anchor> commit, which is usually a special two-parent merge:"
 396 msgstr ""
 397
 398 #. type: textblock
 399 #: ../git-debrebase.5.pod:215
 400 msgid ""
 401 "The first parent contains the most recent version, at that point, of the "
 402 "Debian packaging (in debian/); it also often contains upstream files, but "
 403 "they are to be ignored.  Often the first parent is a previous breakwater tip."
 404 msgstr ""
 405
 406 #. type: textblock
 407 #: ../git-debrebase.5.pod:222
 408 msgid ""
 409 "The second parent is an upstream source commit.  It may sometimes contain a "
 410 "debian/ subdirectory, but if so that is to be ignored.  The second parent's "
 411 "upstream files are identical to the anchor's.  Anchor merges always contain "
 412 "C<[git-debrebase anchor: ...]> as a line in the commit message."
 413 msgstr ""
 414
 415 #. type: textblock
 416 #: ../git-debrebase.5.pod:232
 417 msgid ""
 418 "Alternatively, an anchor may be a single-parent commit which introduces the "
 419 "C<debian/> directory and makes no other changes: ie, the start of Debian "
 420 "packaging."
 421 msgstr ""
 422
 423 #. type: =item
 424 #: ../git-debrebase.5.pod:237
 425 msgid "Packaging"
 426 msgstr ""
 427
 428 #. type: textblock
 429 #: ../git-debrebase.5.pod:239
 430 msgid ""
 431 "Zero or more single-parent commits containing only packaging changes.  (And "
 432 "no quilt patch changes.)"
 433 msgstr ""
 434
 435 #. type: textblock
 436 #: ../git-debrebase.5.pod:245
 437 msgid ""
 438 "The B<laundered> branch state is B<rebasing>.  A laundered branch is based "
 439 "on a breakwater but also contains, additionally, B<after> the breakwater, a "
 440 "representation of the delta queue:"
 441 msgstr ""
 442
 443 #. type: =item
 444 #: ../git-debrebase.5.pod:255
 445 msgid "Delta queue commits"
 446 msgstr ""
 447
 448 #. type: textblock
 449 #: ../git-debrebase.5.pod:257
 450 msgid ""
 451 "Zero or more single-parent commits containing only changes to upstream files."
 452 msgstr ""
 453
 454 #. type: textblock
 455 #: ../git-debrebase.5.pod:262
 456 msgid ""
 457 "The merely B<unstitched> (ie, unstitched but unlaundered)  branch state is "
 458 "also B<rebasing>.  It has the same contents as the laundered state, except "
 459 "that it may contain, additionally, B<in any order but after the breakwater>:"
 460 msgstr ""
 461
 462 #. type: =item
 463 #: ../git-debrebase.5.pod:273
 464 msgid "Linear commits to the source"
 465 msgstr ""
 466
 467 #. type: textblock
 468 #: ../git-debrebase.5.pod:275
 469 msgid ""
 470 "Further commit(s) containing changes to to upstream files and/or to "
 471 "packaging, possibly mixed within a single commit.  (But not quilt patch "
 472 "changes.)"
 473 msgstr ""
 474
 475 #. type: =item
 476 #: ../git-debrebase.5.pod:282
 477 msgid "Quilt patch addition for `3.0 (quilt)'"
 478 msgstr ""
 479
 480 #. type: textblock
 481 #: ../git-debrebase.5.pod:284
 482 msgid ""
 483 "Commit(s) which add patches to B<debian/patches/>, and add those patches to "
 484 "the end of B<series>."
 485 msgstr ""
 486
 487 #. type: textblock
 488 #: ../git-debrebase.5.pod:287
 489 msgid ""
 490 "These are only necessary when working with packages in C<.dsc 3.0 (quilt)> "
 491 "format.  For git-debrebase they are purely an output; they are deleted when "
 492 "branches are laundered.  git-debrebase takes care to make a proper patch "
 493 "series out of the delta queue, so that any resulting source packages are "
 494 "nice."
 495 msgstr ""
 496
 497 #. type: textblock
 498 #: ../git-debrebase.5.pod:297
 499 msgid ""
 500 "Finally, an B<interchange> branch is B<fast forwarding>.  It has the same "
 501 "contents as an unlaundered branch state, but may (and usually will) "
 502 "additionally contain (in some order, possibly intermixed with the extra "
 503 "commits which may be found on an unstitched unlaundered branch):"
 504 msgstr ""
 505
 506 #. type: =item
 507 #: ../git-debrebase.5.pod:309
 508 msgid "Pseudomerge to make fast forward"
 509 msgstr ""
 510
 511 #. type: textblock
 512 #: ../git-debrebase.5.pod:311
 513 msgid ""
 514 "A pseudomerge making the branch fast forward from previous history.  The "
 515 "contributing parent is itself in interchange format.  Normally the "
 516 "overwritten parent is a previous tip of an interchange branch, but this is "
 517 "not necessary as the overwritten parent is not examined."
 518 msgstr ""
 519
 520 #. type: textblock
 521 #: ../git-debrebase.5.pod:319
 522 msgid ""
 523 "If the two parents have identical trees, the one with the later commit date "
 524 "(or, if the commit dates are the same, the first parent)  is treated as the "
 525 "contributing parent."
 526 msgstr ""
 527
 528 #. type: =item
 529 #: ../git-debrebase.5.pod:326
 530 msgid "dgit dsc import pseudomerge"
 531 msgstr ""
 532
 533 #. type: textblock
 534 #: ../git-debrebase.5.pod:328
 535 msgid ""
 536 "Debian .dsc source package import(s)  made by dgit (during dgit fetch of a "
 537 "package most recently uploaded to Debian without dgit, or during dgit import-"
 538 "dsc)."
 539 msgstr ""
 540
 541 #. type: textblock
 542 #: ../git-debrebase.5.pod:334
 543 msgid ""
 544 "git-debrebase requires that each such import is in the fast-forwarding "
 545 "format produced by dgit: a two-parent pseudomerge, whose contributing parent "
 546 "is in the non-fast-forwarding dgit dsc import format (not described further "
 547 "here), and whose overwritten parent is the previous interchange tip (eg, the "
 548 "previous tip of the dgit suite branch)."
 549 msgstr ""
 550
 551 #. type: =head1
 552 #: ../git-debrebase.5.pod:347
 553 msgid "STITCHING, PSEUDO-MERGES, FFQ RECORD"
 554 msgstr ""
 555
 556 #. type: textblock
 557 #: ../git-debrebase.5.pod:349
 558 msgid ""
 559 "Whenever the branch C<refs/B> is unstitched, the previous head is recorded "
 560 "in the git ref C<refs/ffq-prev/B>."
 561 msgstr ""
 562
 563 #. type: textblock
 564 #: ../git-debrebase.5.pod:352
 565 msgid ""
 566 "Unstiched branches are not fast forward from the published interchange "
 567 "branches [1].  So before a branch can be pushed, the right pseudomerge must "
 568 "be reestablished.  This is the stitch operation, which consumes the ffq-prev "
 569 "ref."
 570 msgstr ""
 571
 572 #. type: textblock
 573 #: ../git-debrebase.5.pod:359
 574 msgid ""
 575 "When the user has an unstitched branch, they may rewrite it freely, from the "
 576 "breakwater tip onwards.  Such a git rebase is the default operation for git-"
 577 "debrebase.  Rebases should not go back before the breakwater tip, and "
 578 "certainly not before the most recent anchor."
 579 msgstr ""
 580
 581 #. type: textblock
 582 #: ../git-debrebase.5.pod:366
 583 msgid ""
 584 "Unstitched branches must not be pushed to interchange branch refs (by the "
 585 "use of C<git push -f> or equivalent).  It is OK to share an unstitched "
 586 "branch in similar circumstances and with similar warnings to sharing any "
 587 "other rebasing git branch."
 588 msgstr ""
 589
 590 #. type: textblock
 591 #: ../git-debrebase.5.pod:372
 592 msgid ""
 593 "[1] Strictly, for a package which has never had a Debian delta queue, the "
 594 "interchange and breakwater branches may be identical, in which case the "
 595 "unstitched branch is fast forward from the interchange branch and no "
 596 "pseudomerge is needed."
 597 msgstr ""
 598
 599 #. type: textblock
 600 #: ../git-debrebase.5.pod:378
 601 msgid ""
 602 "When ffq-prev is not present, C<refs/debrebase-last/B> records some ancestor "
 603 "of refs/B, (usually, the result of last stitch).  This is used for status "
 604 "printing and some error error checks - especially for printing guesses about "
 605 "what a problem is.  To determine whether a branch is being maintained in git-"
 606 "debrebase form it is necessary to walk its history."
 607 msgstr ""
 608
 609 #. type: =head1
 610 #: ../git-debrebase.5.pod:387
 611 msgid "OTHER MERGES"
 612 msgstr ""
 613
 614 #. type: textblock
 615 #: ../git-debrebase.5.pod:389
 616 msgid ""
 617 "Note that the representation described here does not permit general merges "
 618 "on any of the relevant branches.  For this reason the tools will try to help "
 619 "the user avoid divergence of the interchange branch."
 620 msgstr ""
 621
 622 #. type: textblock
 623 #: ../git-debrebase.5.pod:394
 624 msgid ""
 625 "See dgit-maint-debrebase(7)  for a discussion of what kinds of behaviours "
 626 "should be be avoided because they might generate such merges."
 627 msgstr ""
 628
 629 #. type: textblock
 630 #: ../git-debrebase.5.pod:400
 631 msgid ""
 632 "Automatic resolution of divergent interchange branches (or laundering of "
 633 "merges on the interchange branch)  is thought to be possible, but there is "
 634 "no tooling for this yet:"
 635 msgstr ""
 636
 637 #. type: textblock
 638 #: ../git-debrebase.5.pod:405
 639 msgid ""
 640 "Nonlinear (merging) history in the interchange branch is awkward because it "
 641 "(obviously) does not preserve the linearity of the delta queue.  Easy "
 642 "merging of divergent delta queues is a research problem."
 643 msgstr ""
 644
 645 #. type: textblock
 646 #: ../git-debrebase.5.pod:410
 647 msgid ""
 648 "Nonlinear (merging) history in the breakwater branch is in principle "
 649 "tolerable, but each of the parents would have to be, in turn, a breakwater, "
 650 "and difficult questions arise if they don't have the same anchor."
 651 msgstr ""
 652
 653 #. type: textblock
 654 #: ../git-debrebase.5.pod:416
 655 msgid ""
 656 "We use the commit message annotation to distinguish the special anchor "
 657 "merges from other general merges, so we can at least detect unsupported "
 658 "merges."
 659 msgstr ""
 660
 661 #. type: =head1
 662 #: ../git-debrebase.5.pod:420
 663 msgid "LEGAL OPERATIONS"
 664 msgstr ""
 665
 666 #. type: textblock
 667 #: ../git-debrebase.5.pod:422
 668 msgid ""
 669 "The following basic operations follow from this model (refer to the diagram "
 670 "above):"
 671 msgstr ""
 672
 673 #. type: =item
 674 #: ../git-debrebase.5.pod:427
 675 msgid "Append linear commits"
 676 msgstr ""
 677
 678 #. type: textblock
 679 #: ../git-debrebase.5.pod:429
 680 msgid ""
 681 "No matter the branch state, it is always fine to simply git commit (or "
 682 "cherry-pick etc.)  commits containing upstream file changes, packaging "
 683 "changes, or both."
 684 msgstr ""
 685
 686 #. type: textblock
 687 #: ../git-debrebase.5.pod:435
 688 msgid "(This may make the branch unlaundered.)"
 689 msgstr ""
 690
 691 #. type: =item
 692 #: ../git-debrebase.5.pod:437
 693 msgid "Launder branch"
 694 msgstr ""
 695
 696 #. type: textblock
 697 #: ../git-debrebase.5.pod:439
 698 msgid ""
 699 "Record the previous head in ffq-prev, if we were stitched before (and delete "
 700 "debrebase-last)."
 701 msgstr ""
 702
 703 #. type: textblock
 704 #: ../git-debrebase.5.pod:443
 705 msgid ""
 706 "Reorganise the current branch so that the packaging changes come first, "
 707 "followed by the delta queue, turning C<-@-A-1-2-B3> into C<...@-A-B-1-2-3>."
 708 msgstr ""
 709
 710 #. type: textblock
 711 #: ../git-debrebase.5.pod:448
 712 msgid "Drop pseudomerges and any quilt patch additions."
 713 msgstr ""
 714
 715 #. type: =item
 716 #: ../git-debrebase.5.pod:450
 717 msgid "Interactive rebase"
 718 msgstr ""
 719
 720 #. type: textblock
 721 #: ../git-debrebase.5.pod:452
 722 msgid ""
 723 "With a laundered branch, one can do an interactive git rebase of the delta "
 724 "queue."
 725 msgstr ""
 726
 727 #. type: =item
 728 #: ../git-debrebase.5.pod:455
 729 msgid "New upstream rebase"
 730 msgstr ""
 731
 732 #. type: textblock
 733 #: ../git-debrebase.5.pod:457
 734 msgid ""
 735 "Start rebasing onto a new upstream version, turning C<...#..@-A-B-1-2-3> "
 736 "into C<(...#..@-A-B-, ...#'-)@'-1-2>."
 737 msgstr ""
 738
 739 #. type: textblock
 740 #: ../git-debrebase.5.pod:460
 741 msgid ""
 742 "This has to be a wrapper around git-rebase, which prepares @' and then tries "
 743 "to rebase 1 2 onto @'.  If the user asks for an interactive rebase, @' "
 744 "doesn't appear in the commit list, since @' is the newbase of the rebase "
 745 "(see git-rebase(1))."
 746 msgstr ""
 747
 748 #. type: textblock
 749 #: ../git-debrebase.5.pod:466
 750 msgid ""
 751 "Note that the construction of @' cannot fail because @' simply copies "
 752 "debian/ from B and and everything else from #'.  (Rebasing A and B is "
 753 "undesirable.  We want the debian/ files to be non-rebasing so that git log "
 754 "shows the packaging history.)"
 755 msgstr ""
 756
 757 #. type: =item
 758 #: ../git-debrebase.5.pod:472
 759 msgid "Stitch"
 760 msgstr ""
 761
 762 #. type: textblock
 763 #: ../git-debrebase.5.pod:474
 764 msgid ""
 765 "Make a pseudomerge, whose contributing parent is the unstitched branch and "
 766 "whose overwritten parent is ffq-prev, consuming ffq-prev in the process (and "
 767 "writing debrebase-last instead).  Ideally the contributing parent would be a "
 768 "laundered branch, or perhaps a laundered branch with a quilt patch addition "
 769 "commit."
 770 msgstr ""
 771
 772 #. type: =item
 773 #: ../git-debrebase.5.pod:483
 774 msgid "Commit quilt patches"
 775 msgstr ""
 776
 777 #. type: textblock
 778 #: ../git-debrebase.5.pod:485
 779 msgid ""
 780 "To generate a tree which can be represented as a 3.0 (quilt) .dsc source "
 781 "package, the delta queue must be reified inside the git tree in B<debian/"
 782 "patches/>.  These patch files can be stripped out and/or regenerated as "
 783 "needed."
 784 msgstr ""
 785
 786 #. type: =head1
 787 #: ../git-debrebase.5.pod:493
 788 msgid "ILLEGAL OPERATIONS"
 789 msgstr ""
 790
 791 #. type: textblock
 792 #: ../git-debrebase.5.pod:495
 793 msgid ""
 794 "Some git operations are not permitted in this data model.  Performing them "
 795 "will break git-debrebase."
 796 msgstr ""
 797
 798 #. type: =item
 799 #: ../git-debrebase.5.pod:500
 800 msgid "General merges"
 801 msgstr ""
 802
 803 #. type: textblock
 804 #: ../git-debrebase.5.pod:502
 805 msgid "See L</OTHER MERGES>, above."
 806 msgstr ""
 807
 808 #. type: =item
 809 #: ../git-debrebase.5.pod:504
 810 msgid "git-rebase starting too soon, or without base argument"
 811 msgstr ""
 812
 813 #. type: textblock
 814 #: ../git-debrebase.5.pod:506
 815 msgid ""
 816 "git-rebase must not be invoked in such a way that the chosen base is before "
 817 "the anchor, or before the last pseudomerge.  This is because git-rebase "
 818 "mangles merges.  git rebase --preserve-merges is also dangerous."
 819 msgstr ""
 820
 821 #. type: textblock
 822 #: ../git-debrebase.5.pod:512
 823 msgid "git-rebase without a base argument will often start too early."
 824 msgstr ""
 825
 826 #. type: textblock
 827 #: ../git-debrebase.5.pod:514
 828 msgid ""
 829 "For these reasons, it is better to use git-debrebase and let it choose the "
 830 "base for your rebase.  If you do realise you have made this mistake, it is "
 831 "best to use the reflog to recover to a suitable good previous state."
 832 msgstr ""
 833
 834 #. type: =item
 835 #: ../git-debrebase.5.pod:522
 836 msgid "Editing debian/patches"
 837 msgstr ""
 838
 839 #. type: textblock
 840 #: ../git-debrebase.5.pod:524
 841 msgid ""
 842 "debian/patches is an output from git-debrebase, not an input.  If you edit "
 843 "patches git-debrebase will complain and refuse to work.  If you add patches "
 844 "your work is likely to be discarded."
 845 msgstr ""
 846
 847 #. type: textblock
 848 #: ../git-debrebase.5.pod:530
 849 msgid ""
 850 "Instead of editing patches, use git-debrebase to edit the corresponding "
 851 "commits."
 852 msgstr ""
 853
 854 #. type: =item
 855 #: ../git-debrebase.5.pod:533
 856 msgid "Renaming (etc.) branch while unstitched"
 857 msgstr ""
 858
 859 #. type: textblock
 860 #: ../git-debrebase.5.pod:535
 861 msgid ""
 862 "The previous HEAD, which will be pseudomerged over by operations like git-"
 863 "debrebase stitch, is recorded in a ref name dervied from your branch name."
 864 msgstr ""
 865
 866 #. type: textblock
 867 #: ../git-debrebase.5.pod:540
 868 msgid ""
 869 "If you rename unstitched branches, this information can get out of step."
 870 msgstr ""
 871
 872 #. type: textblock
 873 #: ../git-debrebase.5.pod:543
 874 msgid ""
 875 "Conversely, creating a new branch from an unstitched branch is good for "
 876 "making a branch to play about in, but the result cannot be stitched."
 877 msgstr ""
 878
 879 #. type: =head1
 880 #: ../git-debrebase.5.pod:550
 881 msgid "COMMIT MESSAGE ANNOTATIONS"
 882 msgstr ""
 883
 884 #. type: textblock
 885 #: ../git-debrebase.5.pod:552
 886 msgid ""
 887 "git-debrebase makes annotations in the messages of commits it generates."
 888 msgstr ""
 889
 890 #. type: textblock
 891 #: ../git-debrebase.5.pod:555
 892 msgid "The general form is"
 893 msgstr ""
 894
 895 #. type: verbatim
 896 #: ../git-debrebase.5.pod:557
 897 #, no-wrap
 898 msgid ""
 899 "  [git-debrebase COMMIT-TYPE [ ARGS...]: PROSE, MORE PROSE]\n"
 900 "\n"
 901 msgstr ""
 902
 903 #. type: textblock
 904 #: ../git-debrebase.5.pod:559
 905 msgid ""
 906 "git-debrebase treats anything after the colon as a comment, paying no "
 907 "attention to PROSE."
 908 msgstr ""
 909
 910 #. type: verbatim
 911 #: ../git-debrebase.5.pod:562
 912 #, no-wrap
 913 msgid ""
 914 "The full set of annotations is:\n"
 915 "  [git-debrebase split: mixed commit, debian part]\n"
 916 "  [git-debrebase split: mixed commit, upstream-part]\n"
 917 "  [git-debrebase convert dgit import: debian changes]\n"
 918 "  [git-debrebase anchor: convert dgit import, upstream changes]\n"
 919 "\n"
 920 msgstr ""
 921
 922 #. type: verbatim
 923 #: ../git-debrebase.5.pod:568
 924 #, no-wrap
 925 msgid ""
 926 "  [git-debrebase upstream-combine . PIECE[ PIECE...]: new upstream]\n"
 927 "  [git-debrebase anchor: new upstream NEW-UPSTREAM-VERSION, merge]\n"
 928 "  [git-debrebase changelog: new upstream NEW-UPSTREAM-VERSION]\n"
 929 "  [git-debrebase make-patches: export and commit patches]\n"
 930 "\n"
 931 msgstr ""
 932
 933 #. type: verbatim
 934 #: ../git-debrebase.5.pod:573
 935 #, no-wrap
 936 msgid ""
 937 "  [git-debrebase convert-from-gbp: drop patches]\n"
 938 "  [git-debrebase anchor: declare upstream]\n"
 939 "  [git-debrebase pseudomerge: stitch]\n"
 940 "\n"
 941 msgstr ""
 942
 943 #. type: verbatim
 944 #: ../git-debrebase.5.pod:577
 945 #, no-wrap
 946 msgid ""
 947 "  [git-debrebase merged-breakwater: constructed from vanilla merge]\n"
 948 "\n"
 949 msgstr ""
 950
 951 #. type: verbatim
 952 #: ../git-debrebase.5.pod:579
 953 #, no-wrap
 954 msgid ""
 955 "  [git-debrebase convert-to-gbp: commit patches]\n"
 956 "  [git-debrebase convert-from-dgit-view upstream-import-convert: VERSION]\n"
 957 "  [git-debrebase convert-from-dgit-view drop-patches]\n"
 958 "\n"
 959 msgstr ""
 960
 961 #. type: textblock
 962 #: ../git-debrebase.5.pod:583
 963 msgid ""
 964 "Only anchor merges have the C<[git-debrebase anchor: ...]> tag.  Single-"
 965 "parent anchors are not generated by git-debrebase, and when made manually "
 966 "should not contain any C<[git-debrebase ...]> annotation."
 967 msgstr ""
 968
 969 #. type: textblock
 970 #: ../git-debrebase.5.pod:588
 971 msgid ""
 972 "The C<split mixed commit> and C<convert dgit import> tags are added to the "
 973 "pre-existing commit message, when git-debrebase rewrites the commit."
 974 msgstr ""
 975
 976 #. type: =head1
 977 #: ../git-debrebase.5.pod:592
 978 msgid "APPENDIX - DGIT IMPORT HANDLING"
 979 msgstr ""
 980
 981 #. type: textblock
 982 #: ../git-debrebase.5.pod:594
 983 msgid ""
 984 "The dgit .dsc import format is not documented or specified (so some of the "
 985 "following terms are not defined anywhere).  The dgit import format it is "
 986 "defined by the implementation in dgit, of which git-debrebase has special "
 987 "knowledge."
 988 msgstr ""
 989
 990 #. type: textblock
 991 #: ../git-debrebase.5.pod:599
 992 msgid "Consider a non-dgit NMU followed by a dgit NMU:"
 993 msgstr ""
 994
 995 #. type: verbatim
 996 #: ../git-debrebase.5.pod:601
 997 #, no-wrap
 998 msgid ""
 999 "            interchange --/--B3!--%--//----D*-->\n"
1000 "                         /          /\n"
1001 "                        %          4\n"
1002 "                       /          3\n"
1003 "                      /          2\n"
1004 "                     /          1\n"
1005 "                    2          &_\n"
1006 "                   /          /| \\\n"
1007 "                  1          0 00 =XBC%\n"
1008 "                 /\n"
1009 "                /\n"
1010 "          --@--A     breakwater\n"
1011 "           /\n"
1012 "        --#--------> upstream\n"
1013 "\n"
1014 msgstr ""
1015
1016 #. type: verbatim
1017 #: ../git-debrebase.5.pod:617
1018 #, no-wrap
1019 msgid ""
1020 " Supplementary key:\n"
1021 "\n"
1022 msgstr ""
1023
1024 #. type: verbatim
1025 #: ../git-debrebase.5.pod:619
1026 #, no-wrap
1027 msgid ""
1028 "    =XBC%     dgit tarball import of .debian.tar.gz containing\n"
1029 "               Debian packaging including changes B C and quilt patches\n"
1030 "    0         dgit tarball import of upstream tarball\n"
1031 "    00        dgit tarball import of supplementary upstream piece\n"
1032 "    &_        dgit import nearly-breakwater-anchor\n"
1033 "    //        dgit fetch / import-dsc pseudomerge to make fast forward\n"
1034 "\n"
1035 msgstr ""
1036
1037 #. type: verbatim
1038 #: ../git-debrebase.5.pod:626
1039 #, no-wrap
1040 msgid ""
1041 "    &'        git-debrebase converted import (upstream files only)\n"
1042 "    C'        git-debrebase converted packaging change import\n"
1043 "\n"
1044 msgstr ""
1045
1046 #. type: verbatim
1047 #: ../git-debrebase.5.pod:629
1048 #, no-wrap
1049 msgid ""
1050 "    * **      before and after HEAD\n"
1051 "\n"
1052 msgstr ""
1053
1054 #. type: textblock
1055 #: ../git-debrebase.5.pod:631
1056 msgid "We want to transform this into:"
1057 msgstr ""
1058
1059 #. type: =item
1060 #: ../git-debrebase.5.pod:635
1061 msgid "I. No new upstream version"
1062 msgstr ""
1063
1064 #. type: verbatim
1065 #: ../git-debrebase.5.pod:637
1066 #, no-wrap
1067 msgid ""
1068 " (0 + 00 eq #)\n"
1069 "                        --/--B3!--%--//-----D*-------------/-->\n"
1070 "                         /          /                     /\n"
1071 "                        %          4                     4**\n"
1072 "                       /          3                     3\n"
1073 "                      /          2                     2\n"
1074 "                     /          1                     1\n"
1075 "                    2          &_                    /\n"
1076 "                   /          /| \\                  /\n"
1077 "                  1          0 00 =XBC%            /\n"
1078 "                 /                                /\n"
1079 "                /                                /\n"
1080 "          --@--A-----B---------------------C'---D\n"
1081 "           /\n"
1082 "        --#----------------------------------------->\n"
1083 "\n"
1084 msgstr ""
1085
1086 #. type: =item
1087 #: ../git-debrebase.5.pod:653
1088 msgid "II. New upstream"
1089 msgstr ""
1090
1091 #. type: verbatim
1092 #: ../git-debrebase.5.pod:655
1093 #, no-wrap
1094 msgid ""
1095 " (0 + 00 neq #)\n"
1096 "\n"
1097 msgstr ""
1098
1099 #. type: verbatim
1100 #: ../git-debrebase.5.pod:657
1101 #, no-wrap
1102 msgid ""
1103 "                        --/--B3!--%--//-----D*-------------/-->\n"
1104 "                         /          /                     /\n"
1105 "                        %          4                     4**\n"
1106 "                       /          3                     3\n"
1107 "                      /          2                     2\n"
1108 "                     /          1                     1\n"
1109 "                    2          &_                    /\n"
1110 "                   /          /| \\                  /\n"
1111 "                  1          0 00 =XBC%            /\n"
1112 "                 /                                /\n"
1113 "                /                                /\n"
1114 "          --@--A-----B-----------------@---C'---D\n"
1115 "           /                          /\n"
1116 "        --#--------------------- - - / - - --------->\n"
1117 "                                    /\n"
1118 "                                   &'\n"
1119 "                                  /|\n"
1120 "                                 0 00\n"
1121 "\n"
1122 msgstr ""
1123
1124 #. type: textblock
1125 #: ../git-debrebase.5.pod:680
1126 msgid "git-debrebase(1), dgit-maint-rebase(7), dgit(1)"
1127 msgstr ""