#1037106 asciidoctor: Some tips to improve the formatting quality of man pages

#1037106#5
Date:
2023-06-04 22:19:54 UTC
From:
To:
Dear Maintainer,

here are some observations about created man pages with asciidoctor.

####

Do not use '.sp' right after paragraphing macros like "SH".

####

Begin each sentence on a new line, applies to both the source file and
the man page, see man-pages(7).

####

Don't use '\c' after a normal line, it's use is to join the output of
_two_ macros without an intervening space.

###