RE: [Springframework-developer] javadocs

[<jue...@we...>]

Hi Isabelle,

I've also noticed repeatedly that some JavaDocs are quite erroneous. =
Thanks for volunteering! Rod, we should definitely give Isabelle commit =
access to be able to fix these issues.

Apropos JavaDoc, we haven't decided which comment style we want to =
endorse:
- the third person style, e.g. "Commits the transaction";
- or the command style, e.g. "Commit the transaction".

The former is rather from the caller's view, the latter from the =
implementer's view. I'm used to the former style, but currently many =
Spring classes have comments of the latter style, so I'm constantly in =
doubt how to handle this.

Juergen


-----Original Message-----
From: Isabelle Muszynski [mailto:met...@pa...]
Sent: Thursday, April 03, 2003 2:34 PM
To: spr...@li...
Subject: [Springframework-developer] javadocs


Hi everyone,

If I can get commit access to the cvs, I will fix all the javadocs. =
Currently gives about 83 warnings and 3 errors.

Isabelle

--=20
Isabelle Muszynski
Zandweellaan 4
2660 Antwerpen
Belgium
Tel. 32-(0)3-830 18 54
Mobile: 32-(0)485 49 50 89


-------------------------------------------------------
This SF.net email is sponsored by: ValueWeb:=20
Dedicated Hosting for just $79/mo with 500 GB of bandwidth!=20
No other company gives more support or power for your dedicated server
http://click.atdmt.com/AFF/go/sdnxxaff00300020aff/direct/01/
_______________________________________________
Springframework-developer mailing list
Spr...@li...
https://lists.sourceforge.net/lists/listinfo/springframework-developer