From 07e910c7f0a91b83d7bc7889766bbb9ca685b001 Mon Sep 17 00:00:00 2001
From: Ingo Schwarze <schwarze@openbsd.org>
Date: Sun, 15 Feb 2015 17:57:45 +0000
Subject: Tweak the wording to avoid the possible misunderstanding that .In
 could only be used in the SYNOPSIS section.  It is fine anywhere. Issue
 noticed by bentley@.

---
 mdoc.7 | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

(limited to 'mdoc.7')

diff --git a/mdoc.7 b/mdoc.7
index 234364c9..119c4401 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -1758,17 +1758,18 @@ is preferred for displaying code; the
 .Sx \&Ic
 macro is used when referring to specific instructions.
 .Ss \&In
-An
-.Dq include
-file.
+The name of an include file.
+This macro is most often used in section 2, 3, and 9 manual pages.
+.Pp
 When invoked as the first macro on an input line in the
 .Em SYNOPSIS
 section, the argument is displayed in angle brackets
 and preceded by
-.Dq #include ,
+.Qq #include ,
 and a blank line is inserted in front if there is a preceding
 function declaration.
-This is most often used in section 2, 3, and 9 manual pages.
+In other sections, it only encloses its argument in angle brackets
+and causes no line break.
 .Pp
 Examples:
 .Dl \&.In sys/types.h
-- 
cgit