X-Authentication-Warning:	delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient:	geda-user AT delorie DOT com
X-Mailer:	exmh version 2.7.2 01/07/2005 (debian 1:2.7.2-18) with nmh-1.3
X-Exmh-Isig-CompType:	comp
X-Exmh-Isig-Folder:	inbox
To:	geda-user AT delorie DOT com
Subject:	[geda-user] doxygen obsolete config
Mime-Version:	1.0
Message-Id:	<20121119182103.6256E813BDB6@turkos.aspodata.se>
Date:	Mon, 19 Nov 2012 19:21:03 +0100 (CET)
From:	karl AT aspodata DOT se (Karl Hammar)
X-Virus-Scanned:	ClamAV using ClamSMTP
Reply-To:	geda-user AT delorie DOT com

$ cd libgeda/docs
$ make doxygen >/dev/null 2> log
$ grep obsolete log
warning: Tag `USE_WINDOWS_ENCODING' at line 64 of file libgeda.dox has become obsolete.
warning: Tag `DETAILS_AT_TOP' at line 156 of file libgeda.dox has become obsolete.
warning: Tag `MAX_DOT_GRAPH_WIDTH' at line 1181 of file libgeda.dox has become obsolete.
warning: Tag `MAX_DOT_GRAPH_HEIGHT' at line 1189 of file libgeda.dox has become obsolete.
$

 According to [1], they become obsolete:
USE_WINDOWS_ENCODING rel. 1.5.2, 4-4-2007
DETAILS_AT_TOP       rel. 1.5.7, 28-9-2008
MAX_DOT_GRAPH_WIDTH  rel. 1.5.2, 4-4-2007
MAX_DOT_GRAPH_HEIGHT rel. 1.5.2, 4-4-2007

Below are suggested (by doxygen -u) replacements.

 Old:
USE_WINDOWS_ENCODING   = YES
 New:
DOXYFILE_ENCODING      = UTF-8

 Old:
DETAILS_AT_TOP         = NO
 New:
LAYOUT_FILE            =

 Old:
MAX_DOT_GRAPH_WIDTH    = 1024
MAX_DOT_GRAPH_HEIGHT   = 1024
 New:
DOT_GRAPH_MAX_NODES    = 50

A default layout file can be generated by "doxygen -l", and it can
be common for the whole geda project.

///

If we upgrade, doxygen with version < 1.5.2 will probably not work and
we need to include a version check in m4/geda-doxygen.m4.

Is that a price we are willing to pay to get rid of the above error
messages ?

What version are you using, will it be a problem at all ?

Regards,
/Karl Hammar

[1] http://www.stack.nl/~dimitri/doxygen/changelog_1.5.html

-----------------------------------------------------------------------
Aspö Data
Lilla Aspö 148
S-742 94 Östhammar
Sweden
+46 173 140 57

- Raw text -