Re: [ROOT] Suggestion THtml II

From: Damir Buskulic (buskulic@lapp.in2p3.fr)
Date: Thu Apr 12 2001 - 13:19:58 MEST


I would support such an add-on, since it would make comments easier to
port from DOC++ style, which is used anyway by a large number of people
(even if they don't know how ROOT powerful is...)
I think one other thing is missing : the ability to "THtml" standard C
routines. I know, we are in a C++ world but one should be able to
document also some old code.

This could all be solved by a utility "a la" rootcint, as suggested by
Fons (?) at the last Root workshop.

In any case, though important, I'm not sure anybody has the time to work
on that for the moment. Thomas, do you want to code :-) ?

Cheers

Damir

Thomas Bretz wrote:
> 
> Hello,
> 
> I have a second idea:
> 
> What about having comments for member functions outside the function?
> Let' say Root.Html.Description is set to "// --------", than it would be
> nice if you could write your descriptions like this:
> 
> //----------------------------------------------
> //
> // This is how my class works
> //
> MyClass::MyMember(Int_t x1, Int_t x2)
> {
>   // describing the first line of code
>   x1 = x2;
> }
> 
> I think this would result in a more intuitive optic of the code.
> 
> Regards,
> Thomas.

-- 
=====================================================================
| Damir Buskulic                  | Universite de Savoie/LAPP       |
|                                 | Chemin de Bellevue, B.P. 110    |
| Tel : +33 (0)450091600          | F-74941 Annecy-le-Vieux Cedex   |
| e-mail: buskulic@lapp.in2p3.fr  | FRANCE                          |
=====================================================================
mailto:buskulic@lapp.in2p3.fr



This archive was generated by hypermail 2b29 : Fri Jun 08 2001 - 11:51:22 MEST