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: 2018-10-04 01:04+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 #: ../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:1394 ../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:722 ../dgit-downstream-dsc.7.pod:352
  34 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:601
  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:321
  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:383
 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:329
 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:289
 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:436
 257 msgid "BUILDING AND UPLOADING"
 258 msgstr ""
 259
 260 #. type: =head2
 261 #: ../dgit-maint-merge.7.pod:333 ../dgit-maint-debrebase.7.pod:319
 262 msgid "Obtaining the release"
 263 msgstr ""
 264
 265 #. type: verbatim
 266 #: ../dgit-maint-merge.7.pod:339 ../dgit-maint-debrebase.7.pod:325
 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:331
 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:336
 284 msgid "Then, either"
 285 msgstr ""
 286
 287 #. type: verbatim
 288 #: ../dgit-maint-merge.7.pod:354 ../dgit-maint-debrebase.7.pod:340
 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:344
 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:348
 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:377
 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:461
 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:521
 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:526
 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:726
 339 msgid "AUTHOR"
 340 msgstr ""
 341
 342 #. type: textblock
 343 #: ../dgit-maint-merge.7.pod:497 ../dgit-maint-debrebase.7.pod:728
 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:293
 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: =item
 581 #: ../dgit-maint-debrebase.7.pod:272
 582 msgid "(C) There is a delta queue, and patches are applied."
 583 msgstr ""
 584
 585 #. type: textblock
 586 #: ../dgit-maint-debrebase.7.pod:274
 587 msgid "Use"
 588 msgstr ""
 589
 590 #. type: verbatim
 591 #: ../dgit-maint-debrebase.7.pod:278
 592 #, no-wrap
 593 msgid ""
 594 "    % git debrebase convert-from-dgit-view\n"
 595 "\n"
 596 msgstr ""
 597
 598 #. type: textblock
 599 #: ../dgit-maint-debrebase.7.pod:284
 600 msgid ""
 601 "Finally, you need to ensure that your git HEAD is dgit-compatible, i.e., it "
 602 "is exactly what you would get if you deleted .git, invoked B<dpkg-"
 603 "buildpackage -S>, and then unpacked the resultant source package."
 604 msgstr ""
 605
 606 #. type: textblock
 607 #: ../dgit-maint-debrebase.7.pod:295
 608 msgid ""
 609 "git-debrebase(1) does not yet support using B<git merge> to merge divergent "
 610 "branches of development (see \"OTHER MERGES\" in git-debrebase(5)).  You "
 611 "should configure git such that B<git pull> does not try to merge:"
 612 msgstr ""
 613
 614 #. type: verbatim
 615 #: ../dgit-maint-debrebase.7.pod:302
 616 #, no-wrap
 617 msgid ""
 618 "    % git config --local pull.rebase true\n"
 619 "\n"
 620 msgstr ""
 621
 622 #. type: textblock
 623 #: ../dgit-maint-debrebase.7.pod:306
 624 msgid ""
 625 "Now when you pull work from other Debian contributors, git will rebase your "
 626 "work on top of theirs."
 627 msgstr ""
 628
 629 #. type: textblock
 630 #: ../dgit-maint-debrebase.7.pod:309
 631 msgid ""
 632 "If you use this clone for upstream development in addition to Debian "
 633 "packaging work, you may not want to set this global setting.  Instead, see "
 634 "the B<branch.autoSetupRebase> and B<branch.E<lt>nameE<gt>.rebase> settings "
 635 "in git-config(5)."
 636 msgstr ""
 637
 638 #. type: =head1
 639 #: ../dgit-maint-debrebase.7.pod:314
 640 msgid "IMPORTING NEW UPSTREAM RELEASES"
 641 msgstr ""
 642
 643 #. type: textblock
 644 #: ../dgit-maint-debrebase.7.pod:316
 645 msgid ""
 646 "There are two steps: obtaining git refs that correspond to the new release, "
 647 "and importing that release using git-debrebase(1)."
 648 msgstr ""
 649
 650 #. type: =head2
 651 #: ../dgit-maint-debrebase.7.pod:352
 652 msgid "Importing the release"
 653 msgstr ""
 654
 655 #. type: verbatim
 656 #: ../dgit-maint-debrebase.7.pod:356
 657 #, no-wrap
 658 msgid ""
 659 "    % git debrebase new-upstream 1.2.3\n"
 660 "\n"
 661 msgstr ""
 662
 663 #. type: textblock
 664 #: ../dgit-maint-debrebase.7.pod:360
 665 msgid ""
 666 "This invocation of git-debrebase(1) involves a git rebase.  You may need to "
 667 "resolve conflicts if the Debian delta queue does not apply cleanly to the "
 668 "new upstream source."
 669 msgstr ""
 670
 671 #. type: textblock
 672 #: ../dgit-maint-debrebase.7.pod:364
 673 msgid ""
 674 "If all went well, you can now review the merge of the new upstream release:"
 675 msgstr ""
 676
 677 #. type: verbatim
 678 #: ../dgit-maint-debrebase.7.pod:369
 679 #, no-wrap
 680 msgid ""
 681 "    git diff debian/1.2.2-1..HEAD -- . ':!debian'\n"
 682 "\n"
 683 msgstr ""
 684
 685 #. type: textblock
 686 #: ../dgit-maint-debrebase.7.pod:373
 687 msgid ""
 688 "Pass I<--stat> just to see the list of changed files, which is useful to "
 689 "determine whether there are any new or deleted files to may need accounting "
 690 "for in your copyright file."
 691 msgstr ""
 692
 693 #. type: =head1
 694 #: ../dgit-maint-debrebase.7.pod:387
 695 msgid "EDITING THE DEBIAN PACKAGING"
 696 msgstr ""
 697
 698 #. type: textblock
 699 #: ../dgit-maint-debrebase.7.pod:389
 700 msgid "Just make commits on master that change the contents of I<debian/>."
 701 msgstr ""
 702
 703 #. type: =head1
 704 #: ../dgit-maint-debrebase.7.pod:391
 705 msgid "EDITING THE DELTA QUEUE"
 706 msgstr ""
 707
 708 #. type: =head2
 709 #: ../dgit-maint-debrebase.7.pod:393
 710 msgid "Adding new patches"
 711 msgstr ""
 712
 713 #. type: textblock
 714 #: ../dgit-maint-debrebase.7.pod:395
 715 msgid ""
 716 "Adding new patches is straightforward: just make commits touching only files "
 717 "outside of the I<debian/> directory.  You can also use tools like git-"
 718 "revert(1), git-am(1) and git-cherry-pick(1)."
 719 msgstr ""
 720
 721 #. type: =head2
 722 #: ../dgit-maint-debrebase.7.pod:399
 723 msgid "Editing patches: starting a debrebase"
 724 msgstr ""
 725
 726 #. type: textblock
 727 #: ../dgit-maint-debrebase.7.pod:401
 728 msgid ""
 729 "git-debrebase(1) is a wrapper around git-rebase(1) which allows us to edit, "
 730 "re-order and delete patches.  Run"
 731 msgstr ""
 732
 733 #. type: verbatim
 734 #: ../dgit-maint-debrebase.7.pod:406 ../dgit-maint-debrebase.7.pod:689
 735 #, no-wrap
 736 msgid ""
 737 "    % git debrebase -i\n"
 738 "\n"
 739 msgstr ""
 740
 741 #. type: textblock
 742 #: ../dgit-maint-debrebase.7.pod:410
 743 msgid ""
 744 "to start an interactive rebase.  You can edit, re-order and delete commits "
 745 "just as you would during B<git rebase -i>."
 746 msgstr ""
 747
 748 #. type: =head2
 749 #: ../dgit-maint-debrebase.7.pod:413
 750 msgid "Editing patches: finishing a debrebase"
 751 msgstr ""
 752
 753 #. type: textblock
 754 #: ../dgit-maint-debrebase.7.pod:415
 755 msgid ""
 756 "After completing the git rebase, your branch will not be a fast-forward of "
 757 "the git HEAD you had before the rebase.  This means that we cannot push the "
 758 "branch anywhere.  If you are ready to upload, B<dgit push> or B<dgit push-"
 759 "source> will take care of fixing this up for you."
 760 msgstr ""
 761
 762 #. type: textblock
 763 #: ../dgit-maint-debrebase.7.pod:421
 764 msgid ""
 765 "If you are not yet ready to upload, and want to push your branch to a git "
 766 "remote such as B<salsa.debian.org>,"
 767 msgstr ""
 768
 769 #. type: verbatim
 770 #: ../dgit-maint-debrebase.7.pod:426
 771 #, no-wrap
 772 msgid ""
 773 "    % git debrebase conclude\n"
 774 "\n"
 775 msgstr ""
 776
 777 #. type: textblock
 778 #: ../dgit-maint-debrebase.7.pod:430
 779 msgid ""
 780 "Note that each time you conclude a debrebase you introduce a pseudomerge "
 781 "into your git history, which may make it harder to read.  Try to do all of "
 782 "the editing of the delta queue that you think will be needed for this "
 783 "editing session in a single debrebase, so that there is a single debrebase "
 784 "stitch."
 785 msgstr ""
 786
 787 #. type: textblock
 788 #: ../dgit-maint-debrebase.7.pod:438
 789 msgid ""
 790 "You can use dpkg-buildpackage(1) for test builds.  When you are ready to "
 791 "build for an upload, use B<dgit sbuild>, B<dgit pbuilder> or B<dgit "
 792 "cowbuilder>."
 793 msgstr ""
 794
 795 #. type: textblock
 796 #: ../dgit-maint-debrebase.7.pod:442
 797 msgid ""
 798 "Upload with B<dgit push> or B<dgit push-source>.  Remember to pass I<--new> "
 799 "if the package is new in the target suite."
 800 msgstr ""
 801
 802 #. type: textblock
 803 #: ../dgit-maint-debrebase.7.pod:445
 804 msgid ""
 805 "Right before uploading, if you did not just already do so, you might want to "
 806 "have git-debrebase(1) shuffle your branch such that the Debian delta queue "
 807 "appears right at the tip of the branch you will push:"
 808 msgstr ""
 809
 810 #. type: verbatim
 811 #: ../dgit-maint-debrebase.7.pod:451
 812 #, no-wrap
 813 msgid ""
 814 "    % git debrebase\n"
 815 "    % dgit push-source\n"
 816 "\n"
 817 msgstr ""
 818
 819 #. type: textblock
 820 #: ../dgit-maint-debrebase.7.pod:456
 821 msgid "Note that this will introduce a new pseudomerge."
 822 msgstr ""
 823
 824 #. type: textblock
 825 #: ../dgit-maint-debrebase.7.pod:458
 826 msgid ""
 827 "After dgit pushing, be sure to git push to B<salsa.debian.org>, if you're "
 828 "using that."
 829 msgstr ""
 830
 831 #. type: =head2
 832 #: ../dgit-maint-debrebase.7.pod:463
 833 msgid "Illegal material"
 834 msgstr ""
 835
 836 #. type: textblock
 837 #: ../dgit-maint-debrebase.7.pod:465
 838 msgid ""
 839 "Here we explain how to handle material that is merely DFSG-non-free.  "
 840 "Material which is legally dangerous (for example, files which are actually "
 841 "illegal) cannot be handled this way."
 842 msgstr ""
 843
 844 #. type: verbatim
 845 #: ../dgit-maint-debrebase.7.pod:469
 846 #, no-wrap
 847 msgid ""
 848 "If you encounter possibly-legally-dangerous material in the upstream\n"
 849 "source code you should seek advice.  It is often best not to make a\n"
 850 "fuss on a public mailing list (at least, not at first).  Instead,\n"
 851 "email your archive administrators.  For Debian that is\n"
 852 " To: dgit-owner@debian.org, ftpmaster@ftp-master.debian.org\n"
 853 "\n"
 854 msgstr ""
 855
 856 #. type: =head2
 857 #: ../dgit-maint-debrebase.7.pod:475
 858 msgid "DFSG-non-free: When upstream tags releases in git"
 859 msgstr ""
 860
 861 #. type: textblock
 862 #: ../dgit-maint-debrebase.7.pod:477
 863 msgid ""
 864 "Our approach is to maintain a DFSG-clean upstream branch, and create tags on "
 865 "this branch for each release that we want to import.  We then import those "
 866 "tags per \"Importing the release\", above."
 867 msgstr ""
 868
 869 #. type: textblock
 870 #: ../dgit-maint-debrebase.7.pod:481
 871 msgid "For the first upstream release that requires DFSG filtering:"
 872 msgstr ""
 873
 874 #. type: verbatim
 875 #: ../dgit-maint-debrebase.7.pod:485
 876 #, no-wrap
 877 msgid ""
 878 "    % git checkout -b upstream-dfsg 1.2.3\n"
 879 "    % git rm evil.bin\n"
 880 "    % git commit -m \"upstream version 1.2.3 DFSG-cleaned\"\n"
 881 "    % git tag -s 1.2.3+dfsg\n"
 882 "    % git checkout master\n"
 883 "    % # proceed with \"Importing the release\" on 1.2.3+dfsg tag\n"
 884 "\n"
 885 msgstr ""
 886
 887 #. type: textblock
 888 #: ../dgit-maint-debrebase.7.pod:494
 889 msgid "And for subsequent releases (whether or not they require filtering):"
 890 msgstr ""
 891
 892 #. type: verbatim
 893 #: ../dgit-maint-debrebase.7.pod:498
 894 #, no-wrap
 895 msgid ""
 896 "    % git checkout upstream-dfsg\n"
 897 "    % git merge 1.2.4\n"
 898 "    % git rm further-evil.bin # if needed\n"
 899 "    % git commit -m \"upstream version 1.2.4 DFSG-cleaned\" # if needed\n"
 900 "    % git tag -s 1.2.4+dfsg\n"
 901 "    % git checkout master\n"
 902 "    % # proceed with \"Importing the release\" on 1.2.4+dfsg tag\n"
 903 "\n"
 904 msgstr ""
 905
 906 #. type: textblock
 907 #: ../dgit-maint-debrebase.7.pod:508
 908 msgid ""
 909 "Our upstream-dfsg branch cannot be pushed to B<dgit-repos>, but since we "
 910 "will need it whenever we import a new upstream version, we must push it "
 911 "somewhere.  Assuming that you have already set up an origin remote per the "
 912 "above,"
 913 msgstr ""
 914
 915 #. type: verbatim
 916 #: ../dgit-maint-debrebase.7.pod:515
 917 #, no-wrap
 918 msgid ""
 919 "    % git push --follow-tags -u origin master upstream-dfsg\n"
 920 "\n"
 921 msgstr ""
 922
 923 #. type: =head2
 924 #: ../dgit-maint-debrebase.7.pod:519
 925 msgid "DFSG-non-free: When upstream releases only tarballs"
 926 msgstr ""
 927
 928 #. type: textblock
 929 #: ../dgit-maint-debrebase.7.pod:528
 930 msgid "In the simplest case,"
 931 msgstr ""
 932
 933 #. type: verbatim
 934 #: ../dgit-maint-debrebase.7.pod:532
 935 #, no-wrap
 936 msgid ""
 937 "    % dgit fetch\n"
 938 "    % git merge --ff-only dgit/dgit/sid\n"
 939 "\n"
 940 msgstr ""
 941
 942 #. type: textblock
 943 #: ../dgit-maint-debrebase.7.pod:537
 944 msgid ""
 945 "If that fails, because your branch and the NMUers work represent divergent "
 946 "branches of development, you have a number of options.  Here we describe the "
 947 "two simplest."
 948 msgstr ""
 949
 950 #. type: textblock
 951 #: ../dgit-maint-debrebase.7.pod:541
 952 msgid ""
 953 "Note that you should not try to resolve the divergent branches by editing "
 954 "files in I<debian/patches>.  Changes there would either cause trouble, or be "
 955 "overwritten by git-debrebase(1)."
 956 msgstr ""
 957
 958 #. type: =head2
 959 #: ../dgit-maint-debrebase.7.pod:545
 960 msgid "Rebasing your work onto the NMU"
 961 msgstr ""
 962
 963 #. type: verbatim
 964 #: ../dgit-maint-debrebase.7.pod:549
 965 #, no-wrap
 966 msgid ""
 967 "    % git rebase dgit/dgit/sid\n"
 968 "\n"
 969 msgstr ""
 970
 971 #. type: textblock
 972 #: ../dgit-maint-debrebase.7.pod:553
 973 msgid ""
 974 "If the NMUer added new commits modifying the upstream source, you will "
 975 "probably want to debrebase before your next upload to tidy those up."
 976 msgstr ""
 977
 978 #. type: textblock
 979 #: ../dgit-maint-debrebase.7.pod:556
 980 msgid ""
 981 "For example, the NMUer might have used git-revert(1) to unapply one of your "
 982 "patches.  A debrebase can be used to strip both the patch and the reversion "
 983 "from the delta queue."
 984 msgstr ""
 985
 986 #. type: =head2
 987 #: ../dgit-maint-debrebase.7.pod:560
 988 msgid "Manually applying the debdiff"
 989 msgstr ""
 990
 991 #. type: textblock
 992 #: ../dgit-maint-debrebase.7.pod:562
 993 msgid ""
 994 "If you cannot rebase because you have already pushed to B<salsa.debian.org>, "
 995 "say, you can manually apply the NMU debdiff, commit and debrebase.  The next "
 996 "B<dgit push> will require I<--overwrite>."
 997 msgstr ""
 998
 999 #. type: =head1
