Someone else suggested something like pressing Alt-Insert|JavaDoc from somewhere within the method or field.
Tom On Wed, 17 Jul 2002 12:02:45 -0500, "Paul Bradshaw" <[EMAIL PROTECTED]> wrote: >Did you read my message at all? It's not just "/**", it's "position cursor, >[enter][up-arrow]/**[Enter], type stuff, then find next method. All I'm >saying is that a global "add javadoc template with a todo" woudl make it so >much easier -- click blue bar, add javadoc, click blue bar, add javadoc... I >don't understand the hatred of something so simple and obvious (and >something you don't have to use anyway, and which wouldn't add any huge >burden to IDEA if you didn't use it). I'd also love it if it did things >like examine existing javadoc, and if a parameter was missing, add it (with >a TODO), and if a parameter was obsolete, delete it. I'm just looking for >ways of making the managing of javadoc simpler by automating some of the >drugery. Isn't that what IDEA is supposed to be about? > > >"Thomas Singer" <[EMAIL PROTECTED]> wrote in message >[EMAIL PROTECTED]">news:[EMAIL PROTECTED]... >> Completely agree with Scott's words. >> >> Paul, since you need to take a look at the method itself to write the >> JavaDoc's content, what's the problem with /**? >> Or do you just write useless space-wasters like: >> >> /** >> * @param forAllUsers New value of property forAllUsers. >> */ >> public void setForAllUsers(boolean forAllUsers) { >> this.forAllUsers = forAllUsers; >> } >> >> or the killer-one: >> >> /** Setter for property forAllUsers. >> * @param forAllUsers New value of property forAllUsers. >> */ >> public void setForAllUsers(boolean forAllUsers) { >> this.forAllUsers = forAllUsers; >> } >> >> Tom >> >> >> On Tue, 16 Jul 2002 13:19:00 -0500, "Scott Sirovy" >> <[EMAIL PROTECTED]> wrote: >> >> > I add javadoc when it helps, not just to add size to my .java files. >> > >> > The functionality you mention could be a plugin (that you can install >and I >> > don't have to) or an external tool (that you configure and I do not). >> > >> > Take a look at http://www.doclet.com and search for either DocWiz or >> > CommentMaster. Feel free to configure an external tool for them. This >> > isn't something JetBrains should waste their time duplicating. >> > >> > -sms >> > >> > "Paul Bradshaw" <[EMAIL PROTECTED]> wrote in message >> > ah1kd7$mh4$[EMAIL PROTECTED]">news:ah1kd7$mh4$[EMAIL PROTECTED]... >> > > Well, it's more than just three characters. I have to go to the >method >> > > name, press enter to "open up" a blank line in which to type the >> > /**[ENTER], >> > > and then up arrow back up to the blank line. A grand total of six >> > > keystrokes NOT including the positioning. >> > > >> > > I'd LOVE to see an "auto generate javadoc stubs" function that would >plug >> > in >> > > a TODO comment at the top of each one. Then I could generate all the >> > > javadoc stubs for a class at once, and then immediately navigate to >each >> > one >> > > by clicking on the blue to-do bars. Talk about a time and energy >saver... >> > > >> > > "Jacques Morel" <[EMAIL PROTECTED]> wrote in message >> > > agv710$i87$[EMAIL PROTECTED]">news:agv710$i87$[EMAIL PROTECTED]... >> > > > I humbly disagree. What would you gain by generating text that would >> > have >> > > > being automatically inferred by the javadoc generator? The batch >> > > generation >> > > > won't change how your html javadoc looks like, do we agree? So why >don't >> > > you >> > > > defer writing the javadoc shell of a member until you want to write >some >> > > > real javadoc. At that point typing /** is not too much I think. It >is >> > just >> > > 3 >> > > > characters. In addition you will get the following benefits: >> > > > 1) a guaranteed up-to-date javadoc of your member >> > > > 2) less comment junk that makes your code more readable >> > > > I think the previous benefits easily offset the burden of typing 3 >> > > > characters for each members don't you think? >> > > > >> > > > Or do I miss something? >> > > > >> > > > Jacques >> > >> > >> > > _______________________________________________ Eap-features mailing list [EMAIL PROTECTED] http://lists.jetbrains.com/mailman/listinfo/eap-features
