add travis doc build

[cpcloud]

not sure if this is worth the trouble but it may catch version incompatibility issues and other bugs not caught by the test suite.

[jtratner]

Check out jtratner/pandas@2c285ea . I think that covers what you're looking for. It really depends how long the job takes - https://travis-ci.org/jtratner/pandas/jobs/7895295

[cpcloud]

looks ok, but i'm thinking about the possible numpy dependency issue here. there's a few examples in the docs that throw an error for slightly older versions of numpy...i wouldn't want this to always fail because of that. i was actually thinking only a doc build and no other tests so another row in the build matrix...

[jtratner]

@cpcloud I updated it a bit - jtratner/pandas@bcae377 . It does mean that the test now has to wait for one of the other tests to finish (since it looks like Travis will only run 5 tests concurrently), which means it adds about 20 minutes to testing time. Would it make more sense to incorporate with one of the other version tests?

[cpcloud]

An extra 20 minutes is unacceptable IMHO. Travis is already slow enough. Probably better to put it in one of the 2.7 like u had. Just need to make sure that no exceptions are generated (which is the point really...) but need to see if there are any benign exceptions generated by numpy... I get these when I run the doc build and I believe it's because I use dev numpy.

[cpcloud]

i'm going to test a doc build on pip install <dependency>-backed pandas to see if any warnings are generated...if not this might be a go pending someone else's review...

[jreback]

can we shove this in the 2.7 non-us build?

[cpcloud]

probably would be ok, i just want to check those deps first...

[jtratner]

So, my branch wasn't actually testing doc building, because it didn't have make doc in the Makefile, but this wasn't causing an error. This is fixed now, but it required pulling in the Makefile commit too... (jtratner/pandas@8994c26)

[cpcloud]

@jreback can assume that the doc-building machine has scikits.timeseries installed so that it won't raise?

[jreback]

yep has all deps AFAIN

[jtratner]

Okay, this doesn't work right now, because make docs is set to be silent. Also, it looks like sphinx doesn't get installed, so I'll have to fix again.

[cpcloud]

also there are some doc build issues that i'm fixing right now...for some reason when branch depending on numpy versions in timeseries.rst i get a few errors in visualisation.rst. probably some variable aliasing somewhere...

[jtratner]

Looks like it needs IPython too ... check out the failing build: https://travis-ci.org/jtratner/pandas/jobs/7913726

(at least we now know that it errors out here)

[cpcloud]

yep just add a pip install ipython

[cpcloud]

if u do that you might want to add ipython to ci/print_versions.py