[GRASS-dev] [GRASS GIS] #1218: make htmldocs generates Python and not C documentation

GRASS GRASS developer
1

#1218: make htmldocs generates Python and not C documentation
-------------------------+--------------------------------------------------
Reporter: marisn | Owner: grass-dev@…
     Type: defect | Status: new
Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Keywords: | Platform: Unspecified
      Cpu: Unspecified |
-------------------------+--------------------------------------------------
After opening programmers manual generated by "make htmldocs", all C
functions having Python alternatives are replaced by Python ones
description.

Example: GRASS 6 Vector Architecture -> Vector build functions ->
Vect_build() -> goes to "list grass::lib::vector::Vect_build =
_libs['grass_vect']" comming from "dist.x86_64-unknown-linux-
gnu/etc/python/grass/lib/vector.py" and not original lib/... C version.

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218&gt;
GRASS GIS <http://grass.osgeo.org>

2

#1218: make htmldocs generates Python and not C documentation
-------------------------+--------------------------------------------------
Reporter: marisn | Owner: grass-dev@…
     Type: defect | Status: new
Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Keywords: | Platform: Unspecified
      Cpu: Unspecified |
-------------------------+--------------------------------------------------

Comment(by neteler):

The command should be "make htmldocs-single".

When using the indicated link, I get the same problem indeed!
For the GRASS 7 progman it works ok.

It must be a recent doxygen bug, perhaps a namespace overlap of the page
labels?

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:1&gt;
GRASS GIS <http://grass.osgeo.org>

3

#1218: make htmldocs generates Python and not C documentation
-------------------------+--------------------------------------------------
Reporter: marisn | Owner: martinl
     Type: defect | Status: assigned
Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Keywords: | Platform: Unspecified
      Cpu: Unspecified |
-------------------------+--------------------------------------------------
Changes (by martinl):

* cc: grass-dev@… (added)
  * owner: grass-dev@… => martinl
  * status: new => assigned

Comment:

Related to r44040. I will take a look as soon as posible.

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:2&gt;
GRASS GIS <http://grass.osgeo.org>

4

#1218: make htmldocs generates Python and not C documentation
-------------------------+--------------------------------------------------
Reporter: marisn | Owner: martinl
     Type: defect | Status: assigned
Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Keywords: | Platform: Unspecified
      Cpu: Unspecified |
-------------------------+--------------------------------------------------

Comment(by martinl):

Hopefully fixed in r44538.

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:3&gt;
GRASS GIS <http://grass.osgeo.org>

5

#1218: make htmldocs generates Python and not C documentation
--------------------------+-------------------------------------------------
  Reporter: marisn | Owner: martinl
      Type: defect | Status: closed
  Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Resolution: fixed | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by martinl):

  * status: assigned => closed
  * resolution: => fixed

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:4&gt;
GRASS GIS <http://grass.osgeo.org>

6

#1218: make htmldocs generates Python and not C documentation
--------------------------+-------------------------------------------------
  Reporter: marisn | Owner: martinl
      Type: defect | Status: reopened
  Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Resolution: | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by marisn):

  * status: closed => reopened
  * resolution: fixed =>

Comment:

Not fixed at all. Confirmed by http://grass.osgeo.org/programming6/

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:5&gt;
GRASS GIS <http://grass.osgeo.org>

7

#1218: make htmldocs generates Python and not C documentation
--------------------------+-------------------------------------------------
  Reporter: marisn | Owner: martinl
      Type: defect | Status: reopened
  Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Resolution: | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------

Comment(by martinl):

Replying to [comment:5 marisn]:
> Not fixed at all. Confirmed by http://grass.osgeo.org/programming6/

When building api docs on my machine, everything is OK. Can you build api
docs on your own and confirm it?

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:6&gt;
GRASS GIS <http://grass.osgeo.org>

8

#1218: make htmldocs generates Python and not C documentation
--------------------------+-------------------------------------------------
  Reporter: marisn | Owner: martinl
      Type: defect | Status: closed
  Priority: major | Milestone: 6.5.0
Component: Docs | Version: svn-develbranch6
Resolution: fixed | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by marisn):

  * status: reopened => closed
  * resolution: => fixed

Comment:

Replying to [comment:6 martinl]:
> When building api docs on my machine, everything is OK. Can you build
api docs on your own and confirm it?

Ah. "make distclean" issue. Somebody needs to run it also on documentation
generation server (Markus?).

Sorry for noise.

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/1218#comment:7&gt;
GRASS GIS <http://grass.osgeo.org>