basemap docs not finding sphinx extensions

Hi,
I was just rebuilding basemap and its docs.
With v1.07 of Sphinx, latest git versions of matplotlib & basemap, I
needed to modify basemap/doc/conf.py as follows:

1. Insert before line 20:

sys.path.append(os.path.abspath(PATH_TO_MATPLOTLIB_SRC/doc/sphinxext'))
(to find matplotlib sphinxext math_symbol_table)

2. Edit line 36
'inheritance_diagram' --> 'sphinx.ext.inheritance_diagram'

--George.

Thanks. That change is due to a recent change I made in matplotlib. The "inheritance_diagram" Sphinx directive has existed in Sphinx itself for a long while now, so there was no need to maintain our old and crufty original version in matplotlib anymore. Since PATH_TO_MATPLOTLIB_SRC/doc/sphinxext is meant to contain private extensions (as opposed to PATH_TO_MATPLOTLIB_SRC/lib/matplotlib/sphinxext which contains public and installed extensions), I didn't realise anyone else was using it.

Your proposed changes look right, except math_symbol_table can probably just be removed altogether -- basemap doesn't use it.

I've filed a pull request for this here:

Mike

···

On 04/07/2011 05:21 AM, George Nurser wrote:

Hi,
I was just rebuilding basemap and its docs.
With v1.07 of Sphinx, latest git versions of matplotlib& basemap, I
needed to modify basemap/doc/conf.py as follows:

1. Insert before line 20:

sys.path.append(os.path.abspath(PATH_TO_MATPLOTLIB_SRC/doc/sphinxext'))
(to find matplotlib sphinxext math_symbol_table)

2. Edit line 36
'inheritance_diagram' --> 'sphinx.ext.inheritance_diagram'

--George.

------------------------------------------------------------------------------
Xperia(TM) PLAY
It's a major breakthrough. An authentic gaming
smartphone on the nation's most reliable network.
And it wants your games.
http://p.sf.net/sfu/verizon-sfdev
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
matplotlib-users List Signup and Options