source-1234409395.txt

   1 Interactive ''rebase'' just learnt a new command: ''topic''
   2
   3 Today I am pretty pleased with myself.  Two projects at my day job got a real
   4 boost, and I implemented a shortcut that avoids the ugly 'bookmark' statement
   5 in rebase scripts most of the time.
   6
   7 A typical rebase script, generated by ''git rebase -i -p $COMMIT'' will look
   8 something like this:
   9
  10 <bash>
  11 pick 1234567 My first commit
  12 topic begin super-cool-feature
  13 pick 2345678 The super cool feature
  14 pick 3456789 Documentation for the super cool feature
  15 topic end super-cool-feature
  16 </bash>
  17
  18 The result will be a merge commit at the HEAD whose first parent is
  19 "My first commit", whose second parent is "Documentation for the super
  20 cool feature" and whose commit message is "Merge branch 'super-cool-feature'".
  21
  22 Side note: internally, ''topic begin $NAME [at $COMMIT]'' will be handled as if
  23 you wrote ''bookmark merge-parent-of-$NAME; goto $COMMIT'', and
  24 ''topic end $NAME [$MESSAGE]'' will be handled as if you wrote
  25 ''bookmark $NAME; goto merge-parent-of-$NAME; merge parents $NAME [original $MARK Merge branch '$NAME']''.
  26
  27 Of course, being more concise, the 'topic' statement is not only nicer to the
  28 eye, but also less error-prone.
  29
  30 And hopefully many people will agree with me that this rebase script is pretty
  31 intuitive.