[Doxygen-users] 2 INLINE_SOURCES related problems
Brought to you by:
dimitri
|
From: Jens S. <jen...@hr...> - 2001-06-04 01:51:32
|
Hi,
I found a few problems in doxygen-1.2.7-20010524:
1) Doxyfile:
# The DOC_ABSPATH tag should be the absolute path to the directory where the
# documentation is located. If left blank the directory on the local machine
# will be used.
# The DOC_URL tag should be the absolute URL to the directory where the
# documentation is located. If left blank the absolute path to the
# documentation, with file:// prepended to it, will be used.
I don't wont to write the full path of the html directory into the config
file. According to the documentation, it's possible to leave these variables
empty. But doxygen uses "." instead of the full path, so I have to start
netscape from this directory. Can someone change this, so that doxygen uses
DOC_URL=file://<path-to-html>, DOC_ABSPATH=<path-to-html> in all files it
generates (search.cfg,...)?
2) If there's a comma separated list of pointers, e.g.
QLineEdit *LEgriddx,*LEgriddy;
the output contains
QLineEdit* LEgriddx
QLineEdit * LEgriddy.
Is it possible to remove the blank in the second line?
3) The order of the arguments of doxygen is important!
"doxygen -s -g" creates Doxyfile, but "doxygen -g -s" creates a file
"-s" (use "rm -- -s" to remove).
4,5) There are two INLINE_SOURCES related problems:
4)
test.h:
class test {
void f();
};
void test::f()
// see: xyz
{
return;
}
Doxyfile:
EXTRACT_ALL = YES
EXTRACT_PRIVATE = YES
INLINE_SOURCES = YES
INPUT = test.h
The output is incomplete ("// see" is missing):
void test::f ( ) [private]
00006 : xyz
00007 {
00008 return;
00009 }
The same happens if I use "/* see: xyz */"!
5)
Tools.h:
long int min(long int, long int);
double min(double, double);
Tools.cpp:
#include "Tools.h"
long int min(long int a, long int b)
{
if (a<b) return a; else return b;
}
double min(double a, double b)
{
if (a<b) return a; else return b;
}
Doxyfile:
EXTRACT_ALL = YES
INLINE_SOURCES = YES
INPUT = Tools.cpp Tools.h
Tools_8h.html contains:
double min (double a,
double b)
00009 {
00010 if (a<b) return a; else return b;
00011 }
long int min (long int a,
long int b)
<there's no source code here!>
The problem doesn't occur, if I use "INPUT=Tools.h Tools.cpp".
Regards,
Jens
|