Document API change in hist

[neggert]

Per discussion in #2293. I was having issues getting the documentation to compile (exception: cannot import name _string_to_bool), but I think this is simple enough that it should be okay.

This time at the correct branch.

[WeatherGod]

That exception might be the result of the refactoring. A common oversight is that when doing "from foo import *" does not import anything starting with an underscore unless explicitly put into foo.__all__. I wonder if this might be the case here?

[neggert]

Looks like the function in question was moved around in #2182, but I don't think those changes are in v1.3.x.

[WeatherGod]

Did you install matplotlib v1.3 prior to trying to build the docs? Unlike the tests, sphinx works off of the installed version of matplotlib rather than an in-place build of it.

[neggert]

Yes, I've tried it with both this branch (installed using setup.py develop) and 1.3.0 from Anaconda.

[mdboom]

I don't think setup.py develop will work -- you need to install to a virtualenv that sphinx will pick up. I keep meaning to get the build_sphinx command working, but at present it doesn't.

[neggert]

Alright, I got it working. There was a .pth file hanging around pointing to the wrong version of matplotlib. The html looks fine.