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