[GRASS-dev] Issues with Sphinx on osgeo server

Markus Neteler neteler at osgeo.org
Sat Oct 4 13:31:34 PDT 2014

On Fri, Oct 3, 2014 at 10:54 PM, Vaclav Petras <wenzeslaus at gmail.com> wrote:
> On Mon, Sep 29, 2014 at 7:11 AM, Markus Neteler <neteler at osgeo.org> wrote:
> Both conf.py files and Sphinx itself requires import of packages/modules. So
> the documentation build must run inside a valid GRASS session. conf.py
> checks if GISBASE is set which is but it seems that Python path is not,
> although the Makefile contains:
> $(call run_grass,$(SPHINXBUILD) ...)
> Does `call run_grass` sets PYTHONPATH? It seems that it does:
> It even seems that variable is set properly (although with the syntax I'm
> never sure):
> GRASS_PYTHONPATH := $(call mkpath,$(GISBASE)/gui/wxpython,$$PYTHONPATH)
> GRASS_PYTHONPATH := $(call mkpath,$(GISBASE)/etc/python,$(GRASS_PYTHONPATH))
> Now I'm wondering if the module is even there. Do you actually compile GRASS
> or just the documentation?

I compile all GRASS 7 trunk there.

I checked again. So the differences are:

# generate pyGRASS sphinx manual (in docs/html/libpython/)
(cd lib/python/docs/ ; make libpythonhtml)

--> works ok

# generate wxGUI sphinx manual etc, (in main src directory)
make sphinxdoc

--> fails (also on Fedora):

Creating file src/vnet.rst.
Creating file src/web_services.rst.
Creating file src/wxplot.rst.
make[1]: Leaving directory
make -C ./gui/wxpython/docs/wxgui_sphinx/ wxguihtml
make[1]: Entering directory
LC_ALL=C  -b html -d _build/doctrees   -c . src/
/bin/sh: -b: command not found
make[1]: *** [wxguihtml] Error 127
make[1]: Leaving directory
make: *** [sphinxdoc] Error 2

Maybe the "make sphinxdoc" way is yet useless and I'll simply keep the
previous one for the weekly cronjob.


More information about the grass-dev mailing list