Michael Jouravlev wrote:
/** * Flag that demo mode is on */ private boolean isDemo; public boolean getIsDemo() { ... } public setIsDemo(boolean isDemo) { ... }... and my methods *would be commented in javadoc* too, it would be much better than current approach with lots of lines and comments for each getter/setter. Three properties commented in current approved Java style, and you already lost in the code. This sucks.
Funny, I used to be *sure* you could do something like that, and just yesterday went looking through the Javadoc tool documentation trying to figure it out. Don't know where I got the idea you could do this from...
It would be so nice if there was a 'Properties' section in Javadoc, along with Fields and Methods, that skipped getters / setters unless explicitly documented and just described each property with 'readable' and 'writeable' flags, using standard JavaBeans conventions to identify properties.
Of course, there's no reliable place to store the Javadoc since properties may or may not have associated fields... :-(
-- Laurie, Open Source advocate, Java geek and novice blogger: http://www.holoweb.net/~laurie/ --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
