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