user_namespaces.7: Minor rewordings of recently added text

[thirdparty/man-pages.git] / man7 / man.7

diff --git a/man7/man.7 b/man7/man.7
index dec7f9038de118eed6c947c45583e87371507edb..678d64607a90895225fdb4f6cfc202d722cfaf2f 100644 (file)
--- a/man7/man.7
+++ b/man7/man.7
@@ -31,18 +31,18 @@
 .\" Modified Tue Jul 27 20:12:02 2004 by Colin Watson <cjwatson@debian.org>
 .\" 2007-05-30, mtk: various rewrites and moved much text to new man-pages.7.
 .\"
-.TH MAN 7 2017-03-13 "Linux" "Linux Programmer's Manual"
+.TH MAN 7 2019-03-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 man \- macros to format man pages
 .SH SYNOPSIS
 .B groff \-Tascii \-man
 .I file
 \&...
-.LP
+.PP
 .B groff \-Tps \-man
 .I file
 \&...
-.LP
+.PP
 .B man
 .RI [ section ]
 .I title
@@ -77,13 +77,13 @@ for the Linux \fIman-pages\fP 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.\\"\fP) should be
+that is, lines that start with \fB.\e"\fP) should be
+.PP
 .RS
-.sp
 .B \&.TH
 .I "title section date source manual"
-.sp
 .RE
+.PP
 For details of the arguments that should be supplied to the
 .B TH
 command, see
@@ -103,16 +103,16 @@ followed by the heading name.
 .\" on the same line as
 .\" .BR \&.SH ,
 .\" then place the heading in double quotes.
-
+.PP
 The only mandatory heading is NAME, which should be the first section and
 be followed on the next line by a one-line description of the program:
+.PP
 .RS
-.sp
 \&.SH NAME
 .br
-item \\- description
-.sp
+item \e- description
 .RE
+.PP
 It is extremely important that this format is followed, and that there is a
 backslash before the single dash which follows the item name.
 This syntax is used by the
@@ -163,7 +163,7 @@ Small alternating with bold
 .TP
 .B \&.SM
 Small (useful for acronyms)
-.LP
+.PP
 Traditionally, each command can have up to six arguments, but the GNU
 implementation removes this limitation (you might still want to limit
 yourself to 6 arguments for portability's sake).
@@ -370,8 +370,8 @@ When you need to include the backslash character as normal text,
 use \ee.
 Other sequences you may use, where x or xx are any characters and N
 is any digit, include:
-.BR \e' ,
-.BR \e` ,
+.BR \e\(aq ,
+.BR \e\(ga ,
 .BR \e- ,
 .BR \e. ,
 .BR \e" ,
@@ -447,14 +447,14 @@ to ensure that tools can automatically find the URLs.
 .PP
 Tools processing these files should open the file and examine the first
 nonwhitespace character.
-A period (.) or single quote (') at the beginning
+A period (.) or single quote (\(aq) at the beginning
 of a line indicates a troff-based file (such as man or mdoc).
 A left angle bracket (<) indicates an SGML/XML-based
 file (such as HTML or Docbook).
 Anything else suggests simple ASCII
 text (e.g., a "catman" result).
 .PP
-Many man pages begin with \fB\'\e"\fP followed by a
+Many man pages begin with \fB\(aq\e"\fP 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
@@ -495,7 +495,7 @@ to make the formatting consistent for a given media, and to automatically
 insert cross-references.
 By sticking to the safe subset described above, it should be easier to
 automate transitioning to a different reference page format in the future.
-.LP
+.PP
 The Sun macro
 .B TX
 is not implemented.
@@ -521,5 +521,4 @@ is not implemented.
 .BR groff_man (7),
 .BR groff_www (7),
 .BR man-pages (7),
-.BR mdoc (7),
-.BR mdoc.samples (7)
+.BR mdoc (7)