X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=NOTES.git-debrebase;h=bd6e7151221f67ff54e6100f629c23ce58afaa55;hp=5a6ff88215ecf1aad496836dd7c4d27a8748bd08;hb=3e3eff12e8f475d4b8bf296d518c786d8a810e29;hpb=952789d95a825aff6524ec45829ed0d9bfd50f6d diff --git a/NOTES.git-debrebase b/NOTES.git-debrebase index 5a6ff882..bd6e7151 100644 --- a/NOTES.git-debrebase +++ b/NOTES.git-debrebase @@ -1,31 +1,27 @@ -TODO - reference docs - git-debrebase(1) command line - tutorial - dgit-maint-debrebase(7) - someone should set branch..mergeOptions to include --ff-only ? +# problems / outstanding questions: +# +# * new-upstream has an awkward UI for multiple upstream pieces. +# You end up with giant runic command lines. Does this matter / +# One consequence of the lack of richness it can need -f in +# fairly sensible situations. +# +# * There should be a good convention for the version number, +# and unfinalised or not changelog, after new-upstream. +# +# * Handing of multi-orig dgit new-upstream .dsc imports is known to +# be broken. They may be not recognised, improperly converted, or +# their conversion may be unrecognised. +# +# * We need to develop a plausible model that works for derivatives, +# who probably want to maintain their stack on top of Debian's. +# downstream-rebase-launder-v0 may be a starting point? +# maybe the hypothetical git-ffqrebase is part of it too. + + +# undocumented usages: +# +# git-debrebase [] downstream-rebase-launder-v0 # experimental - clean up remains of README - - arrange for dgit to automatically stitch on push - -workflow - - git-debrebase blah [implies start] strips pseudomerge(s) - - commit / git-debrebase / etc. - - dgit --damp-run push - hook: call git-debrebase prep-push dgit push does not update remote - or something, must add patches at least - - commit / git-debrebase / etc. strips patches - - dgit push - hook: call git-debrebase prep-push dgit push DOES update remote - - commit / git-debrebase / etc. strips last pm, but arranges - that remade pm will incorporate it ======================================== @@ -82,42 +78,6 @@ When we do a thing We check we are ff from remotes before recording new ffq-prev - ---------- now follows much the same info in different words ---------- - -N. git-debrebase [--noop-ok] record-ffq-prev - - does what is described above - -Re git-debrebase [--noop-ok] stitch - - we will teach dgit to do - git-debrebase stitch - or some such ? - -following parts are not implemented and maybe aren't the -best subcommand names etc. - -3. git-debrebase push - - like git push only does stitch first - ??? command line parsing! - -4. git-debrebase release - - stiches, finalises changelog, signs tags, pushes everything - for the future, when there is some automatic builder - -======================================== - -import from gbp - -what about dgit view branch ? -ideally, would make pseudomerge over dgit view -would need to check that dgit view is actually dgit view of - ond of our ancestors -failing that first push will need --overwrite -that is what is currently implemented - ======================================== how to handle divergence and merges (if not detected soon enough)