Hi!

Almost every time I see comments in code they are out of date or what they say does not correspond to what the code does.

JDK comments serve as API information. The JDK is reviewed by many people before it is released and I think it is different from the code we develop on a daily basis and that it tends to change a lot.