po4a/dgit-maint-debrebase_7.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-03-01 16:59+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 #: ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
  25 #, no-wrap
  26 msgid "NAME"
  27 msgstr ""
  28
  29 #. type: =head1
  30 #: ../dgit.1:1470 ../dgit.7:23 ../dgit-user.7.pod:447
  31 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
  32 #: ../dgit-maint-merge.7.pod:491 ../dgit-maint-gbp.7.pod:136
  33 #: ../dgit-maint-debrebase.7.pod:747 ../dgit-downstream-dsc.7.pod:352
  34 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:619
  35 #: ../git-debrebase.5.pod:678
  36 #, no-wrap
  37 msgid "SEE ALSO"
  38 msgstr ""
  39
  40 #. type: =head1
  41 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
  42 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
  43 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
  44 #: ../git-debrebase.1.pod:10 ../git-debrebase.5.pod:5
  45 msgid "INTRODUCTION"
  46 msgstr ""
  47
  48 #. type: textblock
  49 #: ../dgit-maint-native.7.pod:37 ../dgit-maint-gbp.7.pod:16
  50 #: ../dgit-maint-debrebase.7.pod:38
  51 msgid ""
  52 "Benefit from dgit's safety catches.  In particular, ensure that your upload "
  53 "always matches exactly your git HEAD."
  54 msgstr ""
  55
  56 #. type: =head1
  57 #: ../dgit-maint-merge.7.pod:47 ../dgit-maint-debrebase.7.pod:61
  58 msgid "INITIAL DEBIANISATION"
  59 msgstr ""
  60
  61 #. type: textblock
  62 #: ../dgit-maint-merge.7.pod:49 ../dgit-maint-debrebase.7.pod:63
  63 msgid ""
  64 "This section explains how to start using this workflow with a new package.  "
  65 "It should be skipped when converting an existing package to this workflow."
  66 msgstr ""
  67
  68 #. type: =head3
  69 #: ../dgit-maint-merge.7.pod:53 ../dgit-maint-merge.7.pod:335
  70 #: ../dgit-maint-merge.7.pod:408 ../dgit-maint-debrebase.7.pod:67
  71 #: ../dgit-maint-debrebase.7.pod:326
  72 msgid "When upstream tags releases in git"
  73 msgstr ""
  74
  75 #. type: textblock
  76 #: ../dgit-maint-merge.7.pod:55 ../dgit-maint-debrebase.7.pod:69
  77 msgid ""
  78 "Suppose that the latest stable upstream release is 1.2.2, and this has been "
  79 "tagged '1.2.2' by upstream."
  80 msgstr ""
  81
  82 #. type: verbatim
  83 #: ../dgit-maint-merge.7.pod:60 ../dgit-maint-debrebase.7.pod:74
  84 #, no-wrap
  85 msgid ""
  86 "    % git clone -oupstream https://some.upstream/foo.git\n"
  87 "    % cd foo\n"
  88 "    % git verify-tag 1.2.2\n"
  89 "    % git reset --hard 1.2.2\n"
  90 "    % git branch --unset-upstream\n"
  91 "\n"
  92 msgstr ""
  93
  94 #. type: verbatim
  95 #: ../dgit-maint-merge.7.pod:76 ../dgit-maint-debrebase.7.pod:90
  96 #, no-wrap
  97 msgid ""
  98 "    % git remote add -f origin salsa.debian.org:Debian/foo.git\n"
  99 "    % git push --follow-tags -u origin master\n"
 100 "\n"
 101 msgstr ""
 102
 103 #. type: textblock
 104 #: ../dgit-maint-merge.7.pod:93 ../dgit-maint-debrebase.7.pod:102
 105 msgid "Finally, you need an orig tarball:"
 106 msgstr ""
 107
 108 #. type: verbatim
 109 #: ../dgit-maint-merge.7.pod:97 ../dgit-maint-merge.7.pod:402
 110 #: ../dgit-maint-debrebase.7.pod:106 ../dgit-maint-debrebase.7.pod:388
 111 #, no-wrap
 112 msgid ""
 113 "    % git deborig\n"
 114 "\n"
 115 msgstr ""
 116
 117 #. type: textblock
 118 #: ../dgit-maint-merge.7.pod:101 ../dgit-maint-debrebase.7.pod:110
 119 msgid "See git-deborig(1) if this fails."
 120 msgstr ""
 121
 122 #. type: textblock
 123 #: ../dgit-maint-merge.7.pod:103 ../dgit-maint-debrebase.7.pod:112
 124 msgid ""
 125 "This tarball is ephemeral and easily regenerated, so we don't commit it "
 126 "anywhere (e.g. with tools like pristine-tar(1))."
 127 msgstr ""
 128
 129 #. type: =head3
 130 #: ../dgit-maint-merge.7.pod:123 ../dgit-maint-merge.7.pod:343
 131 #: ../dgit-maint-merge.7.pod:433 ../dgit-maint-debrebase.7.pod:137
 132 #: ../dgit-maint-debrebase.7.pod:334
 133 msgid "When upstream releases only tarballs"
 134 msgstr ""
 135
 136 #. type: verbatim
 137 #: ../dgit-maint-merge.7.pod:130 ../dgit-maint-debrebase.7.pod:145
 138 #, no-wrap
 139 msgid ""
 140 "    % mkdir foo\n"
 141 "    % cd foo\n"
 142 "    % git init\n"
 143 "\n"
 144 msgstr ""
 145
 146 #. type: textblock
 147 #: ../dgit-maint-merge.7.pod:136 ../dgit-maint-debrebase.7.pod:151
 148 msgid "Now create I<debian/gbp.conf>:"
 149 msgstr ""
 150
 151 #. type: verbatim
 152 #: ../dgit-maint-merge.7.pod:140 ../dgit-maint-debrebase.7.pod:155
 153 #, no-wrap
 154 msgid ""
 155 "    [DEFAULT]\n"
 156 "    upstream-branch = upstream\n"
 157 "    debian-branch = master\n"
 158 "    upstream-tag = %(version)s\n"
 159 "\n"
 160 msgstr ""
 161
 162 #. type: verbatim
 163 #: ../dgit-maint-merge.7.pod:145 ../dgit-maint-debrebase.7.pod:160
 164 #, no-wrap
 165 msgid ""
 166 "    sign-tags = True\n"
 167 "    pristine-tar = False\n"
 168 "    pristine-tar-commit = False\n"
 169 "\n"
 170 msgstr ""
 171
 172 #. type: verbatim
 173 #: ../dgit-maint-merge.7.pod:149 ../dgit-maint-debrebase.7.pod:164
 174 #, no-wrap
 175 msgid ""
 176 "    [import-orig]\n"
 177 "    merge-mode = merge\n"
 178 "\n"
 179 msgstr ""
 180
 181 #. type: textblock
 182 #: ../dgit-maint-merge.7.pod:154 ../dgit-maint-debrebase.7.pod:169
 183 msgid "gbp-import-orig(1) requires a pre-existing upstream branch:"
 184 msgstr ""
 185
 186 #. type: verbatim
 187 #: ../dgit-maint-merge.7.pod:158 ../dgit-maint-debrebase.7.pod:173
 188 #, no-wrap
 189 msgid ""
 190 "    % git add debian/gbp.conf && git commit -m \"create gbp.conf\"\n"
 191 "    % git checkout --orphan upstream\n"
 192 "    % git rm -rf .\n"
 193 "    % git commit --allow-empty -m \"initial, empty branch for upstream source\"\n"
 194 "    % git checkout -f master\n"
 195 "\n"
 196 msgstr ""
 197
 198 #. type: textblock
 199 #: ../dgit-maint-merge.7.pod:166 ../dgit-maint-debrebase.7.pod:181
 200 msgid "Then we can import the upstream version:"
 201 msgstr ""
 202
 203 #. type: verbatim
 204 #: ../dgit-maint-merge.7.pod:170 ../dgit-maint-debrebase.7.pod:185
 205 #, no-wrap
 206 msgid ""
 207 "    % gbp import-orig --merge-mode=replace ../foo_1.2.2.orig.tar.xz\n"
 208 "\n"
 209 msgstr ""
 210
 211 #. type: textblock
 212 #: ../dgit-maint-merge.7.pod:174 ../dgit-maint-debrebase.7.pod:189
 213 msgid ""
 214 "Our upstream branch cannot be pushed to B<dgit-repos>, but since we will "
 215 "need it whenever we import a new upstream version, we must push it "
 216 "somewhere.  The usual choice is B<salsa.debian.org>:"
 217 msgstr ""
 218
 219 #. type: verbatim
 220 #: ../dgit-maint-merge.7.pod:180 ../dgit-maint-debrebase.7.pod:195
 221 #, no-wrap
 222 msgid ""
 223 "    % git remote add -f origin salsa.debian.org:Debian/foo.git\n"
 224 "    % git push --follow-tags -u origin master upstream\n"
 225 "\n"
 226 msgstr ""
 227
 228 #. type: =head1
 229 #: ../dgit-maint-merge.7.pod:188 ../dgit-maint-debrebase.7.pod:207
 230 msgid "CONVERTING AN EXISTING PACKAGE"
 231 msgstr ""
 232
 233 #. type: textblock
 234 #: ../dgit-maint-merge.7.pod:190 ../dgit-maint-debrebase.7.pod:209
 235 msgid ""
 236 "This section explains how to convert an existing Debian package to this "
 237 "workflow.  It should be skipped when debianising a new package."
 238 msgstr ""
 239
 240 #. type: verbatim
 241 #: ../dgit-maint-merge.7.pod:229 ../dgit-maint-debrebase.7.pod:240
 242 #, no-wrap
 243 msgid ""
 244 "    % git remote add -f upstream https://some.upstream/foo.git\n"
 245 "\n"
 246 msgstr ""
 247
 248 #. type: textblock
 249 #: ../dgit-maint-merge.7.pod:242 ../dgit-maint-debrebase.7.pod:294
 250 msgid ""
 251 "To achieve this, you might need to delete I<debian/source/local-options>.  "
 252 "One way to have dgit check your progress is to run B<dgit build-source>."
 253 msgstr ""
 254
 255 #. type: =head1
 256 #: ../dgit-maint-merge.7.pod:312 ../dgit-maint-debrebase.7.pod:441
 257 msgid "BUILDING AND UPLOADING"
 258 msgstr ""
 259
 260 #. type: =head2
 261 #: ../dgit-maint-merge.7.pod:333 ../dgit-maint-debrebase.7.pod:324
 262 msgid "Obtaining the release"
 263 msgstr ""
 264
 265 #. type: verbatim
 266 #: ../dgit-maint-merge.7.pod:339 ../dgit-maint-debrebase.7.pod:330
 267 #, no-wrap
 268 msgid ""
 269 "    % git remote update\n"
 270 "\n"
 271 msgstr ""
 272
 273 #. type: textblock
 274 #: ../dgit-maint-merge.7.pod:345 ../dgit-maint-debrebase.7.pod:336
 275 msgid ""
 276 "You will need the I<debian/gbp.conf> from \"When upstream releases only "
 277 "tarballs\", above.  You will also need your upstream branch.  Above, we "
 278 "pushed this to B<salsa.debian.org>.  You will need to clone or fetch from "
 279 "there, instead of relying on B<dgit clone>/B<dgit fetch> alone."
 280 msgstr ""
 281
 282 #. type: textblock
 283 #: ../dgit-maint-merge.7.pod:350 ../dgit-maint-debrebase.7.pod:341
 284 msgid "Then, either"
 285 msgstr ""
 286
 287 #. type: verbatim
 288 #: ../dgit-maint-merge.7.pod:354 ../dgit-maint-debrebase.7.pod:345
 289 #, no-wrap
 290 msgid ""
 291 "    % gbp import-orig --no-merge ../foo_1.2.3.orig.tar.xz\n"
 292 "\n"
 293 msgstr ""
 294
 295 #. type: textblock
 296 #: ../dgit-maint-merge.7.pod:358 ../dgit-maint-debrebase.7.pod:349
 297 msgid "or if you have a working watch file"
 298 msgstr ""
 299
 300 #. type: verbatim
 301 #: ../dgit-maint-merge.7.pod:362 ../dgit-maint-debrebase.7.pod:353
 302 #, no-wrap
 303 msgid ""
 304 "    % gbp import-orig --no-merge --uscan\n"
 305 "\n"
 306 msgstr ""
 307
 308 #. type: textblock
 309 #: ../dgit-maint-merge.7.pod:396 ../dgit-maint-debrebase.7.pod:382
 310 msgid ""
 311 "If you obtained a tarball from upstream, you are ready to try a build.  If "
 312 "you merged a git tag from upstream, you will first need to generate a "
 313 "tarball:"
 314 msgstr ""
 315
 316 #. type: =head1
 317 #: ../dgit-maint-merge.7.pod:406 ../dgit-maint-debrebase.7.pod:472
 318 msgid "HANDLING DFSG-NON-FREE MATERIAL"
 319 msgstr ""
 320
 321 #. type: textblock
 322 #: ../dgit-maint-merge.7.pod:435 ../dgit-maint-debrebase.7.pod:546
 323 msgid ""
 324 "The easiest way to handle this is to add a B<Files-Excluded> field to "
 325 "I<debian/copyright>, and a B<uversionmangle> setting in I<debian/watch>.  "
 326 "See uscan(1).  Alternatively, see the I<--filter> option detailed in gbp-"
 327 "import-orig(1)."
 328 msgstr ""
 329
 330 #. type: =head1
 331 #: ../dgit-maint-merge.7.pod:480 ../dgit-maint-gbp.7.pod:130
 332 #: ../dgit-maint-debrebase.7.pod:551
 333 msgid "INCORPORATING NMUS"
 334 msgstr ""
 335
 336 #. type: =head1
 337 #: ../dgit-maint-merge.7.pod:495 ../dgit-maint-gbp.7.pod:140
 338 #: ../dgit-maint-debrebase.7.pod:751
 339 msgid "AUTHOR"
 340 msgstr ""
 341
 342 #. type: textblock
 343 #: ../dgit-maint-merge.7.pod:497 ../dgit-maint-debrebase.7.pod:753
 344 msgid ""
 345 "This tutorial was written and is maintained by Sean Whitton "
 346 "<spwhitton@spwhitton.name>.  It contains contributions from other dgit "
 347 "contributors too - see the dgit copyright file."
 348 msgstr ""
 349
 350 #. type: =head1
 351 #: ../dgit-maint-gbp.7.pod:32 ../dgit-maint-debrebase.7.pod:298
 352 msgid "GIT CONFIGURATION"
 353 msgstr ""
 354
 355 #. type: textblock
 356 #: ../dgit-maint-debrebase.7.pod:3
 357 msgid ""
 358 "dgit - tutorial for package maintainers, using a workflow centered around "
 359 "git-debrebase(1)"
 360 msgstr ""
 361
 362 #. type: textblock
 363 #: ../dgit-maint-debrebase.7.pod:7
 364 msgid ""
 365 "This document describes elements of a workflow for maintaining a non-native "
 366 "Debian package using B<dgit>.  We maintain the Debian delta as a series of "
 367 "git commits on our master branch.  We use git-debrebase(1) to shuffle our "
 368 "branch such that this series of git commits appears at the end of the "
 369 "branch.  All the public git history is fast-forwarding, i.e., we do not "
 370 "rewrite and force-push."
 371 msgstr ""
 372
 373 #. type: textblock
 374 #: ../dgit-maint-debrebase.7.pod:14
 375 msgid "Some advantages of this workflow:"
 376 msgstr ""
 377
 378 #. type: textblock
 379 #: ../dgit-maint-debrebase.7.pod:20
 380 msgid ""
 381 "Manipulate the delta queue using the full power of git-rebase(1), instead of "
 382 "relying on quilt(1), and without having to switch back and forth between "
 383 "patches-applied and patches-unapplied branches when committing changes and "
 384 "trying to build, as with gbp-pq(1)."
 385 msgstr ""
 386
 387 #. type: textblock
 388 #: ../dgit-maint-debrebase.7.pod:27
 389 msgid ""
 390 "If you are using 3.0 (quilt), provide your delta queue as a properly "
 391 "separated series of quilt patches in the source package that you upload to "
 392 "the archive (unlike with dgit-maint-merge(7))."
 393 msgstr ""
 394
 395 #. type: textblock
 396 #: ../dgit-maint-debrebase.7.pod:33
 397 msgid ""
 398 "Avoid the git tree being dirtied by the application or unapplication of "
 399 "patches, as they are always applied."
 400 msgstr ""
 401
 402 #. type: textblock
 403 #: ../dgit-maint-debrebase.7.pod:43
 404 msgid ""
 405 "Provide your full git history in a standard format on B<dgit-repos>, where "
 406 "it can benefit downstream dgit users, such as people using dgit to do an NMU "
 407 "(see dgit-nmu-simple(7) and dgit-user(7))."
 408 msgstr ""
 409
 410 #. type: textblock
 411 #: ../dgit-maint-debrebase.7.pod:49
 412 msgid ""
 413 "Minimise the amount you need to know about 3.0 (quilt) in order to maintain "
 414 "Debian source packages which use that format."
 415 msgstr ""
 416
 417 #. type: textblock
 418 #: ../dgit-maint-debrebase.7.pod:54
 419 msgid ""
 420 "This workflow is appropriate for packages where the Debian delta contains "
 421 "multiple pieces which interact, or which you don't expect to be able to "
 422 "upstream soon.  For packages with simple and/or short-lived Debian deltas, "
 423 "use of git-debrebase(1) introduces unneeded complexity.  For such packages, "
 424 "consider the workflow described in dgit-maint-merge(7)."
 425 msgstr ""
 426
 427 #. type: textblock
 428 #: ../dgit-maint-debrebase.7.pod:82
 429 msgid ""
 430 "The final command detaches your master branch from the upstream remote, so "
 431 "that git doesn't try to push anything there, or merge unreleased upstream "
 432 "commits.  To maintain a copy of your packaging branch on B<salsa.debian.org> "
 433 "in addition to B<dgit-repos>, you can do something like this:"
 434 msgstr ""
 435
 436 #. type: textblock
 437 #: ../dgit-maint-debrebase.7.pod:95
 438 msgid ""
 439 "Now go ahead and Debianise your package.  Make commits on the master branch, "
 440 "adding things in the I<debian/> directory, or patching the upstream source.  "
 441 "For technical reasons, B<it is essential that your first commit introduces "
 442 "the debian/ directory containing at least one file, and does nothing else.> "
 443 "In other words, make a commit introducing I<debian/> before patching the "
 444 "upstream source."
 445 msgstr ""
 446
 447 #. type: =head3
 448 #: ../dgit-maint-debrebase.7.pod:115
 449 msgid "Comparing upstream's tarball releases"
 450 msgstr ""
 451
 452 #. type: textblock
 453 #: ../dgit-maint-debrebase.7.pod:119
 454 msgid ""
 455 "The above assumes that you know how to build the package from git and that "
 456 "doing so is straightforward."
 457 msgstr ""
 458
 459 #. type: textblock
 460 #: ../dgit-maint-debrebase.7.pod:122
 461 msgid ""
 462 "If, as a user of the upstream source, you usually build from upstream "
 463 "tarball releases, rather than upstream git tags, you will sometimes find "
 464 "that the git tree doesn't contain everything that is in the tarball."
 465 msgstr ""
 466
 467 #. type: textblock
 468 #: ../dgit-maint-debrebase.7.pod:127
 469 msgid ""
 470 "Additional build steps may be needed.  For example, you may need your "
 471 "I<debian/rules> to run autotools."
 472 msgstr ""
 473
 474 #. type: textblock
 475 #: ../dgit-maint-debrebase.7.pod:130
 476 msgid ""
 477 "You can compare the upstream tarball release, and upstream git tag, within "
 478 "git, by importing the tarball into git as described in the next section, "
 479 "using a different value for 'upstream-tag', and then using git-diff(1) to "
 480 "compare the imported tarball to the release tag."
 481 msgstr ""
 482
 483 #. type: textblock
 484 #: ../dgit-maint-debrebase.7.pod:139
 485 msgid ""
 486 "Because we want to work in git, we need a virtual upstream branch with "
 487 "virtual release tags.  gbp-import-orig(1) can manage this for us.  To begin"
 488 msgstr ""
 489
 490 #. type: textblock
 491 #: ../dgit-maint-debrebase.7.pod:200
 492 msgid ""
 493 "You are now ready to proceed as above, making commits to the I<debian/> "
 494 "directory and to the upstream source.  As above, for technical reasons, B<it "
 495 "is essential that your first commit introduces the debian/ directory "
 496 "containing at least one file, and does nothing else.> In other words, make a "
 497 "commit introducing I<debian/> before patching the upstream source."
 498 msgstr ""
 499
 500 #. type: textblock
 501 #: ../dgit-maint-debrebase.7.pod:212
 502 msgid ""
 503 "If you have an existing git history that you have pushed to an ordinary git "
 504 "server like B<salsa.debian.org>, we start with that.  If you don't already "
 505 "have it locally, you'll need to clone it, and obtain the corresponding orig."
 506 "tar from the archive:"
 507 msgstr ""
 508
 509 #. type: verbatim
 510 #: ../dgit-maint-debrebase.7.pod:219
 511 #, no-wrap
 512 msgid ""
 513 "    % git clone salsa.debian.org:Debian/foo\n"
 514 "    % cd foo\n"
 515 "    % dgit setup-new-tree\n"
 516 "    % origtargz\n"
 517 "\n"
 518 msgstr ""
 519
 520 #. type: textblock
 521 #: ../dgit-maint-debrebase.7.pod:226
 522 msgid ""
 523 "If you don't have any existing git history, or you have history only on the "
 524 "special B<dgit-repos> server, we start with B<dgit clone>:"
 525 msgstr ""
 526
 527 #. type: verbatim
 528 #: ../dgit-maint-debrebase.7.pod:231
 529 #, no-wrap
 530 msgid ""
 531 "    % dgit clone foo\n"
 532 "    % cd foo\n"
 533 "\n"
 534 msgstr ""
 535
 536 #. type: textblock
 537 #: ../dgit-maint-debrebase.7.pod:236
 538 msgid "Then we make new upstream tags available:"
 539 msgstr ""
 540
 541 #. type: textblock
 542 #: ../dgit-maint-debrebase.7.pod:244
 543 msgid ""
 544 "We now use a B<git debrebase convert-from-*> command to convert your "
 545 "existing history to the git-debrebase(5) data model.  Which command you "
 546 "should use depends on some facts about your repository:"
 547 msgstr ""
 548
 549 #. type: =item
 550 #: ../dgit-maint-debrebase.7.pod:250
 551 msgid "(A) There is no delta queue."
 552 msgstr ""
 553
 554 #. type: textblock
 555 #: ../dgit-maint-debrebase.7.pod:252
 556 msgid "If there do not exist any Debian patches, use"
 557 msgstr ""
 558
 559 #. type: verbatim
 560 #: ../dgit-maint-debrebase.7.pod:256 ../dgit-maint-debrebase.7.pod:268
 561 #, no-wrap
 562 msgid ""
 563 "    % git debrebase convert-from-gbp\n"
 564 "\n"
 565 msgstr ""
 566
 567 #. type: =item
 568 #: ../dgit-maint-debrebase.7.pod:260
 569 msgid "(B) There is a delta queue, and patches are unapplied."
 570 msgstr ""
 571
 572 #. type: textblock
 573 #: ../dgit-maint-debrebase.7.pod:262
 574 msgid ""
 575 "This is the standard git-buildpackage(1) workflow: there are Debian patches, "
 576 "but the upstream source is committed to git without those patches applied.  "
 577 "Use"
 578 msgstr ""
 579
 580 #. type: textblock
 581 #: ../dgit-maint-debrebase.7.pod:272
 582 msgid ""
 583 "If you were not previously using dgit to upload your package (i.e. you were "
 584 "not using the workflow described in dgit-maint-gbp(7)), and you happen to "
 585 "have run B<dgit fetch sid> in this clone of the repository, you will need to "
 586 "pass I<--fdiverged> to this command."
 587 msgstr ""
 588
 589 #. type: =item
 590 #: ../dgit-maint-debrebase.7.pod:277
 591 msgid "(C) There is a delta queue, and patches are applied."
 592 msgstr ""
 593
 594 #. type: textblock
 595 #: ../dgit-maint-debrebase.7.pod:279
 596 msgid "Use"
 597 msgstr ""
 598
 599 #. type: verbatim
 600 #: ../dgit-maint-debrebase.7.pod:283
 601 #, no-wrap
 602 msgid ""
 603 "    % git debrebase convert-from-dgit-view\n"
 604 "\n"
 605 msgstr ""
 606
 607 #. type: textblock
 608 #: ../dgit-maint-debrebase.7.pod:289
 609 msgid ""
 610 "Finally, you need to ensure that your git HEAD is dgit-compatible, i.e., it "
 611 "is exactly what you would get if you deleted .git, invoked B<dpkg-"
 612 "buildpackage -S>, and then unpacked the resultant source package."
 613 msgstr ""
 614
 615 #. type: textblock
 616 #: ../dgit-maint-debrebase.7.pod:300
 617 msgid ""
 618 "git-debrebase(1) does not yet support using B<git merge> to merge divergent "
 619 "branches of development (see \"OTHER MERGES\" in git-debrebase(5)).  You "
 620 "should configure git such that B<git pull> does not try to merge:"
 621 msgstr ""
 622
 623 #. type: verbatim
 624 #: ../dgit-maint-debrebase.7.pod:307
 625 #, no-wrap
 626 msgid ""
 627 "    % git config --local pull.rebase true\n"
 628 "\n"
 629 msgstr ""
 630
 631 #. type: textblock
 632 #: ../dgit-maint-debrebase.7.pod:311
 633 msgid ""
 634 "Now when you pull work from other Debian contributors, git will rebase your "
 635 "work on top of theirs."
 636 msgstr ""
 637
 638 #. type: textblock
 639 #: ../dgit-maint-debrebase.7.pod:314
 640 msgid ""
 641 "If you use this clone for upstream development in addition to Debian "
 642 "packaging work, you may not want to set this global setting.  Instead, see "
 643 "the B<branch.autoSetupRebase> and B<branch.E<lt>nameE<gt>.rebase> settings "
 644 "in git-config(5)."
 645 msgstr ""
 646
 647 #. type: =head1
 648 #: ../dgit-maint-debrebase.7.pod:319
 649 msgid "IMPORTING NEW UPSTREAM RELEASES"
 650 msgstr ""
 651
 652 #. type: textblock
 653 #: ../dgit-maint-debrebase.7.pod:321
 654 msgid ""
 655 "There are two steps: obtaining git refs that correspond to the new release, "
 656 "and importing that release using git-debrebase(1)."
 657 msgstr ""
 658
 659 #. type: =head2
 660 #: ../dgit-maint-debrebase.7.pod:357
 661 msgid "Importing the release"
 662 msgstr ""
 663
 664 #. type: verbatim
 665 #: ../dgit-maint-debrebase.7.pod:361
 666 #, no-wrap
 667 msgid ""
 668 "    % git debrebase new-upstream 1.2.3\n"
 669 "\n"
 670 msgstr ""
 671
 672 #. type: textblock
 673 #: ../dgit-maint-debrebase.7.pod:365
 674 msgid ""
 675 "This invocation of git-debrebase(1) involves a git rebase.  You may need to "
 676 "resolve conflicts if the Debian delta queue does not apply cleanly to the "
 677 "new upstream source."
 678 msgstr ""
 679
 680 #. type: textblock
 681 #: ../dgit-maint-debrebase.7.pod:369
 682 msgid ""
 683 "If all went well, you can now review the merge of the new upstream release:"
 684 msgstr ""
 685
 686 #. type: verbatim
 687 #: ../dgit-maint-debrebase.7.pod:374
 688 #, no-wrap
 689 msgid ""
 690 "    git diff debian/1.2.2-1..HEAD -- . ':!debian'\n"
 691 "\n"
 692 msgstr ""
 693
 694 #. type: textblock
 695 #: ../dgit-maint-debrebase.7.pod:378
 696 msgid ""
 697 "Pass I<--stat> just to see the list of changed files, which is useful to "
 698 "determine whether there are any new or deleted files that may need "
 699 "accounting for in your copyright file."
 700 msgstr ""
 701
 702 #. type: =head1
 703 #: ../dgit-maint-debrebase.7.pod:392
 704 msgid "EDITING THE DEBIAN PACKAGING"
 705 msgstr ""
 706
 707 #. type: textblock
 708 #: ../dgit-maint-debrebase.7.pod:394
 709 msgid "Just make commits on master that change the contents of I<debian/>."
 710 msgstr ""
 711
 712 #. type: =head1
 713 #: ../dgit-maint-debrebase.7.pod:396
 714 msgid "EDITING THE DELTA QUEUE"
 715 msgstr ""
 716
 717 #. type: =head2
 718 #: ../dgit-maint-debrebase.7.pod:398
 719 msgid "Adding new patches"
 720 msgstr ""
 721
 722 #. type: textblock
 723 #: ../dgit-maint-debrebase.7.pod:400
 724 msgid ""
 725 "Adding new patches is straightforward: just make commits touching only files "
 726 "outside of the I<debian/> directory.  You can also use tools like git-"
 727 "revert(1), git-am(1) and git-cherry-pick(1)."
 728 msgstr ""
 729
 730 #. type: =head2
 731 #: ../dgit-maint-debrebase.7.pod:404
 732 msgid "Editing patches: starting a debrebase"
 733 msgstr ""
 734
 735 #. type: textblock
 736 #: ../dgit-maint-debrebase.7.pod:406
 737 msgid ""
 738 "git-debrebase(1) is a wrapper around git-rebase(1) which allows us to edit, "
 739 "re-order and delete patches.  Run"
 740 msgstr ""
 741
 742 #. type: verbatim
 743 #: ../dgit-maint-debrebase.7.pod:411 ../dgit-maint-debrebase.7.pod:714
 744 #, no-wrap
 745 msgid ""
 746 "    % git debrebase -i\n"
 747 "\n"
 748 msgstr ""
 749
 750 #. type: textblock
 751 #: ../dgit-maint-debrebase.7.pod:415
 752 msgid ""
 753 "to start an interactive rebase.  You can edit, re-order and delete commits "
 754 "just as you would during B<git rebase -i>."
 755 msgstr ""
 756
 757 #. type: =head2
 758 #: ../dgit-maint-debrebase.7.pod:418
 759 msgid "Editing patches: finishing a debrebase"
 760 msgstr ""
 761
 762 #. type: textblock
 763 #: ../dgit-maint-debrebase.7.pod:420
 764 msgid ""
 765 "After completing the git rebase, your branch will not be a fast-forward of "
 766 "the git HEAD you had before the rebase.  This means that we cannot push the "
 767 "branch anywhere.  If you are ready to upload, B<dgit push> or B<dgit push-"
 768 "source> will take care of fixing this up for you."
 769 msgstr ""
 770
 771 #. type: textblock
 772 #: ../dgit-maint-debrebase.7.pod:426
 773 msgid ""
 774 "If you are not yet ready to upload, and want to push your branch to a git "
 775 "remote such as B<salsa.debian.org>,"
 776 msgstr ""
 777
 778 #. type: verbatim
 779 #: ../dgit-maint-debrebase.7.pod:431
 780 #, no-wrap
 781 msgid ""
 782 "    % git debrebase conclude\n"
 783 "\n"
 784 msgstr ""
 785
 786 #. type: textblock
 787 #: ../dgit-maint-debrebase.7.pod:435
 788 msgid ""
 789 "Note that each time you conclude a debrebase you introduce a pseudomerge "
 790 "into your git history, which may make it harder to read.  Try to do all of "
 791 "the editing of the delta queue that you think will be needed for this "
 792 "editing session in a single debrebase, so that there is a single debrebase "
 793 "stitch."
 794 msgstr ""
 795
 796 #. type: textblock
 797 #: ../dgit-maint-debrebase.7.pod:443
 798 msgid ""
 799 "You can use dpkg-buildpackage(1) for test builds.  When you are ready to "
 800 "build for an upload, use B<dgit sbuild>, B<dgit pbuilder> or B<dgit "
 801 "cowbuilder>."
 802 msgstr ""
 803
 804 #. type: textblock
 805 #: ../dgit-maint-debrebase.7.pod:447
 806 msgid ""
 807 "Upload with B<dgit push> or B<dgit push-source>.  Remember to pass I<--new> "
 808 "if the package is new in the target suite."
 809 msgstr ""
 810
 811 #. type: textblock
 812 #: ../dgit-maint-debrebase.7.pod:450
 813 msgid ""
 814 "In some cases where you used B<git debrebase convert-from-gbp> since the "
 815 "last upload, it is not possible for dgit to make your history fast-"
 816 "forwarding from the history on B<dgit-repos>.  In such cases you will have "
 817 "to pass I<--overwrite> to dgit.  git-debrebase will normally tell you if "
 818 "this will be needed."
 819 msgstr ""
 820
 821 #. type: textblock
 822 #: ../dgit-maint-debrebase.7.pod:456
 823 msgid ""
 824 "Right before uploading, if you did not just already do so, you might want to "
 825 "have git-debrebase(1) shuffle your branch such that the Debian delta queue "
 826 "appears right at the tip of the branch you will push:"
 827 msgstr ""
 828
 829 #. type: verbatim
 830 #: ../dgit-maint-debrebase.7.pod:462
 831 #, no-wrap
 832 msgid ""
 833 "    % git debrebase\n"
 834 "    % dgit push-source\n"
 835 "\n"
 836 msgstr ""
 837
 838 #. type: textblock
 839 #: ../dgit-maint-debrebase.7.pod:467
 840 msgid "Note that this will introduce a new pseudomerge."
 841 msgstr ""
 842
 843 #. type: textblock
 844 #: ../dgit-maint-debrebase.7.pod:469
 845 msgid ""
 846 "After dgit pushing, be sure to git push to B<salsa.debian.org>, if you're "
 847 "using that."
 848 msgstr ""
 849
 850 #. type: =head2
 851 #: ../dgit-maint-debrebase.7.pod:474
 852 msgid "Illegal material"
 853 msgstr ""
 854
 855 #. type: textblock
 856 #: ../dgit-maint-debrebase.7.pod:476
 857 msgid ""
 858 "Here we explain how to handle material that is merely DFSG-non-free.  "
 859 "Material which is legally dangerous (for example, files which are actually "
 860 "illegal) cannot be handled this way."
 861 msgstr ""
 862
 863 #. type: verbatim
 864 #: ../dgit-maint-debrebase.7.pod:480
 865 #, no-wrap
 866 msgid ""
 867 "If you encounter possibly-legally-dangerous material in the upstream\n"
 868 "source code you should seek advice.  It is often best not to make a\n"
 869 "fuss on a public mailing list (at least, not at first).  Instead,\n"
 870 "email your archive administrators.  For Debian that is\n"
 871 " To: dgit-owner@debian.org, ftpmaster@ftp-master.debian.org\n"
 872 "\n"
 873 msgstr ""
 874
 875 #. type: =head2
 876 #: ../dgit-maint-debrebase.7.pod:486
 877 msgid "DFSG-non-free: When upstream tags releases in git"
 878 msgstr ""
 879
 880 #. type: textblock
 881 #: ../dgit-maint-debrebase.7.pod:488
 882 msgid ""
 883 "Our approach is to maintain a DFSG-clean upstream branch, and create tags on "
 884 "this branch for each release that we want to import.  We then import those "
 885 "tags per \"Importing the release\", above.  In the case of a new package, we "
 886 "base our initial Debianisation on our first DFSG-clean tag."
 887 msgstr ""
 888
 889 #. type: textblock
 890 #: ../dgit-maint-debrebase.7.pod:494
 891 msgid "For the first upstream release that requires DFSG filtering:"
 892 msgstr ""
 893
 894 #. type: verbatim
 895 #: ../dgit-maint-debrebase.7.pod:498
 896 #, no-wrap
 897 msgid ""
 898 "    % git checkout -b upstream-dfsg 1.2.3\n"
 899 "    % git rm evil.bin\n"
 900 "    % git commit -m \"upstream version 1.2.3 DFSG-cleaned\"\n"
 901 "    % git tag -s 1.2.3+dfsg\n"
 902 "    % git checkout master\n"
 903 "\n"
 904 msgstr ""
 905
 906 #. type: textblock
 907 #: ../dgit-maint-debrebase.7.pod:506
 908 msgid ""
 909 "Now either proceed with \"Importing the release\" on the 1.2.3+dfsg tag, or "
 910 "in the case of a new package,"
 911 msgstr ""
 912
 913 #. type: verbatim
 914 #: ../dgit-maint-debrebase.7.pod:511
 915 #, no-wrap
 916 msgid ""
 917 "    % git branch --unset-upstream\n"
 918 "    % git reset --hard 1.2.3+dfsg\n"
 919 "\n"
 920 msgstr ""
 921
 922 #. type: textblock
 923 #: ../dgit-maint-debrebase.7.pod:516
 924 msgid "and proceed with \"INITIAL DEBIANISATION\"."
 925 msgstr ""
 926
 927 #. type: textblock
 928 #: ../dgit-maint-debrebase.7.pod:518
 929 msgid ""
 930 "For subsequent releases (whether or not they require additional filtering):"
 931 msgstr ""
 932
 933 #. type: verbatim
 934 #: ../dgit-maint-debrebase.7.pod:523
 935 #, no-wrap
 936 msgid ""
 937 "    % git checkout upstream-dfsg\n"
 938 "    % git merge 1.2.4\n"
 939 "    % git rm further-evil.bin # if needed\n"
 940 "    % git commit -m \"upstream version 1.2.4 DFSG-cleaned\" # if needed\n"
 941 "    % git tag -s 1.2.4+dfsg\n"
 942 "    % git checkout master\n"
 943 "    % # proceed with \"Importing the release\" on 1.2.4+dfsg tag\n"
 944 "\n"
 945 msgstr ""
 946
 947 #. type: textblock
 948 #: ../dgit-maint-debrebase.7.pod:533
 949 msgid ""
 950 "Our upstream-dfsg branch cannot be pushed to B<dgit-repos>, but since we "
 951 "will need it whenever we import a new upstream version, we must push it "
 952 "somewhere.  Assuming that you have already set up an origin remote per the "
 953 "above,"
 954 msgstr ""
 955
 956 #. type: verbatim
 957 #: ../dgit-maint-debrebase.7.pod:540
 958 #, no-wrap
 959 msgid ""
 960 "    % git push --follow-tags -u origin master upstream-dfsg\n"
 961 "\n"
 962 msgstr ""
 963
 964 #. type: =head2
 965 #: ../dgit-maint-debrebase.7.pod:544
 966 msgid "DFSG-non-free: When upstream releases only tarballs"
 967 msgstr ""
 968
 969 #. type: textblock
 970 #: ../dgit-maint-debrebase.7.pod:553
 971 msgid "In the simplest case,"
 972 msgstr ""
 973
 974 #. type: verbatim
 975 #: ../dgit-maint-debrebase.7.pod:557
 976 #, no-wrap
 977 msgid ""
 978 "    % dgit fetch\n"
 979 "    % git merge --ff-only dgit/dgit/sid\n"
 980 "\n"
 981 msgstr ""
 982
 983 #. type: textblock
 984 #: ../dgit-maint-debrebase.7.pod:562
 985 msgid ""
 986 "If that fails, because your branch and the NMUers' work represent divergent "
 987 "branches of development, you have a number of options.  Here we describe the "
 988 "two simplest."
 989 msgstr ""
 990
 991 #. type: textblock
 992 #: ../dgit-maint-debrebase.7.pod:566
 993 msgid ""
 994 "Note that you should not try to resolve the divergent branches by editing "
 995 "files in I<debian/patches>.  Changes there would either cause trouble, or be "
 996 "overwritten by git-debrebase(1)."
 997 msgstr ""
 998
 999 #. type: =head2
