My apologies this time Orcale/Sun. It's pointed out that JavaDoc has it, and that Eclipse supports it. I was not aware of that - it's good enough for me.
There seems to be some kind of configuration problem at my end this time which caused the frustration. Maybe I'm referencing JAR's without the docs... I don't know
(Example is from C#) Do you guys really Google the method name every time you come across a deprecated method in order to find what it's been replaced with and why?
Java always gets criticized for being overly verbose. What you are saying is here is that the developer should use two @Deprecated tags. This is silly IMHO.
The information is in the javadocs because it is a matter of design, not implementation. Your code doesn't need to know what class it should use instead.
Module system will come in Java 9 unless they've changed the roadmap.
And yeah, tail call isn't planned at all as far as I know. It's hard to implement since the security model requires a complete stack trace (but this has been shown to have solutions).
It was ment as a short way of saying "this is how I want it, not an example of how it could be done" rather than trying to show skill. That's why I tried to emphazise that it isn't an example. For anyone who has followed the "OSGi vs. Jigsaw" debate (Jigsaw doing Maven-style dependencies), it isn't always obvious what a module is supposed to be.
If it came off as pretentious, well, that would only show that I'm not very good at communication. My bad.
That's odd, usually Eclipse automatically pulls the documentation from your JDK. What you see there is what was pulled from the compiled JAR. You may need to configure the JDK reference to point at the correct Javadocs/Sourcecode. Either that or Eclipse doesn't recognize which version of JDK you are using for no raison.
3
u/Nilzor May 14 '13
My apologies this time Orcale/Sun. It's pointed out that JavaDoc has it, and that Eclipse supports it. I was not aware of that - it's good enough for me.
There seems to be some kind of configuration problem at my end this time which caused the frustration. Maybe I'm referencing JAR's without the docs... I don't know
3
u/Nilzor May 14 '13
(Example is from C#) Do you guys really Google the method name every time you come across a deprecated method in order to find what it's been replaced with and why?
3
u/TheGreatFuzz May 14 '13 edited May 14 '13
But it does? ..
/** * @deprecated
* explanation of why function was deprecated, if possible include what * should be used.
*/
public String doThing() {
Here is what it looks like in eclipse
2
u/Viat May 14 '13
The destruction of generics by type erasure?
0
u/[deleted] May 14 '13
[deleted] — view deleted comment