xblade14-2: doxygen update needed

[neteler]

On xblade14-2, doxygen is too old and fails to generate essential parts of the GRASS programmer's manual (the vector library). Testing newer doxygen versions on different machines show what the current version seems to be too old/buggy:

/usr/local/bin/doxygen -v
Unknown option -v
Doxygen version 1.5.1
Copyright Dimitri van Heesch 1997-2006

Latest release v1.5.7.1 from Oct 2008: ​http://www.stack.nl/~dimitri/doxygen/download.html

Markus

[ajolma]

The current doxygen seems to be from /usr/local/bin, i.e., a local-install. Doxygen is in Fedora system. yum info doxygen says at xblade14-2:

Available Packages
Name   : doxygen
Arch   : i386
Version: 1.4.4

i.e., even older one. However, for example in my own Fedora 8 box, the same is:

Installed Packages
Name       : doxygen
Arch       : i386
Epoch      : 1
Version    : 1.5.6

Updating doxygen would be very simple or even automatic, if we had a newer system.

Hoever, I downloaded 1.5.7.1, configured, and compiled it on xblade14-2 without problems. Is there a specific procedure for installing new development tools? How to test the upgrade?

[neteler]

I have created a RPM of the latest doxygen on xblade14-2:

Wrote: /usr/src/redhat/SRPMS/doxygen-1.5.7.1-1.src.rpm
Wrote: /usr/src/redhat/RPMS/i386/doxygen-1.5.7.1-1.i386.rpm
Wrote: /usr/src/redhat/RPMS/i386/doxygen-debuginfo-1.5.7.1-1.i386.rpm

[root@xblade14-2 SPECS]# rpm -qpil /usr/src/redhat/RPMS/i386/doxygen-1.5.7.1-1.i386.rpm
Name        : doxygen                      Relocations: (not relocatable)
Version     : 1.5.7.1                           Vendor: Dimitri van Heesch
Release     : 1                             Build Date: Mon 17 Nov 2008 06:57:08 AM PST
Install Date: (not installed)               Build Host: xblade14-2.telascience.org
Group       : Development/Tools             Source RPM: doxygen-1.5.7.1-1.src.rpm
Size        : 6526847                          License: GNU General Public License
Signature   : (none)
URL         : http://www.stack.nl/~dimitri/doxygen/index.html
Summary     : A documentation system for C/C++.
Description :
Doxygen can generate an online class browser (in HTML) and/or a
reference manual (in LaTeX) from a set of documented source files. The
documentation is extracted directly from the sources. Doxygen can
also be configured to extract the code structure from undocumented
source files.
/usr/bin/doxygen
/usr/bin/doxytag
/usr/man/man1/doxygen.1.gz
/usr/man/man1/doxytag.1.gz
/usr/share/doc/doxygen-1.5.7.1
/usr/share/doc/doxygen-1.5.7.1/LANGUAGE.HOWTO
/usr/share/doc/doxygen-1.5.7.1/LICENSE
/usr/share/doc/doxygen-1.5.7.1/README
/usr/share/doc/doxygen-1.5.7.1/archoverview.pdf
/usr/share/doc/doxygen-1.5.7.1/doxygen_logo.pdf
/usr/share/doc/doxygen-1.5.7.1/doxygen_manual.pdf
/usr/share/doc/doxygen-1.5.7.1/examples
...

Any objections to install it? When can remove the currently used

/usr/local/bin/doxygen

once we know that the new version works well.

Markus

[warmerdam]

Markus,

I think you should just go ahead. I'll keep an eye on the effect on GDAL, but it is just a point release level upgrade from 1.5.1 so I don't anticipate any dramatic changes.

[neteler]

Frank,

done: new doxygen installed.

Markus

[ajolma]

Markus, what's the reasoning behind creating a RPM? Do you plan to install it elsewhere too? It's just that it seems a bit of extra work, when a normal ./configure; make; make install would have done the job?

[neteler]

Ari,

it was only

rpmbuild -ba doxygen.spec
rpm -Uhv doxygen-1.5.7.1.i386.rpm

The reasoning is that Fedora is RPM based and that this is an elegant way to later upgrade the doxygen version without having the fear to forget abandoned files. RPM takes care of keeping things clean on the machine.

[ajolma]

Hm. Cool. However, the old doxygen is still lying around in /usr/local/bin and the new one is in /usr/bin.

[warmerdam]

Markus,

I would just encourage you to be careful that the /usr/local version of doxygen gets cleaned up properly. I don't know how to manage RPMs so if upgrading ever falls to me again, I'll no doubt just install in /usr/local and hand remove the system version. Hopefully though I'll remember you are a doxygen/rpm guy and turn the request over to you. :-)

[neteler]

Replying to ajolma:

Hm. Cool. However, the old doxygen is still lying around in /usr/local/bin and the new one is in /usr/bin.

Usually /usr/bin comes first in the path. However, I have now done

cd /usr/local/bin/
mv doxytag doxytag_old
mv doxygen doxygen_old

so that the old version is still around (but inactive) and the RPM version picked up.