Hi Valery,
thanks, I understand your point. However, it wasn't not just my
idea - I discussed this issue with different people at CDF and we also looked
at what commercial tools are doing. For example, D0 experiment bought
licence for DOC++ tool, which is essentially the same as THtml class.
The bottom line is that people'd like to have both - 1-2-3 line long comments
briefly describing the data members and meaning/possible values of the call
parameters picked from the include file and also more detailed description
of the algorithm taken from the source file.
Thinking about the technical part of this issue I'd say that I see
many advantages in using header files instead of run-time dictionaries for
generating the HTML documentation but not the vice versa - it is rather
difficult to accept the fact that for generating the documentation you have
at least to generate a shared library first - all the necessary info (.h
and .cc(.cxx) files) are available without it.
So it seems that there is some room for improvement here. Another
question is that of the priority of this job. Frankly it doesnt' seem to be
very high. However may be there are volunteers to do it?
-Pasha