[GRASS-dev] pygrass documentation

[Markus Neteler]

On Fri, Mar 1, 2013 at 6:50 PM, Vaclav Petras <wenzeslaus at gmail.com> wrote:
...
> For now, I would leave pygrass doc in the ReST (both the py and rst files).

That's fine. Martin and me have fixed the sphinx compilation, this now
works on more recent systems:

cd lib/python/pygrass/docs/
make html

It generates the nice Sphinx-based documentation.

---

I have updated the cronjob on grass.osgeo.org accordingly to obtain

http://grass.osgeo.org/programming7/pygrass/

but I struggle on the Debian Wheezy box with this error (maybe bad
sphinx installation there?):

Running Sphinx v1.2b3
loading translations [python]... not available for built-in messages
loading pickled environment... not yet created
building [html]: targets for 6 source files that are out of date
updating environment: 6 added, 0 changed, 0 removed
reading sources... [100%] vector
/home/neteler/grass7_svn_head_progmanual/grass7/lib/python/pygrass/docs/attributes.rst:113:
WARNING: autodoc: failed to import class u'Link' from module
u'pygrass.vector.table'; the following exception was raised:
Traceback (most recent call last):
  File "/usr/local/lib/python2.6/dist-packages/Sphinx-1.2b3-py2.6.egg/sphinx/ext/autodoc.py",
line 335, in import_object
    __import__(self.modname)
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/pygrass/__init__.py",
line 12, in <module>
    from . import errors
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/pygrass/errors.py",
line 8, in <module>
    from grass.pygrass.messages import get_msgr
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/pygrass/__init__.py",
line 13, in <module>
    from . import gis
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/pygrass/gis/__init__.py",
line 23, in <module>
    script.gisenv()
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/script/core.py",
line 979, in gisenv
    s = read_command("g.gisenv", flags='n')
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/script/core.py",
line 420, in read_command
    ps = pipe_command(*args, **kwargs)
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/script/core.py",
line 395, in pipe_command
    return start_command(*args, **kwargs)
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/script/core.py",
line 354, in start_command
    return Popen(args, **popts)
  File "/home/neteler/grass7_svn_head_progmanual/grass7/dist.x86_64-unknown-linux-gnu/etc/python/grass/script/core.py",
line 64, in __init__
    startupinfo, creationflags)
  File "/usr/lib/python2.6/subprocess.py", line 623, in __init__
    errread, errwrite)
  File "/usr/lib/python2.6/subprocess.py", line 1141, in _execute_child
    raise child_exception
OSError: [Errno 2] No such file or directory

Any ideas? On my Fedora 20 it works nicely.

thanks
Markus