Hello:
I am using doxygen, and is great!, but I am getting the idea
that a feature like the '+=' assigment will make it even better,
like in:
-- myfile.cfg --
.....
INPUT += /home/mmatus/cvs/modules2/oss
FILE_PATTERNS += oss.doc
....
-- myfile.cfg --
let me explain the problem first:
I have several big libraries that are related,
but say we have just two: 'bss' and 'oss'
Most of the time, when writting or testing
the documentation I compile only the
library I am interesting on, and use the 'tag'
doxygen features for the references to the
other libraries, and then I have the following files
base.cfg -> allmost full doxygen.cfg file, but with no INPUT definition
oss_i.cfg -> defines the INPUT and FILE_PATTERNS for 'oss'
bss_i.cfg -> defines the INPUT and FILE_PATTERNS for 'bss'
So, to process the documentation for each library, I just do
cat base.cfg oss_i.cfg | doxygen -
or
cat base.cfg bss_i.cfg | doxygen -
This is fast for development.
But in some moment I will have to generate the documentation for
all the libraries togheter, something like
cat base.cfg bss_i.cfg oss_i.cfg | doxygen -
and then using the += assigment will be really handy because if I define
-- oss_i.cfg --
INPUT += /home/mmatus/cvs/modules2/oss
FILE_PATTERNS += oss.doc ...
-- oss_i.cfg --
then I can add as many libraries as I want resuing the local INPUT and
FILE_PATTERNS variables defined in each library cfg file, which will be
contatenated to generate the global INPUT and FILE_PATTERNS variables
needed to compile the whole thing at once.
And this example then introduce us also to the other request, which I guess
could be much harder: the include directive.
As you see before, I am splitting the .cfg files, and then instead of
using the 'cat'
command, it will be more natural to have:
--- bss.cfg ---
#include "base.cfg"
#include "bss_i.cfg"
TAGFILES = ...
OUTPUT =...
--- bss.cfg ---
--- oss.cfg ---
#include "base.cfg"
#include "oss_i.cfg"
TAGFILES = ...
OUTPUT =...
--- oss.cfg ---
--- all_libraries.cfg ---
#include "base.cfg"
#include "bss_i.cfg"
#include "oss_i.cfg"
OUTPUT =...
--- all_libraries.cfg ---
then, I could process quick individual library .cfg files (bss.cfg,
oss.cfg),
using TAGFILES as needed, and from time to time, process the entire
whole thing at once using the 'all_libraries.cfg' file.
But of course, since I still can use 'cat | doxygen -', that is just an
improvement
in usability.
What I can't work around is the lack of the += assigment, and therefore,
right now, I have to keep repeated information in several places: each
library .cfg
file and in the global .cfg one, which is ugly and dangerous.
Marcelo
|
