[SAC] [OSGeo] #314: xblade14-2: doxygen update needed

#314: xblade14-2: doxygen update needed
--------------------+-------------------------------------------------------
Reporter: neteler | Owner: sac@lists.osgeo.org
    Type: defect | Status: new
Priority: normal | Component: SAC
Keywords: doxygen |
--------------------+-------------------------------------------------------
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

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: new
  Priority: normal | Component: SAC
Resolution: | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by 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?

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:1&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: new
  Priority: normal | Component: SAC
Resolution: | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by 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

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:2&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: new
  Priority: normal | Component: SAC
Resolution: | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by 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.

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:3&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: closed
  Priority: normal | Component: SAC
Resolution: fixed | Keywords: doxygen
----------------------+-----------------------------------------------------
Changes (by neteler):

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

Comment:

Frank,

done: new doxygen installed.

Markus

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:4&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: closed
  Priority: normal | Component: SAC
Resolution: fixed | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by 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?

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:5&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: closed
  Priority: normal | Component: SAC
Resolution: fixed | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by 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.

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:6&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: closed
  Priority: normal | Component: SAC
Resolution: fixed | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by ajolma):

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

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:7&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: closed
  Priority: normal | Component: SAC
Resolution: fixed | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by 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. :slight_smile:

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:8&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.

#314: xblade14-2: doxygen update needed
----------------------+-----------------------------------------------------
  Reporter: neteler | Owner: sac@lists.osgeo.org
      Type: defect | Status: closed
  Priority: normal | Component: SAC
Resolution: fixed | Keywords: doxygen
----------------------+-----------------------------------------------------
Comment (by neteler):

Replying to [comment:7 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.

--
Ticket URL: <http://trac.osgeo.org/osgeo/ticket/314#comment:9&gt;
OSGeo <http://www.osgeo.org/&gt;
OSGeo committee and general foundation issue tracker.