From 724ca69c82ac51d2f270f1e45d1ad574d9e7e69a Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 13 Sep 2019 15:24:19 +0200 Subject: [PATCH] man-pages.7: Paragraphs should not be separated by blank lines Reported-by: Paul Wise Signed-off-by: Michael Kerrisk --- man7/man-pages.7 | 9 +++++++++ 1 file changed, 9 insertions(+) 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 ),