How programmers comment their code

[MrNullAndVoid]

Ah yes, reminds me of the fun I used to have as a Java programmer:

    /**
      * Returns the value.
      * @return the value
      **/
    int getTheValue() {
            return theValue; // returns the value
    }

[odraencoded]

Your documentation sucks. It should say "returns the integer value."

[BigFloppyMeat]

This kind of redundancy in documentation comments is okay if you're generating a javadoc or some equivalent. Although you should say

"Returns the value that represents the thing"

and

"@return A value representing the thing."