Improved comments on functions behaviour