Recursive-submodule-checkout.textile

   1 You find the current state of this series in the [[recusive_submodule_update|https://github.com/jlehmann/git-submod-enhancements/tree/recursive_submodule_checkout]] branch in this repo.
   2
   3 **Be warned: the code is still experimental and might damage your data!**
   4 Especially when removing a submodule on checkout all untracked files inside it will be lost! (and it'll stay that way until the discussed ignored-but-precious attribute is implemented in Git)
   5
   6 Having said that, I already use this code for quite some time at my dayjob and it's working fine for me.
   7
   8 *Stuff that's currently known not to work:*
   9
  10 * Interactive rebase doesn't update submodule work trees
  11 * A recreated submodule won't appear on first checkout (but it will on the second checkout; a fix for that is being worked on)
  12 * A non-interactive rebase empties changed submodules
  13
  14 Please mail me if you find another problem so we can take care of it (patches are also welcome ;-).
  15
  16 *How to test it*
  17
  18 Just check out the [[recusive_submodule_update|https://github.com/jlehmann/git-submod-enhancements/tree/recursive_submodule_checkout]] and put a "return 1" in the first line of submodule_needs_update() in submodule.c in a commit on top of it (this enables unconditional recursive checkout and will be needed until the configuration options are implemented and mature enough; but currently it breaks quite some tests).