summaryrefslogtreecommitdiffstats
path: root/man.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-07-20 13:45:11 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-07-20 13:45:11 +0000
commit25c8e13d6e0d017e8ba2fd629708177777d04760 (patch)
tree330da245247676d084af28f41fb2e1aaed34d69e /man.7
parentdcab101ac5d007df643d02c28269f76dc810c349 (diff)
downloadmandoc-25c8e13d6e0d017e8ba2fd629708177777d04760.tar.gz
Removed trailing whitespace in manuals.
Diffstat (limited to 'man.7')
-rw-r--r--man.744
1 files changed, 22 insertions, 22 deletions
diff --git a/man.7 b/man.7
index 7fa470d8..0c555147 100644
--- a/man.7
+++ b/man.7
@@ -25,15 +25,15 @@
.Sh DESCRIPTION
The
.Nm man
-language was historically used to format
+language was historically used to format
.Ux
manuals. This reference document describes its syntax, structure, and
usage.
.Pp
-.Bf Em
-Do not use
+.Bf -emphasis
+Do not use
.Nm
-to write your manuals.
+to write your manuals.
.Ef
Use the
.Xr mdoc 7
@@ -43,7 +43,7 @@ language, instead.
An
.Nm
document follows simple rules: lines beginning with the control
-character
+character
.Sq \&.
are parsed for macros. Other lines are interpreted within the scope of
prior macros:
@@ -57,7 +57,7 @@ Other lines are interpreted within the current state.
documents may contain only graphable 7-bit ASCII characters, the
space character, and the tabs character. All manuals must have
.Ux
-line termination.
+line termination.
.Pp
Blank lines are acceptable; where found, the output will assert a
vertical space.
@@ -71,8 +71,8 @@ subsequent word isn't off-set by whitespace.
.\" SUB-SECTION
.Ss Comments
Anything following a
-.Sq \e"
-delimiter is considered a comment (unless the
+.Sq \e"
+delimiter is considered a comment (unless the
.Sq \e
itself has been escaped) and is ignored to the end of line.
Furthermore, a macro line with only a control character
@@ -82,7 +82,7 @@ optionally followed by whitespace, is ignored.
.Ss Special Characters
Special character sequences begin with the escape character
.Sq \e
-followed by either an open-parenthesis
+followed by either an open-parenthesis
.Sq \&(
for two-character sequences; an open-bracket
.Sq \&[
@@ -114,7 +114,7 @@ macro describing the document's section and title. It may occur
anywhere in the document, although conventionally, it appears as the
first macro.
.Pp
-Beyond the
+Beyond the
.Sq \&.TH ,
at least one macro or text node must appear in the document.
.\" SECTION
@@ -129,11 +129,11 @@ and
.Sq \&.\ \ \ \&PP
are equivalent.
.Pp
-All
+All
.Nm
macros follow the same structural rules:
.Bd -literal -offset indent
-\&.YO \(lBbody...\(rB
+\&.YO \(lBbody...\(rB
.Ed
.Pp
The
@@ -141,7 +141,7 @@ The
consists of zero or more arguments to the macro.
.Pp
.Nm
-has a primitive notion of multi-line scope for the following macros:
+has a primitive notion of multi-line scope for the following macros:
.Sq \&.TM ,
.Sq \&.SM ,
.Sq \&.SB ,
@@ -152,23 +152,23 @@ has a primitive notion of multi-line scope for the following macros:
.Sq \&.R ,
.Sq \&.B ,
.Sq \&.I ,
-.Sq \&.IR
+.Sq \&.IR
and
.Sq \&.RI .
When these macros are invoked without arguments, the subsequent line is
considered a continuation of the macro. Thus:
-.Bd -literal -offset indent
-\&.RI
+.Bd -literal -offset indent
+\&.RI
foo
.Ed
.Pp
-is equivalent to
+is equivalent to
.Sq \&.RI foo .
If two consecutive lines exhibit the latter behaviour,
an error is raised. Thus, the following is not acceptable:
-.Bd -literal -offset indent
-\&.RI
-\&.I
+.Bd -literal -offset indent
+\&.RI
+\&.I
Hello, world.
.Ed
.Pp
@@ -178,7 +178,7 @@ macro is similar, but does not need an empty argument line to trigger
the behaviour.
.\" SECTION
.Sh MACROS
-This section contains a complete list of all
+This section contains a complete list of all
.Nm
macros and corresponding number of arguments.
.Pp
@@ -232,7 +232,7 @@ for groff compatibility notes.
.Sh AUTHORS
The
.Nm
-utility was written by
+utility was written by
.An Kristaps Dzonsons Aq kristaps@kth.se .
.\" SECTION
.Sh CAVEATS