po4a/dgit-sponsorship_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-13 20:41+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:1445 ../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:598
  35 #: ../git-debrebase.5.pod:678
  36 #, no-wrap
  37 msgid "SEE ALSO"
  38 msgstr ""
  39
  40 #. type: =head1
  41 #: ../dgit-nmu-simple.7.pod:5 ../dgit-sponsorship.7.pod:5
  42 msgid "INTRODUCTION AND SCOPE"
  43 msgstr ""
  44
  45 #. type: verbatim
  46 #: ../dgit-maint-gbp.7.pod:113 ../dgit-sponsorship.7.pod:173
  47 #, no-wrap
  48 msgid ""
  49 "    % dgit --gbp push\n"
  50 "\n"
  51 msgstr ""
  52
  53 #. type: textblock
  54 #: ../dgit-sponsorship.7.pod:3
  55 msgid "dgit-sponsorship - tutorial for Debian upload sponsorship, using git"
  56 msgstr ""
  57
  58 #. type: textblock
  59 #: ../dgit-sponsorship.7.pod:7
  60 msgid ""
  61 "This tutorial describes how a Debian sponsored contributor and a sponsoring "
  62 "DD (or DM)  can collaborate and publish using git."
  63 msgstr ""
  64
  65 #. type: textblock
  66 #: ../dgit-sponsorship.7.pod:12
  67 msgid ""
  68 "The sponsor must to be intending to use dgit for the upload.  (If the "
  69 "sponsor does not use dgit, it is not possible to properly publish a "
  70 "sponsee's git branch.)"
  71 msgstr ""
  72
  73 #. type: textblock
  74 #: ../dgit-sponsorship.7.pod:17
  75 msgid ""
  76 "It is best if the sponsee also uses dgit; but also covered (later on) is the "
  77 "case where the sponsee provides a proposed upload in source package form, "
  78 "but the sponsor would like to work in git."
  79 msgstr ""
  80
  81 #. type: textblock
  82 #: ../dgit-sponsorship.7.pod:22
  83 msgid ""
  84 "This tutorial does not provide a checklist for the sponsor's review.  Both "
  85 "contributors are expected to be familiar with Debian packaging and Debian's "
  86 "processes, and with git."
  87 msgstr ""
  88
  89 #. type: =head1
  90 #: ../dgit-sponsorship.7.pod:26
  91 msgid "SPONSEE WORKFLOW"
  92 msgstr ""
  93
  94 #. type: textblock
  95 #: ../dgit-sponsorship.7.pod:28
  96 msgid "This section is addressed to the sponsee:"
  97 msgstr ""
  98
  99 #. type: =head2
 100 #: ../dgit-sponsorship.7.pod:30
 101 msgid "General"
 102 msgstr ""
 103
 104 #. type: textblock
 105 #: ../dgit-sponsorship.7.pod:32
 106 msgid ""
 107 "You should prepare the package as if you were going to upload it with C<dgit "
 108 "push-source> or C<dgit push> yourself."
 109 msgstr ""
 110
 111 #. type: textblock
 112 #: ../dgit-sponsorship.7.pod:35
 113 msgid "For a straightforward NMU, consult L<dgit-nmu-simple(7)>."
 114 msgstr ""
 115
 116 #. type: textblock
 117 #: ../dgit-sponsorship.7.pod:37
 118 msgid ""
 119 "If you are the (prospective) maintainer, you can adopt any suitable (dgit-"
 120 "compatible)  git workflow.  The L<dgit-maint-*(7)> tutorials describe some "
 121 "of the possibilities."
 122 msgstr ""
 123
 124 #. type: =head2
 125 #: ../dgit-sponsorship.7.pod:42
 126 msgid "Upload preparation"
 127 msgstr ""
 128
 129 #. type: textblock
 130 #: ../dgit-sponsorship.7.pod:44
 131 msgid ""
 132 "You should go through all of the steps a self-uploading maintainer would do, "
 133 "including building for ad hoc tests, and checking via a formal build (eg "
 134 "using C<dgit sbuild>)  that the package builds on sid (or the target "
 135 "release)."
 136 msgstr ""
 137
 138 #. type: textblock
 139 #: ../dgit-sponsorship.7.pod:50
 140 msgid ""
 141 "At the point where you would, if you were a DD, do the actual upload by "
 142 "running dgit push, you hand off to your sponsor."
 143 msgstr ""
 144
 145 #. type: textblock
 146 #: ../dgit-sponsorship.7.pod:56
 147 msgid ""
 148 "If you were going to use one of the C<--quilt=> options to dgit, or C<dgit --"
 149 "gbp> or C<dgit --dpm>, you must specify that in your handoff email - see "
 150 "below."
 151 msgstr ""
 152
 153 #. type: =head2
 154 #: ../dgit-sponsorship.7.pod:62
 155 msgid "git+origs based handoff"
 156 msgstr ""
 157
 158 #. type: textblock
 159 #: ../dgit-sponsorship.7.pod:64
 160 msgid "The elements of the handoff consists of:"
 161 msgstr ""
 162
 163 #. type: =item
 164 #: ../dgit-sponsorship.7.pod:68 ../dgit-sponsorship.7.pod:72
 165 #: ../dgit-sponsorship.7.pod:79 ../dgit-sponsorship.7.pod:84
 166 msgid "*"
 167 msgstr ""
 168
 169 #. type: textblock
 170 #: ../dgit-sponsorship.7.pod:70
 171 msgid "The git branch."
 172 msgstr ""
 173
 174 #. type: textblock
 175 #: ../dgit-sponsorship.7.pod:74
 176 msgid ""
 177 "Any .orig tarballs which will be needed, or sample git-archive(1)  or gbp-"
 178 "buildpackage(1)  command(s) to generate them."
 179 msgstr ""
 180
 181 #. type: textblock
 182 #: ../dgit-sponsorship.7.pod:81
 183 msgid ""
 184 "A sample dgit push command, containing any dgit --quilt=, --gbp or --dpm "
 185 "option needed"
 186 msgstr ""
 187
 188 #. type: textblock
 189 #: ../dgit-sponsorship.7.pod:86
 190 msgid ""
 191 "Plus of course all the usual information about the state of the package, any "
 192 "caveats or areas you would like the sponsor to focus their review, "
 193 "constraints about upload timing, etc."
 194 msgstr ""
 195
 196 #. type: textblock
 197 #: ../dgit-sponsorship.7.pod:93
 198 msgid ""
 199 "If the handoff is done by email, the elements above should be a in a single, "
 200 "signed, message.  This could be an RFS submission against the sponsorship-"
 201 "requests pseudo-package."
 202 msgstr ""
 203
 204 #. type: =head3
 205 #: ../dgit-sponsorship.7.pod:98
 206 msgid "git branch"
 207 msgstr ""
 208
 209 #. type: textblock
 210 #: ../dgit-sponsorship.7.pod:102
 211 msgid ""
 212 "The sponsee should push their HEAD as a git branch to any suitable git "
 213 "server.  They can use their own git server; salsa is another possibility."
 214 msgstr ""
 215
 216 #. type: textblock
 217 #: ../dgit-sponsorship.7.pod:107
 218 msgid ""
 219 "The branch names used by the sponsee on their local machine, and on the "
 220 "server, do not matter."
 221 msgstr ""
 222
 223 #. type: textblock
 224 #: ../dgit-sponsorship.7.pod:110
 225 msgid ""
 226 "Instead, the sponsee should include the git commit id of their HEAD in their "
 227 "handover email."
 228 msgstr ""
 229
 230 #. type: =head3
 231 #: ../dgit-sponsorship.7.pod:116
 232 msgid "orig tarballs"
 233 msgstr ""
 234
 235 #. type: textblock
 236 #: ../dgit-sponsorship.7.pod:120
 237 msgid ""
 238 "If there are any .origs that are not in the archive already, the sponsor "
 239 "will need them as part of the upload."
 240 msgstr ""
 241
 242 #. type: textblock
 243 #: ../dgit-sponsorship.7.pod:123
 244 msgid ""
 245 "If the sponsee generated these tarballs with git-archive(1)  or gbp-"
 246 "buildpackage(1), they can simply include a sample invocation of git-"
 247 "archive(1)  or ensure that a suitable gbp.conf is present in the source "
 248 "package to generate the tarball."
 249 msgstr ""
 250
 251 #. type: textblock
 252 #: ../dgit-sponsorship.7.pod:130
 253 msgid ""
 254 "Otherwise, the simplest approach is to commit the orig tarballs with "
 255 "pristine-tar(1), e.g."
 256 msgstr ""
 257
 258 #. type: verbatim
 259 #: ../dgit-sponsorship.7.pod:136
 260 #, no-wrap
 261 msgid ""
 262 "    % pristine-tar commit ../foo_1.2.3.orig.tar.xz upstream/1.2.3\n"
 263 "\n"
 264 msgstr ""
 265
 266 #. type: textblock
 267 #: ../dgit-sponsorship.7.pod:140
 268 msgid ""
 269 "and be sure to push the pristine-tar branch.  If you are using git-"
 270 "buildpackage(1), just pass I<--git-pristine-tar> and I<--git-pristine-tar-"
 271 "commit>."
 272 msgstr ""
 273
 274 #. type: textblock
 275 #: ../dgit-sponsorship.7.pod:144
 276 msgid ""
 277 "Alternatively, the sponsee can put them on a suitable webserver, or attach "
 278 "to the e-mail, if they are small."
 279 msgstr ""
 280
 281 #. type: textblock
 282 #: ../dgit-sponsorship.7.pod:149
 283 msgid ""
 284 "The sponsee should quote sha256sums of the .origs in their handoff email, "
 285 "unless they supplied commands to generate them."
 286 msgstr ""
 287
 288 #. type: =head3
 289 #: ../dgit-sponsorship.7.pod:155
 290 msgid "quilt options"
 291 msgstr ""
 292
 293 #. type: textblock
 294 #: ../dgit-sponsorship.7.pod:159
 295 msgid ""
 296 "Some workflows involve git branches which are not natively dgit-compatible.  "
 297 "Normally dgit will convert them as needed, during push."
 298 msgstr ""
 299
 300 #. type: textblock
 301 #: ../dgit-sponsorship.7.pod:163
 302 msgid ""
 303 "Supply a sample \"dgit push\" command including any C<--gbp> (aka C<--"
 304 "quilt=gbp>), C<--dpm> (aka C<--quilt=dpm>), or other C<--quilt=> option they "
 305 "need to use.  e.g."
 306 msgstr ""
 307
 308 #. type: =head1
 309 #: ../dgit-sponsorship.7.pod:179
 310 msgid "SPONSOR WORKFLOW"
 311 msgstr ""
 312
 313 #. type: textblock
 314 #: ../dgit-sponsorship.7.pod:181 ../dgit-sponsorship.7.pod:273
 315 msgid "This part is addressed to the sponsor:"
 316 msgstr ""
 317
 318 #. type: =head2
 319 #: ../dgit-sponsorship.7.pod:183
 320 msgid "Receiving and validating the sponsorship request"
 321 msgstr ""
 322
 323 #. type: textblock
 324 #: ../dgit-sponsorship.7.pod:185
 325 msgid "You should check the signature on the email."
 326 msgstr ""
 327
 328 #. type: textblock
 329 #: ../dgit-sponsorship.7.pod:187
 330 msgid ""
 331 "Use C<git fetch> or C<git clone> to obtain the git branch prepared by your "
 332 "sponsee, and obtain any .origs mentioned by the sponsee (to extract .origs "
 333 "committed with pristine-tar, you can use origtargz(1), or use \"gbp clone --"
 334 "pristine-tar\".)"
 335 msgstr ""
 336
 337 #. type: textblock
 338 #: ../dgit-sponsorship.7.pod:194
 339 msgid ""
 340 "Check the git commit ID of the sponsee's branch tip, and the sha256sums of "
 341 "the .origs, against the handoff email."
 342 msgstr ""
 343
 344 #. type: textblock
 345 #: ../dgit-sponsorship.7.pod:198
 346 msgid "Now you can check out the branch tip, and do your substantive review."
 347 msgstr ""
 348
 349 #. type: =head2
 350 #: ../dgit-sponsorship.7.pod:201
 351 msgid "Dealing with branches that want --quilt="
 352 msgstr ""
 353
 354 #. type: textblock
 355 #: ../dgit-sponsorship.7.pod:203
 356 msgid ""
 357 "If your sponsee mentioned a C<--quilt> option, and you don't want to grapple "
 358 "with their preferred tree format, you can convert their tree into the "
 359 "standard dgit view:"
 360 msgstr ""
 361
 362 #. type: verbatim
 363 #: ../dgit-sponsorship.7.pod:209
 364 #, no-wrap
 365 msgid ""
 366 "    % dgit -wgf --quilt=foo --dgit-view-save=unquilted quilt-fixup\n"
 367 "    % git checkout unquilted\n"
 368 "\n"
 369 msgstr ""
 370
 371 #. type: textblock
 372 #: ../dgit-sponsorship.7.pod:214
 373 msgid ""
 374 "You should check that what you're looking at is a descendant of the "
 375 "sponsee's branch."
 376 msgstr ""
 377
 378 #. type: =head2
 379 #: ../dgit-sponsorship.7.pod:217
 380 msgid "Some hints which may help the review"
 381 msgstr ""
 382
 383 #. type: textblock
 384 #: ../dgit-sponsorship.7.pod:219
 385 msgid ""
 386 "C<dgit fetch sid> will get you an up-to-date C<refs/remotes/dgit/dgit/sid> "
 387 "showing what's in the archive already."
 388 msgstr ""
 389
 390 #. type: textblock
 391 #: ../dgit-sponsorship.7.pod:223
 392 msgid ""
 393 "C<dgit -wgf --damp-run push-source> will check that dgit can build an "
 394 "appropriate source package."
 395 msgstr ""
 396
 397 #. type: textblock
 398 #: ../dgit-sponsorship.7.pod:226
 399 msgid ""
 400 "There is no need to run debdiff.  dgit will not upload anything that doesn't "
 401 "unpack to exactly the git commit you are pushing, so you can rely on what "
 402 "you see in C<git diff>."
 403 msgstr ""
 404
 405 #. type: =head2
 406 #: ../dgit-sponsorship.7.pod:231
 407 msgid "Doing the upload"
 408 msgstr ""
 409
 410 #. type: textblock
 411 #: ../dgit-sponsorship.7.pod:233
 412 msgid ""
 413 "When you have completed your source review, and use C<dgit -wgf [--"
 414 "quilt=...] sbuild -A -C> or similar, to to the build, and then C<dgit -wgf "
 415 "[--quilt=...] push-source> or C<dgit -wgf [--quilt=...] push> to do the "
 416 "upload."
 417 msgstr ""
 418
 419 #. type: textblock
 420 #: ../dgit-sponsorship.7.pod:242
 421 msgid ""
 422 "Check whether the sponsee made a debian/I<version> tag.  If they did, ensure "
 423 "you have their tag in the repository you are pushing from, or pass C<--no-"
 424 "dep14tag>.  This avoids identically named, non-identical tags, which can be "
 425 "confusing."
 426 msgstr ""
 427
 428 #. type: textblock
 429 #: ../dgit-sponsorship.7.pod:249
 430 msgid ""
 431 "(It is possible to upload from the quilt-cache dgit view.  If you want to do "
 432 "this, B<do not> pass the C<--quilt> or C<--gbp> or C<--dpm> options again, "
 433 "and B<do> pass C<--no-dep14tag>, since the debian/I<version> tag should go "
 434 "on the sponsee's branch.)"
 435 msgstr ""
 436
 437 #. type: textblock
 438 #: ../dgit-sponsorship.7.pod:257
 439 msgid ""
 440 "If this was the first upload done with dgit, you may need to pass C<--"
 441 "overwrite> to dgit."
 442 msgstr ""
 443
 444 #. type: textblock
 445 #: ../dgit-sponsorship.7.pod:262
 446 msgid ""
 447 "Alternatively, if this was the first ever dgit push of the package, you can "
 448 "pass C<--deliberately-not-fast-forward> instead of C<--overwrite>.  This "
 449 "avoids introducing a new origin commit into the dgit view of the sponsee's "
 450 "git history which is unnecessary and could be confusing."
 451 msgstr ""
 452
 453 #. type: =head1
 454 #: ../dgit-sponsorship.7.pod:271
 455 msgid "SPONSORING A NON-GIT-USING SPONSEE"
 456 msgstr ""
 457
 458 #. type: textblock
 459 #: ../dgit-sponsorship.7.pod:275
 460 msgid ""
 461 "If your sponsee does not use git, you can still do your review with git, and "
 462 "use dgit for the upload."
 463 msgstr ""
 464
 465 #. type: textblock
 466 #: ../dgit-sponsorship.7.pod:279
 467 msgid ""
 468 "Your sponsee will provide you with a source package: that is, a .dsc and the "
 469 "files it refers to.  Obtain these files, and check signatures as "
 470 "appropriate.  Then:"
 471 msgstr ""
 472
 473 #. type: verbatim
 474 #: ../dgit-sponsorship.7.pod:286
 475 #, no-wrap
 476 msgid ""
 477 "    % dgit clone PACKAGE\n"
 478 "    % cd PACKAGE\n"
 479 "    % dgit import-dsc /path/to/sponsee's.dsc +sponsee\n"
 480 "    % git checkout sponsee\n"
 481 "\n"
 482 msgstr ""
 483
 484 #. type: textblock
 485 #: ../dgit-sponsorship.7.pod:293
 486 msgid "Or for an entirely new package:"
 487 msgstr ""
 488
 489 #. type: verbatim
 490 #: ../dgit-sponsorship.7.pod:297
 491 #, no-wrap
 492 msgid ""
 493 "    % mkdir PACKAGE\n"
 494 "    % cd PACKAGE\n"
 495 "    % git init\n"
 496 "    % dgit -pPACKAGE import-dsc /path/to/sponsee's.dsc +sponsee\n"
 497 "\n"
 498 msgstr ""
 499
 500 #. type: textblock
 501 #: ../dgit-sponsorship.7.pod:304
 502 msgid ""
 503 "This will leave you looking at the sponsee's package, formatted as a dgit "
 504 "branch."
 505 msgstr ""
 506
 507 #. type: textblock
 508 #: ../dgit-sponsorship.7.pod:307
 509 msgid ""
 510 "When you have finished your review and your tests, you can do the dgit "
 511 "sbuild and dgit push directly from the \"sponsee\" branch."
 512 msgstr ""
 513
 514 #. type: textblock
 515 #: ../dgit-sponsorship.7.pod:312
 516 msgid ""
 517 "You will need to pass C<--overwrite> to dgit push for every successive "
 518 "upload.  This disables a safety catch which would normally spot situations "
 519 "where changes are accidentally lost.  When your sponsee is sending you "
 520 "source packages - perhaps multiple source packages with the same version "
 521 "number - these safety catches are inevitably ineffective."
 522 msgstr ""
 523
 524 #. type: textblock
 525 #: ../dgit-sponsorship.7.pod:323
 526 msgid "dgit(1), dgit(7), dgit-nmu-simple(7), dgit-maint-*(7)"
 527 msgstr ""