summaryrefslogtreecommitdiffstats
path: root/man7/man.7
diff options
context:
space:
mode:
Diffstat (limited to 'man7/man.7')
-rw-r--r--man7/man.717
1 files changed, 12 insertions, 5 deletions
diff --git a/man7/man.7 b/man7/man.7
index 583fe354f..87cb5bbcc 100644
--- a/man7/man.7
+++ b/man7/man.7
@@ -53,11 +53,15 @@ option is, however, recommended, since this will automatically detect which
macro package is in use.
.PP
For conventions that should be employed when writing man pages
-for the Linux \fIman-pages\fP package, see
+for the Linux
+.I man-pages
+package, see
.BR man\-pages (7).
.SS Title line
The first command in a man page (after comment lines,
-that is, lines that start with \fB.\e"\fP) should be
+that is, lines that start with
+.BR .\e\[dq] )
+should be
.PP
.RS
.B .TH
@@ -399,7 +403,9 @@ Only translations
that can be ignored should be used.
Font changes
.RB ( ft
-and the \fB\ef\fP escape sequence)
+and the
+.B \ef
+escape sequence)
should only have the values 1, 2, 3, 4, R, I, B, P, or CW
(the ft command may also have no parameters).
.PP
@@ -438,8 +444,9 @@ file (such as HTML or Docbook).
Anything else suggests simple ASCII
text (e.g., a "catman" result).
.PP
-Many man pages begin with \fB\[aq]\e"\fP followed by a
-space and a list of characters,
+Many man pages begin with
+.B \[aq]\e\[dq]
+followed by a space and a list of characters,
indicating how the page is to be preprocessed.
For portability's sake to non-troff translators we recommend
that you avoid using anything other than