Nope thats not what i meant. It would only generate the stubs for methods that YOU SELECT, like right clicking on the method name and selecting "create java doc stub", intelliJ then creates the stub code, the developer then fills in the rest. This would then be particularly useful for methods with large parameter lists.
i hope this is clear now? cheers Nad > -----Original Message----- > From: Dimiter Dimitrov [mailto:[EMAIL PROTECTED]] > Sent: 04 December 2001 10:37 > To: '[EMAIL PROTECTED]' > Subject: RE: [Eap-features] Javadoc feature request. > > > Are you truing to say that you would fill afterwards EVERY > stupid field in > this generated java doc? > I don't believe it :) > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED]]On Behalf Of Shabir, Nadeem > Sent: Monday, December 03, 2001 11:53 PM > To: '[EMAIL PROTECTED]' > Subject: RE: [Eap-features] Javadoc feature request. > > > I think I should have been more clear, Im not suggesting a > feature that > writes the comment itself, > but a feature that provides the stub so if a method takes a number of > parameters and returns a type, it shouldnt be difficult for > intellij to > generated a javadoc comment with only the @param and @return lists > populated, it still means the developer has to write a > meaningful comment > but at least the "stubs" are generated. > > I dont for one second believe any tool could generate > meaningful comments. > But What would be useful is a tool that did the "leg work" > for us leaving > developers to fill in the details. > > cheers, > > Nad > > > -----Original Message----- > > From: Mark Swinkels [mailto:[EMAIL PROTECTED]] > > Sent: 03 December 2001 21:51 > > To: '[EMAIL PROTECTED]' > > Subject: RE: [Eap-features] Javadoc feature request. > > > > > > I think people have just stopped complaining about this > > request. If you go > > back through the archives you will see that there are mostly lots of > > negative responses to this feature. > > > > The negative responses all revolve around the problem of > > developers not > > going in after using this feature and making the generated > > java docs useful. > > A more generally accepted form of this proposal is that IDEA > > provide help > > for writing the javadoc for a particular method, rather than > > adding them > > wholesale. The help could include generating a skeleton and > > provide tag > > completion. In this way the developer can generate the > > comments as they work > > or generate them afterwards. If the comments are generated > > automatically for > > whole files or projects at a time the developer will have to > > go in to edit > > the all comments anyway. > > > > +1 for javadoc generation on a single method basis > > +1 for a way to find methods that meet some criteria (e.g. > > public) but don't > > have Javadoc comments > > -10 for a way to fill source files with meaningless comments > > that don't > > convey any information beyond the method signature yet have > > to be read to > > determine that fact. > > > > -----Original Message----- > > From: Noah Nordrum [mailto:[EMAIL PROTECTED]] > > Sent: Monday, December 03, 2001 09:44a > > To: [EMAIL PROTECTED] > > Subject: Re: [Eap-features] Javadoc feature request. > > > > > > ok, this is like at least the 15th time I've seen this > request (not a > > complaint to you Nadeem)... It is also one of the only > requests that I > > haven't seen any complaints about. I can't imagine that this > > would be a very > > tough thing to implement. > > > > Could we PLEASE get this in Pandora? or as one of (or the) > > first features in > > the next EAP? > > > > Thanks, > > Noah > > > > ----- Original Message ----- > > From: "Shabir, Nadeem" <[EMAIL PROTECTED]> > > To: <[EMAIL PROTECTED]> > > Sent: Monday, December 03, 2001 5:57 AM > > Subject: [Eap-features] Javadoc feature request. > > > > > > > I dont know if anyone has already asked for this but it > > would be very > > > useful. > > > > > > What id like is a feature that would look at all the method > > signatures, in > > a > > > file an insert javadoc comments infront of each method, but > > pre-populating > > > param and return lists based on the signature. This would > > save a lot of > > > time, ive used similar features in Kawa where it was > > implemented as a > > plugin > > > that would pass through the file and do it for you. Im not sure if > > IntelliJ > > > could also do something similar? > > > > > > Ive tried to create a live template to do this but arent > having much > > > success. > > > > > > Any thoughts? > > > > > > cheers > > > > > > Nadeem > > > > > > > > > Nadeem Shabir BSc > > > Senior > > > J2EE Developer > > > > > > Data Systems & Solutions (DS&S), > > > PO Box No 31, > > > Sinfin Lane, > > > Derby. > > > DE24 8BJ. > > > > > > www.ds-s.com > > > > > > Tel : (01332) 777570 > > > Fax : (01332) 772647 > > > Mobile: (07790) 901297 > > > > > > E-mail: [EMAIL PROTECTED] > > > > > > For optimum solutions that save you time, visit www.ds-s.com. > > > > > > _______________________________________________ > > > Eap-features mailing list > > > [EMAIL PROTECTED] > > > http://www.intellij.com/mailman/listinfo/eap-features > > > > > > _________________________________________________________ > > Do You Yahoo!? > > Get your free @yahoo.com address at http://mail.yahoo.com > > > > > > _______________________________________________ > > Eap-features mailing list > > [EMAIL PROTECTED] > > http://www.intellij.com/mailman/listinfo/eap-features > > > > _______________________________________________ > > Eap-features mailing list > > [EMAIL PROTECTED] > > http://www.intellij.com/mailman/listinfo/eap-features > > > For optimum solutions that save you time, visit www.ds-s.com. > > _______________________________________________ > Eap-features mailing list > [EMAIL PROTECTED] > http://www.intellij.com/mailman/listinfo/eap-features > > _______________________________________________ > Eap-features mailing list > [EMAIL PROTECTED] > http://www.intellij.com/mailman/listinfo/eap-features > For optimum solutions that save you time, visit www.ds-s.com. _______________________________________________ Eap-features mailing list [EMAIL PROTECTED] http://www.intellij.com/mailman/listinfo/eap-features
