aboutsummaryrefslogtreecommitdiffstats
path: root/man7/man-pages.7
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2017-08-19 10:56:06 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2017-08-19 13:47:27 +0200
commit9c40f2b9ba935b423a6c31ec4c252c3afdee696c (patch)
tree34b69daa340b0902f39c0bbbeeee84e53efecdbb /man7/man-pages.7
parent010c75a2bbe2768e27998d476da04f0b23084234 (diff)
downloadman-pages-9c40f2b9ba935b423a6c31ec4c252c3afdee696c.tar.gz
random.4, gai.conf.5, slabinfo.5, cgroup_namespaces.7, feature_test_macros.7, keyrings.7, locale.7, man-pages.7, sock_diag.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man7/man-pages.7')
-rw-r--r--man7/man-pages.724
1 files changed, 13 insertions, 11 deletions
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index e4a7ede73c..dbc8f55d9b 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -174,9 +174,9 @@ Most manual pages should include at least the
sections.
Arrange a new manual page so that sections
are placed in the order shown in the list.
-.in +0.5i
+.PP
+.in +4n
.nf
-
\fBNAME\fP
\fBSYNOPSIS\fP
CONFIGURATION [Normally only in Section 4]
@@ -203,7 +203,7 @@ EXAMPLE
.\" AUTHORS sections are discouraged
.\" AUTHORS [Discouraged]
\fBSEE ALSO\fP
-.EE
+.fi
.in
.PP
.IR "Where a traditional heading would apply" ", " "please use it" ;
@@ -519,11 +519,11 @@ For example, in the
man page, references to the subject of the page would be written as:
.BR fcntl ().
The preferred way to write this in the source file is:
-.nf
-
+.PP
+.EX
.BR fcntl ()
-
-.fi
+.EE
+.PP
(Using this format, rather than the use of "\\fB...\\fP()"
makes it easier to write tools that parse man page source files.)
.\"
@@ -588,11 +588,11 @@ formatted in Roman (normal) font, without any
separating spaces (e.g.,
.BR intro (2)).
The preferred way to write this in the source file is:
-.nf
-
+.PP
+.EX
.BR intro (2)
-
-.fi
+.EE
+.PP
(Including the section number in cross references lets tools like
.BR man2html (1)
create properly hyperlinked pages.)
@@ -628,7 +628,9 @@ except where English usage (e.g., proper nouns) or programming
language requirements (e.g., identifier names) dictate otherwise.
For example:
.PP
+.EX
.SS Unicode under Linux
+.EE
.\"
.SS Indentation of structure definitions, shell session logs, and so on
When structure definitions, shell session logs, and so on are included