po4a/dgit-maint-merge_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-09-06 23:47+0100\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: =head1
  20 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
  21 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
  22 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
  23 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
  24 #: ../dgit-maint-bpo.7.pod:1 ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
  25 #: ../git-debpush.1.pod:1
  26 #, no-wrap
  27 msgid "NAME"
  28 msgstr ""
  29
  30 #. type: =item
  31 #: ../dgit.1:286 ../dgit-maint-merge.7.pod:476
  32 #, no-wrap
  33 msgid "1."
  34 msgstr ""
  35
  36 #. type: =item
  37 #: ../dgit.1:287 ../dgit-maint-merge.7.pod:480
  38 #, no-wrap
  39 msgid "2."
  40 msgstr ""
  41
  42 #. type: =item
  43 #: ../dgit.1:288 ../dgit-maint-merge.7.pod:485
  44 #, no-wrap
  45 msgid "3."
  46 msgstr ""
  47
  48 #. type: =head1
  49 #: ../dgit.1:1568 ../dgit.7:23 ../dgit-user.7.pod:447
  50 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
  51 #: ../dgit-maint-merge.7.pod:521 ../dgit-maint-gbp.7.pod:136
  52 #: ../dgit-maint-debrebase.7.pod:778 ../dgit-downstream-dsc.7.pod:352
  53 #: ../dgit-sponsorship.7.pod:321 ../dgit-maint-bpo.7.pod:134
  54 #: ../git-debrebase.1.pod:633 ../git-debrebase.5.pod:678
  55 #: ../git-debpush.1.pod:254
  56 #, no-wrap
  57 msgid "SEE ALSO"
  58 msgstr ""
  59
  60 #. type: =head1
  61 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
  62 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
  63 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
  64 #: ../dgit-maint-bpo.7.pod:5 ../git-debrebase.5.pod:5
  65 msgid "INTRODUCTION"
  66 msgstr ""
  67
  68 #. type: textblock
  69 #: ../dgit-user.7.pod:449 ../dgit-maint-native.7.pod:128
  70 #: ../dgit-maint-merge.7.pod:523 ../dgit-maint-gbp.7.pod:138
  71 msgid "dgit(1), dgit(7)"
  72 msgstr ""
  73
  74 #. type: verbatim
  75 #: ../dgit-maint-native.7.pod:107 ../dgit-maint-merge.7.pod:514
  76 #, no-wrap
  77 msgid ""
  78 "    % dgit pull\n"
  79 "\n"
  80 msgstr ""
  81
  82 #. type: textblock
  83 #: ../dgit-maint-merge.7.pod:3
  84 msgid ""
  85 "dgit - tutorial for package maintainers, using a workflow centered around "
  86 "git-merge(1)"
  87 msgstr ""
  88
  89 #. type: textblock
  90 #: ../dgit-maint-merge.7.pod:7
  91 msgid ""
  92 "This document describes elements of a workflow for maintaining a non-native "
  93 "Debian package using B<dgit>.  The workflow makes the following opinionated "
  94 "assumptions:"
  95 msgstr ""
  96
  97 #. type: textblock
  98 #: ../dgit-maint-merge.7.pod:15
  99 msgid ""
 100 "Git histories should be the non-linear histories produced by git-merge(1), "
 101 "preserving all information about divergent development that was later "
 102 "brought together."
 103 msgstr ""
 104
 105 #. type: textblock
 106 #: ../dgit-maint-merge.7.pod:21
 107 msgid ""
 108 "Maintaining convenient and powerful git workflows takes priority over the "
 109 "usefulness of the raw Debian source package.  The Debian archive is thought "
 110 "of as an output format."
 111 msgstr ""
 112
 113 #. type: textblock
 114 #: ../dgit-maint-merge.7.pod:25
 115 msgid ""
 116 "For example, we don't spend time curating a series of quilt patches.  "
 117 "However, in straightforward cases, the information such a series would "
 118 "contain is readily available from B<dgit-repos>."
 119 msgstr ""
 120
 121 #. type: textblock
 122 #: ../dgit-maint-merge.7.pod:33
 123 msgid ""
 124 "It is more important to have the Debian package's git history be a "
 125 "descendent of upstream's git history than to use exactly the orig.tar that "
 126 "upstream makes available for download."
 127 msgstr ""
 128
 129 #. type: textblock
 130 #: ../dgit-maint-merge.7.pod:39
 131 msgid ""
 132 "This workflow is less suitable for some packages.  When the Debian delta "
 133 "contains multiple pieces which interact, or which you aren't going to be "
 134 "able to upstream soon, it might be preferable to maintain the delta as a "
 135 "rebasing patch series.  For such a workflow see for example dgit-maint-"
 136 "debrebase(7) and dgit-maint-gbp(7)."
 137 msgstr ""
 138
 139 #. type: =head1
 140 #: ../dgit-maint-merge.7.pod:47 ../dgit-maint-debrebase.7.pod:61
 141 msgid "INITIAL DEBIANISATION"
 142 msgstr ""
 143
 144 #. type: textblock
 145 #: ../dgit-maint-merge.7.pod:49 ../dgit-maint-debrebase.7.pod:63
 146 msgid ""
 147 "This section explains how to start using this workflow with a new package.  "
 148 "It should be skipped when converting an existing package to this workflow."
 149 msgstr ""
 150
 151 #. type: =head3
 152 #: ../dgit-maint-merge.7.pod:53 ../dgit-maint-merge.7.pod:361
 153 #: ../dgit-maint-merge.7.pod:438 ../dgit-maint-debrebase.7.pod:67
 154 #: ../dgit-maint-debrebase.7.pod:352
 155 msgid "When upstream tags releases in git"
 156 msgstr ""
 157
 158 #. type: textblock
 159 #: ../dgit-maint-merge.7.pod:55 ../dgit-maint-debrebase.7.pod:69
 160 msgid ""
 161 "Suppose that the latest stable upstream release is 1.2.2, and this has been "
 162 "tagged '1.2.2' by upstream."
 163 msgstr ""
 164
 165 #. type: verbatim
 166 #: ../dgit-maint-merge.7.pod:60 ../dgit-maint-debrebase.7.pod:74
 167 #, no-wrap
 168 msgid ""
 169 "    % git clone -oupstream https://some.upstream/foo.git\n"
 170 "    % cd foo\n"
 171 "    % git verify-tag 1.2.2\n"
 172 "    % git reset --hard 1.2.2\n"
 173 "    % git branch --unset-upstream\n"
 174 "\n"
 175 msgstr ""
 176
 177 #. type: textblock
 178 #: ../dgit-maint-merge.7.pod:68
 179 msgid ""
 180 "The final command detaches your master branch from the upstream remote, so "
 181 "that git doesn't try to push anything there, or merge unreleased upstream "
 182 "commits.  If you want to maintain a copy of your packaging branch on B<salsa."
 183 "debian.org> in addition to B<dgit-repos>, you can do something like this:"
 184 msgstr ""
 185
 186 #. type: verbatim
 187 #: ../dgit-maint-merge.7.pod:76 ../dgit-maint-debrebase.7.pod:90
 188 #, no-wrap
 189 msgid ""
 190 "    % git remote add -f origin salsa.debian.org:Debian/foo.git\n"
 191 "    % git push --follow-tags -u origin master\n"
 192 "\n"
 193 msgstr ""
 194
 195 #. type: textblock
 196 #: ../dgit-maint-merge.7.pod:81
 197 msgid ""
 198 "Now go ahead and Debianise your package.  Just make commits on the master "
 199 "branch, adding things in the I<debian/> directory.  If you need to patch the "
 200 "upstream source, just make commits that change files outside of the I<debian/"
 201 "> directory.  It is best to separate commits that touch I<debian/> from "
 202 "commits that touch upstream source, so that the latter can be cherry-picked "
 203 "by upstream."
 204 msgstr ""
 205
 206 #. type: textblock
 207 #: ../dgit-maint-merge.7.pod:88
 208 msgid ""
 209 "Note that there is no need to maintain a separate 'upstream' branch, unless "
 210 "you also happen to be involved in upstream development.  We work with "
 211 "upstream tags rather than any branches, except when forwarding patches (see "
 212 "FORWARDING PATCHES UPSTREAM, below)."
 213 msgstr ""
 214
 215 #. type: textblock
 216 #: ../dgit-maint-merge.7.pod:93 ../dgit-maint-debrebase.7.pod:102
 217 msgid "Finally, you need an orig tarball:"
 218 msgstr ""
 219
 220 #. type: verbatim
 221 #: ../dgit-maint-merge.7.pod:97 ../dgit-maint-merge.7.pod:432
 222 #: ../dgit-maint-debrebase.7.pod:106 ../dgit-maint-debrebase.7.pod:419
 223 #, no-wrap
 224 msgid ""
 225 "    % git deborig\n"
 226 "\n"
 227 msgstr ""
 228
 229 #. type: textblock
 230 #: ../dgit-maint-merge.7.pod:101 ../dgit-maint-debrebase.7.pod:110
 231 msgid "See git-deborig(1) if this fails."
 232 msgstr ""
 233
 234 #. type: textblock
 235 #: ../dgit-maint-merge.7.pod:103 ../dgit-maint-debrebase.7.pod:112
 236 msgid ""
 237 "This tarball is ephemeral and easily regenerated, so we don't commit it "
 238 "anywhere (e.g. with tools like pristine-tar(1))."
 239 msgstr ""
 240
 241 #. type: =head3
 242 #: ../dgit-maint-merge.7.pod:106
 243 msgid "Verifying upstream's tarball releases"
 244 msgstr ""
 245
 246 #. type: textblock
 247 #: ../dgit-maint-merge.7.pod:110
 248 msgid ""
 249 "It can be a good idea to compare upstream's released tarballs with the "
 250 "release tags, at least for the first upload of the package.  If they are "
 251 "different, you might need to add some additional steps to your I<debian/"
 252 "rules>, such as running autotools."
 253 msgstr ""
 254
 255 #. type: textblock
 256 #: ../dgit-maint-merge.7.pod:115
 257 msgid ""
 258 "A convenient way to perform this check is to import the tarball as described "
 259 "in the following section, using a different value for 'upstream-tag', and "
 260 "then use git-diff(1) to compare the imported tarball to the release tag.  If "
 261 "they are the same, you can use upstream's tarball instead of running git-"
 262 "deborig(1)."
 263 msgstr ""
 264
 265 #. type: =head3
 266 #: ../dgit-maint-merge.7.pod:123 ../dgit-maint-debrebase.7.pod:137
 267 msgid "Using untagged upstream commits"
 268 msgstr ""
 269
 270 #. type: textblock
 271 #: ../dgit-maint-merge.7.pod:127 ../dgit-maint-debrebase.7.pod:141
 272 msgid ""
 273 "Sometimes upstream does not tag their releases, or you want to package an "
 274 "unreleased git snapshot.  In such a case you can create your own upstream "
 275 "release tag, of the form B<upstream/>I<ver>, where I<ver> is the upstream "
 276 "version you plan to put in I<debian/changelog>.  The B<upstream/> prefix "
 277 "ensures that your tag will not clash with any tags upstream later creates."
 278 msgstr ""
 279
 280 #. type: textblock
 281 #: ../dgit-maint-merge.7.pod:134 ../dgit-maint-debrebase.7.pod:148
 282 msgid ""
 283 "For example, suppose that the latest upstream release is 1.2.2 and you want "
 284 "to package git commit ab34c21 which was made on 2013-12-11.  A common "
 285 "convention is to use the upstream version number 1.2.2+git20131211.ab34c21 "
 286 "and so you could use"
 287 msgstr ""
 288
 289 #. type: verbatim
 290 #: ../dgit-maint-merge.7.pod:141 ../dgit-maint-debrebase.7.pod:155
 291 #, no-wrap
 292 msgid ""
 293 "    % git tag -s upstream/1.2.2+git20131211.ab34c21 ab34c21\n"
 294 "\n"
 295 msgstr ""
 296
 297 #. type: textblock
 298 #: ../dgit-maint-merge.7.pod:145 ../dgit-maint-debrebase.7.pod:159
 299 msgid "to obtain a release tag, and then proceed as above."
 300 msgstr ""
 301
 302 #. type: =head3
 303 #: ../dgit-maint-merge.7.pod:149 ../dgit-maint-merge.7.pod:373
 304 #: ../dgit-maint-merge.7.pod:463 ../dgit-maint-debrebase.7.pod:163
 305 #: ../dgit-maint-debrebase.7.pod:364
 306 msgid "When upstream releases only tarballs"
 307 msgstr ""
 308
 309 #. type: textblock
 310 #: ../dgit-maint-merge.7.pod:151
 311 msgid ""
 312 "We need a virtual upstream branch with virtual release tags.  gbp-import-"
 313 "orig(1) can manage this for us.  To begin"
 314 msgstr ""
 315
 316 #. type: verbatim
 317 #: ../dgit-maint-merge.7.pod:156 ../dgit-maint-debrebase.7.pod:171
 318 #, no-wrap
 319 msgid ""
 320 "    % mkdir foo\n"
 321 "    % cd foo\n"
 322 "    % git init\n"
 323 "\n"
 324 msgstr ""
 325
 326 #. type: textblock
 327 #: ../dgit-maint-merge.7.pod:162 ../dgit-maint-debrebase.7.pod:177
 328 msgid "Now create I<debian/gbp.conf>:"
 329 msgstr ""
 330
 331 #. type: verbatim
 332 #: ../dgit-maint-merge.7.pod:166 ../dgit-maint-debrebase.7.pod:181
 333 #, no-wrap
 334 msgid ""
 335 "    [DEFAULT]\n"
 336 "    upstream-branch = upstream\n"
 337 "    debian-branch = master\n"
 338 "    upstream-tag = %(version)s\n"
 339 "\n"
 340 msgstr ""
 341
 342 #. type: verbatim
 343 #: ../dgit-maint-merge.7.pod:171 ../dgit-maint-debrebase.7.pod:186
 344 #, no-wrap
 345 msgid ""
 346 "    sign-tags = True\n"
 347 "    pristine-tar = False\n"
 348 "    pristine-tar-commit = False\n"
 349 "\n"
 350 msgstr ""
 351
 352 #. type: verbatim
 353 #: ../dgit-maint-merge.7.pod:175 ../dgit-maint-debrebase.7.pod:190
 354 #, no-wrap
 355 msgid ""
 356 "    [import-orig]\n"
 357 "    merge-mode = merge\n"
 358 "\n"
 359 msgstr ""
 360
 361 #. type: textblock
 362 #: ../dgit-maint-merge.7.pod:180 ../dgit-maint-debrebase.7.pod:195
 363 msgid "gbp-import-orig(1) requires a pre-existing upstream branch:"
 364 msgstr ""
 365
 366 #. type: verbatim
 367 #: ../dgit-maint-merge.7.pod:184 ../dgit-maint-debrebase.7.pod:199
 368 #, no-wrap
 369 msgid ""
 370 "    % git add debian/gbp.conf && git commit -m \"create gbp.conf\"\n"
 371 "    % git checkout --orphan upstream\n"
 372 "    % git rm -rf .\n"
 373 "    % git commit --allow-empty -m \"initial, empty branch for upstream source\"\n"
 374 "    % git checkout -f master\n"
 375 "\n"
 376 msgstr ""
 377
 378 #. type: textblock
 379 #: ../dgit-maint-merge.7.pod:192 ../dgit-maint-debrebase.7.pod:207
 380 msgid "Then we can import the upstream version:"
 381 msgstr ""
 382
 383 #. type: verbatim
 384 #: ../dgit-maint-merge.7.pod:196 ../dgit-maint-debrebase.7.pod:211
 385 #, no-wrap
 386 msgid ""
 387 "    % gbp import-orig --merge-mode=replace ../foo_1.2.2.orig.tar.xz\n"
 388 "\n"
 389 msgstr ""
 390
 391 #. type: textblock
 392 #: ../dgit-maint-merge.7.pod:200 ../dgit-maint-debrebase.7.pod:215
 393 msgid ""
 394 "Our upstream branch cannot be pushed to B<dgit-repos>, but since we will "
 395 "need it whenever we import a new upstream version, we must push it "
 396 "somewhere.  The usual choice is B<salsa.debian.org>:"
 397 msgstr ""
 398
 399 #. type: verbatim
 400 #: ../dgit-maint-merge.7.pod:206 ../dgit-maint-debrebase.7.pod:221
 401 #, no-wrap
 402 msgid ""
 403 "    % git remote add -f origin salsa.debian.org:Debian/foo.git\n"
 404 "    % git push --follow-tags -u origin master upstream\n"
 405 "\n"
 406 msgstr ""
 407
 408 #. type: textblock
 409 #: ../dgit-maint-merge.7.pod:211
 410 msgid ""
 411 "You are now ready to proceed as above, making commits to both the upstream "
 412 "source and the I<debian/> directory."
 413 msgstr ""
 414
 415 #. type: =head1
 416 #: ../dgit-maint-merge.7.pod:214 ../dgit-maint-debrebase.7.pod:233
 417 msgid "CONVERTING AN EXISTING PACKAGE"
 418 msgstr ""
 419
 420 #. type: textblock
 421 #: ../dgit-maint-merge.7.pod:216 ../dgit-maint-debrebase.7.pod:235
 422 msgid ""
 423 "This section explains how to convert an existing Debian package to this "
 424 "workflow.  It should be skipped when debianising a new package."
 425 msgstr ""
 426
 427 #. type: =head2
 428 #: ../dgit-maint-merge.7.pod:219
 429 msgid "No existing git history"
 430 msgstr ""
 431
 432 #. type: verbatim
 433 #: ../dgit-maint-merge.7.pod:223
 434 #, no-wrap
 435 msgid ""
 436 "    % dgit clone foo\n"
 437 "    % cd foo\n"
 438 "    % git remote add -f upstream https://some.upstream/foo.git\n"
 439 "\n"
 440 msgstr ""
 441
 442 #. type: =head2
 443 #: ../dgit-maint-merge.7.pod:229
 444 msgid "Existing git history using another workflow"
 445 msgstr ""
 446
 447 #. type: textblock
 448 #: ../dgit-maint-merge.7.pod:231
 449 msgid ""
 450 "First, if you don't already have the git history locally, clone it, and "
 451 "obtain the corresponding orig.tar from the archive:"
 452 msgstr ""
 453
 454 #. type: verbatim
 455 #: ../dgit-maint-merge.7.pod:236
 456 #, no-wrap
 457 msgid ""
 458 "    % git clone git.debian.org:collab-maint/foo\n"
 459 "    % cd foo\n"
 460 "    % origtargz\n"
 461 "\n"
 462 msgstr ""
 463
 464 #. type: textblock
 465 #: ../dgit-maint-merge.7.pod:242
 466 msgid "Now dump any existing patch queue:"
 467 msgstr ""
 468
 469 #. type: verbatim
 470 #: ../dgit-maint-merge.7.pod:246
 471 #, no-wrap
 472 msgid ""
 473 "    % git rm -rf debian/patches\n"
 474 "    % git commit -m \"drop existing quilt patch queue\"\n"
 475 "\n"
 476 msgstr ""
 477
 478 #. type: textblock
 479 #: ../dgit-maint-merge.7.pod:251
 480 msgid "Then make new upstream tags available:"
 481 msgstr ""
 482
 483 #. type: verbatim
 484 #: ../dgit-maint-merge.7.pod:255 ../dgit-maint-debrebase.7.pod:266
 485 #, no-wrap
 486 msgid ""
 487 "    % git remote add -f upstream https://some.upstream/foo.git\n"
 488 "\n"
 489 msgstr ""
 490
 491 #. type: =for
 492 #: ../dgit-maint-merge.7.pod:259
 493 msgid "dgit-test dpkg-source-ignores begin"
 494 msgstr ""
 495
 496 #. type: textblock
 497 #: ../dgit-maint-merge.7.pod:261
 498 msgid ""
 499 "Now you simply need to ensure that your git HEAD is dgit-compatible, i.e., "
 500 "it is exactly what you would get if you ran B<dpkg-buildpackage -i'(?:^|/)\\."
 501 "git(?:/|$)' -I.git -S> and then unpacked the resultant source package."
 502 msgstr ""
 503
 504 #. type: =for
 505 #: ../dgit-maint-merge.7.pod:266
 506 msgid "dgit-test dpkg-source-ignores end"
 507 msgstr ""
 508
 509 #. type: textblock
 510 #: ../dgit-maint-merge.7.pod:268 ../dgit-maint-debrebase.7.pod:320
 511 msgid ""
 512 "To achieve this, you might need to delete I<debian/source/local-options>.  "
 513 "One way to have dgit check your progress is to run B<dgit build-source>."
 514 msgstr ""
 515
 516 #. type: textblock
 517 #: ../dgit-maint-merge.7.pod:272
 518 msgid ""
 519 "The first dgit push will require I<--overwrite>.  If this is the first ever "
 520 "dgit push of the package, consider passing I<--deliberately-not-fast-"
 521 "forward> instead of I<--overwrite>.  This avoids introducing a new origin "
 522 "commit into your git history.  (This origin commit would represent the most "
 523 "recent non-dgit upload of the package, but this should already be "
 524 "represented in your git history.)"
 525 msgstr ""
 526
 527 #. type: =head1
 528 #: ../dgit-maint-merge.7.pod:279
 529 msgid "SOURCE PACKAGE CONFIGURATION"
 530 msgstr ""
 531
 532 #. type: =head2
 533 #: ../dgit-maint-merge.7.pod:281
 534 msgid "debian/source/options"
 535 msgstr ""
 536
 537 #. type: textblock
 538 #: ../dgit-maint-merge.7.pod:283
 539 msgid ""
 540 "We set some source package options such that dgit can transparently handle "
 541 "the \"dropping\" and \"refreshing\" of changes to the upstream source:"
 542 msgstr ""
 543
 544 #. type: verbatim
 545 #: ../dgit-maint-merge.7.pod:289
 546 #, no-wrap
 547 msgid ""
 548 "    single-debian-patch\n"
 549 "    auto-commit\n"
 550 "\n"
 551 msgstr ""
 552
 553 #. type: textblock
 554 #: ../dgit-maint-merge.7.pod:294
 555 msgid ""
 556 "You don't need to create this file if you are using the version 1.0 source "
 557 "package format."
 558 msgstr ""
 559
 560 #. type: =head2
 561 #: ../dgit-maint-merge.7.pod:297
 562 msgid "Sample text for debian/source/patch-header"
 563 msgstr ""
 564
 565 #. type: textblock
 566 #: ../dgit-maint-merge.7.pod:299
 567 msgid ""
 568 "It is a good idea to explain how a user can obtain a breakdown of the "
 569 "changes to the upstream source:"
 570 msgstr ""
 571
 572 #. type: textblock
 573 #: ../dgit-maint-merge.7.pod:304
 574 msgid ""
 575 "The Debian packaging of foo is maintained in git, using the merging workflow "
 576 "described in dgit-maint-merge(7).  There isn't a patch queue that can be "
 577 "represented as a quilt series."
 578 msgstr ""
 579
 580 #. type: textblock
 581 #: ../dgit-maint-merge.7.pod:308
 582 msgid ""
 583 "A detailed breakdown of the changes is available from their canonical "
 584 "representation - git commits in the packaging repository.  For example, to "
 585 "see the changes made by the Debian maintainer in the first upload of "
 586 "upstream version 1.2.3, you could use:"
 587 msgstr ""
 588
 589 #. type: verbatim
 590 #: ../dgit-maint-merge.7.pod:316
 591 #, no-wrap
 592 msgid ""
 593 "    % git clone https://git.dgit.debian.org/foo\n"
 594 "    % cd foo\n"
 595 "    % git log --oneline 1.2.3..debian/1.2.3-1 -- . ':!debian'\n"
 596 "\n"
 597 msgstr ""
 598
 599 #. type: textblock
 600 #: ../dgit-maint-merge.7.pod:322
 601 msgid ""
 602 "(If you have dgit, use `dgit clone foo`, rather than plain `git clone`.)"
 603 msgstr ""
 604
 605 #. type: textblock
 606 #: ../dgit-maint-merge.7.pod:325
 607 msgid "A single combined diff, containing all the changes, follows."
 608 msgstr ""
 609
 610 #. type: textblock
 611 #: ../dgit-maint-merge.7.pod:329
 612 msgid ""
 613 "If you are using the version 1.0 source package format, this text should be "
 614 "added to README.source instead.  The version 1.0 source package format "
 615 "ignores debian/source/patch-header."
 616 msgstr ""
 617
 618 #. type: textblock
 619 #: ../dgit-maint-merge.7.pod:333
 620 msgid ""
 621 "If you're using the version 3.0 (quilt) source package format, you could add "
 622 "this text to README.source instead of debian/source/patch-header, but this "
 623 "might distract from more important information present in README.source."
 624 msgstr ""
 625
 626 #. type: =head1
 627 #: ../dgit-maint-merge.7.pod:338 ../dgit-maint-debrebase.7.pod:472
 628 msgid "BUILDING AND UPLOADING"
 629 msgstr ""
 630
 631 #. type: textblock
 632 #: ../dgit-maint-merge.7.pod:340
 633 msgid ""
 634 "Use B<dgit build>, B<dgit sbuild>, B<dgit pbuilder>, B<dgit cowbuilder>, "
 635 "B<dgit push-source>, and B<dgit push> as detailed in dgit(1).  If any "
 636 "command fails, dgit will provide a carefully-worded error message explaining "
 637 "what you should do.  If it's not clear, file a bug against dgit.  Remember "
 638 "to pass I<--new> for the first upload."
 639 msgstr ""
 640
 641 #. type: textblock
 642 #: ../dgit-maint-merge.7.pod:346
 643 msgid ""
 644 "As an alternative to B<dgit build> and friends, you can use a tool like "
 645 "gitpkg(1).  This works because like dgit, gitpkg(1) enforces that HEAD has "
 646 "exactly the contents of the source package.  gitpkg(1) is highly "
 647 "configurable, and one dgit user reports using it to produce and test "
 648 "multiple source packages, from different branches corresponding to each of "
 649 "the current Debian suites."
 650 msgstr ""
 651
 652 #. type: textblock
 653 #: ../dgit-maint-merge.7.pod:353
 654 msgid ""
 655 "If you want to skip dgit's checks while iterating on a problem with the "
 656 "package build (for example, you don't want to commit your changes to git), "
 657 "you can just run dpkg-buildpackage(1) or debuild(1) instead."
 658 msgstr ""
 659
 660 #. type: =head1
 661 #: ../dgit-maint-merge.7.pod:357
 662 msgid "NEW UPSTREAM RELEASES"
 663 msgstr ""
 664
 665 #. type: =head2
 666 #: ../dgit-maint-merge.7.pod:359 ../dgit-maint-debrebase.7.pod:350
 667 msgid "Obtaining the release"
 668 msgstr ""
 669
 670 #. type: verbatim
 671 #: ../dgit-maint-merge.7.pod:365 ../dgit-maint-debrebase.7.pod:356
 672 #, no-wrap
 673 msgid ""
 674 "    % git fetch --all --tags\n"
 675 "\n"
 676 msgstr ""
 677
 678 #. type: textblock
 679 #: ../dgit-maint-merge.7.pod:369 ../dgit-maint-debrebase.7.pod:360
 680 msgid ""
 681 "If you want to package an untagged upstream commit (because upstream does "
 682 "not tag releases or because you want to package an upstream development "
 683 "snapshot), see \"Using untagged upstream commits\" above."
 684 msgstr ""
 685
 686 #. type: textblock
 687 #: ../dgit-maint-merge.7.pod:375 ../dgit-maint-debrebase.7.pod:366
 688 msgid ""
 689 "You will need the I<debian/gbp.conf> from \"When upstream releases only "
 690 "tarballs\", above.  You will also need your upstream branch.  Above, we "
 691 "pushed this to B<salsa.debian.org>.  You will need to clone or fetch from "
 692 "there, instead of relying on B<dgit clone>/B<dgit fetch> alone."
 693 msgstr ""
 694
 695 #. type: textblock
 696 #: ../dgit-maint-merge.7.pod:380 ../dgit-maint-debrebase.7.pod:371
 697 msgid "Then, either"
 698 msgstr ""
 699
 700 #. type: verbatim
 701 #: ../dgit-maint-merge.7.pod:384 ../dgit-maint-debrebase.7.pod:375
 702 #, no-wrap
 703 msgid ""
 704 "    % gbp import-orig --no-merge ../foo_1.2.3.orig.tar.xz\n"
 705 "\n"
 706 msgstr ""
 707
 708 #. type: textblock
 709 #: ../dgit-maint-merge.7.pod:388 ../dgit-maint-debrebase.7.pod:379
 710 msgid "or if you have a working watch file"
 711 msgstr ""
 712
 713 #. type: verbatim
 714 #: ../dgit-maint-merge.7.pod:392 ../dgit-maint-debrebase.7.pod:383
 715 #, no-wrap
 716 msgid ""
 717 "    % gbp import-orig --no-merge --uscan\n"
 718 "\n"
 719 msgstr ""
 720
 721 #. type: =head2
 722 #: ../dgit-maint-merge.7.pod:396
 723 msgid "Reviewing & merging the release"
 724 msgstr ""
 725
 726 #. type: textblock
 727 #: ../dgit-maint-merge.7.pod:398
 728 msgid ""
 729 "It's a good idea to preview the merge of the new upstream release.  First, "
 730 "just check for any new or deleted files that may need accounting for in your "
 731 "copyright file:"
 732 msgstr ""
 733
 734 #. type: verbatim
 735 #: ../dgit-maint-merge.7.pod:404
 736 #, no-wrap
 737 msgid ""
 738 "    % git diff --name-status --diff-filter=ADR master..1.2.3 -- . ':!debian'\n"
 739 "\n"
 740 msgstr ""
 741
 742 #. type: textblock
 743 #: ../dgit-maint-merge.7.pod:408
 744 msgid "You can then review the full merge diff:"
 745 msgstr ""
 746
 747 #. type: verbatim
 748 #: ../dgit-maint-merge.7.pod:412
 749 #, no-wrap
 750 msgid ""
 751 "    % git merge-tree `git merge-base master 1.2.3` master 1.2.3 | $PAGER\n"
 752 "\n"
 753 msgstr ""
 754
 755 #. type: textblock
 756 #: ../dgit-maint-merge.7.pod:416
 757 msgid "Once you're satisfied with what will be merged, update your package:"
 758 msgstr ""
 759
 760 #. type: verbatim
 761 #: ../dgit-maint-merge.7.pod:420
 762 #, no-wrap
 763 msgid ""
 764 "    % git merge 1.2.3\n"
 765 "    % dch -v1.2.3-1 New upstream release.\n"
 766 "    % git add debian/changelog && git commit -m changelog\n"
 767 "\n"
 768 msgstr ""
 769
 770 #. type: textblock
 771 #: ../dgit-maint-merge.7.pod:426 ../dgit-maint-debrebase.7.pod:413
 772 msgid ""
 773 "If you obtained a tarball from upstream, you are ready to try a build.  If "
 774 "you merged a git tag from upstream, you will first need to generate a "
 775 "tarball:"
 776 msgstr ""
 777
 778 #. type: =head1
 779 #: ../dgit-maint-merge.7.pod:436 ../dgit-maint-debrebase.7.pod:503
 780 msgid "HANDLING DFSG-NON-FREE MATERIAL"
 781 msgstr ""
 782
 783 #. type: textblock
 784 #: ../dgit-maint-merge.7.pod:440
 785 msgid "We create a DFSG-clean tag to merge to master:"
 786 msgstr ""
 787
 788 #. type: verbatim
 789 #: ../dgit-maint-merge.7.pod:444
 790 #, no-wrap
 791 msgid ""
 792 "    % git checkout -b pre-dfsg 1.2.3\n"
 793 "    % git rm evil.bin\n"
 794 "    % git commit -m \"upstream version 1.2.3 DFSG-cleaned\"\n"
 795 "    % git tag -s 1.2.3+dfsg\n"
 796 "    % git checkout master\n"
 797 "    % git branch -D pre-dfsg\n"
 798 "\n"
 799 msgstr ""
 800
 801 #. type: textblock
 802 #: ../dgit-maint-merge.7.pod:453
 803 msgid ""
 804 "Before merging the new 1.2.3+dfsg tag to master, you should first determine "
 805 "whether it would be legally dangerous for the non-free material to be "
 806 "publicly accessible in the git history on B<dgit-repos>."
 807 msgstr ""
 808
 809 #. type: textblock
 810 #: ../dgit-maint-merge.7.pod:458
 811 msgid ""
 812 "If it would be dangerous, there is a big problem; in this case please "
 813 "consult your archive administrators (for Debian this is the dgit "
 814 "administrator dgit-owner@debian.org and the ftpmasters ftpmaster@ftp-master."
 815 "debian.org)."
 816 msgstr ""
 817
 818 #. type: textblock
 819 #: ../dgit-maint-merge.7.pod:465 ../dgit-maint-debrebase.7.pod:577
 820 msgid ""
 821 "The easiest way to handle this is to add a B<Files-Excluded> field to "
 822 "I<debian/copyright>, and a B<uversionmangle> setting in I<debian/watch>.  "
 823 "See uscan(1).  Alternatively, see the I<--filter> option detailed in gbp-"
 824 "import-orig(1)."
 825 msgstr ""
 826
 827 #. type: =head1
 828 #: ../dgit-maint-merge.7.pod:470
 829 msgid "FORWARDING PATCHES UPSTREAM"
 830 msgstr ""
 831
 832 #. type: textblock
 833 #: ../dgit-maint-merge.7.pod:472
 834 msgid "The basic steps are:"
 835 msgstr ""
 836
 837 #. type: textblock
 838 #: ../dgit-maint-merge.7.pod:478
 839 msgid "Create a new branch based off upstream's master branch."
 840 msgstr ""
 841
 842 #. type: textblock
 843 #: ../dgit-maint-merge.7.pod:482
 844 msgid ""
 845 "git-cherry-pick(1) commits from your master branch onto your new branch."
 846 msgstr ""
 847
 848 #. type: textblock
 849 #: ../dgit-maint-merge.7.pod:487
 850 msgid ""
 851 "Push the branch somewhere and ask upstream to merge it, or use git-format-"
 852 "patch(1) or git-request-pull(1)."
 853 msgstr ""
 854
 855 #. type: textblock
 856 #: ../dgit-maint-merge.7.pod:492
 857 msgid "For example (and it is only an example):"
 858 msgstr ""
 859
 860 #. type: verbatim
 861 #: ../dgit-maint-merge.7.pod:496
 862 #, no-wrap
 863 msgid ""
 864 "    % # fork foo.git on GitHub\n"
 865 "    % git remote add -f fork git@github.com:spwhitton/foo.git\n"
 866 "    % git checkout -b fix-error upstream/master\n"
 867 "    % git config branch.fix-error.pushRemote fork\n"
 868 "    % git cherry-pick master^2\n"
 869 "    % git push\n"
 870 "    % # submit pull request on GitHub\n"
 871 "\n"
 872 msgstr ""
 873
 874 #. type: textblock
 875 #: ../dgit-maint-merge.7.pod:506
 876 msgid ""
 877 "Note that when you merge an upstream release containing your forwarded "
 878 "patches, git and dgit will transparently handle \"dropping\" the patches "
 879 "that have been forwarded, \"retaining\" the ones that haven't."
 880 msgstr ""
 881
 882 #. type: =head1
 883 #: ../dgit-maint-merge.7.pod:510 ../dgit-maint-gbp.7.pod:130
 884 #: ../dgit-maint-debrebase.7.pod:582
 885 msgid "INCORPORATING NMUS"
 886 msgstr ""
 887
 888 #. type: textblock
 889 #: ../dgit-maint-merge.7.pod:518
 890 msgid ""
 891 "Alternatively, you can apply the NMU diff to your repository.  The next push "
 892 "will then require I<--overwrite>."
 893 msgstr ""
 894
 895 #. type: =head1
 896 #: ../dgit-maint-merge.7.pod:525 ../dgit-maint-gbp.7.pod:140
 897 #: ../dgit-maint-debrebase.7.pod:782 ../dgit-maint-bpo.7.pod:138
 898 #: ../git-debpush.1.pod:259
 899 msgid "AUTHOR"
 900 msgstr ""
 901
 902 #. type: textblock
 903 #: ../dgit-maint-merge.7.pod:527 ../dgit-maint-debrebase.7.pod:784
 904 msgid ""
 905 "This tutorial was written and is maintained by Sean Whitton "
 906 "<spwhitton@spwhitton.name>.  It contains contributions from other dgit "
 907 "contributors too - see the dgit copyright file."
 908 msgstr ""