Trying to follow XP practices to the extreme, I've been trying to let the code
of my methods be the documentation, so I haven't been creating JavaDoc
comments for my methods (except for public API methods).

IDEA's very cool JavaDoc popup (ctrl-Q) feature therefore doesn't help me as
much as it might help other people. It would be cool if IDEA provided a method
contents popup (ctrl-alt-Q or something) that would show the contents of
selected method in the same kind of popup box. If the method was bigger than
the box, the box could scroll or the contents could be truncated (maybe
truncation would force the programmer to make smaller methods).


(In case anyone is wondering, the argument against JavaDoc comments is that if
you don't change the comments when you change the code, you then have a worse
situation (incorrect comments) than you'd have if you didn't provide any
comments. I haven't decided if I agree with it, but I thought I'd try it out
for a while.)


_______________________________________________
Eap-features mailing list
[EMAIL PROTECTED]
http://www.intellij.com/mailman/listinfo/eap-features

Reply via email to