chiark / gitweb /
b38a193cb219380f0643656337a01d32c3e0f6aa
[dgit.git] / po4a / git-debrebase_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: 2018-10-04 01:04+0100\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: =head1
20 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
21 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
22 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
23 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
24 #: ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
25 #, no-wrap
26 msgid "NAME"
27 msgstr ""
28
29 #. type: =head1
30 #: ../dgit.1:496 ../git-debrebase.1.pod:441
31 #, no-wrap
32 msgid "OPTIONS"
33 msgstr ""
34
35 #. type: =head1
36 #: ../dgit.1:1394 ../dgit.7:23 ../dgit-user.7.pod:447
37 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
38 #: ../dgit-maint-merge.7.pod:491 ../dgit-maint-gbp.7.pod:136
39 #: ../dgit-maint-debrebase.7.pod:722 ../dgit-downstream-dsc.7.pod:352
40 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:601
41 #: ../git-debrebase.5.pod:678
42 #, no-wrap
43 msgid "SEE ALSO"
44 msgstr ""
45
46 #. type: =head1
47 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
48 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
49 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
50 #: ../git-debrebase.1.pod:10 ../git-debrebase.5.pod:5
51 msgid "INTRODUCTION"
52 msgstr ""
53
54 #. type: textblock
55 #: ../git-debrebase.1.pod:3
56 msgid "git-debrebase - delta queue rebase tool for Debian packaging"
57 msgstr ""
58
59 #. type: =head1
60 #: ../git-debrebase.1.pod:5
61 msgid "SYNOPSYS"
62 msgstr ""
63
64 #. type: verbatim
65 #: ../git-debrebase.1.pod:7
66 #, no-wrap
67 msgid ""
68 " git-debrebase [<options...>] [-- <git-rebase options...>]\n"
69 " git-debrebase [<options...>] <operation> [<operation options...>\n"
70 "\n"
71 msgstr ""
72
73 #. type: textblock
74 #: ../git-debrebase.1.pod:12 ../git-debrebase.5.pod:7
75 msgid ""
76 "git-debrebase is a tool for representing in git, and manpulating, Debian "
77 "packages based on upstream source code."
78 msgstr ""
79
80 #. type: textblock
81 #: ../git-debrebase.1.pod:16
82 msgid ""
83 "This is the command line reference.  Please read the tutorial L<dgit-maint-"
84 "debrebase(7)>.  For background, theory of operation, and definitions see "
85 "L<git-debrebase(5)>."
86 msgstr ""
87
88 #. type: textblock
89 #: ../git-debrebase.1.pod:22
90 msgid ""
91 "You should read this manpage in cojnunction with L<git-debrebase(5)/"
92 "TERMINOLOGY>, which defines many important terms used here."
93 msgstr ""
94
95 #. type: =head1
96 #: ../git-debrebase.1.pod:26
97 msgid "PRINCIPAL OPERATIONS"
98 msgstr ""
99
100 #. type: =item
101 #: ../git-debrebase.1.pod:30
102 msgid "git-debrebase [-- <git-rebase options...>]"
103 msgstr ""
104
105 #. type: =item
106 #: ../git-debrebase.1.pod:32
107 msgid "git-debrebase [-i <further git-rebase options...>]"
108 msgstr ""
109
110 #. type: textblock
111 #: ../git-debrebase.1.pod:34
112 msgid ""
113 "Unstitches and launders the branch.  (See L</UNSTITCHING AND LAUNDERING> "
114 "below.)"
115 msgstr ""
116
117 #. type: textblock
118 #: ../git-debrebase.1.pod:37
119 msgid ""
120 "Then, if any git-rebase options were supplied, edits the Debian delta queue, "
121 "using git-rebase, by running"
122 msgstr ""
123
124 #. type: verbatim
125 #: ../git-debrebase.1.pod:41
126 #, no-wrap
127 msgid ""
128 "    git rebase <git-rebase options> <breakwater-tip>\n"
129 "\n"
130 msgstr ""
131
132 #. type: textblock
133 #: ../git-debrebase.1.pod:43
134 msgid ""
135 "Do not pass a base branch argument: git-debrebase will supply that.  Do not "
136 "use --onto, or --fork-point.  Useful git-rebase options include -i and --"
137 "autosquash."
138 msgstr ""
139
140 #. type: textblock
141 #: ../git-debrebase.1.pod:48
142 msgid ""
143 "If git-rebase stops for any reason, you may git-rebase --abort, --continue, "
144 "or --skip, as usual.  If you abort the git-rebase, the branch will still "
145 "have been laundered, but everything in the rebase will be undone."
146 msgstr ""
147
148 #. type: textblock
149 #: ../git-debrebase.1.pod:54
150 msgid ""
151 "The options for git-rebase must either start with C<-i>, or be prececded by "
152 "C<-->, to distinguish them from options for git-debrebase."
153 msgstr ""
154
155 #. type: textblock
156 #: ../git-debrebase.1.pod:58
157 msgid ""
158 "It is hazardous to use plain git-rebase on a git-debrebase branch, because "
159 "git-rebase has a tendency to start the rebase too far back in history, and "
160 "then drop important commits.  Soo L<git-debrebase(5)/ILLEGAL OPERATIONS>"
161 msgstr ""
162
163 #. type: =item
164 #: ../git-debrebase.1.pod:64
165 msgid "git-debrebase status"
166 msgstr ""
167
168 #. type: textblock
169 #: ../git-debrebase.1.pod:66
170 msgid ""
171 "Analyses the current branch, both in terms of its contents, and the refs "
172 "which are relevant to git-debrebase, and prints a human-readable summary."
173 msgstr ""
174
175 #. type: textblock
176 #: ../git-debrebase.1.pod:71
177 msgid ""
178 "Please do not attempt to parse the output; it may be reformatted or "
179 "reorganised in the future.  Instead, use one of the L<UNDERLYING AND "
180 "SUPPLEMENTARY OPERATIONS> described below."
181 msgstr ""
182
183 #. type: =item
184 #: ../git-debrebase.1.pod:77
185 msgid "git-debrebase conclude"
186 msgstr ""
187
188 #. type: textblock
189 #: ../git-debrebase.1.pod:79
190 msgid ""
191 "Finishes a git-debrebase session, tidying up the branch and making it fast "
192 "forward again."
193 msgstr ""
194
195 #. type: textblock
196 #: ../git-debrebase.1.pod:82
197 msgid ""
198 "Specifically: if the branch is unstitched, launders and restitches it, "
199 "making a new pseudomerge.  Otherwise, it is an error, unless --noop-ok."
200 msgstr ""
201
202 #. type: =item
203 #: ../git-debrebase.1.pod:88
204 msgid "git-debrebase quick"
205 msgstr ""
206
207 #. type: textblock
208 #: ../git-debrebase.1.pod:90
209 msgid ""
210 "Unconditionally launders and restitches the branch, consuming any ffq-prev "
211 "and making a new pseudomerge."
212 msgstr ""
213
214 #. type: textblock
215 #: ../git-debrebase.1.pod:94
216 msgid "If the branch is already laundered and stitched, does nothing."
217 msgstr ""
218
219 #. type: =item
220 #: ../git-debrebase.1.pod:96
221 msgid "git-debrebase prepush [--prose=<for commit message>]"
222 msgstr ""
223
224 #. type: textblock
225 #: ../git-debrebase.1.pod:98
226 msgid "If the branch is unstitched, stitches it, consuming ffq-prev."
227 msgstr ""
228
229 #. type: textblock
230 #: ../git-debrebase.1.pod:102
231 msgid ""
232 "This is a good command to run before pushing to a git server.  You should "
233 "consider using B<conclude> instead, because that launders the branch too."
234 msgstr ""
235
236 #. type: =item
237 #: ../git-debrebase.1.pod:106
238 msgid "git-debrebase stitch [--prose=<for commit message>]"
239 msgstr ""
240
241 #. type: textblock
242 #: ../git-debrebase.1.pod:108
243 msgid "Stitches the branch, consuming ffq-prev."
244 msgstr ""
245
246 #. type: textblock
247 #: ../git-debrebase.1.pod:111
248 msgid "If there is no ffq-prev, it is an error, unless --noop-ok."
249 msgstr ""
250
251 #. type: textblock
252 #: ../git-debrebase.1.pod:113
253 msgid "You should consider using B<prepush> or B<conclude> instead."
254 msgstr ""
255
256 #. type: =item
257 #: ../git-debrebase.1.pod:115
258 msgid "git-debrebase scrap"
259 msgstr ""
260
261 #. type: textblock
262 #: ../git-debrebase.1.pod:117
263 msgid ""
264 "Throws away all the work since the branch was last stitched.  This is done "
265 "by rewinding you to ffq-prev."
266 msgstr ""
267
268 #. type: textblock
269 #: ../git-debrebase.1.pod:120
270 msgid "If you are in the middle of a git-rebase, will abort that too."
271 msgstr ""
272
273 #. type: =item
274 #: ../git-debrebase.1.pod:122
275 msgid "git-debrebase new-upstream <new-version> [<upstream-details>...]"
276 msgstr ""
277
278 #. type: textblock
279 #: ../git-debrebase.1.pod:124
280 msgid "Rebases the delta queue onto a new upstream version.  In detail:"
281 msgstr ""
282
283 #. type: textblock
284 #: ../git-debrebase.1.pod:127
285 msgid ""
286 "Firstly, checks that the proposed rebase seems to make sense: It is a snag "
287 "unless the new upstream(s)  are fast forward from the previous upstream(s)  "
288 "as found in the current breakwater anchor.  And, in the case of a multi-"
289 "piece upstream (a multi-component upstream, in dpkg-source terminology), if "
290 "the pieces are not in the same order, with the same names."
291 msgstr ""
292
293 #. type: textblock
294 #: ../git-debrebase.1.pod:135
295 msgid "If all seems well, unstitches and launders the branch."
296 msgstr ""
297
298 #. type: textblock
299 #: ../git-debrebase.1.pod:137
300 msgid ""
301 "Then, generates (in a private working area)  a new anchor merge commit, on "
302 "top of the breakwater tip, and on top of that a commit to update the version "
303 "number in debian/changelog."
304 msgstr ""
305
306 #. type: textblock
307 #: ../git-debrebase.1.pod:145
308 msgid "Finally, starts a git-rebase of the delta queue onto these new commits."
309 msgstr ""
310
311 #. type: textblock
312 #: ../git-debrebase.1.pod:149
313 msgid ""
314 "That git-rebase may complete successfully, or it may require your "
315 "assistance, just like a normal git-rebase."
316 msgstr ""
317
318 #. type: textblock
319 #: ../git-debrebase.1.pod:153
320 msgid ""
321 "If you git-rebase --abort, the whole new upstream operation is aborted, "
322 "except for the laundering."
323 msgstr ""
324
325 #. type: textblock
326 #: ../git-debrebase.1.pod:157
327 msgid ""
328 "<new-version> may be whole new Debian version, including revision, or just "
329 "the upstream part, in which case -1 will be appended to make the new Debian "
330 "version."
331 msgstr ""
332
333 #. type: textblock
334 #: ../git-debrebase.1.pod:163
335 msgid "The <upstream-details> are, optionally, in order:"
336 msgstr ""
337
338 #. type: =item
339 #: ../git-debrebase.1.pod:167
340 msgid "<upstream-commit-ish>"
341 msgstr ""
342
343 #. type: textblock
344 #: ../git-debrebase.1.pod:169
345 msgid ""
346 "The new upstream branch (or commit-ish).  The default is to look for one of "
347 "these tags, in this order: U vU upstream/U; where U is the new upstream "
348 "version.  (This is the same algorithm as L<git-deborig(1)>.)"
349 msgstr ""
350
351 #. type: textblock
352 #: ../git-debrebase.1.pod:175
353 msgid ""
354 "It is a snag if the upstream contains a debian/ directory; if forced to "
355 "proceed, git-debrebase will disregard the upstream's debian/ and take (only) "
356 "the packaging from the current breakwater."
357 msgstr ""
358
359 #. type: =item
360 #: ../git-debrebase.1.pod:180
361 msgid "<piece-name> <piece-upstream-commit-ish>"
362 msgstr ""
363
364 #. type: textblock
365 #: ../git-debrebase.1.pod:182
366 msgid "Specifies that this is a multi-piece upstream.  May be repeated."
367 msgstr ""
368
369 #. type: textblock
370 #: ../git-debrebase.1.pod:185
371 msgid ""
372 "When such a pair is specified, git-debrebase will first combine the pieces "
373 "of the upstream together, and then use the result as the combined new "
374 "upstream."
375 msgstr ""
376
377 #. type: textblock
378 #: ../git-debrebase.1.pod:190
379 msgid ""
380 "For each <piece-name>, the tree of the <piece-upstream-commit-ish> becomes "
381 "the subdirectory <piece-name> in the combined new upstream (supplanting any "
382 "subdirectory that might be there in the main upstream branch)."
383 msgstr ""
384
385 #. type: textblock
386 #: ../git-debrebase.1.pod:197
387 msgid ""
388 "<piece-name> has a restricted syntax: it may contain only ASCII "
389 "alphanumerics and hyphens."
390 msgstr ""
391
392 #. type: textblock
393 #: ../git-debrebase.1.pod:200
394 msgid ""
395 "The combined upstream is itself recorded as a commit, with each of the "
396 "upstream pieces' commits as parents.  The combined commit contains an "
397 "annotation to allow a future git-debrebase new upstream operation to make "
398 "the coherency checks described above."
399 msgstr ""
400
401 #. type: =item
402 #: ../git-debrebase.1.pod:206
403 msgid "<git-rebase options>"
404 msgstr ""
405
406 #. type: textblock
407 #: ../git-debrebase.1.pod:208
408 msgid "These will be passed to git rebase."
409 msgstr ""
410
411 #. type: textblock
412 #: ../git-debrebase.1.pod:210
413 msgid ""
414 "If the upstream rebase is troublesome, -i may be helpful.  As with plain git-"
415 "debrebase, do not specify a base, or --onto, or --fork-point."
416 msgstr ""
417
418 #. type: textblock
419 #: ../git-debrebase.1.pod:216
420 msgid ""
421 "If you are planning to generate a .dsc, you will also need to have, or "
422 "generate, actual orig tarball(s), which must be identical to the rev-"
423 "spec(s)  passed to git-debrebase.  git-debrebase does not concern itself "
424 "with source packages so neither helps with this, nor checks it.  L<git-"
425 "deborig(1)>, L<git-archive(1)>, L<dgit(1)> and L<gbp-import-orig(1)> may be "
426 "able to help."
427 msgstr ""
428
429 #. type: =item
430 #: ../git-debrebase.1.pod:227
431 msgid "git-debrebase make-patches [--quiet-would-amend]"
432 msgstr ""
433
434 #. type: textblock
435 #: ../git-debrebase.1.pod:229
436 msgid ""
437 "Generate patches in debian/patches/ representing the changes made to "
438 "upstream files."
439 msgstr ""
440
441 #. type: textblock
442 #: ../git-debrebase.1.pod:232
443 msgid ""
444 "It is not normally necessary to run this command explicitly.  When uploading "
445 "to Debian, dgit and git-debrebase will cooperate to regenerate patches as "
446 "necessary.  When working with pure git remotes, the patches are not needed."
447 msgstr ""
448
449 #. type: textblock
450 #: ../git-debrebase.1.pod:239
451 msgid ""
452 "Normally git-debrebase make-patches will require a laundered branch.  (A "
453 "laundered branch does not contain any patches.)  But if there are already "
454 "some patches made by git-debrebase make-patches, and all that has happened "
455 "is that more changes to upstream files have been committed, running it again "
456 "can add the missing patches."
457 msgstr ""
458
459 #. type: textblock
460 #: ../git-debrebase.1.pod:248
461 msgid ""
462 "If the patches implied by the current branch are not a simple superset of "
463 "those already in debian/patches, make-patches will fail with exit status 7, "
464 "and an error message.  (The message can be suppress with --quiet-would-"
465 "amend.)  If the problem is simply that the existing patches were not made by "
466 "git-debrebase, using dgit quilt-fixup instead should succeed."
467 msgstr ""
468
469 #. type: =item
470 #: ../git-debrebase.1.pod:257
471 msgid "git-debrebase convert-from-gbp [<upstream-commit-ish>]"
472 msgstr ""
473
474 #. type: textblock
475 #: ../git-debrebase.1.pod:259
476 msgid ""
477 "Cnnverts a gbp patches-unapplied branch (not a gbp pq patch queue branch)  "
478 "into a git-debrebase interchange branch."
479 msgstr ""
480
481 #. type: textblock
482 #: ../git-debrebase.1.pod:263
483 msgid ""
484 "This is done by generating a new anchor merge, converting the quilt patches "
485 "as a delta queue, and dropping the patches from the tree."
486 msgstr ""
487
488 #. type: textblock
489 #: ../git-debrebase.1.pod:267
490 msgid ""
491 "The upstream commit-ish should correspond to the gbp upstream branch, if "
492 "there is one.  It is a snag if it is not an ancestor of HEAD, or if the "
493 "history between the upstream and HEAD contains commits which make changes to "
494 "upstream files.  If it is not specified, the same algorithm is used as for "
495 "git-debrebase new-upstream."
496 msgstr ""
497
498 #. type: textblock
499 #: ../git-debrebase.1.pod:275
500 msgid ""
501 "It is also a snag if the specified upstream has a debian/ subdirectory.  "
502 "This check exists to detect certain likely user errors, but if this "
503 "situation is true and expected, forcing it is fine."
504 msgstr ""
505
506 #. type: textblock
507 #: ../git-debrebase.1.pod:281
508 msgid ""
509 "git-debrebase will try to look for the dgit archive view of the most recent "
510 "release, and if it finds it will make a pseduomerge so that your new git-"
511 "debrebase view is appropriately fast forward."
512 msgstr ""
513
514 #. type: textblock
515 #: ../git-debrebase.1.pod:286
516 msgid ""
517 "The result is a well-formed git-debrebase interchange branch.  The result is "
518 "also fast-forward from the gbp branch."
519 msgstr ""
520
521 #. type: textblock
522 #: ../git-debrebase.1.pod:289
523 msgid ""
524 "It is a snag if the new branch looks like it will have diverged, just as for "
525 "a laundering/unstitching call to git-debrebase; See L</Establish the current "
526 "branch's ffq-prev>, below."
527 msgstr ""
528
529 #. type: textblock
530 #: ../git-debrebase.1.pod:293
531 msgid ""
532 "Note that it is dangerous not to know whether you are dealing with a gbp "
533 "patches-unapplied branch containing quilt patches, or a git-debrebase "
534 "interchange branch.  At worst, using the wrong tool for the branch format "
535 "might result in a dropped patch queue!"
536 msgstr ""
537
538 #. type: =head1
539 #: ../git-debrebase.1.pod:302
540 msgid "UNDERLYING AND SUPPLEMENTARY OPERATIONS"
541 msgstr ""
542
543 #. type: =item
544 #: ../git-debrebase.1.pod:306
545 msgid "git-debrebase breakwater"
546 msgstr ""
547
548 #. type: textblock
549 #: ../git-debrebase.1.pod:308
550 msgid ""
551 "Prints the breakwater tip commitid.  If your HEAD branch is not fully "
552 "laundered, prints the tip of the so-far-laundered breakwater."
553 msgstr ""
554
555 #. type: =item
556 #: ../git-debrebase.1.pod:312
557 msgid "git-debrebase anchor"
558 msgstr ""
559
560 #. type: textblock
561 #: ../git-debrebase.1.pod:314
562 msgid "Prints the breakwater anchor commitid."
563 msgstr ""
564
565 #. type: =item
566 #: ../git-debrebase.1.pod:316
567 msgid "git-debrebase analyse"
568 msgstr ""
569
570 #. type: textblock
571 #: ../git-debrebase.1.pod:318
572 msgid ""
573 "Walks the history of the current branch, most recent commit first, back "
574 "until the most recent anchor, printing the commit object id, and commit type "
575 "and info (ie the semantics in the git-debrebase model)  for each commit."
576 msgstr ""
577
578 #. type: =item
579 #: ../git-debrebase.1.pod:326
580 msgid "git-debrebase record-ffq-prev"
581 msgstr ""
582
583 #. type: textblock
584 #: ../git-debrebase.1.pod:328
585 msgid ""
586 "Establishes the current branch's ffq-prev, as discussed in L</UNSTITCHING "
587 "AND LAUNDERING>, but does not launder the branch or move HEAD."
588 msgstr ""
589
590 #. type: textblock
591 #: ../git-debrebase.1.pod:332
592 msgid ""
593 "It is an error if the ffq-prev could not be recorded.  It is also an error "
594 "if an ffq-prev has already been recorded, unless --noop-ok."
595 msgstr ""
596
597 #. type: =item
598 #: ../git-debrebase.1.pod:336
599 msgid "git-debrebase launder-v0"
600 msgstr ""
601
602 #. type: textblock
603 #: ../git-debrebase.1.pod:338
604 msgid ""
605 "Launders the branch without recording anything in ffq-prev.  Then prints "
606 "some information about the current branch.  Do not use this operation; it "
607 "will be withdrawn soon."
608 msgstr ""
609
610 #. type: =item
611 #: ../git-debrebase.1.pod:343
612 msgid "git-debrebase convert-to-gbp"
613 msgstr ""
614
615 #. type: textblock
616 #: ../git-debrebase.1.pod:345
617 msgid ""
618 "Converts a laundered branch into a gbp patches-unapplied branch containing "
619 "quilt patches.  The result is not fast forward from the interchange branch, "
620 "and any ffq-prev is deleted."
621 msgstr ""
622
623 #. type: textblock
624 #: ../git-debrebase.1.pod:350
625 msgid ""
626 "This is provided mostly for the test suite and for unusual situations.  It "
627 "should only be used with a care and with a proper understanding of the "
628 "underlying theory."
629 msgstr ""
630
631 #. type: textblock
632 #: ../git-debrebase.1.pod:355
633 msgid ""
634 "Be sure to not accidentally treat the result as a git-debrebase branch, or "
635 "you will drop all the patches!"
636 msgstr ""
637
638 #. type: =item
639 #: ../git-debrebase.1.pod:359
640 msgid "git-debrebase convert-from-dgit-view [<convert-options>] [upstream]"
641 msgstr ""
642
643 #. type: textblock
644 #: ../git-debrebase.1.pod:361
645 msgid ""
646 "Converts any dgit-compatible git branch corresponding to a (possibly "
647 "hypothetical) 3.0 quilt dsc source package into a git-debrebase-compatible "
648 "branch."
649 msgstr ""
650
651 #. type: textblock
652 #: ../git-debrebase.1.pod:365
653 msgid ""
654 "This operation should not be used if the branch is already in git-debrebase "
655 "form.  Normally git-debrebase will refuse to continue in this case (or "
656 "silently do nothing if the global --noop-ok option is used)."
657 msgstr ""
658
659 #. type: textblock
660 #: ../git-debrebase.1.pod:370
661 msgid ""
662 "Some representation of the original upstream source code will be needed.  If "
663 "I<upstream> is supplied, that must be a suitable upstream commit.  By "
664 "default, git-debrebase will look first for git tags (as for new-upstream), "
665 "and then for orig tarballs which it will ask dgit to process."
666 msgstr ""
667
668 #. type: textblock
669 #: ../git-debrebase.1.pod:376
670 msgid ""
671 "The upstream source must be exactly right and all the patches in debian/"
672 "patches must be up to date.  Applying the patches from debian/patches to the "
673 "upstream source must result in exactly your HEAD."
674 msgstr ""
675
676 #. type: textblock
677 #: ../git-debrebase.1.pod:381
678 msgid ""
679 "The output is laundered and stitched.  The resulting history is not "
680 "particularly pretty, especially if orig tarball(s) were imported to produce "
681 "a synthetic upstream commit."
682 msgstr ""
683
684 #. type: textblock
685 #: ../git-debrebase.1.pod:386
686 msgid ""
687 "The available convert-options are as follows.  (These must come after "
688 "convert-from-dgit-view.)"
689 msgstr ""
690
691 #. type: =item
692 #: ../git-debrebase.1.pod:391
693 msgid "--[no-]diagnose"
694 msgstr ""
695
696 #. type: textblock
697 #: ../git-debrebase.1.pod:393
698 msgid ""
699 "Print additional error messages to help diagnose failure to find an "
700 "appropriate upstream.  --no-diagnose is the default."
701 msgstr ""
702
703 #. type: =item
704 #: ../git-debrebase.1.pod:397
705 msgid "--build-products-dir"
706 msgstr ""
707
708 #. type: textblock
709 #: ../git-debrebase.1.pod:399
710 msgid ""
711 "Directory to look in for orig tarballs.  The default is the git config "
712 "option dgit.default.build-products-dir or failing that, C<..>.  Passed on to "
713 "dgit, if git-debrebase invokes dgit."
714 msgstr ""
715
716 #. type: =item
717 #: ../git-debrebase.1.pod:405
718 msgid "--[no-]origs"
719 msgstr ""
720
721 #. type: textblock
722 #: ../git-debrebase.1.pod:407
723 msgid ""
724 "Whether to try to look for or use any orig tarballs.  --origs is the default."
725 msgstr ""
726
727 #. type: =item
728 #: ../git-debrebase.1.pod:410
729 msgid "--[no-]tags"
730 msgstr ""
731
732 #. type: textblock
733 #: ../git-debrebase.1.pod:412
734 msgid ""
735 "Whether to try to look for or use any upstream git tags.  --tags is the "
736 "default."
737 msgstr ""
738
739 #. type: =item
740 #: ../git-debrebase.1.pod:415
741 msgid "--always-convert-anyway"
742 msgstr ""
743
744 #. type: textblock
745 #: ../git-debrebase.1.pod:417
746 msgid ""
747 "Perform the conversion operation, producing unpleasant extra history, even "
748 "if the branch seems to be in git-debrebase form already.  This should not be "
749 "done unless necessary, and it should not be necessary."
750 msgstr ""
751
752 #. type: =item
753 #: ../git-debrebase.1.pod:425
754 msgid "git-debrebase forget-was-ever-debrebase"
755 msgstr ""
756
757 #. type: textblock
758 #: ../git-debrebase.1.pod:427
759 msgid ""
760 "Deletes the ffq-prev and debrebase-last refs associated with this branch, "
761 "that git-debrebase and dgit use to determine whether this branch is managed "
762 "by git-debrebase, and what previous head may need to be stitched back in."
763 msgstr ""
764
765 #. type: textblock
766 #: ../git-debrebase.1.pod:433
767 msgid ""
768 "This can be useful if you were just playing with git-debrebase, and have "
769 "used git-reset --hard to go back to a commit before your experiments."
770 msgstr ""
771
772 #. type: textblock
773 #: ../git-debrebase.1.pod:437
774 msgid "Do not use this if you expect to run git-debrebase on the branch again."
775 msgstr ""
776
777 #. type: textblock
778 #: ../git-debrebase.1.pod:443
779 msgid ""
780 "This section documents the general options to git-debrebase (ie, the ones "
781 "which immediately follow git-debrebase or git debrebase on the command "
782 "line).  Individual operations may have their own options which are docuented "
783 "under each operation."
784 msgstr ""
785
786 #. type: =item
787 #: ../git-debrebase.1.pod:455
788 msgid "-f<snag-id>"
789 msgstr ""
790
791 #. type: textblock
792 #: ../git-debrebase.1.pod:457
793 msgid "Turns snag(s) with id <snag-id> into warnings."
794 msgstr ""
795
796 #. type: textblock
797 #: ../git-debrebase.1.pod:459
798 msgid ""
799 "Some troublesome things which git-debrebase encounters are B<snag>s.  (The "
800 "specific instances are discussed in the text for the relevant operation.)"
801 msgstr ""
802
803 #. type: textblock
804 #: ../git-debrebase.1.pod:464
805 msgid ""
806 "When a snag is detected, a message is printed to stderr containing the snag "
807 "id (in the form C<-f<snag-idE<gt>>), along with some prose."
808 msgstr ""
809
810 #. type: textblock
811 #: ../git-debrebase.1.pod:469
812 msgid ""
813 "If snags are detected, git-debrebase does not continue, unless the relevant -"
814 "f<snag-id> is specified, or --force is specified."
815 msgstr ""
816
817 #. type: =item
818 #: ../git-debrebase.1.pod:473
819 msgid "--force"
820 msgstr ""
821
822 #. type: textblock
823 #: ../git-debrebase.1.pod:475
824 msgid "Turns all snags into warnings.  See the -f<snag-id> option."
825 msgstr ""
826
827 #. type: textblock
828 #: ../git-debrebase.1.pod:478
829 msgid ""
830 "Do not invoke git-debrebase --force in scripts and aliases; instead, specify "
831 "the particular -f<snag-id> for expected snags."
832 msgstr ""
833
834 #. type: =item
835 #: ../git-debrebase.1.pod:481
836 msgid "--noop-ok"
837 msgstr ""
838
839 #. type: textblock
840 #: ../git-debrebase.1.pod:483
841 msgid ""
842 "Suppresses the error in some situations where git-debrebase does nothing, "
843 "because there is nothing to do."
844 msgstr ""
845
846 #. type: textblock
847 #: ../git-debrebase.1.pod:487
848 msgid ""
849 "The specific instances are discussed in the text for the relvant operation."
850 msgstr ""
851
852 #. type: =item
853 #: ../git-debrebase.1.pod:490
854 msgid "--anchor=<commit-ish>"
855 msgstr ""
856
857 #. type: textblock
858 #: ../git-debrebase.1.pod:492
859 msgid ""
860 "Treats <commit-ish> as an anchor.  This overrides the usual logic which "
861 "automatically classifies commits as anchors, pseudomerges, delta queue "
862 "commits, etc."
863 msgstr ""
864
865 #. type: textblock
866 #: ../git-debrebase.1.pod:496
867 msgid ""
868 "It also disables some coherency checks which depend on metadata extracted "
869 "from its commit message, so it is a snag if <commit-ish> is the anchor for "
870 "the previous upstream version in git-debrebase new-upstream operations."
871 msgstr ""
872
873 #. type: =item
874 #: ../git-debrebase.1.pod:503
875 msgid "--dgit=<program>"
876 msgstr ""
877
878 #. type: textblock
879 #: ../git-debrebase.1.pod:505
880 msgid ""
881 "Run <program>, instead of dgit from PATH, when invocation of dgit is "
882 "necessary.  This is provided mostly for the benefit of the test suite."
883 msgstr ""
884
885 #. type: =item
886 #: ../git-debrebase.1.pod:509
887 msgid "-D"
888 msgstr ""
889
890 #. type: textblock
891 #: ../git-debrebase.1.pod:511
892 msgid "Requests (more) debugging.  May be repeated."
893 msgstr ""
894
895 #. type: =item
896 #: ../git-debrebase.1.pod:513
897 msgid "--experimntal-merge-resolution"
898 msgstr ""
899
900 #. type: textblock
901 #: ../git-debrebase.1.pod:515
902 msgid ""
903 "Enable experimental code for handling general merges (see L<git-debrebase(5)/"
904 "General merges>)."
905 msgstr ""
906
907 #. type: textblock
908 #: ../git-debrebase.1.pod:518
909 msgid ""
910 "This option may generate branch structures that require the use of this same "
911 "option by other people.  Also you may experience lossage of various kinds, "
912 "including false error messages, references to nonexistent documentation, "
913 "being handed an incomprehensible pile of multidimensional merge wreckage, "
914 "and/or possible mangling of your package's source code."
915 msgstr ""
916
917 #. type: =head1
918 #: ../git-debrebase.1.pod:529
919 msgid "UNSTITCHING AND LAUNDERING"
920 msgstr ""
921
922 #. type: textblock
923 #: ../git-debrebase.1.pod:531
924 msgid ""
925 "Several operations unstitch and launder the branch first.  In detail this "
926 "means:"
927 msgstr ""
928
929 #. type: =head2
930 #: ../git-debrebase.1.pod:534
931 msgid "Establish the current branch's ffq-prev"
932 msgstr ""
933
934 #. type: textblock
935 #: ../git-debrebase.1.pod:536
936 msgid ""
937 "If ffq-prev is not yet recorded, git-debrebase checks that the current "
938 "branch is ahead of relevant remote tracking branches.  The relevant branches "
939 "depend on the current branch (and its git configuration)  and are as follows:"
940 msgstr ""
941
942 #. type: textblock
943 #: ../git-debrebase.1.pod:548
944 msgid ""
945 "The branch that git would merge from (remote.<branch>.merge, remote.<branch>."
946 "remote);"
947 msgstr ""
948
949 #. type: textblock
950 #: ../git-debrebase.1.pod:553
951 msgid ""
952 "The branch git would push to, if different (remote.<branch>.pushRemote etc.);"
953 msgstr ""
954
955 #. type: textblock
956 #: ../git-debrebase.1.pod:558
957 msgid "For local dgit suite branches, the corresponding tracking remote;"
958 msgstr ""
959
960 #. type: textblock
961 #: ../git-debrebase.1.pod:563
962 msgid "If you are on C<master>, remotes/dgit/dgit/sid."
963 msgstr ""
964
965 #. type: textblock
966 #: ../git-debrebase.1.pod:568
967 msgid ""
968 "The apparently relevant ref names to check are filtered through branch."
969 "<branch>.ffq-ffrefs, which is a semicolon-separated list of glob patterns, "
970 "each optionally preceded by !; first match wins."
971 msgstr ""
972
973 #. type: textblock
974 #: ../git-debrebase.1.pod:573
975 msgid ""
976 "In each case it is a snag if the local HEAD is behind the checked remote, or "
977 "if local HEAD has diverged from it.  All the checks are done locally using "
978 "the remote tracking refs: git-debrebase does not fetch anything from "
979 "anywhere."
980 msgstr ""
981
982 #. type: textblock
983 #: ../git-debrebase.1.pod:579
984 msgid ""
985 "If these checks pass, or are forced, git-debrebse then records the current "
986 "tip as ffq-prev."
987 msgstr ""
988
989 #. type: =head2
990 #: ../git-debrebase.1.pod:583
991 msgid "Examine the branch"
992 msgstr ""
993
994 #. type: textblock
995 #: ../git-debrebase.1.pod:585
996 msgid ""
997 "git-debrebase analyses the current HEAD's history to find the anchor in its "
998 "breakwater, and the most recent breakwater tip."
999 msgstr ""
1000
1001 #. type: =head2
1002 #: ../git-debrebase.1.pod:590
1003 msgid "Rewrite the commits into laundered form"
1004 msgstr ""
1005
1006 #. type: textblock
1007 #: ../git-debrebase.1.pod:592
1008 msgid ""
1009 "Mixed debian+upstream commits are split into two commits each.  Delta queue "
1010 "(upstream files) commits bubble to the top.  Pseudomerges, and quilt patch "
1011 "additions, are dropped."
1012 msgstr ""
1013
1014 #. type: textblock
1015 #: ../git-debrebase.1.pod:598
1016 msgid ""
1017 "This rewrite will always succeed, by construction.  The result is the "
1018 "laundered branch."
1019 msgstr ""
1020
1021 #. type: textblock
1022 #: ../git-debrebase.1.pod:603
1023 msgid "git-debrebase(1), dgit-maint-rebase(7), dgit(1), gitglossary(7)"
1024 msgstr ""