[GRASS-dev] doxygen problem - Re: [GRASS-SVN] r33243 - grass/branches/develbranch_6/lib

On Fri, Sep 5, 2008 at 10:28 AM, Martin Landa <landa.martin@gmail.com> wrote:

2008/9/5 Martin Landa <landa.martin@gmail.com>:

2008/9/5 Markus Neteler <neteler@osgeo.org>:

OK. The problem is that
"vector: Vector_Library (GRASS Vector and Direct Graph Library)"
is no longer expanded as link. Someone just asked me if the
vector lib is not documented and I discovered that the link is
no longer generated at all. I just tried a fix but it isn't expanded...

it should be

<li>%vector: \ref Vector_Library (GRASS Vector and Direct Graph Library)

see

lib/vector/vectorlib.dox

the page is called Vector_Library.

I reverted the changes in r33271

make htmldocs-single

builds programmer manual properly on my machine.

Not so on grass.osgeo.org...:
http://download.osgeo.org/grass/grass6_progman/main.html

Could it be the doxygen version (the server has 1.5.1)?

Markus

Hi,

2008/9/7 Markus Neteler <neteler@osgeo.org>:

make htmldocs-single

builds programmer manual properly on my machine.

Not so on grass.osgeo.org...:
http://download.osgeo.org/grass/grass6_progman/main.html

Could it be the doxygen version (the server has 1.5.1)?

I am using 1.5.6, anyway, if you replace '%vector' by 'vector' link to
Vector_Library appears?

Martin

--
Martin Landa <landa.martin gmail.com> * http://gama.fsv.cvut.cz/~landa *

On Sun, Sep 7, 2008 at 12:24 PM, Martin Landa <landa.martin@gmail.com> wrote:

Hi,

2008/9/7 Markus Neteler <neteler@osgeo.org>:

make htmldocs-single

builds programmer manual properly on my machine.

Not so on grass.osgeo.org...:
http://download.osgeo.org/grass/grass6_progman/main.html

Could it be the doxygen version (the server has 1.5.1)?

I am using 1.5.6, anyway, if you replace '%vector' by 'vector' link to
Vector_Library appears?

Ah, on the server I found a local change:

--- vector/vectorlib.dox (revision 33309)
+++ vector/vectorlib.dox (working copy)
@@ -1,4 +1,4 @@
-/*! \page Vector_Library GRASS 6 Vector Architecture
+/*! \mainpage Vector_Library GRASS 6 Vector Architecture

I have reverted that and set it to the SVN version.
In ~1h from now we can check again:
http://download.osgeo.org/grass/grass6_progman/main.html

Hopefully now solved.

Markus

On Sun, Sep 7, 2008 at 11:55 AM, Markus Neteler <neteler@osgeo.org> wrote:

On Sun, Sep 7, 2008 at 12:24 PM, Martin Landa <landa.martin@gmail.com> wrote:

Hi,

2008/9/7 Markus Neteler <neteler@osgeo.org>:

make htmldocs-single

builds programmer manual properly on my machine.

Not so on grass.osgeo.org...:
http://download.osgeo.org/grass/grass6_progman/main.html

Ah, on the server I found a local change:

--- vector/vectorlib.dox (revision 33309)
+++ vector/vectorlib.dox (working copy)
@@ -1,4 +1,4 @@
-/*! \page Vector_Library GRASS 6 Vector Architecture
+/*! \mainpage Vector_Library GRASS 6 Vector Architecture

I have reverted that and set it to the SVN version.
In ~1h from now we can check again:
http://download.osgeo.org/grass/grass6_progman/main.html

Hopefully now solved.

No, not resolved. The change residual indicated above turns
back every week. Apparently a bug in

include/Make/Doxygen.make

    12 # generate docs as multiple HTML documents:
    13 htmldocs: checkdoxygen cleandocs
    14 # hack needed to get main page at beginning:
    15 @mv $(DOXINPUT) $(DOXINPUT).org
    16 @sed 's+/\*! \\page +/\*! \\mainpage +g'
$(DOXINPUT).org > $(DOXINPUT)
    17 doxygen $(MODULE_TOPDIR)/include/Make/Doxyfile_arch_html
    18 @mv $(DOXINPUT).org $(DOXINPUT)
    19 @echo "HTML reference in directory ./html/index.html"

Maybe mv fails and it must be 'mv -f'? The cronjob runs under
my user login on xblade14 and mv is an alias to 'mv -v'. I don't
know if aliases are picked up by user cronjobs.

Markus

Markus Neteler wrote:

Maybe mv fails and it must be 'mv -f'? The cronjob runs under
my user login on xblade14 and mv is an alias to 'mv -v'. I don't
know if aliases are picked up by user cronjobs.

They aren't, nor is the user's environment from /etc/profile,
~/.bash_profile, etc.

In any case, aliases only work in shells where they are explicitly
defined (in practice, this means interactive shells which source
~/.bashrc). They aren't propagated to child processes (e.g. scripts,
make, etc).

--
Glynn Clements <glynn@gclements.plus.com>

On Sun, Dec 14, 2008 at 2:54 PM, Glynn Clements
<glynn@gclements.plus.com> wrote:

Markus Neteler wrote:

Maybe mv fails and it must be 'mv -f'? The cronjob runs under
my user login on xblade14 and mv is an alias to 'mv -v'. I don't
know if aliases are picked up by user cronjobs.

They aren't, nor is the user's environment from /etc/profile,
~/.bash_profile, etc.

In any case, aliases only work in shells where they are explicitly
defined (in practice, this means interactive shells which source
~/.bashrc). They aren't propagated to child processes (e.g. scripts,
make, etc).

Thanks, then there must be some magic elsewhere.
For now, I force the removal and retrieval of the lib/vector/vectorlib.dox
file to get rid of the left-over change.
Currently ok, we'll see next Sunday if the fix persists.

Markus