[GRASS-dev] Issues with Sphinx on osgeo server

[Markus Neteler]

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:
>
> PYTHONPATH="$(GRASS_PYTHONPATH)"
>
> 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
`/home/neteler/software/grass71/gui/wxpython/docs/wxgui_sphinx'
make -C ./gui/wxpython/docs/wxgui_sphinx/ wxguihtml
make[1]: Entering directory
`/home/neteler/software/grass71/gui/wxpython/docs/wxgui_sphinx'
GISRC=/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/demolocation/.grassrc71
GISBASE=/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu
PATH="/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/bin:/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/bin:/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/scripts:$PATH"
PYTHONPATH="/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/etc/python:/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/gui/wxpython:$PYTHONPATH"
LD_LIBRARY_PATH="/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/bin:/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/scripts:/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/lib:/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/lib:"
LC_ALL=C  -b html -d _build/doctrees   -c . src/
/home/neteler/software/grass71/dist.x86_64-unknown-linux-gnu/docs/html/wxgui
/bin/sh: -b: command not found
make[1]: *** [wxguihtml] Error 127
make[1]: Leaving directory
`/home/neteler/software/grass71/gui/wxpython/docs/wxgui_sphinx'
make: *** [sphinxdoc] Error 2

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

Markus