[Doxygen-develop] New feature request, the '+=' assigment (and Include directive?)

[Marcelo M. <mm...@di...>]

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