summaryrefslogtreecommitdiffstats
path: root/mdoc.7
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2015-02-15 17:57:45 +0000
committerIngo Schwarze <schwarze@openbsd.org>2015-02-15 17:57:45 +0000
commit07e910c7f0a91b83d7bc7889766bbb9ca685b001 (patch)
tree94a7e9bb7071213727202e1767b61cb2931ed98e /mdoc.7
parent5606c3c6143de772dffc1928eac3cd7eb76fe5ea (diff)
downloadmandoc-07e910c7f0a91b83d7bc7889766bbb9ca685b001.tar.gz
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@.
Diffstat (limited to 'mdoc.7')
-rw-r--r--mdoc.711
1 files changed, 6 insertions, 5 deletions
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