From: Ian Scott <ian.m.scott@st...> - 2003-09-26 15:20:57
We have been aware of a particular documentation problem for some time.
Documentation of particular non-member functions would either be found in
the file documentation, based on its name, or in the class documentation of
a related class.
One particular example came up on the reflector recently when someone could
not find the vgl_area(vgl_polygon&) function in the documentation. vgl, vil
and vnl are littered with examples of non-member functions that could either
be documented in a related class's page, or in a file.h page.
Using a new doxygen feature, the documentation for such a function can be
found in both the related class page, and the file.h page.
Hope this helps,