a bit of doc refactoring, and fix write \par instead of \6 when appropriate