[Doxygen-users] 3 feature requests

[<cy...@so...>]

Hi all, and thanks for the wonderful tool...

I would love to see three features:

    1) Ability to define new tags like \todo and \test, in the doxygen.cfg,
like \security (eg. to leave out notes about areas to re-audit). Ideally,
whenever such administrator-defined tags are encountered, the text would be
accumulated to a
new page (also defined in the doxygen.cfg) and shown on the "associate
pages" list.

    2) Ability to limit the depth of collaboration graphs, by access type.
Let's say I've got this:

class VeryCommonHelper {
   /* a dense forest of otherwise trivial attributes */
};

class SomeClass {
   VeryCommonHelper& a_helper;
   char          a_other;
   AnotherClass  a_stuff;
};

I would like the ability to not display what's in VeryCommonHelper, unless
I'm looking at VeryCommonHelper's collab graph. OTOH, I may be interested in
having AnotherClass' graph be expanded in SomeClass' graph. Could it be done
by a \tag in VeryCommonHelper's docstring ? Like an array of options like
\hide${i}InDeepGraph (with i in "Private", "Protected", "Public", "Base",
"All").

    3) Nicer handling of template instanciations

I've got a template class which looks a lot like ATL's CPtr:
template<class T> class smptr { ... };

it is used that way:
typedef smptr<SomeClass> p_SomeClass;

and then each time a smart pointer to SomeClass is needed, p_SomeClass is
used.

Problem is, if I look at the collab graph of :

class SomeClassUser {
  p_SomeClass a_sc;
};

I see this:
        [smptr< SomeClass >]
               ^
               |
        [SomeClassUser]
which is fine.

Now, when I click on smptr< SomeClass >, I get the collab graph of smptr< T
>, which is fine but makes collab graph navigability harder.

It would be extremely nice if there was YACO, which forced the construction
of an intermediary "template instanciation" page, which would say (in the
above case):
   <h1>Template Instanciation Reference</h1>
   Template class: smptr
   Template argument T: SomeClass

.. with of course, the relevant links. This'd be very sweet (even sweeter
would be the ability to have the words "smptr" and "SomeClass" in the above
collab graph link each to its page, but that is maybe a little too much to
ask from GraphViz).



Thanks a lot in advance !

    -- Cyrille