[IPython-dev] git submodules

[MinRK]

As of this week, IPython now gets its third-party javascript dependencies
from a git submodule.
This adds an extra wrinkle to using IPython from git, but the basics all
work:

    git clone git://github.com/ipython/ipython.git
    cd ipython && python setup.py install
    # or
    cd ipython && python setup.py develop

# or one step with pip:

    pip install -e git://github.com/ipython/ipython.git#egg=ipython

But where you might get tripped up is updating an existing repo via `git
pull`, which does not update the submodule (the plan is for this to be
needed very rarely, but it will come up, especially now that the submodule
is new).  The gist is that if you get 404s on files in `static/components`
while running the notebook, the first thing to try is:

    python setup.py submodule

which just does

    git submodule init
    git submodule update --recursive

to make sure that the components submodule is up to date.

We will try to get this as automatic as we can, so that we trip up /
confuse / annoy as few people as possible, but we are figuring things out
as we go right now.

-MinRK
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20130502/7045b621/attachment.html>