Root has great documentation but the generated html has many missing items which are actually present in the code. For example in TEveRecTrackT
(https://root.cern.ch/doc/master/classTEveRecTrackT.html), the Public Attributes
are not documented though proper comments exists in the code, e.g.
Int_t fLabel; // Label of the track.
Doxygen expect comment following to start with e.g. ///<
:
Most often one only wants to put a brief description after a member. This is done as follows:
int var; //!< Brief description after the member
or
int var; ///< Brief description after the member
So my kind request is whenever any developer touches header file (ROOT-team or someone forking it, making PR), please check whether the members are commented properly and fix comments if needed. It will allow to fix comments in small steps.