po4a/dgit-user_7.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2018-10-04 01:04+0100\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: =head1
  20 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
  21 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
  22 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
  23 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
  24 #: ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
  25 #, no-wrap
  26 msgid "NAME"
  27 msgstr ""
  28
  29 #. type: =head1
  30 #: ../dgit.1:1394 ../dgit.7:23 ../dgit-user.7.pod:447
  31 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
  32 #: ../dgit-maint-merge.7.pod:491 ../dgit-maint-gbp.7.pod:136
  33 #: ../dgit-maint-debrebase.7.pod:722 ../dgit-downstream-dsc.7.pod:352
  34 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:601
  35 #: ../git-debrebase.5.pod:678
  36 #, no-wrap
  37 msgid "SEE ALSO"
  38 msgstr ""
  39
  40 #. type: =head1
  41 #: ../dgit.7:4 ../dgit-user.7.pod:27 ../dgit-nmu-simple.7.pod:35
  42 #, no-wrap
  43 msgid "SUMMARY"
  44 msgstr ""
  45
  46 #. type: textblock
  47 #: ../dgit-user.7.pod:3
  48 msgid "dgit-user - making and sharing changes to Debian packages, with git"
  49 msgstr ""
  50
  51 #. type: =head1
  52 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
  53 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
  54 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
  55 #: ../git-debrebase.1.pod:10 ../git-debrebase.5.pod:5
  56 msgid "INTRODUCTION"
  57 msgstr ""
  58
  59 #. type: textblock
  60 #: ../dgit-user.7.pod:7
  61 msgid ""
  62 "dgit lets you fetch the source code to every package on your system as if "
  63 "your distro used git to maintain all of it."
  64 msgstr ""
  65
  66 #. type: textblock
  67 #: ../dgit-user.7.pod:11
  68 msgid ""
  69 "You can then edit it, build updated binary packages (.debs)  and install and "
  70 "run them.  You can also share your work with others."
  71 msgstr ""
  72
  73 #. type: textblock
  74 #: ../dgit-user.7.pod:16
  75 msgid ""
  76 "This tutorial gives some recipes and hints for this.  It assumes you have "
  77 "basic familiarity with git.  It does not assume any initial familiarity with "
  78 "Debian's packaging processes."
  79 msgstr ""
  80
  81 #. type: textblock
  82 #: ../dgit-user.7.pod:21
  83 msgid ""
  84 "If you are a package maintainer within Debian; a DM or DD; and/or a sponsee: "
  85 "this tutorial is not for you.  Try L<dgit-nmu-simple(7)>, L<dgit-maint-"
  86 "*(7)>, or L<dgit(1)> and L<dgit(7)>."
  87 msgstr ""
  88
  89 #. type: textblock
  90 #: ../dgit-user.7.pod:29
  91 msgid "(These runes will be discussed later.)"
  92 msgstr ""
  93
  94 #. type: verbatim
  95 #: ../dgit-user.7.pod:33
  96 #, no-wrap
  97 msgid ""
  98 "    % dgit clone glibc jessie,-security\n"
  99 "    % cd glibc\n"
 100 "    % curl 'https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=28250;mbox=yes;msg=89' | patch -p1 -u\n"
 101 "    % git commit -a -m 'Fix libc lost output bug'\n"
 102 "    % gbp dch -S --since=dgit/dgit/sid --ignore-branch --commit\n"
 103 "    % mk-build-deps --root-cmd=sudo --install\n"
 104 "    % dpkg-buildpackage -uc -b\n"
 105 "    % sudo dpkg -i ../libc6_*.deb\n"
 106 "\n"
 107 msgstr ""
 108
 109 #. type: textblock
 110 #: ../dgit-user.7.pod:44
 111 msgid "Occasionally:"
 112 msgstr ""
 113
 114 #. type: verbatim
 115 #: ../dgit-user.7.pod:48 ../dgit-user.7.pod:242
 116 #, no-wrap
 117 msgid ""
 118 "    % git clean -xdf\n"
 119 "    % git reset --hard\n"
 120 "\n"
 121 msgstr ""
 122
 123 #. type: textblock
 124 #: ../dgit-user.7.pod:53
 125 msgid "Later:"
 126 msgstr ""
 127
 128 #. type: verbatim
 129 #: ../dgit-user.7.pod:57
 130 #, no-wrap
 131 msgid ""
 132 "    % cd glibc\n"
 133 "    % dgit pull jessie,-security\n"
 134 "    % gbp dch -S --since=dgit/dgit/sid --ignore-branch --commit\n"
 135 "    % dpkg-buildpackage -uc -b\n"
 136 "    % sudo dpkg -i ../libc6_*.deb\n"
 137 "\n"
 138 msgstr ""
 139
 140 #. type: =head1
 141 #: ../dgit-user.7.pod:65
 142 msgid "FINDING THE RIGHT SOURCE CODE - DGIT CLONE"
 143 msgstr ""
 144
 145 #. type: verbatim
 146 #: ../dgit-user.7.pod:69
 147 #, no-wrap
 148 msgid ""
 149 "    % dgit clone glibc jessie,-security\n"
 150 "    % cd glibc\n"
 151 "\n"
 152 msgstr ""
 153
 154 #. type: textblock
 155 #: ../dgit-user.7.pod:74
 156 msgid ""
 157 "dgit clone needs to be told the source package name (which might be "
 158 "different to the binary package name, which was the name you passed to \"apt-"
 159 "get install\")  and the codename or alias of the Debian release (this is "
 160 "called the \"suite\")."
 161 msgstr ""
 162
 163 #. type: =head2
 164 #: ../dgit-user.7.pod:80
 165 msgid "Finding the source package name"
 166 msgstr ""
 167
 168 #. type: textblock
 169 #: ../dgit-user.7.pod:82
 170 msgid ""
 171 "For many packages, the source package name is obvious.  Otherwise, if you "
 172 "know a file that's in the package, you can look it up with dpkg:"
 173 msgstr ""
 174
 175 #. type: verbatim
 176 #: ../dgit-user.7.pod:88
 177 #, no-wrap
 178 msgid ""
 179 "    % dpkg -S /lib/i386-linux-gnu/libc.so.6 \n"
 180 "    libc6:i386: /lib/i386-linux-gnu/libc.so.6\n"
 181 "    % dpkg -s libc6:i386\n"
 182 "    Package: libc6\n"
 183 "    Status: install ok installed\n"
 184 "    ...\n"
 185 "    Source: glibc\n"
 186 "\n"
 187 msgstr ""
 188
 189 #. type: verbatim
 190 #: ../dgit-user.7.pod:98
 191 #, no-wrap
 192 msgid ""
 193 "(In this example,\n"
 194 "libc6 is a \"multi-arch: allowed\" package,\n"
 195 " which means that it exists in several different builds\n"
 196 " for different architectures.\n"
 197 "That's where C<:i386> comes from.)\n"
 198 "\n"
 199 msgstr ""
 200
 201 #. type: =head2
 202 #: ../dgit-user.7.pod:104
 203 msgid "Finding the Debian release (the \"suite\")"
 204 msgstr ""
 205
 206 #. type: textblock
 207 #: ../dgit-user.7.pod:106
 208 msgid ""
 209 "Internally, Debian (and derived) distros normally refer to their releases by "
 210 "codenames.  Debian also has aliases which refer to the current stable "
 211 "release etc.  So for example, at the time of writing Debian C<jessie> "
 212 "(Debian 8) is Debian C<stable>; and the current version of Ubuntu is "
 213 "C<yakkety> (Yakkety Yak, 16.10).  You can specify either the codename "
 214 "C<jessie> or the alias C<stable>.  If you don't say, you get C<sid>, which "
 215 "is Debian C<unstable> - the main work-in progress branch."
 216 msgstr ""
 217
 218 #. type: textblock
 219 #: ../dgit-user.7.pod:117
 220 msgid "If you don't know what you're running, try this:"
 221 msgstr ""
 222
 223 #. type: verbatim
 224 #: ../dgit-user.7.pod:121
 225 #, no-wrap
 226 msgid ""
 227 "    % grep '^deb' /etc/apt/sources.list\n"
 228 "    deb http://the.earth.li/debian/ jessie main non-free contrib\n"
 229 "    ...\n"
 230 "    %\n"
 231 "\n"
 232 msgstr ""
 233
 234 #. type: textblock
 235 #: ../dgit-user.7.pod:128
 236 msgid ""
 237 "For Debian, you should add C<,-security> to the end of the suite name, "
 238 "unless you're on unstable or testing.  Hence, in our example C<jessie> "
 239 "becomes C<jessie,-security>.  (Yes, with a comma.)"
 240 msgstr ""
 241
 242 #. type: =head1
 243 #: ../dgit-user.7.pod:135
 244 msgid "WHAT DGIT CLONE PRODUCES"
 245 msgstr ""
 246
 247 #. type: =head2
 248 #: ../dgit-user.7.pod:137
 249 msgid "What branches are there"
 250 msgstr ""
 251
 252 #. type: textblock
 253 #: ../dgit-user.7.pod:139
 254 msgid ""
 255 "dgit clone will give you a new working tree, and arrange for you to be on a "
 256 "branch named like C<dgit/jessie,-security> (yes, with a comma in the branch "
 257 "name)."
 258 msgstr ""
 259
 260 #. type: textblock
 261 #: ../dgit-user.7.pod:143
 262 msgid ""
 263 "For each release (like C<jessie>)  there is a tracking branch for the "
 264 "contents of the archive, called C<remotes/dgit/dgit/jessie> (and similarly "
 265 "for other suites).  This can be updated with C<dgit fetch jessie>.  This, "
 266 "the I<remote suite branch>, is synthesized by your local copy of dgit.  It "
 267 "is fast forwarding."
 268 msgstr ""
 269
 270 #. type: textblock
 271 #: ../dgit-user.7.pod:152
 272 msgid ""
 273 "Debian separates out the security updates, into C<*-security>.  Telling dgit "
 274 "C<jessie,-security> means that it should include any updates available in "
 275 "C<jessie-security>.  The comma notation is a request to dgit to track "
 276 "jessie, or jessie-security if there is an update for the package there."
 277 msgstr ""
 278
 279 #. type: textblock
 280 #: ../dgit-user.7.pod:158
 281 msgid ""
 282 "(You can also dgit fetch in a tree that wasn't made by dgit clone.  If "
 283 "there's no C<debian/changelog> you'll have to supply a C<-p>I<package> "
 284 "option to dgit fetch.)"
 285 msgstr ""
 286
 287 #. type: =head2
 288 #: ../dgit-user.7.pod:162
 289 msgid "What kind of source tree do you get"
 290 msgstr ""
 291
 292 #. type: textblock
 293 #: ../dgit-user.7.pod:164
 294 msgid ""
 295 "If the Debian package is based on some upstream release, the code layout "
 296 "should be like the upstream version.  You should find C<git grep> helpful to "
 297 "find where to edit."
 298 msgstr ""
 299
 300 #. type: textblock
 301 #: ../dgit-user.7.pod:168
 302 msgid ""
 303 "The package's Debian metadata and the scripts for building binary packages "
 304 "are under C<debian/>.  C<debian/control>, C<debian/changelog> and C<debian/"
 305 "rules> are the starting points.  The Debian Policy Manual has most of the in-"
 306 "depth technical details."
 307 msgstr ""
 308
 309 #. type: textblock
 310 #: ../dgit-user.7.pod:175
 311 msgid ""
 312 "For many Debian packages, there will also be some things in C<debian/patches/"
 313 ">.  It is best to ignore these.  Insofar as they are relevant the changes "
 314 "there will have been applied to the actual files, probably by means of "
 315 "actual comments in the git history.  The contents of debian/patches are "
 316 "ignored when building binaries from dgitish git branches."
 317 msgstr ""
 318
 319 #. type: textblock
 320 #: ../dgit-user.7.pod:185
 321 msgid ""
 322 "(For Debian afficionados: the git trees that come out of dgit are \"patches-"
 323 "applied packaging branches without a .pc directory\".)"
 324 msgstr ""
 325
 326 #. type: =head2
 327 #: ../dgit-user.7.pod:190
 328 msgid "What kind of history you get"
 329 msgstr ""
 330
 331 #. type: textblock
 332 #: ../dgit-user.7.pod:192
 333 msgid ""
 334 "If you're lucky, the history will be a version of, or based on, the Debian "
 335 "maintainer's own git history, or upstream's git history."
 336 msgstr ""
 337
 338 #. type: textblock
 339 #: ../dgit-user.7.pod:197
 340 msgid ""
 341 "But for many packages the real git history does not exist, or has not been "
 342 "published in a dgitish form.  So you may find that the history is a rather "
 343 "short history invented by dgit."
 344 msgstr ""
 345
 346 #. type: textblock
 347 #: ../dgit-user.7.pod:203
 348 msgid ""
 349 "dgit histories often contain automatically-generated commits, including "
 350 "commits which make no changes but just serve to make a rebasing branch fast-"
 351 "forward.  This is particularly true of combining branches like C<jessie,-"
 352 "security>."
 353 msgstr ""
 354
 355 #. type: textblock
 356 #: ../dgit-user.7.pod:210
 357 msgid ""
 358 "If the package maintainer is using git then after dgit clone you may find "
 359 "that there is a useful C<vcs-git> remote referring to the Debian package "
 360 "maintainer's repository for the package.  You can see what's there with "
 361 "C<git fetch vcs-git>.  But use what you find there with care: Debian "
 362 "maintainers' git repositories often have contents which are very confusing "
 363 "and idiosyncratic.  In particular, you may need to manually apply the "
 364 "patches that are in debian/patches before you do anything else!"
 365 msgstr ""
 366
 367 #. type: =head1
 368 #: ../dgit-user.7.pod:222 ../dgit-maint-gbp.7.pod:56
 369 msgid "BUILDING"
 370 msgstr ""
 371
 372 #. type: =head2
 373 #: ../dgit-user.7.pod:224
 374 msgid "Always commit before building"
 375 msgstr ""
 376
 377 #. type: verbatim
 378 #: ../dgit-user.7.pod:228
 379 #, no-wrap
 380 msgid ""
 381 "    % wget 'https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=28250;mbox=yes;msg=89' | patch -p1 -u\n"
 382 "    % git commit -a -m 'Fix libc lost output bug'\n"
 383 "\n"
 384 msgstr ""
 385
 386 #. type: textblock
 387 #: ../dgit-user.7.pod:233
 388 msgid ""
 389 "Debian package builds are often quite messy: they may modify files which are "
 390 "also committed to git, or leave outputs and temporary files not covered by "
 391 "C<.gitignore>."
 392 msgstr ""
 393
 394 #. type: textblock
 395 #: ../dgit-user.7.pod:237
 396 msgid "If you always commit, you can use"
 397 msgstr ""
 398
 399 #. type: textblock
 400 #: ../dgit-user.7.pod:247
 401 msgid ""
 402 "to tidy up after a build.  (If you forgot to commit, don't use those "
 403 "commands; instead, you may find that you can use C<git add -p> to help "
 404 "commit what you actually wanted to keep.)"
 405 msgstr ""
 406
 407 #. type: textblock
 408 #: ../dgit-user.7.pod:252
 409 msgid ""
 410 "These are destructive commands which delete all new files (so you B<must> "
 411 "remember to say C<git add>)  and throw away edits to every file (so you "
 412 "B<must> remember to commit)."
 413 msgstr ""
 414
 415 #. type: =head2
 416 #: ../dgit-user.7.pod:257
 417 msgid "Update the changelog (at least once) before building"
 418 msgstr ""
 419
 420 #. type: verbatim
 421 #: ../dgit-user.7.pod:261
 422 #, no-wrap
 423 msgid ""
 424 "    % gbp dch -S --since=dgit/dgit/sid --ignore-branch --commit\n"
 425 "\n"
 426 msgstr ""
 427
 428 #. type: textblock
 429 #: ../dgit-user.7.pod:265
 430 msgid ""
 431 "The binaries you build will have a version number which ultimately comes "
 432 "from the C<debian/changelog>.  You want to be able to tell your binaries "
 433 "apart from your distro's."
 434 msgstr ""
 435
 436 #. type: textblock
 437 #: ../dgit-user.7.pod:270
 438 msgid ""
 439 "So you should update C<debian/changelog> to add a new stanza at the top, for "
 440 "your build."
 441 msgstr ""
 442
 443 #. type: textblock
 444 #: ../dgit-user.7.pod:274
 445 msgid ""
 446 "This rune provides an easy way to do this.  It adds a new changelog entry "
 447 "with an uninformative message and a plausible version number (containing a "
 448 "bit of your git commit id)."
 449 msgstr ""
 450
 451 #. type: textblock
 452 #: ../dgit-user.7.pod:279
 453 msgid ""
 454 "If you want to be more sophisticated, the package C<dpkg-dev-el> has a good "
 455 "Emacs mode for editing changelogs.  Alternatively, you could edit the "
 456 "changelog with another text editor, or run C<dch> or C<gbp dch> with "
 457 "different options.  Choosing a good version number is slightly tricky and a "
 458 "complete treatment is beyond the scope of this tutorial."
 459 msgstr ""
 460
 461 #. type: =head2
 462 #: ../dgit-user.7.pod:287
 463 msgid "Actually building"
 464 msgstr ""
 465
 466 #. type: verbatim
 467 #: ../dgit-user.7.pod:291
 468 #, no-wrap
 469 msgid ""
 470 "    % mk-build-deps --root-cmd=sudo --install\n"
 471 "    % dpkg-buildpackage -uc -b\n"
 472 "\n"
 473 msgstr ""
 474
 475 #. type: textblock
 476 #: ../dgit-user.7.pod:296
 477 msgid ""
 478 "dpkg-buildpackage is the primary tool for building a Debian source package.  "
 479 "C<-uc> means not to pgp-sign the results.  C<-b> means build all binary "
 480 "packages, but not to build a source package."
 481 msgstr ""
 482
 483 #. type: =head2
 484 #: ../dgit-user.7.pod:302
 485 msgid "Using sbuild"
 486 msgstr ""
 487
 488 #. type: textblock
 489 #: ../dgit-user.7.pod:304
 490 msgid ""
 491 "You can build in an schroot chroot, with sbuild, instead of in your main "
 492 "environment.  (sbuild is used by the Debian build daemons.)"
 493 msgstr ""
 494
 495 #. type: verbatim
 496 #: ../dgit-user.7.pod:309
 497 #, no-wrap
 498 msgid ""
 499 "    % git clean -xdf\n"
 500 "    % sbuild -c jessie -A --no-clean-source \\\n"
 501 "             --dpkg-source-opts='-Zgzip -z1 --format=1.0 -sn'\n"
 502 "\n"
 503 msgstr ""
 504
 505 #. type: textblock
 506 #: ../dgit-user.7.pod:315
 507 msgid ""
 508 "Note that this will seem to leave a \"source package\" (.dsc and .tar.gz)  "
 509 "in the parent directory, but that source package should not be used.  It is "
 510 "likely to be broken.  For more information see Debian bug #868527."
 511 msgstr ""
 512
 513 #. type: =head1
 514 #: ../dgit-user.7.pod:322
 515 msgid "INSTALLING"
 516 msgstr ""
 517
 518 #. type: =head2
 519 #: ../dgit-user.7.pod:324
 520 msgid "Debian Jessie or older"
 521 msgstr ""
 522
 523 #. type: verbatim
 524 #: ../dgit-user.7.pod:328
 525 #, no-wrap
 526 msgid ""
 527 "    % sudo dpkg -i ../libc6_*.deb\n"
 528 "\n"
 529 msgstr ""
 530
 531 #. type: textblock
 532 #: ../dgit-user.7.pod:332
 533 msgid ""
 534 "You can use C<dpkg -i> to install the .debs that came out of your package."
 535 msgstr ""
 536
 537 #. type: textblock
 538 #: ../dgit-user.7.pod:335
 539 msgid ""
 540 "If the dependencies aren't installed, you will get an error, which can "
 541 "usually be fixed with C<apt-get -f install>."
 542 msgstr ""
 543
 544 #. type: =head2
 545 #: ../dgit-user.7.pod:339
 546 msgid "Debian Stretch or newer"
 547 msgstr ""
 548
 549 #. type: verbatim
 550 #: ../dgit-user.7.pod:343
 551 #, no-wrap
 552 msgid ""
 553 "    % sudo apt install ../libc6_*.deb\n"
 554 "\n"
 555 msgstr ""
 556
 557 #. type: =head1
 558 #: ../dgit-user.7.pod:347
 559 msgid "Multiarch"
 560 msgstr ""
 561
 562 #. type: textblock
 563 #: ../dgit-user.7.pod:349
 564 msgid ""
 565 "If you're working on a library package and your system has multiple "
 566 "architectures enabled, you may see something like this:"
 567 msgstr ""
 568
 569 #. type: verbatim
 570 #: ../dgit-user.7.pod:355
 571 #, no-wrap
 572 msgid ""
 573 "    dpkg: error processing package libpcre3-dev:amd64 (--configure):\n"
 574 "     package libpcre3-dev:amd64 2:8.39-3~3.gbp8f25f5 cannot be configured because libpcre3-dev:i386 is at a different version (2:8.39-2)\n"
 575 "\n"
 576 msgstr ""
 577
 578 #. type: textblock
 579 #: ../dgit-user.7.pod:360
 580 msgid ""
 581 "The multiarch system used by Debian requires each package which is present "
 582 "for multiple architectures to be exactly the same across all the "
 583 "architectures for which it is installed."
 584 msgstr ""
 585
 586 #. type: textblock
 587 #: ../dgit-user.7.pod:364
 588 msgid ""
 589 "The proper solution is to build the package for all the architectures you "
 590 "have enabled.  You'll need a chroot for each of the secondary "
 591 "architectures.  This is somewhat tiresome, even though Debian has excellent "
 592 "tools for managing chroots.  C<sbuild-debian-developer-setup> from the "
 593 "package of the same name and C<sbuild-createchroot> from the C<sbuild> "
 594 "package are good starting points."
 595 msgstr ""
 596
 597 #. type: textblock
 598 #: ../dgit-user.7.pod:374
 599 msgid ""
 600 "Otherwise you could deinstall the packages of interest for those other "
 601 "architectures with something like C<dpkg --remove libpcre3:i386>."
 602 msgstr ""
 603
 604 #. type: textblock
 605 #: ../dgit-user.7.pod:378
 606 msgid ""
 607 "If neither of those are an option, your desperate last resort is to try "
 608 "using the same version number as the official package for your own package.  "
 609 "(The version is controlled by C<debian/changelog> - see above).  This is not "
 610 "ideal because it makes it hard to tell what is installed, and because it "
 611 "will mislead and confuse apt."
 612 msgstr ""
 613
 614 #. type: textblock
 615 #: ../dgit-user.7.pod:386
 616 msgid "With the \"same number\" approach you may still get errors like"
 617 msgstr ""
 618
 619 #. type: textblock
 620 #: ../dgit-user.7.pod:390
 621 msgid ""
 622 "trying to overwrite shared '/usr/include/pcreposix.h', which is different "
 623 "from other instances of package libpcre3-dev"
 624 msgstr ""
 625
 626 #. type: textblock
 627 #: ../dgit-user.7.pod:394
 628 msgid ""
 629 "but passing C<--force-overwrite> to dpkg will help - assuming you know what "
 630 "you're doing."
 631 msgstr ""
 632
 633 #. type: =head1
 634 #: ../dgit-user.7.pod:397
 635 msgid "SHARING YOUR WORK"
 636 msgstr ""
 637
 638 #. type: textblock
 639 #: ../dgit-user.7.pod:399
 640 msgid ""
 641 "The C<dgit/jessie,-security> branch (or whatever) is a normal git branch.  "
 642 "You can use C<git push> to publish it on any suitable git server."
 643 msgstr ""
 644
 645 #. type: textblock
 646 #: ../dgit-user.7.pod:402
 647 msgid ""
 648 "Anyone who gets that git branch from you will be able to build binary "
 649 "packages (.deb)  just as you did."
 650 msgstr ""
 651
 652 #. type: textblock
 653 #: ../dgit-user.7.pod:406
 654 msgid ""
 655 "If you want to contribute your changes back to Debian, you should probably "
 656 "send them as attachments to an email to the L<Debian Bug System|https://bugs."
 657 "debian.org/> (either a followup to an existing bug, or a new bug).  Patches "
 658 "in C<git-format-patch> format are usually very welcome."
 659 msgstr ""
 660
 661 #. type: =head2
 662 #: ../dgit-user.7.pod:413
 663 msgid "Source packages"
 664 msgstr ""
 665
 666 #. type: textblock
 667 #: ../dgit-user.7.pod:415
 668 msgid ""
 669 "The git branch is not sufficient to build a source package the way Debian "
 670 "does.  Source packages are somewhat awkward to work with.  Indeed many "
 671 "plausible git histories or git trees cannot be converted into a suitable "
 672 "source package.  So I recommend you share your git branch instead."
 673 msgstr ""
 674
 675 #. type: textblock
 676 #: ../dgit-user.7.pod:423
 677 msgid ""
 678 "If a git branch is not enough, and you need to provide a source package but "
 679 "don't care about its format/layout (for example because some software you "
 680 "have consumes source packages, not git histories)  you can use this recipe "
 681 "to generate a C<3.0 (native)> source package, which is just a tarball with "
 682 "accompanying .dsc metadata file:"
 683 msgstr ""
 684
 685 #. type: verbatim
 686 #: ../dgit-user.7.pod:434
 687 #, no-wrap
 688 msgid ""
 689 "    % echo '3.0 (native)' >debian/source/format\n"
 690 "    % git commit -m 'switch to native source format' debian/source/format\n"
 691 "    % dgit -wgf build-source\n"
 692 "\n"
 693 msgstr ""
 694
 695 #. type: textblock
 696 #: ../dgit-user.7.pod:440
 697 msgid ""
 698 "If you need to provide a good-looking source package, be prepared for a lot "
 699 "more work.  You will need to read much more, perhaps starting with L<dgit-"
 700 "nmu-simple(7)>, L<dgit-sponsorship(7)> or L<dgit-maint-*(7)>"
 701 msgstr ""
 702
 703 #. type: textblock
 704 #: ../dgit-user.7.pod:449 ../dgit-maint-native.7.pod:128
 705 #: ../dgit-maint-merge.7.pod:493 ../dgit-maint-gbp.7.pod:138
 706 msgid "dgit(1), dgit(7)"
 707 msgstr ""