1000 #: ../dgit-maint-debrebase.7.pod:570
1001 msgid "Rebasing your work onto the NMU"
1002 msgstr ""
1003
1004 #. type: verbatim
1005 #: ../dgit-maint-debrebase.7.pod:574
1006 #, no-wrap
1007 msgid ""
1008 "    % git rebase dgit/dgit/sid\n"
1009 "\n"
1010 msgstr ""
1011
1012 #. type: textblock
1013 #: ../dgit-maint-debrebase.7.pod:578
1014 msgid ""
1015 "If the NMUer added new commits modifying the upstream source, you will "
1016 "probably want to debrebase before your next upload to tidy those up."
1017 msgstr ""
1018
1019 #. type: textblock
1020 #: ../dgit-maint-debrebase.7.pod:581
1021 msgid ""
1022 "For example, the NMUer might have used git-revert(1) to unapply one of your "
1023 "patches.  A debrebase can be used to strip both the patch and the reversion "
1024 "from the delta queue."
1025 msgstr ""
1026
1027 #. type: =head2
1028 #: ../dgit-maint-debrebase.7.pod:585
1029 msgid "Manually applying the debdiff"
1030 msgstr ""
1031
1032 #. type: textblock
1033 #: ../dgit-maint-debrebase.7.pod:587
1034 msgid ""
1035 "If you cannot rebase because you have already pushed to B<salsa.debian.org>, "
1036 "say, you can manually apply the NMU debdiff, commit and debrebase.  The next "
1037 "B<dgit push> will require I<--overwrite>."
1038 msgstr ""
1039
1040 #. type: =head1
1041 #: ../dgit-maint-debrebase.7.pod:592
1042 msgid "HINTS AND TIPS"
1043 msgstr ""
1044
1045 #. type: =head2
1046 #: ../dgit-maint-debrebase.7.pod:594
1047 msgid "Minimising pseudomerges"
1048 msgstr ""
1049
1050 #. type: textblock
1051 #: ../dgit-maint-debrebase.7.pod:596
1052 msgid ""
1053 "Above we noted that each time you conclude a debrebase, you introduce a "
1054 "pseudomerge into your git history, which may make it harder to read."
1055 msgstr ""
1056
1057 #. type: textblock
1058 #: ../dgit-maint-debrebase.7.pod:599
1059 msgid ""
1060 "A simple convention you can use to minimise the number of pseudomerges is to "
1061 "B<git debrebase conclude> only right before you upload or push to B<salsa."
1062 "debian.org>."
1063 msgstr ""
1064
1065 #. type: textblock
1066 #: ../dgit-maint-debrebase.7.pod:603
1067 msgid ""
1068 "It is possible, though much less convenient, to reduce the number of "
1069 "pseudomerges yet further.  We debrebase only (i) when importing a new "
1070 "release, and (ii) right before uploading.  Instead of editing the existing "
1071 "delta queue, you append fixup commits (and reversions of commits) that alter "
1072 "the upstream source to the required state.  You can push and pull to and "
1073 "from B<salsa.debian.org> during this.  Just before uploading, you debrebase, "
1074 "once, to tidy everything up."
1075 msgstr ""
1076
1077 #. type: =head2
1078 #: ../dgit-maint-debrebase.7.pod:611
1079 msgid "The debian/patches directory"
1080 msgstr ""
1081
1082 #. type: textblock
1083 #: ../dgit-maint-debrebase.7.pod:613
1084 msgid ""
1085 "In this workflow, I<debian/patches> is purely an output of git-"
1086 "debrebase(1).  You should not make changes there.  They will either cause "
1087 "trouble, or be ignored and overwritten by git-debrebase(1)."
1088 msgstr ""
1089
1090 #. type: textblock
1091 #: ../dgit-maint-debrebase.7.pod:618
1092 msgid ""
1093 "I<debian/patches> will often be out-of-date because git-debrebase(1)  will "
1094 "only regenerate it when it needs to.  So you should not rely on the "
1095 "information in that directory.  When preparing patches to forward upstream, "
1096 "you should use git-format-patch(1) on git commits, rather than sending files "
1097 "from I<debian/patches>."
1098 msgstr ""
1099
1100 #. type: =head2
1101 #: ../dgit-maint-debrebase.7.pod:624
1102 msgid "Upstream branches"
1103 msgstr ""
1104
1105 #. type: textblock
1106 #: ../dgit-maint-debrebase.7.pod:626
1107 msgid "In this workflow, we specify upstream tags rather than any branches."
1108 msgstr ""
1109
1110 #. type: textblock
1111 #: ../dgit-maint-debrebase.7.pod:628
1112 msgid ""
1113 "Except when (i) upstream releases only tarballs, (ii) we require DFSG "
1114 "filtering, or (iii) you also happen to be involved in upstream development, "
1115 "we do not maintain any local branch corresponding to upstream, except "
1116 "temporary branches used to prepare patches for forwarding, and the like."
1117 msgstr ""
1118
1119 #. type: textblock
1120 #: ../dgit-maint-debrebase.7.pod:634
1121 msgid ""
1122 "The idea here is that from Debian's point of view, upstream releases are "
1123 "immutable points in history.  We want to make sure that we are basing our "
1124 "Debian package on a properly identified upstream version, rather than some "
1125 "arbitrary commit on some branch.  Tags are more useful for this."
1126 msgstr ""
1127
1128 #. type: textblock
1129 #: ../dgit-maint-debrebase.7.pod:640
1130 msgid ""
1131 "Upstream's branches remain available as the git remote tracking branches for "
1132 "your upstream remote, e.g. I<remotes/upstream/master>."
1133 msgstr ""
1134
1135 #. type: =head2
1136 #: ../dgit-maint-debrebase.7.pod:643
1137 msgid "The first ever dgit push"
1138 msgstr ""
1139
1140 #. type: textblock
1141 #: ../dgit-maint-debrebase.7.pod:645
1142 msgid ""
1143 "If this is the first ever dgit push of the package, consider passing I<--"
1144 "deliberately-not-fast-forward> instead of I<--overwrite>.  This avoids "
1145 "introducing a new origin commit into your git history.  (This origin commit "
1146 "would represent the most recent non-dgit upload of the package, but this "
1147 "should already be represented in your git history.)"
1148 msgstr ""
1149
1150 #. type: =head2
1151 #: ../dgit-maint-debrebase.7.pod:651
1152 msgid "Inspecting the history"
1153 msgstr ""
1154
1155 #. type: textblock
1156 #: ../dgit-maint-debrebase.7.pod:653
1157 msgid ""
1158 "The git history made by git-debrebase can seem complicated.  Here are some "
1159 "suggestions for helpful invocations of gitk and git.  They can be adapted "
1160 "for other tools like tig(1), git-log(1), magit, etc."
1161 msgstr ""
1162
1163 #. type: textblock
1164 #: ../dgit-maint-debrebase.7.pod:657
1165 msgid "History of package in Debian, disregarding history from upstream:"
1166 msgstr ""
1167
1168 #. type: verbatim
1169 #: ../dgit-maint-debrebase.7.pod:661
1170 #, no-wrap
1171 msgid ""
1172 "    % gitk --first-parent\n"
1173 "\n"
1174 msgstr ""
1175
1176 #. type: textblock
1177 #: ../dgit-maint-debrebase.7.pod:663
1178 msgid "In a laundered branch, the delta queue is at the top."
1179 msgstr ""
1180
1181 #. type: textblock
1182 #: ../dgit-maint-debrebase.7.pod:667
1183 msgid "History of the packaging, excluding the delta queue:"
1184 msgstr ""
1185
1186 #. type: verbatim
1187 #: ../dgit-maint-debrebase.7.pod:669
1188 #, no-wrap
1189 msgid ""
1190 "    % gitk :/debian :!/debian/patches\n"
1191 "\n"
1192 msgstr ""
1193
1194 #. type: textblock
1195 #: ../dgit-maint-debrebase.7.pod:671
1196 msgid "Just the delta queue (i.e. Debian's changes to upstream):"
1197 msgstr ""
1198
1199 #. type: verbatim
1200 #: ../dgit-maint-debrebase.7.pod:673
1201 #, no-wrap
1202 msgid ""
1203 "    % gitk --first-parent -- :/ :!/debian\n"
1204 "\n"
1205 msgstr ""
1206
1207 #. type: textblock
1208 #: ../dgit-maint-debrebase.7.pod:675
1209 msgid "Full history including old versions of the delta queue:"
1210 msgstr ""
1211
1212 #. type: verbatim
1213 #: ../dgit-maint-debrebase.7.pod:679
1214 #, no-wrap
1215 msgid ""
1216 "    % gitk --date-order\n"
1217 "\n"
1218 msgstr ""
1219
1220 #. type: textblock
1221 #: ../dgit-maint-debrebase.7.pod:681
1222 msgid ""
1223 "The \"Declare fast forward\" commits you see have an older history (usually, "
1224 "an older delta queue) as one parent, and a newer history as the other.  --"
1225 "date-order makes gitk show the delta queues in the right order."
1226 msgstr ""
1227
1228 #. type: textblock
1229 #: ../dgit-maint-debrebase.7.pod:688
1230 msgid "Complete diff since the last upload:"
1231 msgstr ""
1232
1233 #. type: verbatim
1234 #: ../dgit-maint-debrebase.7.pod:692
1235 #, no-wrap
1236 msgid ""
1237 "    % git diff dgit/dgit/sid..HEAD -- :/ :!/debian/patches\n"
1238 "\n"
1239 msgstr ""
1240
1241 #. type: textblock
1242 #: ../dgit-maint-debrebase.7.pod:694
1243 msgid "This includes changes to upstream files."
1244 msgstr ""
1245
1246 #. type: textblock
1247 #: ../dgit-maint-debrebase.7.pod:698
1248 msgid "Interdiff of delta queue since last upload, if you really want it:"
1249 msgstr ""
1250
1251 #. type: verbatim
1252 #: ../dgit-maint-debrebase.7.pod:700
1253 #, no-wrap
1254 msgid ""
1255 "    % git debrebase make-patches\n"
1256 "    % git diff dgit/dgit/sid..HEAD -- debian/patches\n"
1257 "\n"
1258 msgstr ""
1259
1260 #. type: textblock
1261 #: ../dgit-maint-debrebase.7.pod:703
1262 msgid "And of course there is:"
1263 msgstr ""
1264
1265 #. type: verbatim
1266 #: ../dgit-maint-debrebase.7.pod:705
1267 #, no-wrap
1268 msgid ""
1269 "    % git debrebase status\n"
1270 "\n"
1271 msgstr ""
1272
1273 #. type: =head2
1274 #: ../dgit-maint-debrebase.7.pod:707
1275 msgid "Alternative ways to start a debrebase"
1276 msgstr ""
1277
1278 #. type: textblock
1279 #: ../dgit-maint-debrebase.7.pod:709
1280 msgid ""
1281 "Above we started an interactive debrebase by invoking git-debrebase(1)  like "
1282 "this:"
1283 msgstr ""
1284
1285 #. type: textblock
1286 #: ../dgit-maint-debrebase.7.pod:718
1287 msgid "It is also possible to perform a non-interactive rebase, like this:"
1288 msgstr ""
1289
1290 #. type: verbatim
1291 #: ../dgit-maint-debrebase.7.pod:722
1292 #, no-wrap
1293 msgid ""
1294 "    % git debrebase -- [git-rebase options...]\n"
1295 "\n"
1296 msgstr ""
1297
1298 #. type: textblock
1299 #: ../dgit-maint-debrebase.7.pod:727
1300 msgid ""
1301 "A third alternative is to have git-debrebase(1) shuffle all the Debian "
1302 "changes to the end of your branch, and then manipulate them yourself using "
1303 "git-rebase(1) directly.  For example,"
1304 msgstr ""
1305
1306 #. type: verbatim
1307 #: ../dgit-maint-debrebase.7.pod:733
1308 #, no-wrap
1309 msgid ""
1310 "    % git debrebase\n"
1311 "    % git rebase -i HEAD~5      # there are 4 Debian patches\n"
1312 "\n"
1313 msgstr ""
1314
1315 #. type: textblock
1316 #: ../dgit-maint-debrebase.7.pod:738
1317 msgid ""
1318 "If you take this approach, you should be very careful not to start the "
1319 "rebase too early, including before the most recent pseudomerge.  git-rebase "
1320 "without a base argument will often start the rebase too early, and should be "
1321 "avoided.  Run git-debrebase instead.  See also \"ILLEGAL OPERATIONS\" in git-"
1322 "debrebase(5)."
1323 msgstr ""
1324
1325 #. type: textblock
1326 #: ../dgit-maint-debrebase.7.pod:749
1327 msgid "dgit(1), dgit(7), git-debrebase(1), git-debrebase(5)"
1328 msgstr ""