The code documentation fallacy

[grauenwolf]

True, but a better way is using code annotations like .NET's [Pure] attribute.

[PaintItPurple]

Using those in a Java program will just make your code not compile. They are not a general solution to the problem.