doc update about behavior.