diff --git a/man7/man-pages.7 b/man7/man-pages.7 index 5204d6b6e..58357cd82 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -528,6 +528,15 @@ The preferred way to write this in the source file is: makes it easier to write tools that parse man page source files.) .\" .SS Formatting conventions (general) +Paragraphs should be separated by suitable markers (usually either +.I .PP +or +.IR .IP ). +Do +.I not +separate paragraphs using blank lines, as this results in poor rendering +in some output formats (such as PostScript and PDF). +.PP Filenames (whether pathnames, or references to header files) are always in italics (e.g., .IR ),