chiark / gitweb /
changelog: start 9.14
[dgit.git] / po4a / dgit_1.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-03-01 16:59+0000\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: TH
20 #: ../dgit.1:2 ../dgit.7:1
21 #, no-wrap
22 msgid "dgit"
23 msgstr ""
24
25 #. type: TH
26 #: ../dgit.1:2 ../dgit.7:1
27 #, no-wrap
28 msgid "Debian Project"
29 msgstr ""
30
31 #. type: =head1
32 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
33 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
34 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
35 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
36 #: ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
37 #, no-wrap
38 msgid "NAME"
39 msgstr ""
40
41 #. type: Plain text
42 #: ../dgit.1:5
43 msgid "dgit - git integration with the Debian archive"
44 msgstr ""
45
46 #. type: SH
47 #: ../dgit.1:6
48 #, no-wrap
49 msgid "SYNOPSIS"
50 msgstr ""
51
52 #. type: Plain text
53 #: ../dgit.1:10
54 msgid ""
55 "B<dgit> [I<dgit-opts>] B<clone> [I<dgit-opts>] I<package> [I<suite>] [B<./"
56 ">I<dir|>B</>I<dir>]"
57 msgstr ""
58
59 #. type: Plain text
60 #: ../dgit.1:14
61 msgid "B<dgit> [I<dgit-opts>] B<fetch>|B<pull> [I<dgit-opts>] [I<suite>]"
62 msgstr ""
63
64 #. type: Plain text
65 #: ../dgit.1:18
66 msgid ""
67 "B<dgit> [I<dgit-opts>] B<build>|B<sbuild>|B<build-source> [I<build-opts>]"
68 msgstr ""
69
70 #. type: Plain text
71 #: ../dgit.1:22
72 msgid "B<dgit> [I<dgit-opts>] B<pbuilder>|B<cowbuilder> [I<debbuildopts>]"
73 msgstr ""
74
75 #. type: Plain text
76 #: ../dgit.1:26
77 msgid "B<dgit> [I<dgit-opts>] B<push>|B<push-source> [I<dgit-opts>] [I<suite>]"
78 msgstr ""
79
80 #. type: Plain text
81 #: ../dgit.1:30
82 msgid ""
83 "B<dgit> [I<dgit-opts>] B<rpush> I<build-host>B<:>I<build-dir> [I<push args..."
84 ">]"
85 msgstr ""
86
87 #. type: Plain text
88 #: ../dgit.1:33
89 msgid "B<dgit> [I<dgit-opts>] I<action> ..."
90 msgstr ""
91
92 #. type: SH
93 #: ../dgit.1:33
94 #, no-wrap
95 msgid "DESCRIPTION"
96 msgstr ""
97
98 #. type: Plain text
99 #: ../dgit.1:41
100 msgid ""
101 "B<dgit> allows you to treat the Debian archive as if it were a git "
102 "repository.  Conversely, it allows Debian to publish the source of its "
103 "packages as git branches, in a format which is directly useable by ordinary "
104 "people."
105 msgstr ""
106
107 #. type: Plain text
108 #: ../dgit.1:44
109 msgid "This is the command line reference.  Please read the tutorial(s):"
110 msgstr ""
111
112 #. type: tbl table
113 #: ../dgit.1:46
114 #, no-wrap
115 msgid "dgit-user(7)"
116 msgstr ""
117
118 #. type: tbl table
119 #: ../dgit.1:46
120 #, no-wrap
121 msgid "for users: edit, build and share packages"
122 msgstr ""
123
124 #. type: tbl table
125 #: ../dgit.1:47
126 #, no-wrap
127 msgid "dgit-nmu-simple(7)"
128 msgstr ""
129
130 #. type: tbl table
131 #: ../dgit.1:47
132 #, no-wrap
133 msgid "for DDs: do a straightforward NMU"
134 msgstr ""
135
136 #. type: tbl table
137 #: ../dgit.1:48
138 #, no-wrap
139 msgid "dgit-maint-native(7)"
140 msgstr ""
141
142 #. type: tbl table
143 #: ../dgit.1:48
144 #, no-wrap
145 msgid "for maintainers of Debian-native packages"
146 msgstr ""
147
148 #. type: tbl table
149 #: ../dgit.1:49
150 #, no-wrap
151 msgid "dgit-maint-debrebase(7)"
152 msgstr ""
153
154 #. type: tbl table
155 #: ../dgit.1:49
156 #, no-wrap
157 msgid "for maintainers: a pure-git rebasish workflow"
158 msgstr ""
159
160 #. type: tbl table
161 #: ../dgit.1:50
162 #, no-wrap
163 msgid "dgit-maint-merge(7)"
164 msgstr ""
165
166 #. type: tbl table
167 #: ../dgit.1:50
168 #, no-wrap
169 msgid "for maintainers: a pure-git merging workflow"
170 msgstr ""
171
172 #. type: tbl table
173 #: ../dgit.1:51
174 #, no-wrap
175 msgid "dgit-maint-gbp(7)"
176 msgstr ""
177
178 #. type: tbl table
179 #: ../dgit.1:51
180 #, no-wrap
181 msgid "for maintainers already using git-buildpackage"
182 msgstr ""
183
184 #. type: tbl table
185 #: ../dgit.1:52
186 #, no-wrap
187 msgid "dgit-sponsorship(7)"
188 msgstr ""
189
190 #. type: tbl table
191 #: ../dgit.1:52
192 #, no-wrap
193 msgid "for sponsors and sponsored contributors"
194 msgstr ""
195
196 #. type: tbl table
197 #: ../dgit.1:53
198 #, no-wrap
199 msgid "dgit-downstream-dsc(7)"
200 msgstr ""
201
202 #. type: tbl table
203 #: ../dgit.1:53
204 #, no-wrap
205 msgid "setting up dgit push for a new distro"
206 msgstr ""
207
208 #. type: Plain text
209 #: ../dgit.1:60
210 msgid ""
211 "See B<dgit(7)> for detailed information about the data model, common "
212 "problems likely to arise with certain kinds of package, etc."
213 msgstr ""
214
215 #. type: SH
216 #: ../dgit.1:60
217 #, no-wrap
218 msgid "OPERATIONS"
219 msgstr ""
220
221 #. type: TP
222 #: ../dgit.1:61
223 #, no-wrap
224 msgid "B<dgit clone> I<package> [I<suite>] [B<./>I<dir|>B</>I<dir>]"
225 msgstr ""
226
227 #. type: Plain text
228 #: ../dgit.1:74
229 msgid ""
230 "Consults the archive and dgit-repos to construct the git view of history for "
231 "I<package> in I<suite> (B<sid> by default)  in a new directory (named B<./"
232 ">I<package> by default); also, downloads any necessary orig tarballs."
233 msgstr ""
234
235 #. type: Plain text
236 #: ../dgit.1:85
237 msgid ""
238 "The suite's git tip is left on the local branch B<dgit/>I<suite> ready for "
239 "work, and on the corresponding dgit remote tracking branch.  The B<origin> "
240 "remote will be set up to point to the package's dgit-repos tree for the "
241 "distro to which I<suite> belongs."
242 msgstr ""
243
244 #. type: Plain text
245 #: ../dgit.1:90
246 msgid ""
247 "I<suite> may be a combination of several underlying suites in the form "
248 "I<mainsuite>B<,>I<subsuite>...; see COMBINED SUITES in dgit(7)."
249 msgstr ""
250
251 #. type: Plain text
252 #: ../dgit.1:97
253 msgid ""
254 "For your convenience, the B<vcs-git> remote will be set up from the "
255 "package's Vcs-Git field, if there is one - but note that in the general case "
256 "the history found there may be different to or even disjoint from dgit's "
257 "view.  (See also dgit update-vcs-git.)"
258 msgstr ""
259
260 #. type: TP
261 #: ../dgit.1:97
262 #, no-wrap
263 msgid "B<dgit fetch> [I<suite>]"
264 msgstr ""
265
266 #. type: Plain text
267 #: ../dgit.1:110
268 msgid ""
269 "Consults the archive and git-repos to update the git view of history for a "
270 "specific suite (and downloads any necessary orig tarballs), and updates the "
271 "remote tracking branch B<remotes/dgit/dgit/>I<suite>.  If the current branch "
272 "is B<dgit/>I<suite> then dgit fetch defaults to I<suite>; otherwise it "
273 "parses debian/changelog and uses the suite specified there.  suite may be a "
274 "combined suite, as for clone."
275 msgstr ""
276
277 #. type: TP
278 #: ../dgit.1:110
279 #, no-wrap
280 msgid "B<dgit pull> [I<suite>]"
281 msgstr ""
282
283 #. type: Plain text
284 #: ../dgit.1:116
285 msgid ""
286 "Does dgit fetch, and then merges the new head of the remote tracking branch "
287 "B<remotes/dgit/dgit/>I<suite> into the current branch."
288 msgstr ""
289
290 #. type: TP
291 #: ../dgit.1:116
292 #, no-wrap
293 msgid "B<dgit checkout> I<suite>"
294 msgstr ""
295
296 #. type: Plain text
297 #: ../dgit.1:120
298 msgid "Checks out the local branch B<dgit/>I<suite>."
299 msgstr ""
300
301 #. type: Plain text
302 #: ../dgit.1:127
303 msgid ""
304 "If the branch does not exist, dgit checkout creates it, and sets it up the "
305 "same way as dgit clone would.  In that case, if the archive remote tracking "
306 "branch does not exist, dgit checkout will do a dgit fetch first."
307 msgstr ""
308
309 #. type: Plain text
310 #: ../dgit.1:132
311 msgid ""
312 "NB: dgit checkout will only do a fetch if it has to.  If you already have "
313 "the suite branch, and want to merge your branch with updates from the "
314 "archive, use dgit pull."
315 msgstr ""
316
317 #. type: Plain text
318 #: ../dgit.1:137
319 msgid ""
320 "dgit checkout will normally need to access the archive server, to "
321 "canonicalise the provided suite name.  The exception is if you specify the "
322 "canonical name, and the branch (or tracking branch) already exists."
323 msgstr ""
324
325 #. type: TP
326 #: ../dgit.1:137
327 #, no-wrap
328 msgid "B<dgit build> ..."
329 msgstr ""
330
331 #. type: Plain text
332 #: ../dgit.1:146
333 msgid ""
334 "Runs B<dpkg-buildpackage> with some suitable options.  Options and arguments "
335 "after build will be passed on to dpkg-buildpackage.  It is not necessary to "
336 "use dgit build when using dgit; it is OK to use any approach which ensures "
337 "that the generated source package corresponds to the relevant git commit."
338 msgstr ""
339
340 #. type: Plain text
341 #: ../dgit.1:148 ../dgit.1:200 ../dgit.1:240
342 msgid "Tagging, signing and actually uploading should be left to dgit push."
343 msgstr ""
344
345 #. type: Plain text
346 #: ../dgit.1:152
347 msgid ""
348 "dgit's build operations access the network, to get the -v option right.  See "
349 "-v, below."
350 msgstr ""
351
352 #. type: TP
353 #: ../dgit.1:152
354 #, no-wrap
355 msgid "B<dgit build-source> ..."
356 msgstr ""
357
358 #. type: Plain text
359 #: ../dgit.1:161
360 msgid ""
361 "Builds the source package, and a changes file for a prospective source-only "
362 "upload, using B<dpkg-source>.  The output is left in "
363 "I<package>B<_>I<version>B<.dsc> and I<package>B<_>I<version>B<_source."
364 "changes>."
365 msgstr ""
366
367 #. type: Plain text
368 #: ../dgit.1:164
369 msgid ""
370 "Tagging, signing and actually uploading should be left to dgit push-source, "
371 "or dgit push."
372 msgstr ""
373
374 #. type: TP
375 #: ../dgit.1:164
376 #, no-wrap
377 msgid "B<dgit clean>"
378 msgstr ""
379
380 #. type: Plain text
381 #: ../dgit.1:168
382 msgid ""
383 "Cleans the current working tree (according to the --clean= option in force)."
384 msgstr ""
385
386 #. type: TP
387 #: ../dgit.1:168
388 #, no-wrap
389 msgid "B<dgit update-vcs-git> [I<suite>|B<.>] [B<-->] [I<git fetch options>]"
390 msgstr ""
391
392 #. type: TQ
393 #: ../dgit.1:170
394 #, no-wrap
395 msgid "B<dgit update-vcs-git> [I<suite|>B<.>] B<->"
396 msgstr ""
397
398 #. type: Plain text
399 #: ../dgit.1:175
400 msgid ""
401 "Sets up, or updates the url of, the vcs-git remote, and (unless B<-> was "
402 "specified)  runs git fetch on it."
403 msgstr ""
404
405 #. type: Plain text
406 #: ../dgit.1:182
407 msgid ""
408 "By default, the Vcs-Git field of the .dsc from Debian sid is used, as that "
409 "is probably most up to date.  Another suite may be specified, or B<.> to "
410 "indicate that the Vcs-Git of the cwd's debian/control should be used instead."
411 msgstr ""
412
413 #. type: TP
414 #: ../dgit.1:182
415 #, no-wrap
416 msgid "B<dgit help>"
417 msgstr ""
418
419 #. type: Plain text
420 #: ../dgit.1:185 ../dgit.1:1192
421 msgid "Print a usage summary."
422 msgstr ""
423
424 #. type: TP
425 #: ../dgit.1:185
426 #, no-wrap
427 msgid "B<dgit sbuild> ..."
428 msgstr ""
429
430 #. type: Plain text
431 #: ../dgit.1:194
432 msgid ""
433 "Constructs the source package, uses B<sbuild> to do a binary build, and uses "
434 "mergechanges to merge the source and binary changes files.  Options and "
435 "arguments after sbuild will be passed on to sbuild.  The output is left in "
436 "I<package>B<_>I<version>B<_multi.changes>."
437 msgstr ""
438
439 #. type: Plain text
440 #: ../dgit.1:198
441 msgid ""
442 "Note that by default sbuild does not build arch-independent packages.  You "
443 "probably want to pass -A, to request those."
444 msgstr ""
445
446 #. type: TP
447 #: ../dgit.1:200
448 #, no-wrap
449 msgid "B<dgit pbuilder> [I<debbuildopts>]"
450 msgstr ""
451
452 #. type: Plain text
453 #: ../dgit.1:208
454 msgid ""
455 "Constructs the source package, uses B<pbuilder> to do a binary build, and "
456 "uses mergechanges to merge the source and binary changes files.  The output "
457 "is left in I<package>B<_>I<version>B<_multi.changes>."
458 msgstr ""
459
460 #. type: Plain text
461 #: ../dgit.1:211
462 msgid ""
463 "You should ensure that your dgit --build-products-dir setting matches your "
464 "pbuilder --buildresult."
465 msgstr ""
466
467 #. type: Plain text
468 #: ../dgit.1:217
469 msgid ""
470 "The I<debbuildopts> are passed to pbuilder using its --debbuildopts option.  "
471 "If you want to pass other options to pbuilder, use the B<--pbuilder:> dgit "
472 "option as described below (remember that dgit options should appear between "
473 "B<dgit> and B<pbuilder>)."
474 msgstr ""
475
476 #. type: Plain text
477 #: ../dgit.1:223
478 msgid ""
479 "You should ensure that in your pbuilderrc you do B<not> have the setting "
480 "B<SOURCE_ONLY_CHANGES=yes> as this may cause trouble."
481 msgstr ""
482
483 #. type: TP
484 #: ../dgit.1:223
485 #, no-wrap
486 msgid "B<dgit cowbuilder> [I<debbuildopts>]"
487 msgstr ""
488
489 #. type: Plain text
490 #: ../dgit.1:229
491 msgid "Like B<dgit pbuilder>, but uses B<cowbuilder> instead of B<pbuilder.>"
492 msgstr ""
493
494 #. type: TP
495 #: ../dgit.1:229
496 #, no-wrap
497 msgid "B<dgit gbp-build> ..."
498 msgstr ""
499
500 #. type: Plain text
501 #: ../dgit.1:235
502 msgid ""
503 "Runs B<git-buildpackage> with some suitable options.  Options and arguments "
504 "after gbp-build will be passed on to git-buildpackage."
505 msgstr ""
506
507 #. type: Plain text
508 #: ../dgit.1:238
509 msgid ""
510 "By default this uses --quilt=gbp, so HEAD should be a git-buildpackage style "
511 "branch, not a patches-applied branch."
512 msgstr ""
513
514 #. type: TP
515 #: ../dgit.1:240
516 #, no-wrap
517 msgid "B<dgit push> [I<suite>]"
518 msgstr ""
519
520 #. type: Plain text
521 #: ../dgit.1:249
522 msgid ""
523 "Does an `upload', pushing the current HEAD to the archive (as a source "
524 "package) and to dgit-repos (as git commits).  The package must already have "
525 "been built ready for upload, with the .dsc and .changes left in the parent "
526 "directory.  It is normally best to do the build with dgit too (eg with dgit "
527 "sbuild): some existing build tools pass unhelpful options to dpkg-source et "
528 "al by default, which can result in the built source package not being "
529 "identical to the git tree."
530 msgstr ""
531
532 #. type: Plain text
533 #: ../dgit.1:259
534 msgid ""
535 "In more detail: dgit push checks that the current HEAD corresponds to the ."
536 "dsc.  It then pushes the HEAD to the suite's dgit-repos branch, adjusts the ."
537 "changes to include any .origs which the archive lacks and exclude .origs "
538 "which the archive has (so -sa and -sd are not needed when building for dgit "
539 "push), makes a signed git tag, edits the .dsc to contain the dgit metadata "
540 "field, runs debsign to sign the upload (.dsc and .changes), pushes the "
541 "signed tag, and finally uses dput to upload the .changes to the archive."
542 msgstr ""
543
544 #. type: Plain text
545 #: ../dgit.1:263
546 msgid ""
547 "dgit push always uses the package, suite and version specified in the debian/"
548 "changelog and the .dsc, which must agree.  If the command line specifies a "
549 "suite then that must match too."
550 msgstr ""
551
552 #. type: Plain text
553 #: ../dgit.1:268
554 msgid ""
555 "When used on a git-debrebase branch, dgit calls git-debrebase to prepare the "
556 "branch for source package upload and push."
557 msgstr ""
558
559 #. type: TP
560 #: ../dgit.1:268
561 #, no-wrap
562 msgid "B<dgit push-source> [I<suite>]"
563 msgstr ""
564
565 #. type: Plain text
566 #: ../dgit.1:273
567 msgid ""
568 "Without B<-C>, builds a source package and dgit pushes it.  Saying B<dgit "
569 "push-source> is like saying \"update the source code in the archive to match "
570 "my git HEAD, and let the autobuilders do the rest.\""
571 msgstr ""
572
573 #. type: Plain text
574 #: ../dgit.1:276
575 msgid ""
576 "With B<-C>, performs a dgit push, additionally ensuring that no binary "
577 "packages are uploaded."
578 msgstr ""
579
580 #. type: TP
581 #: ../dgit.1:276
582 #, no-wrap
583 msgid "B<dgit rpush> I<build-host>B<:>I<build-dir> [I<push args...>]"
584 msgstr ""
585
586 #. type: Plain text
587 #: ../dgit.1:283
588 msgid ""
589 "Pushes the contents of the specified directory on a remote machine.  This is "
590 "like running dgit push on build-host with build-dir as the current "
591 "directory; however, signing operations are done on the invoking host.  This "
592 "allows you to do a push when the system which has the source code and the "
593 "build outputs has no access to the key:"
594 msgstr ""
595
596 #. type: =item
597 #: ../dgit.1:286 ../dgit-maint-merge.7.pod:446
598 #, no-wrap
599 msgid "1."
600 msgstr ""
601
602 #. type: tbl table
603 #: ../dgit.1:286
604 #, no-wrap
605 msgid "Clone on build host (dgit clone)"
606 msgstr ""
607
608 #. type: =item
609 #: ../dgit.1:287 ../dgit-maint-merge.7.pod:450
610 #, no-wrap
611 msgid "2."
612 msgstr ""
613
614 #. type: tbl table
615 #: ../dgit.1:287
616 #, no-wrap
617 msgid "Edit code on build host (edit, git commit)"
618 msgstr ""
619
620 #. type: =item
621 #: ../dgit.1:288 ../dgit-maint-merge.7.pod:455
622 #, no-wrap
623 msgid "3."
624 msgstr ""
625
626 #. type: tbl table
627 #: ../dgit.1:288
628 #, no-wrap
629 msgid "Build package on build host (dgit build)"
630 msgstr ""
631
632 #. type: tbl table
633 #: ../dgit.1:289
634 #, no-wrap
635 msgid "4."
636 msgstr ""
637
638 #. type: tbl table
639 #: ../dgit.1:289
640 #, no-wrap
641 msgid "Test package on build host or elsewhere (dpkg -i, test)"
642 msgstr ""
643
644 #. type: tbl table
645 #: ../dgit.1:290
646 #, no-wrap
647 msgid "5."
648 msgstr ""
649
650 #. type: tbl table
651 #: ../dgit.1:290
652 #, no-wrap
653 msgid "Upload by invoking dgit rpush on host with your GPG key."
654 msgstr ""
655
656 #. type: Plain text
657 #: ../dgit.1:296
658 msgid ""
659 "However, the build-host must be able to ssh to the dgit repos.  If this is "
660 "not already the case, you must organise it separately, for example by the "
661 "use of ssh agent forwarding."
662 msgstr ""
663
664 #. type: Plain text
665 #: ../dgit.1:299
666 msgid ""
667 "The remaining arguments are treated just as dgit push would handle them."
668 msgstr ""
669
670 #. type: Plain text
671 #: ../dgit.1:304
672 msgid ""
673 "build-host and build-dir can be passed as separate arguments; this is "
674 "assumed to be the case if the first argument contains no : (except perhaps "
675 "one in [ ], to support IPv6 address literals)."
676 msgstr ""
677
678 #. type: Plain text
679 #: ../dgit.1:308
680 msgid ""
681 "You will need similar enough versions of dgit on the build-host and the "
682 "invocation host.  The build-host needs gnupg installed, with your public key "
683 "in its keyring (but not your private key, obviously)."
684 msgstr ""
685
686 #. type: TP
687 #: ../dgit.1:308
688 #, no-wrap
689 msgid "B<dgit setup-new-tree>"
690 msgstr ""
691
692 #. type: Plain text
693 #: ../dgit.1:324
694 msgid ""
695 "Configure the current working tree the way that dgit clone would have set it "
696 "up.  Like running B<dgit setup-useremail>, B<setup-mergechangelogs> and "
697 "B<setup-gitattributes> (but only does each thing if dgit is configured to do "
698 "it automatically).  You can use these in any git repository, not just ones "
699 "used with the other dgit operations.  Does B<not> run B<update-vcs-git> (as "
700 "that requires Debian packaging information)."
701 msgstr ""
702
703 #. type: TP
704 #: ../dgit.1:324
705 #, no-wrap
706 msgid "B<dgit setup-useremail>"
707 msgstr ""
708
709 #. type: Plain text
710 #: ../dgit.1:330
711 msgid ""
712 "Set the working tree's user.name and user.email from the distro-specific "
713 "dgit configuration (B<dgit-distro.>I<distro>B<.user-name> and B<.user-"
714 "email>), or DEBFULLNAME or DEBEMAIL."
715 msgstr ""
716
717 #. type: TP
718 #: ../dgit.1:330
719 #, no-wrap
720 msgid "B<dgit setup-mergechangelogs>"
721 msgstr ""
722
723 #. type: Plain text
724 #: ../dgit.1:336
725 msgid ""
726 "Configures a git merge helper for the file B<debian/changelog> which uses "
727 "B<dpkg-mergechangelogs>."
728 msgstr ""
729
730 #. type: TP
731 #: ../dgit.1:336
732 #, no-wrap
733 msgid "B<dgit setup-gitattributes>"
734 msgstr ""
735
736 #. type: Plain text
737 #: ../dgit.1:351
738 msgid ""
739 "Set up the working tree's B<.git/info/attributes> to disable all "
740 "transforming attributes for all files.  This is done by defining a macro "
741 "attribute, B<dgit-defuse-attrs,> and applying it to B<*>.  For why, see "
742 "B<GITATTRIBUTES> in B<dgit(7)>.  Note that only attributes affecting the "
743 "working tree are suppressed.  git-archive may remain exciting."
744 msgstr ""
745
746 #. type: Plain text
747 #: ../dgit.1:359
748 msgid ""
749 "If there is an existing macro attribute line B<[attr]dgit-defuse-attrs> in ."
750 "git/info/attributes, but it is insufficient, because it was made by an "
751 "earlier version of dgit and git has since introduced new transforming "
752 "attributes, this modifies the macro to disable the newer transformations."
753 msgstr ""
754
755 #. type: Plain text
756 #: ../dgit.1:370
757 msgid ""
758 "(If there is already a macro attribute line B<[attr]dgit-defuse-attrs> in ."
759 "git/info/attributes which does what dgit requires (whatever files it "
760 "effects), this operation does nothing further.  This fact can be used to "
761 "defeat or partially defeat dgit setup-gitattributes and hence dgit setup-new-"
762 "tree.)"
763 msgstr ""
764
765 #. type: TP
766 #: ../dgit.1:370
767 #, no-wrap
768 msgid "B<dgit quilt-fixup>"
769 msgstr ""
770
771 #. type: Plain text
772 #: ../dgit.1:377
773 msgid ""
774 "`3.0 (quilt)' format source packages need changes representing not only in-"
775 "tree but also as patches in debian/patches.  dgit quilt-fixup checks whether "
776 "this has been done; if not, dgit will make appropriate patches in debian/"
777 "patches and also commit the resulting changes to git."
778 msgstr ""
779
780 #. type: Plain text
781 #: ../dgit.1:379
782 msgid "This is normally done automatically by dgit build and dgit push."
783 msgstr ""
784
785 #. type: Plain text
786 #: ../dgit.1:385
787 msgid ""
788 "dgit will try to turn each relevant commit in your git history into a new "
789 "quilt patch.  dgit cannot convert nontrivial merges, or certain other kinds "
790 "of more exotic history.  If dgit can't find a suitable linearisation of your "
791 "history, by default it will fail, but you can ask it to generate a single "
792 "squashed patch instead."
793 msgstr ""
794
795 #. type: Plain text
796 #: ../dgit.1:394
797 msgid ""
798 "When used with a git-debrebase branch, dgit will ask git-debrebase to "
799 "prepare patches.  However, dgit can make patches in some situations where "
800 "git-debrebase fails, so dgit quilt-fixup can be useful in its own right.  To "
801 "always use dgit's own patch generator instead of git-debrebase make-patches, "
802 "pass --git-debrebase=true to dgit."
803 msgstr ""
804
805 #. type: Plain text
806 #: ../dgit.1:399
807 msgid "See B<FORMAT 3.0 (QUILT)> in B<dgit(7)>."
808 msgstr ""
809
810 #. type: TP
811 #: ../dgit.1:399
812 #, no-wrap
813 msgid "B<dgit import-dsc> [I<sub-options>] I<../path/to/.dsc> [B<+>|B<..>]branch"
814 msgstr ""
815
816 #. type: Plain text
817 #: ../dgit.1:405
818 msgid ""
819 "Import a Debian-format source package, specified by its .dsc, into git, the "
820 "way dgit fetch would do."
821 msgstr ""
822
823 #. type: Plain text
824 #: ../dgit.1:416
825 msgid ""
826 "This does about half the work of dgit fetch: it will convert the .dsc into a "
827 "new, orphan git branch.  Since dgit has no access to a corresponding source "
828 "package archive or knowledge of the history it does not consider whether "
829 "this version is newer than any previous import or corresponding git "
830 "branches; and it therefore does not make a pseudomerge to bind the import "
831 "into any existing git history."
832 msgstr ""
833
834 #. type: Plain text
835 #: ../dgit.1:426
836 msgid ""
837 "Because a .dsc can contain a Dgit field naming a git commit (which you might "
838 "not have), and specifying where to find that commit (and any history rewrite "
839 "table), import-dsc might need online access.  If this is a problem (or "
840 "dgit's efforts to find the commit fail), consider --no-chase-dsc-distro or --"
841 "force-import-dsc-with-dgit-field."
842 msgstr ""
843
844 #. type: Plain text
845 #: ../dgit.1:428
846 msgid "There is only one sub-option:"
847 msgstr ""
848
849 #. type: Plain text
850 #: ../dgit.1:434
851 msgid ""
852 "B<--require-valid-signature> causes dgit to insist that the signature on "
853 "the .dsc is valid (using the same criteria as dpkg-source -x).  Otherwise, "
854 "dgit tries to verify the signature but the outcome is reported only as "
855 "messages to stderr."
856 msgstr ""
857
858 #. type: Plain text
859 #: ../dgit.1:453
860 msgid ""
861 "If I<branch> is prefixed with B<+> then if it already exists, it will be "
862 "simply overwritten, no matter its existing contents.  If I<branch> is "
863 "prefixed with B<..> then if it already exists and dgit actually imports the "
864 "dsc (rather than simply reading the git commit out of the Dgit field), dgit "
865 "will make a pseudomerge so that the result is necessarily fast forward from "
866 "the existing branch.  Otherwise, if I<branch> already exists, dgit will stop "
867 "with an error message."
868 msgstr ""
869
870 #. type: Plain text
871 #: ../dgit.1:457
872 msgid "If I<branch> does not start with refs/, refs/heads/ is prepended."
873 msgstr ""
874
875 #. type: TP
876 #: ../dgit.1:457
877 #, no-wrap
878 msgid "B<dgit version>"
879 msgstr ""
880
881 #. type: Plain text
882 #: ../dgit.1:460
883 msgid "Prints version information and exits."
884 msgstr ""
885
886 #. type: TP
887 #: ../dgit.1:460
888 #, no-wrap
889 msgid "B<dgit clone-dgit-repos-server>I< destdir>"
890 msgstr ""
891
892 #. type: Plain text
893 #: ../dgit.1:464
894 msgid ""
895 "Tries to fetch a copy of the source code for the dgit-repos-server, as "
896 "actually being used on the dgit git server, as a git tree."
897 msgstr ""
898
899 #. type: TP
900 #: ../dgit.1:464
901 #, no-wrap
902 msgid "B<dgit print-dgit-repos-server-source-url>"
903 msgstr ""
904
905 #. type: Plain text
906 #: ../dgit.1:469
907 msgid ""
908 "Prints the url used by dgit clone-dgit-repos-server.  This is hopefully "
909 "suitable for use as a git remote url.  It may not be useable in a browser."
910 msgstr ""
911
912 #. type: TP
913 #: ../dgit.1:469
914 #, no-wrap
915 msgid "B<dgit print-dpkg-source-ignores>"
916 msgstr ""
917
918 #. type: Plain text
919 #: ../dgit.1:476
920 msgid ""
921 "Prints the -i and -I arguments which must be passed to dpkg-souce to cause "
922 "it to exclude exactly the .git directory and nothing else.  The separate "
923 "arguments are unquoted, separated by spaces, and do not contain spaces."
924 msgstr ""
925
926 #. type: TP
927 #: ../dgit.1:476
928 #, no-wrap
929 msgid "B<dgit print-unapplied-treeish>"
930 msgstr ""
931
932 #. type: Plain text
933 #: ../dgit.1:487
934 msgid ""
935 "Constructs a tree-ish approximating the patches-unapplied state of your 3.0 "
936 "(quilt) package, and prints the git object name to stdout.  This requires "
937 "appropriate .orig tarballs.  This tree object is identical to your .origs as "
938 "regards upstream files.  The contents of the debian subdirectory is not "
939 "interesting and should not be inspected; except that debian/patches will be "
940 "identical to your HEAD."
941 msgstr ""
942
943 #. type: Plain text
944 #: ../dgit.1:494
945 msgid ""
946 "To make this operate off-line, the access configuration key which is used to "
947 "determine the build-products-dir is the uncanonicalised version of the suite "
948 "name from the changelog, or (of course) dgit.default.build-products-dir.  "
949 "See ACCESS CONFIGURATION, below."
950 msgstr ""
951
952 #. type: Plain text
953 #: ../dgit.1:496
954 msgid "This function is primarily provided for the benefit of git-debrebase."
955 msgstr ""
956
957 #. type: =head1
958 #: ../dgit.1:496 ../git-debrebase.1.pod:462
959 #, no-wrap
960 msgid "OPTIONS"
961 msgstr ""
962
963 #. type: TP
964 #: ../dgit.1:497
965 #, no-wrap
966 msgid "B<--dry-run> | B<-n>"
967 msgstr ""
968
969 #. type: Plain text
970 #: ../dgit.1:503
971 msgid ""
972 "Go through the motions, fetching all information needed, but do not actually "
973 "update the output(s).  For push, dgit does the required checks and leaves "
974 "the new .dsc in a temporary file, but does not sign, tag, push or upload."
975 msgstr ""
976
977 #. type: TP
978 #: ../dgit.1:503
979 #, no-wrap
980 msgid "B<--damp-run> | B<-L>"
981 msgstr ""
982
983 #. type: Plain text
984 #: ../dgit.1:508
985 msgid ""
986 "Go through many more of the motions: do everything that doesn't involve "
987 "either signing things, or making changes on the public servers."
988 msgstr ""
989
990 #. type: TP
991 #: ../dgit.1:508
992 #, no-wrap
993 msgid "B<-k>I<keyid>"
994 msgstr ""
995
996 #. type: Plain text
997 #: ../dgit.1:517
998 msgid ""
999 "Use I<keyid> for signing the tag and the upload.  The default comes from the "
1000 "distro's B<keyid> config setting (see CONFIGURATION, below), or failing "
1001 "that, the uploader trailer line in debian/changelog."
1002 msgstr ""
1003
1004 #. type: TP
1005 #: ../dgit.1:517
1006 #, no-wrap
1007 msgid "B<--no-sign>"
1008 msgstr ""
1009
1010 #. type: Plain text
1011 #: ../dgit.1:520
1012 msgid "does not sign tags or uploads (meaningful only with push)."
1013 msgstr ""
1014
1015 #. type: TP
1016 #: ../dgit.1:521
1017 #, no-wrap
1018 msgid "B<-p>I<package>"
1019 msgstr ""
1020
1021 #. type: Plain text
1022 #: ../dgit.1:527
1023 msgid ""
1024 "Specifies that we should process source package I<package> rather than "
1025 "looking in debian/control or debian/changelog.  Valid with dgit fetch and "
1026 "dgit pull, only."
1027 msgstr ""
1028
1029 #. type: TP
1030 #: ../dgit.1:527
1031 #, no-wrap
1032 msgid "B<--clean=git> | B<-wg>"
1033 msgstr ""
1034
1035 #. type: Plain text
1036 #: ../dgit.1:533
1037 msgid ""
1038 "Use B<git clean -xdf> to clean the working tree, rather than running the "
1039 "package's rules clean target."
1040 msgstr ""
1041
1042 #. type: Plain text
1043 #: ../dgit.1:536
1044 msgid ""
1045 "This will delete all files which are not tracked by git.  (Including any "
1046 "files you forgot to git add.)"
1047 msgstr ""
1048
1049 #. type: Plain text
1050 #: ../dgit.1:541
1051 msgid ""
1052 "B<--clean=>I<...> options other than dpkg-source are useful when the "
1053 "package's clean target is troublesome, or to avoid needing the build-"
1054 "dependencies."
1055 msgstr ""
1056
1057 #. type: Plain text
1058 #: ../dgit.1:548
1059 msgid ""
1060 "dgit will only actually clean the tree if it needs to (because it needs to "
1061 "build the source package or binaries from your working tree).  Otherwise it "
1062 "will just check that there are no untracked unignored files.  See --"
1063 "clean=git[-ff],always, below."
1064 msgstr ""
1065
1066 #. type: TP
1067 #: ../dgit.1:548
1068 #, no-wrap
1069 msgid "B<--clean=git-ff> | B<-wgf>"
1070 msgstr ""
1071
1072 #. type: Plain text
1073 #: ../dgit.1:557
1074 msgid ""
1075 "Use B<git clean -xdff> to clean the working tree.  Like git clean -xdf but "
1076 "it also removes any subdirectories containing different git trees (which "
1077 "only unusual packages are likely to create)."
1078 msgstr ""
1079
1080 #. type: TP
1081 #: ../dgit.1:557
1082 #, no-wrap
1083 msgid "B<--clean=git>[B<-ff>]B<,always> | B<-wga> | B<-wgfa>"
1084 msgstr ""
1085
1086 #. type: Plain text
1087 #: ../dgit.1:561
1088 msgid ""
1089 "Like --clean=git, but always does the clean and not just a check, deleting "
1090 "any untracked un-ignored files."
1091 msgstr ""
1092
1093 #. type: TP
1094 #: ../dgit.1:561
1095 #, no-wrap
1096 msgid "B<--clean=check> | B<--clean=check,ignores> | B<-wc> | B<-wci>"
1097 msgstr ""
1098
1099 #. type: Plain text
1100 #: ../dgit.1:567
1101 msgid ""
1102 "Merely check that the tree is clean (does not contain uncommitted files).  "
1103 "Avoids running rules clean, and can avoid needing the build-dependencies."
1104 msgstr ""
1105
1106 #. type: Plain text
1107 #: ../dgit.1:578
1108 msgid ""
1109 "With B<,ignores> or B<-wci>, untracked files covered by .gitignore are "
1110 "tolerated, so only files which show up as B<?> in git status (ie, ones you "
1111 "maybe forgot to git add)  are treated as a problem."
1112 msgstr ""
1113
1114 #. type: TP
1115 #: ../dgit.1:578
1116 #, no-wrap
1117 msgid "B<--clean=none> | B<-wn>"
1118 msgstr ""
1119
1120 #. type: Plain text
1121 #: ../dgit.1:586
1122 msgid ""
1123 "Do not clean the tree, nor check that it is clean.  Avoids running rules "
1124 "clean, and can avoid needing the build-dependencies.  If there are files "
1125 "which are not in git, or if the build creates such files, a subsequent dgit "
1126 "push will fail."
1127 msgstr ""
1128
1129 #. type: TP
1130 #: ../dgit.1:586
1131 #, no-wrap
1132 msgid "B<--clean=dpkg-source>[B<-d>] | B<-wd> | B<-wdd>"
1133 msgstr ""
1134
1135 #. type: Plain text
1136 #: ../dgit.1:591
1137 msgid ""
1138 "Use dpkg-buildpackage to do the clean, so that the source package is cleaned "
1139 "by dpkg-source running the package's clean target.  --clean=dpkg-source is "
1140 "the default."
1141 msgstr ""
1142
1143 #. type: Plain text
1144 #: ../dgit.1:595
1145 msgid "Without the extra B<d>, requires the package's build dependencies."
1146 msgstr ""
1147
1148 #. type: Plain text
1149 #: ../dgit.1:605
1150 msgid ""
1151 "With B<...>-d or B<-wdd>, the build-dependencies are not checked (due to "
1152 "passing B<-d> to dpkg-buildpackage), which violates policy, but may work in "
1153 "practice."
1154 msgstr ""
1155
1156 #. type: Plain text
1157 #: ../dgit.1:612
1158 msgid ""
1159 "The rules clean target will only be run if it is needed: when dgit is going "
1160 "to build source or binary packages from your working tree, rather than from "
1161 "your git branch (for example because of --include-dirty or because the "
1162 "binary package build uses your working tree)."
1163 msgstr ""
1164
1165 #. type: Plain text
1166 #: ../dgit.1:622
1167 msgid ""
1168 "In all cases, dgit will check that there are (after rules clean, if "
1169 "applicable) no untracked un-ignored files, in case these are files you "
1170 "forgot to git add.  (Except that this check is not done for a `3.0 (quilt)' "
1171 "package when dgit has to apply patches, dirtily, to the working tree.)  If "
1172 "your package does not have a good .gitignore you will probably need --"
1173 "clean=dpkg-source,no-check aka -wdn."
1174 msgstr ""
1175
1176 #. type: TP
1177 #: ../dgit.1:622
1178 #, no-wrap
1179 msgid "B<--clean=dpkg-source>[B<-d>]B<,no-check> | B<-wdn> | B<-wddn>"
1180 msgstr ""
1181
1182 #. type: Plain text
1183 #: ../dgit.1:626
1184 msgid ""
1185 "Like --clean=dpkg-source, but does not care about untracked un-ignored files."
1186 msgstr ""
1187
1188 #. type: TP
1189 #: ../dgit.1:626
1190 #, no-wrap
1191 msgid "B<--clean=dpkg-source>[B<-d>]B<,all-check> | B<-wda> | B<-wdda>"
1192 msgstr ""
1193
1194 #. type: Plain text
1195 #: ../dgit.1:631
1196 msgid ""
1197 "Like --clean=dpkg-source, but fails even on ignored untracked files.  This "
1198 "could perhaps be used to detect bugs in your rules clean target."
1199 msgstr ""
1200
1201 #. type: TP
1202 #: ../dgit.1:631
1203 #, no-wrap
1204 msgid "B<-N> | B<--new>"
1205 msgstr ""
1206
1207 #. type: Plain text
1208 #: ../dgit.1:637
1209 msgid ""
1210 "The package is or may be new in this suite.  Without this, dgit will refuse "
1211 "to push.  It may (for Debian, will) be unable to access the git history for "
1212 "any packages which have been newly pushed and have not yet been published."
1213 msgstr ""
1214
1215 #. type: TP
1216 #: ../dgit.1:637
1217 #, no-wrap
1218 msgid "B<--include-dirty>"
1219 msgstr ""
1220
1221 #. type: Plain text
1222 #: ../dgit.1:645
1223 msgid ""
1224 "Do not complain if the working tree does not match your git HEAD, and when "
1225 "building, include the changes from your working tree.  This can be useful "
1226 "with build, if you plan to commit later.  (dgit push will still ensure that "
1227 "the .dsc you upload and the git tree you push are identical, so this option "
1228 "won't make broken pushes.)"
1229 msgstr ""
1230
1231 #. type: TP
1232 #: ../dgit.1:645
1233 #, no-wrap
1234 msgid "B<--ignore-dirty>"
1235 msgstr ""
1236
1237 #. type: Plain text
1238 #: ../dgit.1:648
1239 msgid "Deprecated alias for --include-dirty."
1240 msgstr ""
1241
1242 #. type: TP
1243 #: ../dgit.1:648
1244 #, no-wrap
1245 msgid "B<--overwrite>[=I<previous-version>]"
1246 msgstr ""
1247
1248 #. type: Plain text
1249 #: ../dgit.1:659
1250 msgid ""
1251 "Declare that your HEAD really does contain all the (wanted) changes from all "
1252 "versions listed in its changelog; or, all (wanted) changes from I<previous-"
1253 "version>.  This promise is needed when your git branch is not a descendant "
1254 "of the version in the archive according to the git revision history."
1255 msgstr ""
1256
1257 #. type: Plain text
1258 #: ../dgit.1:666
1259 msgid ""
1260 "It is safer not to specify I<previous-version>, and usually it's not "
1261 "needed.  Just say B<--overwrite>, unless you know what you are doing."
1262 msgstr ""
1263
1264 #. type: Plain text
1265 #: ../dgit.1:670
1266 msgid ""
1267 "This option is useful if you are the maintainer, and you have incorporated "
1268 "NMU changes into your own git workflow in a way that doesn't make your "
1269 "branch a fast forward from the NMU."
1270 msgstr ""
1271
1272 #. type: Plain text
1273 #: ../dgit.1:676
1274 msgid ""
1275 "This option is also usually necessary the first time a package is pushed "
1276 "with dgit push to a particular suite.  See B<dgit-maint->I<*>B<(7)>."
1277 msgstr ""
1278
1279 #. type: Plain text
1280 #: ../dgit.1:690
1281 msgid ""
1282 "If I<previous-version> is not specified, dgit will check that the version in "
1283 "the archive is mentioned in your debian/changelog.  (This will avoid losing "
1284 "changes, even with B<--overwrite>, unless someone committed to git a "
1285 "finalised changelog entry, and then made later changes to that version.)  If "
1286 "I<previous-version> is specified, it ought to be the version currently in "
1287 "the archive."
1288 msgstr ""
1289
1290 #. type: Plain text
1291 #: ../dgit.1:696
1292 msgid ""
1293 "dgit push --overwrite will, if necessary, make a pseudo-merge (that is, "
1294 "something that looks like the result of git merge -s ours) to stitch the "
1295 "archive's version into your own git history, so that your push is a fast "
1296 "forward from the archive."
1297 msgstr ""
1298
1299 #. type: Plain text
1300 #: ../dgit.1:701
1301 msgid ""
1302 "(In quilt mode B<gbp>, B<dpm> or B<unpatched>, implying a split between the "
1303 "dgit view and the maintainer view, the pseudo-merge will appear only in the "
1304 "dgit view.)"
1305 msgstr ""
1306
1307 #. type: TP
1308 #: ../dgit.1:701
1309 #, no-wrap
1310 msgid "B<--delayed>=I<days>"
1311 msgstr ""
1312
1313 #. type: Plain text
1314 #: ../dgit.1:704
1315 msgid "Upload to a DELAYED queue."
1316 msgstr ""
1317
1318 #. type: Plain text
1319 #: ../dgit.1:714
1320 msgid ""
1321 "B<WARNING:> If the maintainer responds by cancelling your upload from the "
1322 "queue, and does not make an upload of their own, this will not rewind the "
1323 "git branch on the dgit git server.  Other dgit users will then see your push "
1324 "(with a warning message from dgit)  even though the maintainer wanted to "
1325 "abolish it.  Such users might unwittingly reintroduce your changes."
1326 msgstr ""
1327
1328 #. type: Plain text
1329 #: ../dgit.1:719
1330 msgid ""
1331 "If this situation arises, someone should make a suitable dgit push to update "
1332 "the contents of dgit-repos to a version without the controversial changes."
1333 msgstr ""
1334
1335 #. type: TP
1336 #: ../dgit.1:719
1337 #, no-wrap
1338 msgid "B<--no-chase-dsc-distro>"
1339 msgstr ""
1340
1341 #. type: Plain text
1342 #: ../dgit.1:725
1343 msgid ""
1344 "Tells dgit not to look online for additional git repositories containing "
1345 "information about a particular .dsc being imported.  Chasing is the default."
1346 msgstr ""
1347
1348 #. type: Plain text
1349 #: ../dgit.1:735
1350 msgid ""
1351 "For most operations (such as fetch and pull), disabling chasing means dgit "
1352 "will access only the git server for the distro you are directly working "
1353 "with, even if the .dsc was copied verbatim from another distro.  For import-"
1354 "dsc, disabling chasing means dgit will work completely offline."
1355 msgstr ""
1356
1357 #. type: Plain text
1358 #: ../dgit.1:743
1359 msgid ""
1360 "Disabling chasing can be hazardous: if the .dsc names a git commit which has "
1361 "been rewritten by those in charge of the distro, this option may prevent "
1362 "that rewrite from being effective.  Also, it can mean that dgit fails to "
1363 "find necessary git commits."
1364 msgstr ""
1365
1366 #. type: TP
1367 #: ../dgit.1:743
1368 #, no-wrap
1369 msgid "B<--save-dgit-view=>I<branch>|I<ref>"
1370 msgstr ""
1371
1372 #. type: Plain text
1373 #: ../dgit.1:753
1374 msgid ""
1375 "Specifies that when a split view quilt mode is in operation, and dgit "
1376 "calculates (or looks up in its cache)  a dgit view corresponding to your "
1377 "HEAD, the dgit view will be left in I<ref>.  The specified ref is "
1378 "unconditionally overwritten, so don't specify a branch you want to keep."
1379 msgstr ""
1380
1381 #. type: Plain text
1382 #: ../dgit.1:760
1383 msgid ""
1384 "This option is effective only with the following operations: quilt-fixup; "
1385 "push; all builds.  And it is only effective with --[quilt=]gbp, --"
1386 "[quilt=]dpm, --quilt=unpatched."
1387 msgstr ""
1388
1389 #. type: Plain text
1390 #: ../dgit.1:764
1391 msgid ""
1392 "If ref does not start with refs/ it is taken to be a branch - i.e. refs/"
1393 "heads/ is prepended."
1394 msgstr ""
1395
1396 #. type: Plain text
1397 #: ../dgit.1:768
1398 msgid "B<--dgit-view-save> is a deprecated alias for --save-dgit-view."
1399 msgstr ""
1400
1401 #. type: TP
1402 #: ../dgit.1:768
1403 #, no-wrap
1404 msgid "B<--deliberately->I<something>"
1405 msgstr ""
1406
1407 #. type: Plain text
1408 #: ../dgit.1:782
1409 msgid ""
1410 "Declare that you are deliberately doing I<something>.  This can be used to "
1411 "override safety catches, including safety catches which relate to distro-"
1412 "specific policies.  The use of --deliberately is declared and published in "
1413 "the signed tags generated for you by dgit, so that the archive software can "
1414 "give effect to your intent, and for the benefit of humans looking at the "
1415 "history.  The meanings of I<something>s understood in the context of Debian "
1416 "are discussed below:"
1417 msgstr ""
1418
1419 #. type: TP
1420 #: ../dgit.1:782
1421 #, no-wrap
1422 msgid "B<--deliberately-not-fast-forward>"
1423 msgstr ""
1424
1425 #. type: Plain text
1426 #: ../dgit.1:788
1427 msgid ""
1428 "Declare that you are deliberately rewinding history.  When pushing to "
1429 "Debian, use this when you are making a renewed upload of an entirely new "
1430 "source package whose previous version was not accepted for release from NEW "
1431 "because of problems with copyright or redistributibility."
1432 msgstr ""
1433
1434 #. type: Plain text
1435 #: ../dgit.1:799
1436 msgid ""
1437 "In split view quilt modes, this also prevents the construction by dgit of a "
1438 "pseudomerge to make the dgit view fast forwarding.  Normally only one of --"
1439 "overwrite (which creates a suitable pseudomerge)  and --deliberately-not-"
1440 "fast-forward (which suppresses the pseudomerge and the fast forward checks)  "
1441 "should be needed; --overwrite is usually better."
1442 msgstr ""
1443
1444 #. type: TP
1445 #: ../dgit.1:799
1446 #, no-wrap
1447 msgid "B<--deliberately-include-questionable-history>"
1448 msgstr ""
1449
1450 #. type: Plain text
1451 #: ../dgit.1:808
1452 msgid ""
1453 "Declare that you are deliberately including, in the git history of your "
1454 "current push, history which contains a previously-submitted version of this "
1455 "package which was not approved (or has not yet been approved) by the "
1456 "ftpmasters.  When pushing to Debian, only use this option after verifying "
1457 "that: none of the rejected-from-NEW (or never-accepted) versions in the git "
1458 "history of your current push, were rejected by ftpmaster for copyright or "
1459 "redistributability reasons."
1460 msgstr ""
1461
1462 #. type: TP
1463 #: ../dgit.1:808
1464 #, no-wrap
1465 msgid "B<--deliberately-fresh-repo>"
1466 msgstr ""
1467
1468 #. type: Plain text
1469 #: ../dgit.1:813
1470 msgid ""
1471 "Declare that you are deliberately rewinding history and want to throw away "
1472 "the existing repo.  Not relevant when pushing to Debian, as the Debian "
1473 "server will do this automatically when necessary."
1474 msgstr ""
1475
1476 #. type: TP
1477 #: ../dgit.1:813
1478 #, no-wrap
1479 msgid "B<--quilt=linear>"
1480 msgstr ""
1481
1482 #. type: Plain text
1483 #: ../dgit.1:820
1484 msgid ""
1485 "When fixing up source format `3.0 (quilt)' metadata, insist on generating a "
1486 "linear patch stack: one new patch for each relevant commit.  If such a stack "
1487 "cannot be generated, fail.  This is the default for Debian."
1488 msgstr ""
1489
1490 #. type: Plain text
1491 #: ../dgit.1:825
1492 msgid ""
1493 "HEAD should be a series of plain commits (not touching debian/patches/), and "
1494 "pseudomerges, with as ancestor a patches-applied branch."
1495 msgstr ""
1496
1497 #. type: TP
1498 #: ../dgit.1:825
1499 #, no-wrap
1500 msgid "B<--quilt=auto>"
1501 msgstr ""
1502
1503 #. type: Plain text
1504 #: ../dgit.1:834
1505 msgid ""
1506 "When fixing up source format `3.0 (quilt)' metadata, prefer to generate a "
1507 "linear patch stack (as with --quilt=auto)  but if that doesn't seem "
1508 "possible, try to generate a single squashed patch for all the changes made "
1509 "in git (as with --quilt=smash).  This is not a good idea for an NMU in "
1510 "Debian."
1511 msgstr ""
1512
1513 #. type: TP
1514 #: ../dgit.1:834
1515 #, no-wrap
1516 msgid "B<--quilt=smash>"
1517 msgstr ""
1518
1519 #. type: Plain text
1520 #: ../dgit.1:839
1521 msgid ""
1522 "When fixing up source format `3.0 (quilt)' metadata, generate a single "
1523 "additional patch for all the changes made in git.  This is not a good idea "
1524 "for an NMU in Debian."
1525 msgstr ""
1526
1527 #. type: Plain text
1528 #: ../dgit.1:845
1529 msgid ""
1530 "(If HEAD has any in-tree patches already, they must apply cleanly.  This "
1531 "will be the case for any trees produced by dgit fetch or clone; if you do "
1532 "not change the upstream version nor make changes in debian/patches, it will "
1533 "remain true.)"
1534 msgstr ""
1535
1536 #. type: TP
1537 #: ../dgit.1:845
1538 #, no-wrap
1539 msgid "B<--quilt=nofix>"
1540 msgstr ""
1541
1542 #. type: Plain text
1543 #: ../dgit.1:853
1544 msgid ""
1545 "Check whether source format `3.0 (quilt)' metadata would need fixing up, "
1546 "but, if it does, fail.  You must then fix the metadata yourself somehow "
1547 "before pushing.  (NB that dpkg-source --commit will not work because the "
1548 "dgit git tree does not have a B<.pc> directory.)"
1549 msgstr ""
1550
1551 #. type: TP
1552 #: ../dgit.1:853
1553 #, no-wrap
1554 msgid "B<--quilt=nocheck> | B<--no-quilt-fixup>"
1555 msgstr ""
1556
1557 #. type: Plain text
1558 #: ../dgit.1:858
1559 msgid ""
1560 "Do not check whether source format `3.0 (quilt)' metadata needs fixing up.  "
1561 "If you use this option and the metadata did in fact need fixing up, dgit "
1562 "push will fail."
1563 msgstr ""
1564
1565 #. type: TP
1566 #: ../dgit.1:858
1567 #, no-wrap
1568 msgid "B<-->[B<quilt=>]B<gbp> | B<-->[B<quilt=>]B<dpm> | B<--quilt=unapplied>"
1569 msgstr ""
1570
1571 #. type: Plain text
1572 #: ../dgit.1:865
1573 msgid ""
1574 "Tell dgit that you are using a nearly-dgit-compatible git branch, aka a "
1575 "B<maintainer view>, and do not want your branch changed by dgit."
1576 msgstr ""
1577
1578 #. type: Plain text
1579 #: ../dgit.1:873
1580 msgid ""
1581 "B<--gbp> (short for B<--quilt=gbp>)  is for use with git-buildpackage.  Your "
1582 "HEAD is expected to be a patches-unapplied git branch, except that it might "
1583 "contain changes to upstream .gitignore files.  This is the default for dgit "
1584 "gbp-build."
1585 msgstr ""
1586
1587 #. type: Plain text
1588 #: ../dgit.1:881
1589 msgid ""
1590 "B<--dpm> (short for B<--quilt=dpm>)  is for use with git-dpm.  Your HEAD is "
1591 "expected to be a patches-applied git branch, except that it might contain "
1592 "changes to upstream .gitignore files."
1593 msgstr ""
1594
1595 #. type: Plain text
1596 #: ../dgit.1:886
1597 msgid ""
1598 "B<--quilt=unapplied> specifies that your HEAD is a patches-unapplied git "
1599 "branch (and that any changes to upstream .gitignore files are represented as "
1600 "patches in debian/patches)."
1601 msgstr ""
1602
1603 #. type: Plain text
1604 #: ../dgit.1:904
1605 msgid ""
1606 "With --quilt=gbp|dpm|unapplied, dgit push (or precursors like quilt-fixup "
1607 "and build) will automatically generate a conversion of your git branch into "
1608 "the right form.  dgit push will push the dgit-compatible form (the B<dgit "
1609 "view>)  to the dgit git server.  The dgit view will be visible to you in the "
1610 "dgit remote tracking branches, but your own branch will not be modified.  "
1611 "dgit push will create a tag B<debian/>I<version> for the maintainer view, "
1612 "and the dgit tag B<archive/debian/>I<version> for the dgit view.  dgit quilt-"
1613 "fixup will merely do some checks, and cache the maintainer view."
1614 msgstr ""
1615
1616 #. type: Plain text
1617 #: ../dgit.1:913
1618 msgid ""
1619 "B<If you have a branch like this it is essential to specify the appropriate "
1620 "--quilt= option!> This is because it is not always possible to tell: a "
1621 "patches-unapplied git branch of a package with one patch, for example, looks "
1622 "very like a patches-applied branch where the user has used git revert to "
1623 "undo the patch, expecting to actually revert it.  However, if you fail to "
1624 "specify the right --quilt option, and you aren't too lucky, dgit will notice "
1625 "the problem and stop, with a useful hint."
1626 msgstr ""
1627
1628 #. type: TP
1629 #: ../dgit.1:913
1630 #, no-wrap
1631 msgid "B<-d>I<distro> | B<--distro=>I<distro>"
1632 msgstr ""
1633
1634 #. type: Plain text
1635 #: ../dgit.1:922
1636 msgid ""
1637 "Specifies that the suite to be operated on is part of distro I<distro>.  "
1638 "This overrides the default value found from the git config option B<dgit-"
1639 "suite.>I<suite>B<.distro>.  The only effect is that other configuration "
1640 "variables (used for accessing the archive and dgit-repos) used are B<dgit-"
1641 "distro.>I<distro>B<.*>."
1642 msgstr ""
1643
1644 #. type: Plain text
1645 #: ../dgit.1:928
1646 msgid ""
1647 "If your suite is part of a distro that dgit already knows about, you can use "
1648 "this option to make dgit work even if your dgit doesn't know about the "
1649 "suite.  For example, specifying B<-ddebian> will work when the suite is an "
1650 "unknown suite in the Debian archive."
1651 msgstr ""
1652
1653 #. type: Plain text
1654 #: ../dgit.1:933
1655 msgid ""
1656 "To define a new distro it is necessary to define methods and URLs for "
1657 "fetching (and, for dgit push, altering) a variety of information both in the "
1658 "archive and in dgit-repos.  How to set this up is not yet documented."
1659 msgstr ""
1660
1661 #. type: TP
1662 #: ../dgit.1:933
1663 #, no-wrap
1664 msgid "B<-C>I<changesfile>"
1665 msgstr ""
1666
1667 #. type: Plain text
1668 #: ../dgit.1:938
1669 msgid ""
1670 "Specifies the .changes file which is to be uploaded.  By default dgit push "
1671 "looks for a single .changes file in the parent directory whose filename "
1672 "suggests it is for the right package and version."
1673 msgstr ""
1674
1675 #. type: Plain text
1676 #: ../dgit.1:947
1677 msgid ""
1678 "If the specified I<changesfile> pathname contains slashes, the directory "
1679 "part is also used as the value for B<--build-products-dir>; otherwise, the "
1680 "changes file is expected in that directory (by default, in B<..>)."
1681 msgstr ""
1682
1683 #. type: TP
1684 #: ../dgit.1:947
1685 #, no-wrap
1686 msgid "B<--rm-old-changes>"
1687 msgstr ""
1688
1689 #. type: Plain text
1690 #: ../dgit.1:959
1691 msgid ""
1692 "When doing a build, delete any changes files matching "
1693 "I<package>B<_>I<version>B<_*.changes> before starting.  This ensures that "
1694 "dgit push (and dgit sbuild) will be able to unambiguously identify the "
1695 "relevant changes files from the most recent build, even if there have been "
1696 "previous builds with different tools or options.  The default is not to "
1697 "remove, but B<--no-rm-old-changes> can be used to override a previous --rm-"
1698 "old-changes or the .rm-old-changes configuration setting."
1699 msgstr ""
1700
1701 #. type: Plain text
1702 #: ../dgit.1:962
1703 msgid ""
1704 "Note that B<dgit push-source> will always find the right .changes, "
1705 "regardless of this option."
1706 msgstr ""
1707
1708 #. type: TP
1709 #: ../dgit.1:962
1710 #, no-wrap
1711 msgid "B<--build-products-dir=>I<directory>"
1712 msgstr ""
1713
1714 #. type: Plain text
1715 #: ../dgit.1:966
1716 msgid ""
1717 "Specifies where to find and create tarballs, binary packages, source "
1718 "packages, .changes files, and so on."
1719 msgstr ""
1720
1721 #. type: Plain text
1722 #: ../dgit.1:969
1723 msgid "By default, dgit uses the parent directory (B<..>)."
1724 msgstr ""
1725
1726 #. type: Plain text
1727 #: ../dgit.1:978
1728 msgid ""
1729 "Changing this setting may necessitate moving .orig tarballs to the new "
1730 "directory, so it is probably best to use the B<dgit.default.build-products-"
1731 "dir> configuration setting (see CONFIGURATION, below)  which this command "
1732 "line option overrides)."
1733 msgstr ""
1734
1735 #. type: TP
1736 #: ../dgit.1:978
1737 #, no-wrap
1738 msgid "B<--no-rm-on-error>"
1739 msgstr ""
1740
1741 #. type: Plain text
1742 #: ../dgit.1:981
1743 msgid "Do not delete the destination directory if clone fails."
1744 msgstr ""
1745
1746 #. type: TP
1747 #: ../dgit.1:981
1748 #, no-wrap
1749 msgid "B<--dep14tag>"
1750 msgstr ""
1751
1752 #. type: Plain text
1753 #: ../dgit.1:988
1754 msgid ""
1755 "Generates a DEP-14 tag (eg B<debian/>I<version>)  as well as a dgit tag (eg "
1756 "B<archive/debian/>I<version>)  where possible.  This is the default."
1757 msgstr ""
1758
1759 #. type: TP
1760 #: ../dgit.1:988
1761 #, no-wrap
1762 msgid "B<--no-dep14tag>"
1763 msgstr ""
1764
1765 #. type: Plain text
1766 #: ../dgit.1:994
1767 msgid ""
1768 "Do not generate a DEP-14 tag, except in split quilt view mode.  (On servers "
1769 "where only the old tag format is supported, the dgit tag will have the "
1770 "DEP-14 name.  This option does not prevent that.)"
1771 msgstr ""
1772
1773 #. type: TP
1774 #: ../dgit.1:994
1775 #, no-wrap
1776 msgid "B<--dep14tag-always>"
1777 msgstr ""
1778
1779 #. type: Plain text
1780 #: ../dgit.1:999
1781 msgid ""
1782 "Insist on generating a DEP-14 tag as well as a dgit tag.  If the server does "
1783 "not support that, dgit push will fail."
1784 msgstr ""
1785
1786 #. type: TP
1787 #: ../dgit.1:999
1788 #, no-wrap
1789 msgid "B<-D>"
1790 msgstr ""
1791
1792 #. type: Plain text
1793 #: ../dgit.1:1003
1794 msgid ""
1795 "Prints debugging information to stderr.  Repeating the option produces more "
1796 "output (currently, up to -DDDD is meaningfully different)."
1797 msgstr ""
1798
1799 #. type: TP
1800 #: ../dgit.1:1003
1801 #, no-wrap
1802 msgid "B<-c>I<name>B<=>I<value>"
1803 msgstr ""
1804
1805 #. type: Plain text
1806 #: ../dgit.1:1007
1807 msgid ""
1808 "Specifies a git configuration option, to be used for this run.  dgit itself "
1809 "is also controlled by git configuration options."
1810 msgstr ""
1811
1812 #. type: TP
1813 #: ../dgit.1:1007
1814 #, no-wrap
1815 msgid "B<-v>I<version>|B<_> | B<--since-version=>versionI<|>B<_>"
1816 msgstr ""
1817
1818 #. type: Plain text
1819 #: ../dgit.1:1016
1820 msgid ""
1821 "Specifies the B<-v>I<version> option to pass to dpkg-genchanges, during "
1822 "builds.  Changes (from debian/changelog) since this version will be included "
1823 "in the built changes file, and hence in the upload.  If this option is not "
1824 "specified, dgit will query the archive and use the latest version uploaded "
1825 "to the intended suite."
1826 msgstr ""
1827
1828 #. type: Plain text
1829 #: ../dgit.1:1022
1830 msgid ""
1831 "Specifying B<_> inhibits this, so that no -v option will be passed to dpkg-"
1832 "genchanges (and as a result, only the last stanza from debian/changelog will "
1833 "be used for the build and upload)."
1834 msgstr ""
1835
1836 #. type: TP
1837 #: ../dgit.1:1022
1838 #, no-wrap
1839 msgid "B<-m>I<maintaineraddress>"
1840 msgstr ""
1841
1842 #. type: Plain text
1843 #: ../dgit.1:1025
1844 msgid "Passed to dpkg-genchanges (eventually)."
1845 msgstr ""
1846
1847 #. type: TP
1848 #: ../dgit.1:1025
1849 #, no-wrap
1850 msgid "B<--ch:>I<option>"
1851 msgstr ""
1852
1853 #. type: Plain text
1854 #: ../dgit.1:1029
1855 msgid ""
1856 "Specifies a single additional option to pass, eventually, to dpkg-genchanges."
1857 msgstr ""
1858
1859 #. type: Plain text
1860 #: ../dgit.1:1036
1861 msgid ""
1862 "Options which are safe to pass include B<-C> (and also B<-si -sa -sd> "
1863 "although these should never be necessary with Debian since dgit "
1864 "automatically calculates whether .origs need to be uploaded.)"
1865 msgstr ""
1866
1867 #. type: Plain text
1868 #: ../dgit.1:1038
1869 msgid "For other options the caveat below applies."
1870 msgstr ""
1871
1872 #. type: TP
1873 #: ../dgit.1:1038
1874 #, no-wrap
1875 msgid "B<--curl:>I<option> | B<--dput:>I<option> |..."
1876 msgstr ""
1877
1878 #. type: Plain text
1879 #: ../dgit.1:1060
1880 msgid ""
1881 "Specifies a single additional option to pass to B<curl>, B<dput>, "
1882 "B<debsign>, B<dpkg-source>, B<dpkg-buildpackage>, B<dpkg-genchanges>, "
1883 "B<sbuild>, B<pbuilder>, B<cowbuilder>, B<ssh>, B<dgit>, B<git-debrebase>, "
1884 "B<apt-get>, B<apt-cache>, B<gbp-pq>, B<gbp-build>, or B<mergechanges>.  Can "
1885 "be repeated as necessary."
1886 msgstr ""
1887
1888 #. type: Plain text
1889 #: ../dgit.1:1068
1890 msgid ""
1891 "Use of this ability should not normally be necessary.  It is provided for "
1892 "working around bugs, or other unusual situations.  If you use these options, "
1893 "you may violate dgit's assumptions about the behaviour of its subprograms "
1894 "and cause lossage."
1895 msgstr ""
1896
1897 #. type: Plain text
1898 #: ../dgit.1:1073
1899 msgid ""
1900 "For dpkg-buildpackage, dpkg-genchanges, mergechanges and sbuild, the option "
1901 "applies only when the program is invoked directly by dgit.  Usually, for "
1902 "passing options to dpkg-genchanges, you should use B<--ch:>I<option>."
1903 msgstr ""
1904
1905 #. type: Plain text
1906 #: ../dgit.1:1077
1907 msgid ""
1908 "Specifying --git is not effective for some lower-level read-only git "
1909 "operations performed by dgit, and also not when git is invoked by another "
1910 "program run by dgit."
1911 msgstr ""
1912
1913 #. type: Plain text
1914 #: ../dgit.1:1079
1915 msgid "See notes below regarding ssh and dgit."
1916 msgstr ""
1917
1918 #. type: Plain text
1919 #: ../dgit.1:1087
1920 msgid ""
1921 "NB that --gpg:option is not supported (because debsign does not have that "
1922 "facility).  But see B<-k> and the B<keyid> distro config setting."
1923 msgstr ""
1924
1925 #. type: TP
1926 #: ../dgit.1:1087
1927 #, no-wrap
1928 msgid "B<--curl!:>I<option> | B<--dput!:>I<option> |..."
1929 msgstr ""
1930
1931 #. type: Plain text
1932 #: ../dgit.1:1093
1933 msgid ""
1934 "Specifies an option to remove from the command line for a program called by "
1935 "dgit, as for B<-->I<program>B<:>I<option> (and the same caveats apply)."
1936 msgstr ""
1937
1938 #. type: Plain text
1939 #: ../dgit.1:1098
1940 msgid ""
1941 "Any options or arguments exactly identical to I<option> are removed.  (It is "
1942 "not an error if there were none.)"
1943 msgstr ""
1944
1945 #. type: Plain text
1946 #: ../dgit.1:1105
1947 msgid ""
1948 "This can only be used to delete options which are always passed by default "
1949 "by dgit, or to undo a previous B<-->I<program>B<:>I<option>.  It cannot be "
1950 "used to override option(s) dynamically decided on by dgit."
1951 msgstr ""
1952
1953 #. type: TP
1954 #: ../dgit.1:1105
1955 #, no-wrap
1956 msgid "B<--curl=>I<program> | B<--dput=>I<program> |..."
1957 msgstr ""
1958
1959 #. type: Plain text
1960 #: ../dgit.1:1128
1961 msgid ""
1962 "Specifies alternative programs to use instead of B<curl>, B<dput>, "
1963 "B<debsign>, B<dpkg-source>, B<dpkg-buildpackage>, B<dpkg-genchanges>, "
1964 "B<sbuild>, B<pbuilder>, B<cowbuilder>, B<gpg>, B<ssh>, B<dgit>, B<git-"
1965 "debrebase>, B<apt-get>, B<apt-cache>, B<git>, B<gbp-pq>, B<gbp-build>, or "
1966 "B<mergechanges>."
1967 msgstr ""
1968
1969 #. type: Plain text
1970 #: ../dgit.1:1136
1971 msgid ""
1972 "For B<dpkg-buildpackage>, B<dpkg-genchanges>, B<mergechanges> and B<sbuild>, "
1973 "this applies only when the program is invoked directly by dgit."
1974 msgstr ""
1975
1976 #. type: Plain text
1977 #: ../dgit.1:1143
1978 msgid ""
1979 "For B<dgit>, specifies the command to run on the remote host when dgit rpush "
1980 "needs to invoke a remote copy of itself.  (dgit also reinvokes itself as the "
1981 "EDITOR for dpkg-source --commit; this is done using argv[0], and is not "
1982 "affected by --dgit=)."
1983 msgstr ""
1984
1985 #. type: Plain text
1986 #: ../dgit.1:1154
1987 msgid ""
1988 "B<gbp-build>'s value is used instead of gbp build or git-buildpackage.  (The "
1989 "default is the latter unless the former exists on PATH.)  B<gbp-pq>'s value "
1990 "is used instead of gbp pq.  In both cases, unusually, the specified value is "
1991 "split on whitespace to produce a command and possibly some options and/or "
1992 "arguments."
1993 msgstr ""
1994
1995 #. type: Plain text
1996 #: ../dgit.1:1162
1997 msgid ""
1998 "For pbuilder and cowbuilder, the defaults are B<sudo -E pbuilder> and B<sudo "
1999 "-E cowbuilder> respectively.  Like with gbp-build and gbp pq, the specified "
2000 "value is split on whitespace."
2001 msgstr ""
2002
2003 #. type: Plain text
2004 #: ../dgit.1:1179
2005 msgid ""
2006 "For B<ssh>, the default value is taken from the B<DGIT_SSH> or B<GIT_SSH> "
2007 "environment variables, if set (see below).  And, for ssh, when accessing the "
2008 "archive and dgit-repos, this command line setting is overridden by the git "
2009 "config variables B<dgit-distro.>I<distro>B<.ssh> and B<.dgit.default.ssh> "
2010 "(which can in turn be overridden with -c).  Also, when dgit is using git to "
2011 "access dgit-repos, only git's idea of what ssh to use (eg, B<GIT_SSH>)  is "
2012 "relevant."
2013 msgstr ""
2014
2015 #. type: TP
2016 #: ../dgit.1:1179
2017 #, no-wrap
2018 msgid "B<--existing-package=>I<package>"
2019 msgstr ""
2020
2021 #. type: Plain text
2022 #: ../dgit.1:1189
2023 msgid ""
2024 "dgit push needs to canonicalise the suite name.  Sometimes, dgit lacks a way "
2025 "to ask the archive to do this without knowing the name of an existing "
2026 "package.  Without --new we can just use the package we are trying to push.  "
2027 "But with --new that will not work, so we guess B<dpkg> or use the value of "
2028 "this option.  This option is not needed with the default mechanisms for "
2029 "accessing the archive."
2030 msgstr ""
2031
2032 #. type: TP
2033 #: ../dgit.1:1189
2034 #, no-wrap
2035 msgid "B<-h>|B<--help>"
2036 msgstr ""
2037
2038 #. type: TP
2039 #: ../dgit.1:1192
2040 #, no-wrap
2041 msgid "B<--initiator-tempdir=>I<directory>"
2042 msgstr ""
2043
2044 #. type: Plain text
2045 #: ../dgit.1:1201
2046 msgid ""
2047 "dgit rpush uses a temporary directory on the invoking (signing) host.  This "
2048 "option causes dgit to use I<directory> instead.  Furthermore, the specified "
2049 "directory will be emptied, removed and recreated before dgit starts, rather "
2050 "than removed after dgit finishes.  The directory specified must be an "
2051 "absolute pathname."
2052 msgstr ""
2053
2054 #. type: TP
2055 #: ../dgit.1:1201
2056 #, no-wrap
2057 msgid "B<--force->I<something>"
2058 msgstr ""
2059
2060 #. type: Plain text
2061 #: ../dgit.1:1209
2062 msgid ""
2063 "Instructs dgit to try to proceed despite detecting what it thinks is going "
2064 "to be a fatal problem.  B<This is probably not going to work.> These options "
2065 "are provided as an escape hatch, in case dgit is confused.  (They might also "
2066 "be useful for testing error cases.)"
2067 msgstr ""
2068
2069 #. type: TP
2070 #: ../dgit.1:1209
2071 #, no-wrap
2072 msgid "B<--force-import-dsc-with-dgit-field>"
2073 msgstr ""
2074
2075 #. type: Plain text
2076 #: ../dgit.1:1216
2077 msgid ""
2078 "Tell dgit import-dsc to treat a .dsc with a Dgit field like one without it.  "
2079 "The result is a fresh import, discarding the git history that the person who "
2080 "pushed that .dsc was working with."
2081 msgstr ""
2082
2083 #. type: TP
2084 #: ../dgit.1:1216
2085 #, no-wrap
2086 msgid "B<--force-uploading-binaries>"
2087 msgstr ""
2088
2089 #. type: Plain text
2090 #: ../dgit.1:1221
2091 msgid ""
2092 "Carry on and upload binaries even though dgit thinks your distro does not "
2093 "permit that."
2094 msgstr ""
2095
2096 #. type: TP
2097 #: ../dgit.1:1221
2098 #, no-wrap
2099 msgid "B<--force-uploading-source-only>"
2100 msgstr ""
2101
2102 #. type: Plain text
2103 #: ../dgit.1:1227
2104 msgid ""
2105 "Carry on and do a source-only upload, without any binaries, even though dgit "
2106 "thinks your distro does not permit that, or does not permit that in this "
2107 "situation."
2108 msgstr ""
2109
2110 #. type: TP
2111 #: ../dgit.1:1227
2112 #, no-wrap
2113 msgid "B<--force-unrepresentable>"
2114 msgstr ""
2115
2116 #. type: Plain text
2117 #: ../dgit.1:1234
2118 msgid ""
2119 "Carry on even if dgit thinks that your git tree contains changes (relative "
2120 "to your .orig tarballs)  which dpkg-source is not able to represent.  Your "
2121 "build or push will probably fail later."
2122 msgstr ""
2123
2124 #. type: TP
2125 #: ../dgit.1:1234
2126 #, no-wrap
2127 msgid "B<--force-changes-origs-exactly>"
2128 msgstr ""
2129
2130 #. type: Plain text
2131 #: ../dgit.1:1239
2132 msgid ""
2133 "Use the set of .origs specified in your .changes, exactly, without regard to "
2134 "what is in the archive already.  The archive may well reject your upload."
2135 msgstr ""
2136
2137 #. type: TP
2138 #: ../dgit.1:1239
2139 #, no-wrap
2140 msgid "B<--force-unsupported-source-format>"
2141 msgstr ""
2142
2143 #. type: Plain text
2144 #: ../dgit.1:1243
2145 msgid ""
2146 "Carry on despite dgit not understanding your source package format.  dgit "
2147 "will probably mishandle it."
2148 msgstr ""
2149
2150 #. type: TP
2151 #: ../dgit.1:1243
2152 #, no-wrap
2153 msgid "B<--force-dsc-changes-mismatch>"
2154 msgstr ""
2155
2156 #. type: Plain text
2157 #: ../dgit.1:1247
2158 msgid ""
2159 "Do not check whether .dsc and .changes match.  The archive will probably "
2160 "reject your upload."
2161 msgstr ""
2162
2163 #. type: TP
2164 #: ../dgit.1:1247
2165 #, no-wrap
2166 msgid "B<--force-import-gitapply-absurd> | B<--force-import-gitapply-no-absurd>"
2167 msgstr ""
2168
2169 #. type: Plain text
2170 #: ../dgit.1:1253
2171 msgid ""
2172 "Force on or off the use of the absurd git-apply emulation when running gbp "
2173 "pq import when importing a package from a .dsc.  See Debian bug #841867."
2174 msgstr ""
2175
2176 #. type: =head1
2177 #: ../dgit.1:1253 ../dgit-downstream-dsc.7.pod:150
2178 #, no-wrap
2179 msgid "CONFIGURATION"
2180 msgstr ""
2181
2182 #. type: Plain text
2183 #: ../dgit.1:1259
2184 msgid ""
2185 "dgit can be configured via the git config system.  You may set keys with git-"
2186 "config (either in system-global or per-tree configuration), or provide B<-"
2187 "c>I<key>B<=>I<value> on the dgit command line."
2188 msgstr ""
2189
2190 #. type: Plain text
2191 #: ../dgit.1:1261
2192 msgid "Settings likely to be useful for an end user include:"
2193 msgstr ""
2194
2195 #. type: TP
2196 #: ../dgit.1:1261
2197 #, no-wrap
2198 msgid "B<dgit.default.build-products-dir>"
2199 msgstr ""
2200
2201 #. type: Plain text
2202 #: ../dgit.1:1267
2203 msgid ""
2204 "Specifies where to find the built files to be uploaded, when --build-"
2205 "products-dir is not specified.  The default is the parent directory (B<..>)."
2206 msgstr ""
2207
2208 #. type: =item
2209 #: ../dgit.1:1267 ../dgit-downstream-dsc.7.pod:286
2210 #, no-wrap
2211 msgid "B<dgit-suite.>I<suite>B<.distro> I<distro>"
2212 msgstr ""
2213
2214 #. type: Plain text
2215 #: ../dgit.1:1272
2216 msgid ""
2217 "Specifies the distro for a suite.  dgit keys off the suite name (which "
2218 "appears in changelogs etc.), and uses that to determine the distro which is "
2219 "involved.  The config used is thereafter that for the distro."
2220 msgstr ""
2221
2222 #. type: Plain text
2223 #: ../dgit.1:1275
2224 msgid "I<suite> may be a glob pattern."
2225 msgstr ""
2226
2227 #. type: TP
2228 #: ../dgit.1:1275
2229 #, no-wrap
2230 msgid "B<dgit.default.distro>I< distro>"
2231 msgstr ""
2232
2233 #. type: Plain text
2234 #: ../dgit.1:1278
2235 msgid "The default distro for an unknown suite."
2236 msgstr ""
2237
2238 #. type: TP
2239 #: ../dgit.1:1278
2240 #, no-wrap
2241 msgid "B<dgit.default.default-suite>I< suite>"
2242 msgstr ""
2243
2244 #. type: Plain text
2245 #: ../dgit.1:1281
2246 msgid "The default suite (eg for clone)."
2247 msgstr ""
2248
2249 #. type: TP
2250 #: ../dgit.1:1281
2251 #, no-wrap
2252 msgid "B<dgit.default.>*"
2253 msgstr ""
2254
2255 #. type: Plain text
2256 #: ../dgit.1:1286
2257 msgid ""
2258 "for each B<dgit-distro.>I<distro>B<.>*, the default value used if there is "
2259 "no distro-specific setting."
2260 msgstr ""
2261
2262 #. type: TP
2263 #: ../dgit.1:1286
2264 #, no-wrap
2265 msgid "B<dgit-distro.>I<distro>B<.clean-mode>"
2266 msgstr ""
2267
2268 #. type: Plain text
2269 #: ../dgit.1:1290
2270 msgid ""
2271 "One of the values for the command line --clean= option; used if --clean is "
2272 "not specified."
2273 msgstr ""
2274
2275 #. type: TP
2276 #: ../dgit.1:1290
2277 #, no-wrap
2278 msgid "B<dgit-distro.>I<distro>B<.clean-mode-newer>"
2279 msgstr ""
2280
2281 #. type: Plain text
2282 #: ../dgit.1:1296
2283 msgid ""
2284 "Like .clean-mode, but ignored if the value is unknown to this version of "
2285 "dgit.  Setting both .clean-mode and .clean-mode-newer is useful to provide a "
2286 "single git config compatible with different dgit versions."
2287 msgstr ""
2288
2289 #. type: TP
2290 #: ../dgit.1:1296
2291 #, no-wrap
2292 msgid "B<dgit-distro.>I<distro>B<.quilt-mode>"
2293 msgstr ""
2294
2295 #. type: Plain text
2296 #: ../dgit.1:1300
2297 msgid ""
2298 "One of the values for the command line --quilt= option; used if --quilt is "
2299 "not specified."
2300 msgstr ""
2301
2302 #. type: TP
2303 #: ../dgit.1:1300
2304 #, no-wrap
2305 msgid "B<dgit-distro.>I<distro>B<.rm-old-changes>"
2306 msgstr ""
2307
2308 #. type: Plain text
2309 #: ../dgit.1:1304
2310 msgid ""
2311 "Boolean, used if neither --rm-old-changes nor --no-rm-old-changes is "
2312 "specified.  The default is not to remove."
2313 msgstr ""
2314
2315 #. type: TP
2316 #: ../dgit.1:1304
2317 #, no-wrap
2318 msgid "B<dgit-distro.>I<distro>B<.readonly> B<auto>|B<a> | B<true>|B<t>|B<y>|B<1> | B<false>|B<f>|B<n>|B<0>"
2319 msgstr ""
2320
2321 #. type: Plain text
2322 #: ../dgit.1:1311
2323 msgid ""
2324 "Whether you have push access to the distro.  For Debian, it is OK to use "
2325 "auto, which uses readonly mode if you are not pushing right now; but, "
2326 "setting this to false will avoid relying on the mirror of the dgit git "
2327 "repository server."
2328 msgstr ""
2329
2330 #. type: TP
2331 #: ../dgit.1:1311
2332 #, no-wrap
2333 msgid "B<dgit-distro.>I<distro>B<.keyid>"
2334 msgstr ""
2335
2336 #. type: Plain text
2337 #: ../dgit.1:1315
2338 msgid "See also B<-k>."
2339 msgstr ""
2340
2341 #. type: TP
2342 #: ../dgit.1:1315
2343 #, no-wrap
2344 msgid "B<dgit-distro.>I<distro>B<.mirror>I< url>"
2345 msgstr ""
2346
2347 #. type: TP
2348 #: ../dgit.1:1317
2349 #, no-wrap
2350 msgid "B<dgit-distro.>I<distro>B<.username>"
2351 msgstr ""
2352
2353 #. type: Plain text
2354 #: ../dgit.1:1320
2355 msgid "Not relevant for Debian."
2356 msgstr ""
2357
2358 #. type: =item
2359 #: ../dgit.1:1320 ../dgit-downstream-dsc.7.pod:242
2360 #, no-wrap
2361 msgid "B<dgit-distro.>I<distro>B<.upload-host>"
2362 msgstr ""
2363
2364 #. type: Plain text
2365 #: ../dgit.1:1323
2366 msgid "Might be useful if you have an intermediate queue server."
2367 msgstr ""
2368
2369 #. type: TP
2370 #: ../dgit.1:1323
2371 #, no-wrap
2372 msgid "B<dgit-distro.>I<distro>B<.user-name>I< >B<dgit-distro.>I<distro>B<.user-email>"
2373 msgstr ""
2374
2375 #. type: Plain text
2376 #: ../dgit.1:1328
2377 msgid ""
2378 "Values to configure for user.name and user.email in new git trees.  If not "
2379 "specified, the DEBFULLNAME and DEBEMAIL environment variables are used, "
2380 "respectively.  Only used if .setup-usermail is not disabled."
2381 msgstr ""
2382
2383 #. type: TP
2384 #: ../dgit.1:1328
2385 #, no-wrap
2386 msgid "B<dgit-distro.>I<distro>B<.setup-useremail>"
2387 msgstr ""
2388
2389 #. type: Plain text
2390 #: ../dgit.1:1332
2391 msgid ""
2392 "Whether to set user.name and user.email in new git trees.  True by default.  "
2393 "Ignored for dgit setup-useremail, which does it anyway."
2394 msgstr ""
2395
2396 #. type: TP
2397 #: ../dgit.1:1332
2398 #, no-wrap
2399 msgid "B<dgit-distro.>I<distro>B<.setup-mergechangelogs>"
2400 msgstr ""
2401
2402 #. type: Plain text
2403 #: ../dgit.1:1337
2404 msgid ""
2405 "Whether to set up a merge driver which uses dpkg-mergechangelogs for debian/"
2406 "changelog.  True by default.  Ignored for dgit setup-mergechangelogs, which "
2407 "does it anyway."
2408 msgstr ""
2409
2410 #. type: TP
2411 #: ../dgit.1:1337
2412 #, no-wrap
2413 msgid "B<dgit-distro.>I<distro>B<.setup-gitattributes>"
2414 msgstr ""
2415
2416 #. type: Plain text
2417 #: ../dgit.1:1343
2418 msgid ""
2419 "Whether to configure .git/info/attributes to suppress checkin/checkout file "
2420 "content transformations in new git trees.  True by default.  Ignored for "
2421 "dgit setup-gitattributes, which does it anyway."
2422 msgstr ""
2423
2424 #. type: TP
2425 #: ../dgit.1:1343
2426 #, no-wrap
2427 msgid "B<dgit-distro.>I<distro>B<.cmd->I<cmd>"
2428 msgstr ""
2429
2430 #. type: Plain text
2431 #: ../dgit.1:1349
2432 msgid "Program to use instead of I<cmd>.  Works like B<-->I<cmd>B<=>... ."
2433 msgstr ""
2434
2435 #. type: TP
2436 #: ../dgit.1:1349
2437 #, no-wrap
2438 msgid "B<dgit-distro.>I<distro>B<.opts->I<cmd>"
2439 msgstr ""
2440
2441 #. type: Plain text
2442 #: ../dgit.1:1361
2443 msgid ""
2444 "Extra options to pass to I<cmd>.  Works like B<-->I<cmd>B<:>... .  To pass "
2445 "several options, configure multiple values in git config (with git config --"
2446 "add).  The options for B<dgit.default.opts->I<cmd> and B<dgit-distro."
2447 ">I<distro>B</push.opts->I<cmd> are all used, followed by options from dgit's "
2448 "command line."
2449 msgstr ""
2450
2451 #. type: SH
2452 #: ../dgit.1:1361
2453 #, no-wrap
2454 msgid "ACCESS CONFIGURATION"
2455 msgstr ""
2456
2457 #. type: Plain text
2458 #: ../dgit.1:1366
2459 msgid ""
2460 "There are many other settings which specify how a particular distro's "
2461 "services (archive and git) are provided.  These should not normally be "
2462 "adjusted, but are documented for the benefit of distros who wish to adopt "
2463 "dgit."
2464 msgstr ""
2465
2466 #. type: TP
2467 #: ../dgit.1:1366
2468 #, no-wrap
2469 msgid "B<dgit-distro.>I<distro>B<.nominal-distro>"
2470 msgstr ""
2471
2472 #. type: Plain text
2473 #: ../dgit.1:1369
2474 msgid "Shown in git tags, Dgit fields, and so on."
2475 msgstr ""
2476
2477 #. type: TP
2478 #: ../dgit.1:1369
2479 #, no-wrap
2480 msgid "B<dgit-distro.>I<distro>B<.alias-canon>"
2481 msgstr ""
2482
2483 #. type: Plain text
2484 #: ../dgit.1:1372
2485 msgid "Used for all access configuration lookup."
2486 msgstr ""
2487
2488 #. type: TP
2489 #: ../dgit.1:1372
2490 #, no-wrap
2491 msgid "B<dgit-distro.>I<distro>B</push.>*"
2492 msgstr ""
2493
2494 #. type: Plain text
2495 #: ../dgit.1:1378
2496 msgid ""
2497 "If set, overrides corresponding non B</push> config when B<readonly=false>, "
2498 "or when pushing and B<readonly=auto>."
2499 msgstr ""
2500
2501 #. type: TP
2502 #: ../dgit.1:1378
2503 #, no-wrap
2504 msgid "B<dgit-distro.>I<distro>B<.git-url>"
2505 msgstr ""
2506
2507 #. type: TP
2508 #: ../dgit.1:1380
2509 #, no-wrap
2510 msgid "B<dgit-distro.>I<distro>B<.git-url>[B<-suffix>]"
2511 msgstr ""
2512
2513 #. type: TP
2514 #: ../dgit.1:1382
2515 #, no-wrap
2516 msgid "B<dgit-distro.>I<distro>B<.git-proto>"
2517 msgstr ""
2518
2519 #. type: TP
2520 #: ../dgit.1:1384
2521 #, no-wrap
2522 msgid "B<dgit-distro.>I<distro>B<.git-path>"
2523 msgstr ""
2524
2525 #. type: TP
2526 #: ../dgit.1:1386
2527 #, no-wrap
2528 msgid "B<dgit-distro.>I<distro>B<.git-check> B<true>|B<false>|B<url>|B<ssh-cmd>"
2529 msgstr ""
2530
2531 #. type: TP
2532 #: ../dgit.1:1388
2533 #, no-wrap
2534 msgid "B<dgit-distro.>I<distro>B<.git-check-suffix>"
2535 msgstr ""
2536
2537 #. type: TP
2538 #: ../dgit.1:1390
2539 #, no-wrap
2540 msgid "B<dgit-distro.>I<distro>B<.diverts.divert> B<new-distro>|B</>I<distro-suffix>"
2541 msgstr ""
2542
2543 #. type: TP
2544 #: ../dgit.1:1392
2545 #, no-wrap
2546 msgid "B<dgit-distro.>I<distro>B<.git-create>I< >B<ssh-cmd>I<|>B<true>"
2547 msgstr ""
2548
2549 #. type: TP
2550 #: ../dgit.1:1394
2551 #, no-wrap
2552 msgid "B<dgit-distro.>I<distro>B<.archive-query> B<ftpmasterapi:> | B<madison:>I<distro> | B<dummycat:>I</path>  | B<sshpsql:>I<user>B<@>I<host>B<:>I<dbname> | B<aptget:>"
2553 msgstr ""
2554
2555 #. type: TP
2556 #: ../dgit.1:1396
2557 #, no-wrap
2558 msgid "B<dgit-distro.>I<distro>B<.archive-query->(B<url>|B<tls-key>|B<curl-ca-args>)"
2559 msgstr ""
2560
2561 #. type: TP
2562 #: ../dgit.1:1398
2563 #, no-wrap
2564 msgid "B<dgit-distro.>I<distro>B<.madison-distro>"
2565 msgstr ""
2566
2567 #. type: TP
2568 #: ../dgit.1:1400
2569 #, no-wrap
2570 msgid "B<dgit-distro.>I<distro>B<.archive-query-default-component>"
2571 msgstr ""
2572
2573 #. type: TP
2574 #: ../dgit.1:1402
2575 #, no-wrap
2576 msgid "B<dgit-distro.>I<distro>B<.dgit-tag-format>"
2577 msgstr ""
2578
2579 #. type: TP
2580 #: ../dgit.1:1404
2581 #, no-wrap
2582 msgid "B<dgit-distro.>I<distro>B<.dep14tag> B<want>|B<no>|B<always>"
2583 msgstr ""
2584
2585 #. type: TP
2586 #: ../dgit.1:1406
2587 #, no-wrap
2588 msgid "B<dgit-distro.>I<distro>B<.ssh>"
2589 msgstr ""
2590
2591 #. type: TP
2592 #: ../dgit.1:1408
2593 #, no-wrap
2594 msgid "B<dgit-distro.>I<distro>B<.sshpsql-dbname>"
2595 msgstr ""
2596
2597 #. type: TP
2598 #: ../dgit.1:1410
2599 #, no-wrap
2600 msgid "B<dgit-distro.>I<distro>B<.>(B<git>|B<sshpsql>)B<->(B<user>|B<host>|B<user-force>)"
2601 msgstr ""
2602
2603 #. type: TP
2604 #: ../dgit.1:1412
2605 #, no-wrap
2606 msgid "B<dgit-distro.>I<distro>B<.backports-quirk>"
2607 msgstr ""
2608
2609 #. type: TP
2610 #: ../dgit.1:1414
2611 #, no-wrap
2612 msgid "B<dgit-distro.>I<distro>B<.rewrite-map-enable>"
2613 msgstr ""
2614
2615 #. type: TP
2616 #: ../dgit.1:1416
2617 #, no-wrap
2618 msgid "B<dgit-distro.>I<distro>B<.source-only-uploads> B<ok>|B<always>|B<never>|B<not-wholly-new>"
2619 msgstr ""
2620
2621 #. type: TP
2622 #: ../dgit.1:1418
2623 #, no-wrap
2624 msgid "B<dgit.default.old-dsc-distro>"
2625 msgstr ""
2626
2627 #. type: TP
2628 #: ../dgit.1:1420
2629 #, no-wrap
2630 msgid "B<dgit.dsc-url-proto-ok.>I<protocol>"
2631 msgstr ""
2632
2633 #. type: TP
2634 #: ../dgit.1:1422
2635 #, no-wrap
2636 msgid "B<dgit.dsc-url-proto-ok.bad-syntax>"
2637 msgstr ""
2638
2639 #. type: TP
2640 #: ../dgit.1:1424
2641 #, no-wrap
2642 msgid "B<dgit.default.dsc-url-proto-ok>"
2643 msgstr ""
2644
2645 #. type: TP
2646 #: ../dgit.1:1426
2647 #, no-wrap
2648 msgid "B<dgit.vcs-git.suites> I<suite>[B<;>...]"
2649 msgstr ""
2650
2651 #. type: SH
2652 #: ../dgit.1:1428
2653 #, no-wrap
2654 msgid "ENVIRONMENT VARIABLES"
2655 msgstr ""
2656
2657 #. type: TP
2658 #: ../dgit.1:1429
2659 #, no-wrap
2660 msgid "B<DGIT_SSH>, B<GIT_SSH>"
2661 msgstr ""
2662
2663 #. type: Plain text
2664 #: ../dgit.1:1438
2665 msgid ""
2666 "specify an alternative default program (and perhaps arguments) to use "
2667 "instead of ssh.  DGIT_SSH is consulted first and may contain arguments; if "
2668 "it contains any whitespace will be passed to the shell.  GIT_SSH specifies "
2669 "just the program; no arguments can be specified, so dgit interprets it the "
2670 "same way as git does.  See also the --ssh= and --ssh: options."
2671 msgstr ""
2672
2673 #. type: TP
2674 #: ../dgit.1:1438
2675 #, no-wrap
2676 msgid "B<DEBEMAIL>, B<DEBFULLNAME>"
2677 msgstr ""
2678
2679 #. type: Plain text
2680 #: ../dgit.1:1442
2681 msgid ""
2682 "Default git user.email and user.name for new trees.  See B<dgit setup-new-"
2683 "tree>."
2684 msgstr ""
2685
2686 #. type: TP
2687 #: ../dgit.1:1442
2688 #, no-wrap
2689 msgid "B<gpg>, B<dpkg->..., B<debsign>, B<git>, B<curl>, B<dput>, B<LWP::UserAgent>"
2690 msgstr ""
2691
2692 #. type: Plain text
2693 #: ../dgit.1:1447
2694 msgid ""
2695 "and other subprograms and modules used by dgit are affected by various "
2696 "environment variables.  Consult the documentation for those programs for "
2697 "details."
2698 msgstr ""
2699
2700 #. type: SH
2701 #: ../dgit.1:1447
2702 #, no-wrap
2703 msgid "BUGS"
2704 msgstr ""
2705
2706 #. type: Plain text
2707 #: ../dgit.1:1454
2708 msgid ""
2709 "There should be a `dgit rebase-prep' command or some such to turn a fast-"
2710 "forwarding branch containing pseudo-merges back into a rebasing patch "
2711 "stack.  It might have to leave a note for a future dgit push."
2712 msgstr ""
2713
2714 #. type: Plain text
2715 #: ../dgit.1:1460
2716 msgid ""
2717 "If the dgit push fails halfway through, it is not necessarily restartable "
2718 "and idempotent.  It would be good to check that the proposed signing key is "
2719 "available before starting work."
2720 msgstr ""
2721
2722 #. type: Plain text
2723 #: ../dgit.1:1465
2724 msgid ""
2725 "dgit's build functions, and dgit push, may make changes to your current "
2726 "HEAD.  Sadly this is necessary for packages in the `3.0 (quilt)' source "
2727 "format.  This is ultimately due to what I consider design problems in quilt "
2728 "and dpkg-source."
2729 msgstr ""
2730
2731 #. type: Plain text
2732 #: ../dgit.1:1470
2733 msgid ""
2734 "--dry-run does not always work properly, as not doing some of the git "
2735 "fetches may result in subsequent actions being different.  Doing a non-dry-"
2736 "run dgit fetch first will help.  --damp-run is likely to work much better."
2737 msgstr ""
2738
2739 #. type: =head1
2740 #: ../dgit.1:1470 ../dgit.7:23 ../dgit-user.7.pod:447
2741 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
2742 #: ../dgit-maint-merge.7.pod:491 ../dgit-maint-gbp.7.pod:136
2743 #: ../dgit-maint-debrebase.7.pod:747 ../dgit-downstream-dsc.7.pod:352
2744 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:619
2745 #: ../git-debrebase.5.pod:678
2746 #, no-wrap
2747 msgid "SEE ALSO"
2748 msgstr ""
2749
2750 #. type: Plain text
2751 #: ../dgit.1:1479
2752 msgid ""
2753 "B<dgit>(7), B<dgit-*>(7), B<curl>(1), B<dput>(1), B<debsign>(1), B<git-"
2754 "config>(1), B<git-buildpackage>(1), B<dpkg-buildpackage>(1),"
2755 msgstr ""
2756
2757 #. type: Plain text
2758 #: ../dgit.1:1480
2759 msgid "https://browse.dgit.debian.org/"
2760 msgstr ""