[IPython-dev] AttributeError when running sphinx docs

[Brian Granger]

On Fri, Aug 10, 2012 at 8:28 PM, Fernando Perez <fperez.net at gmail.com> wrote:
> On Fri, Aug 10, 2012 at 8:12 PM, Brian Granger <ellisonbg at gmail.com> wrote:
>
>> Yes, it completely fails.  I am attaching the log of the TB that
>> finally kills it.
>
> Argh.. No clue.  I compared my versions and I have almost everything
> the same as you, except sphinx is 1.1.3 for me, but I doubt that tiny
> version delta is the issue here.

I wonder if it is that I use setup.py develop?

> One option would be to get rid of our auto-generated API docs.  I'm
> reluctant to do this because that's the kind of thing that we never
> know who may regularly use them and we've had them for years.  But I
> personally never use them, and they are the source of most of our
> build time as well as most of the errors and warnings.  A bit brutal
> of a solution, but it would go a long way to making this more
> manageable.  Thoughts?

We could get rid of that until we can clean up the build.  I do like
having the auto-generated API docs though.

>> Yep, silent errors like that are horrible.  Can we set a flag to cause
>> warnings to halt the build?
>
> Yup, call the build with -W:
>
> http://sphinx.pocoo.org/latest/invocation.html#cmdoption-sphinx-build-W
>
> The problem is that right now that's so depressing to do that we have
> all just stuck our collective heads in the sand :)
>
>> We currently have this category, and it is logically sound.  But these
>> days the notebook almost belongs at the top-level.  But it does share
>> a lot with the other frontends.  Maybe organize this "interactive"
>> section according to components: qtconsole, terminal, notebook,
>> kernel.  But the kernel is more of a dev level thing.
>
> Agreed.
>
>> I think we are ready to get rid of the plugin stuff.  I will check on
>> that are submit a PR.
>
> Great!
>
>> I almost think that the dev guide should be done as a github wiki -
>> basically use github for everything dev related.  I think that will
>> encourage more people to keep those docs updated.
>
> I'd be up for that.  And we've had the conversation about getting rid
> of our wiki in favor of a github one, we might as well make that
> decision with this in mind... Though probably in a separate thread to
> keep the conversation manageable.
>
>> Yes, but for now I would be happy being able to build the docs, errors
>> and all ;-(
>
> I know, I wish I knew what was going on for you.  I'm assuming you did
> a make clean first, right?  I've had in the past (years ago) to debug
> one of those, and all I remember is that it was a pain and put me in a
> bad mood...

Yes, I did make clean.  Don't feel up to it tonight.

Brian

> Cheers,
>
> f
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev



-- 
Brian E. Granger
Cal Poly State University, San Luis Obispo
bgranger at calpoly.edu and ellisonbg at gmail.com