X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=git-debrebase.1.pod;h=1c3e68128f0e4967e90d1bb9e219b43b075e57a9;hp=f17f1d670e3f5ffb529ecb5fa228f2109bcbab87;hb=3c2fdc3b9e35352aabbc8b09c286aba2fbfab2ac;hpb=edc1cd049cfa01e7d6249ea199725d2448858704 diff --git a/git-debrebase.1.pod b/git-debrebase.1.pod index f17f1d67..1c3e6812 100644 --- a/git-debrebase.1.pod +++ b/git-debrebase.1.pod @@ -15,11 +15,11 @@ Debian packages based on upstream source code. This is the command line reference. Please read the tutorial -L. +L. For background, theory of operation, and definitions see L. -You should read this manpage in conjunction with +You should read this manpage in cojnunction with L, which defines many important terms used here. @@ -57,10 +57,10 @@ to distinguish them from options for git-debrebase. =item git-debrebase status -Analyise the current branch, -both in terms of its conents, +Analyses the current branch, +both in terms of its contents, and the refs which are relevant to git-debrebase, -and print a human-readable summary. +and prints a human-readable summary. Please do not attempt to parse the output; it may be reformatted or reorganised in the future. @@ -100,7 +100,7 @@ If there is no ffq-prev, it is an error, unless --noop-ok. You should consider using B instead, because that launders the branch too. -=item git-debrebase new-upstream-v0 [...] +=item git-debrebase new-upstream [...] Rebases the delta queue onto a new upstream version. In detail: @@ -199,11 +199,6 @@ L, L, L and L may be able to help. -This subcommand has -v0 in its name because we are not yet sure -that its command line syntax is optimal. -We may want to introduce an incompatible replacement syntax -under the name C. - =item git-debrebase make-patches [--quiet-would-amend] Generate patches in debian/patches/ @@ -230,6 +225,9 @@ are not a simple superset of those already in debian/patches, make-patches will fail with exit status 7, and an error message. (The message can be suppress with --quiet-would-amend.) +If the problem is simply that +the existing patches were not made by git-debrebase, +using dgit quilt-fixup instead should succeed. =item git-debrebase convert-from-gbp [] @@ -345,7 +343,7 @@ Turns snag(s) with id into warnings. Some troublesome things which git-debrebase encounters are Bs. (The specific instances are discussed -in the text for the relvant operation.) +in the text for the relevant operation.) When a snag is detected, a message is printed to stderr containing the snag id