doxygen on uml.sf.net was: [Uml-devel] Real Fix of UMLWidget::adjustAssocs() and Repair of MessageWidget load

[Jonathan Riddell]

Attachment was too big for list, at

 http://muse.19inch.net/~jr/tmp/umbrello/Doxyfile.umbrello

----- Forwarded message from Achim Spangler <Achim.Spangler at mnet-online.de> -----

From: Achim Spangler <Achim.Spangler at mnet-online.de>
To: umbrello-devel at kde.org
Subject: Re: doxygen on uml.sf.net was: [Uml-devel] Real Fix of UMLWidget::adjustAssocs() and Repair of MessageWidget load
Date: Mon, 26 Jul 2004 22:39:24 +0200
Resent-To: jr at jriddell.org
Sender: umbrello-devel-admin at kde.org
Resent-From: umbrello-devel-admin at kde.org

Hi,
first of all thanks to Sebastian and Jonathan for realising my idea!!

A look the already generated doc shows me, that the installed doxygen is 
already 1.3.7 - but the attached doxyconfig file is from the outdated version 
1.2.15 .

So I attach an updated version:
+ do the listed changes
+ let doxygen generate an updated version of the config file with
    `doxygen -u <file>`

##
Additional:
Is there the possibility to install graphviz ( the "dot-tool" ), which is 
capable to draw nice class diagrams _and_ call graphs?
( debian "graphviz/testing uptodate 1.10.20030915.0415-2" )

The resulting call graphs help me very much for my own proprietary and open 
source projects - I can simply trace the execution over several steps with 
one view.

Some change suggestions:

I think doc on private elements is interesting for our application.
EXTRACT_PRIVATE        = NO ===>> YES

A list of tests and todo entries might be also nice, or not?
GENERATE_TESTLIST      = NO ===>> YES
GENERATE_TODOLIST      = NO ===>> YES

Maybe matter of style - I like it:
DISABLE_INDEX          = YES ===>> NO

Which version do we want - I think 3.0.5 is rather outdated:
QT_VERSION=305 ===>> 323 / 332 ??

See above:
HAVE_DOT               = NO ===>> YES
GRAPHICAL_HIERARCHY    = NO ===>> YES


Interesting settings from the 1.3.7 version:
------------------------------------
# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will
# generate a call dependency graph for every global function or class method.
# Note that enabling this option will significantly increase the time of a 
run.
# So in most cases it will be better to enable call graphs for selected
# functions only using the \callgraph command.

CALL_GRAPH             = YES
------------------------------------
# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the
# graphs generated by dot. A depth value of 3 means that only nodes reachable
# from the root by following a path via at most 3 edges will be shown. Nodes 
that
# lay further from the root node will be omitted. Note that setting this 
option to
# 1 or 2 may greatly reduce the computation time needed for large code bases. 
Also
# note that a graph may be further truncated if the graph's image dimensions 
are
# not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH and 
MAX_DOT_GRAPH_HEIGHT).
# If 0 is used for the depth value (the default), the graph is not 
depth-constrained.

MAX_DOT_GRAPH_DEPTH    = 0
------------------------------------



Bye,
Achim

Am Montag, 26. Juli 2004 21:40 schrieb Jonathan Riddell:
> Can't be done on sourceforge, they don't allow outgoing connections so
> you can't download from CVS. ?I've set it up elsewhere.
>
> ?http://geeksoc.org/~jr/umbrello/kdesdk/apidocs/umbrello/html/



----- End forwarded message -----