Skip to content

doc building taking a very long time #6411

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
cpcloud opened this issue Feb 19, 2014 · 18 comments
Closed

doc building taking a very long time #6411

cpcloud opened this issue Feb 19, 2014 · 18 comments
Milestone

Comments

@cpcloud
Copy link
Member

cpcloud commented Feb 19, 2014

I remember these building in less than 5 minutes in the past.

@cpcloud cpcloud added this to the 0.14.0 milestone Feb 19, 2014
@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

are u using sphinx 1.1.3? (1.2 doesn't seem to work for me)

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

I'm using sphinx 1.2.1 let me try reverting to an older versio

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

btw phillipcloud.com is now temporarily host pandas docs if you want to take a look :)

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

still taking a long time with sphinx 1.1.3

@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

you can just build a single section...-single much faster

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

ok thx

@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

the api is what takes a long time

@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

fyi...i think their is a way to limit the exception backtraces (or can use a code-block...but better to have it except)

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

right ... yeah that thing is huge bc of visitor

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

hm doesn't look like it's anywhere in our ipython directive ..

@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

hmm...ok...maybe just do a code-block then?

@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

maybe make an issue about limiting backtraces....got to be a way

@cpcloud
Copy link
Member Author

cpcloud commented Feb 19, 2014

ipython/ipython#5162

@jreback
Copy link
Contributor

jreback commented Feb 19, 2014

gr8

@cpcloud
Copy link
Member Author

cpcloud commented Feb 20, 2014

@jreback Should we keep this open?

@jreback
Copy link
Contributor

jreback commented Feb 20, 2014

did it take a long time? excessive?

@jorisvandenbossche

@cpcloud
Copy link
Member Author

cpcloud commented Feb 20, 2014

make doc is slow ... but if that's how it is because of API docs I guess I can live with that and just use --single since that's fast.

@jreback jreback closed this as completed Feb 20, 2014
@jorisvandenbossche
Copy link
Member

yep. The doc building has always been slow, we now have just a lot more docs than some months ago (mainly more api docs).
And you can indeed build partial docs after #6179.

I would also advise not to use make doc, maar python doc/make.py html if you don't want to do a full rebuild every time. This will be much quicker if you just want to check your changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants