clarify detect-paragraphs behavior in docs