If you require comments to try to help programmers follow a confused set of return value conventions, I submit to you that comments aren't the real solution, since they're minimally helpful in addressing the real problem.
Incidentally, would this bug have been flagged by a compiler warning?