So you never look at the Flash help code? You just open the .as files and trawl through them?
> And to the point about Javadoc, I'm not going to ruin my code and > handicap my debugging ability to satisfy some poorly thought out > requirement of a 3rd party tool. They require you to use block > commenting in your code to automatically write documentation and that's > counterproductive to actual coding. It should work hand in hand with > not diametrically opposed to the coding process. If they were smart > about it, they would support line commenting with non-asterisk > delimiters. Say //! !//, or //| |// or //[ ]//, etc. Exclamations, > pipes, and brackets are all better choices because they do not conflict > with anything. I am totally confused by your raging asteriskism. What do asterisks conflict with that those do not? What's wrong with asterisks? I actually like having block comments before functions because it makes it ridiculously easy to comment out a function. Just remove the last "/" (assuming there's a block comment after the function as well; if not you have to add a "*/"). Makes it very easy to do "Move Method" refactorings and suchlike. > I'm not going to make my process suffer nor am I going to litter my code > with ugly asterisks just to document my work when I can spend that > energy writing cleaner, easier to read code with light commenting in the > code itself. :) I still don't understand how Javadoc makes your process suffer. -- Mike Keesey _______________________________________________ [email protected] To change your subscription options or search the archive: http://chattyfig.figleaf.com/mailman/listinfo/flashcoders Brought to you by Fig Leaf Software Premier Authorized Adobe Consulting and Training http://www.figleaf.com http://training.figleaf.com