1000 #: ../dgit-maint-debrebase.7.pod:567
1001 msgid "HINTS AND TIPS"
1002 msgstr ""
1003
1004 #. type: =head2
1005 #: ../dgit-maint-debrebase.7.pod:569
1006 msgid "Minimising pseudomerges"
1007 msgstr ""
1008
1009 #. type: textblock
1010 #: ../dgit-maint-debrebase.7.pod:571
1011 msgid ""
1012 "Above we noted that each time you conclude a debrebase, you introduce a "
1013 "pseudomerge into your git history, which may make it harder to read."
1014 msgstr ""
1015
1016 #. type: textblock
1017 #: ../dgit-maint-debrebase.7.pod:574
1018 msgid ""
1019 "A simple convention you can use to minimise the number of pseudomerges is to "
1020 "B<git debrebase conclude> only right before you upload or push to B<salsa."
1021 "debian.org>."
1022 msgstr ""
1023
1024 #. type: textblock
1025 #: ../dgit-maint-debrebase.7.pod:578
1026 msgid ""
1027 "It is possible, though much less convenient, to reduce the number of "
1028 "pseudomerges yet further.  We debrebase only (i) when importing a new "
1029 "release, and (ii) right before uploading.  Instead of editing the existing "
1030 "delta queue, you append fixup commits (and reversions of commits) that alter "
1031 "the upstream source to the required state.  You can push and pull to and "
1032 "from B<salsa.debian.org> during this.  Just before uploading, you debrebase, "
1033 "once, to tidy everything up."
1034 msgstr ""
1035
1036 #. type: =head2
1037 #: ../dgit-maint-debrebase.7.pod:586
1038 msgid "The debian/patches directory"
1039 msgstr ""
1040
1041 #. type: textblock
1042 #: ../dgit-maint-debrebase.7.pod:588
1043 msgid ""
1044 "In this workflow, I<debian/patches> is purely an output of git-"
1045 "debrebase(1).  You should not make changes there.  They will either cause "
1046 "trouble, or be ignored and overwritten by git-debrebase(1)."
1047 msgstr ""
1048
1049 #. type: textblock
1050 #: ../dgit-maint-debrebase.7.pod:593
1051 msgid ""
1052 "I<debian/patches> will often be out-of-date because git-debrebase(1)  will "
1053 "only regenerate it when it needs to.  So you should not rely on the "
1054 "information in that directory.  When preparing patches to forward upstream, "
1055 "you should use git-format-patch(1) on git commits, rather than sending files "
1056 "from I<debian/patches>."
1057 msgstr ""
1058
1059 #. type: =head2
1060 #: ../dgit-maint-debrebase.7.pod:599
1061 msgid "Upstream branches"
1062 msgstr ""
1063
1064 #. type: textblock
1065 #: ../dgit-maint-debrebase.7.pod:601
1066 msgid "In this workflow, we specify upstream tags rather than any branches."
1067 msgstr ""
1068
1069 #. type: textblock
1070 #: ../dgit-maint-debrebase.7.pod:603
1071 msgid ""
1072 "Except when (i) upstream releases only tarballs, (ii) we require DFSG "
1073 "filtering, or (iii) you also happen to be involved in upstream development, "
1074 "we do not maintain any local branch corresponding to upstream, except "
1075 "temporary branches used to prepare patches for forwarding, and the like."
1076 msgstr ""
1077
1078 #. type: textblock
1079 #: ../dgit-maint-debrebase.7.pod:609
1080 msgid ""
1081 "The idea here is that from Debian's point of view, upstream releases are "
1082 "immutable points in history.  We want to make sure that we are basing our "
1083 "Debian package on a properly identified upstream version, rather than some "
1084 "arbitrary commit on some branch.  Tags are more useful for this."
1085 msgstr ""
1086
1087 #. type: textblock
1088 #: ../dgit-maint-debrebase.7.pod:615
1089 msgid ""
1090 "Upstream's branches remain available as the git remote tracking branches for "
1091 "your upstream remote, e.g. I<remotes/upstream/master>."
1092 msgstr ""
1093
1094 #. type: =head2
1095 #: ../dgit-maint-debrebase.7.pod:618
1096 msgid "The first ever dgit push"
1097 msgstr ""
1098
1099 #. type: textblock
1100 #: ../dgit-maint-debrebase.7.pod:620
1101 msgid ""
1102 "If this is the first ever dgit push of the package, consider passing I<--"
1103 "deliberately-not-fast-forward> instead of I<--overwrite>.  This avoids "
1104 "introducing a new origin commit into your git history.  (This origin commit "
1105 "would represent the most recent non-dgit upload of the package, but this "
1106 "should already be represented in your git history.)"
1107 msgstr ""
1108
1109 #. type: =head2
1110 #: ../dgit-maint-debrebase.7.pod:626
1111 msgid "Inspecting the history"
1112 msgstr ""
1113
1114 #. type: textblock
1115 #: ../dgit-maint-debrebase.7.pod:628
1116 msgid ""
1117 "The git history made by git-debrebase can seem complicated.  Here are some "
1118 "suggestions for helpful invocations of gitk and git.  They can be adapted "
1119 "for other tools like tig(1), git-log(1), magit, etc."
1120 msgstr ""
1121
1122 #. type: textblock
1123 #: ../dgit-maint-debrebase.7.pod:632
1124 msgid "History of package in Debian, disregarding history from upstream:"
1125 msgstr ""
1126
1127 #. type: verbatim
1128 #: ../dgit-maint-debrebase.7.pod:636
1129 #, no-wrap
1130 msgid ""
1131 "    % gitk --first-parent\n"
1132 "\n"
1133 msgstr ""
1134
1135 #. type: textblock
1136 #: ../dgit-maint-debrebase.7.pod:638
1137 msgid "In a laundered branch, the delta queue is at the top."
1138 msgstr ""
1139
1140 #. type: textblock
1141 #: ../dgit-maint-debrebase.7.pod:642
1142 msgid "History of the packaging, excluding the delta queue:"
1143 msgstr ""
1144
1145 #. type: verbatim
1146 #: ../dgit-maint-debrebase.7.pod:644
1147 #, no-wrap
1148 msgid ""
1149 "    % gitk :/debian :!/debian/patches\n"
1150 "\n"
1151 msgstr ""
1152
1153 #. type: textblock
1154 #: ../dgit-maint-debrebase.7.pod:646
1155 msgid "Just the delta queue (i.e. Debian's changes to upstream):"
1156 msgstr ""
1157
1158 #. type: verbatim
1159 #: ../dgit-maint-debrebase.7.pod:648
1160 #, no-wrap
1161 msgid ""
1162 "    % gitk --first-parent -- :/ :!/debian\n"
1163 "\n"
1164 msgstr ""
1165
1166 #. type: textblock
1167 #: ../dgit-maint-debrebase.7.pod:650
1168 msgid "Full history including old versions of the delta queue:"
1169 msgstr ""
1170
1171 #. type: verbatim
1172 #: ../dgit-maint-debrebase.7.pod:654
1173 #, no-wrap
1174 msgid ""
1175 "    % gitk --date-order\n"
1176 "\n"
1177 msgstr ""
1178
1179 #. type: textblock
1180 #: ../dgit-maint-debrebase.7.pod:656
1181 msgid ""
1182 "The \"Declare fast forward\" commits you see have an older history (usually, "
1183 "an older delta queue) as one parent, and a newer history as the other.  --"
1184 "date-order makes gitk show the delta queues in the right order."
1185 msgstr ""
1186
1187 #. type: textblock
1188 #: ../dgit-maint-debrebase.7.pod:663
1189 msgid "Complete diff since the last upload:"
1190 msgstr ""
1191
1192 #. type: verbatim
1193 #: ../dgit-maint-debrebase.7.pod:667
1194 #, no-wrap
1195 msgid ""
1196 "    % git diff dgit/dgit/sid..HEAD -- :/ :!/debian/patches\n"
1197 "\n"
1198 msgstr ""
1199
1200 #. type: textblock
1201 #: ../dgit-maint-debrebase.7.pod:669
1202 msgid "This includes changes to upstream files."
1203 msgstr ""
1204
1205 #. type: textblock
1206 #: ../dgit-maint-debrebase.7.pod:673
1207 msgid "Interdiff of delta queue since last upload, if you really want it:"
1208 msgstr ""
1209
1210 #. type: verbatim
1211 #: ../dgit-maint-debrebase.7.pod:675
1212 #, no-wrap
1213 msgid ""
1214 "    % git debrebase make-patches\n"
1215 "    % git diff dgit/dgit/sid..HEAD -- debian/patches\n"
1216 "\n"
1217 msgstr ""
1218
1219 #. type: textblock
1220 #: ../dgit-maint-debrebase.7.pod:678
1221 msgid "And of course there is:"
1222 msgstr ""
1223
1224 #. type: verbatim
1225 #: ../dgit-maint-debrebase.7.pod:680
1226 #, no-wrap
1227 msgid ""
1228 "    % git debrebase status\n"
1229 "\n"
1230 msgstr ""
1231
1232 #. type: =head2
1233 #: ../dgit-maint-debrebase.7.pod:682
1234 msgid "Alternative ways to start a debrebase"
1235 msgstr ""
1236
1237 #. type: textblock
1238 #: ../dgit-maint-debrebase.7.pod:684
1239 msgid ""
1240 "Above we started an interactive debrebase by invoking git-debrebase(1)  like "
1241 "this:"
1242 msgstr ""
1243
1244 #. type: textblock
1245 #: ../dgit-maint-debrebase.7.pod:693
1246 msgid "It is also possible to perform a non-interactive rebase, like this:"
1247 msgstr ""
1248
1249 #. type: verbatim
1250 #: ../dgit-maint-debrebase.7.pod:697
1251 #, no-wrap
1252 msgid ""
1253 "    % git debrebase -- [git-rebase options...]\n"
1254 "\n"
1255 msgstr ""
1256
1257 #. type: textblock
1258 #: ../dgit-maint-debrebase.7.pod:702
1259 msgid ""
1260 "A third alternative is to have git-debrebase(1) shuffle all the Debian "
1261 "changes to the end of your branch, and then manipulate them yourself using "
1262 "git-rebase(1) directly.  For example,"
1263 msgstr ""
1264
1265 #. type: verbatim
1266 #: ../dgit-maint-debrebase.7.pod:708
1267 #, no-wrap
1268 msgid ""
1269 "    % git debrebase\n"
1270 "    % git rebase -i HEAD~5      # there are 4 Debian patches\n"
1271 "\n"
1272 msgstr ""
1273
1274 #. type: textblock
1275 #: ../dgit-maint-debrebase.7.pod:713
1276 msgid ""
1277 "If you take this approach, you should be very careful not to start the "
1278 "rebase too early, including before the most recent pseudomerge.  git-rebase "
1279 "without a base argument will often start the rebase too early, and should be "
1280 "avoided.  Run git-debrebase instead.  See also \"ILLEGAL OPERATIONS\" in git-"
1281 "debrebase(5)."
1282 msgstr ""
1283
1284 #. type: textblock
1285 #: ../dgit-maint-debrebase.7.pod:724
1286 msgid "dgit(1), dgit(7), git-debrebase(1), git-debrebase(5)"
1287 msgstr ""