aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/mdoc.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2011-03-17 14:50:14 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2011-03-17 14:50:14 +0000
commitb1b2cb525e0bae0ca46bdb3f33d134a84a0907b7 (patch)
treed15e67413179c495f2390194d49dbb2c2a55d3f3 /mdoc.7
parent17b94712d73f470995f91e260f858e8e0420224e (diff)
downloadmandoc-b1b2cb525e0bae0ca46bdb3f33d134a84a0907b7.tar.gz
mandoc-b1b2cb525e0bae0ca46bdb3f33d134a84a0907b7.tar.zst
mandoc-b1b2cb525e0bae0ca46bdb3f33d134a84a0907b7.zip
"Reserved Characters" isn't correct since `\.' and `\*(Ba' aren't
characters. Use "Reserved Terms" instead.
Diffstat (limited to 'mdoc.7')
-rw-r--r--mdoc.725
1 files changed, 14 insertions, 11 deletions
diff --git a/mdoc.7 b/mdoc.7
index ee685016..2a553570 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -1,4 +1,4 @@
-.\" $Id: mdoc.7,v 1.181 2011/03/07 01:35:51 schwarze Exp $
+.\" $Id: mdoc.7,v 1.182 2011/03/17 14:50:14 kristaps Exp $
.\"
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
.\" Copyright (c) 2010 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 7 2011 $
+.Dd $Mdocdate: March 17 2011 $
.Dt MDOC 7
.Os
.Sh NAME
@@ -65,12 +65,14 @@ A macro line with only a control character and comment escape,
is also ignored.
Macro lines with only a control character and optional whitespace are
stripped from input.
-.Ss Reserved Characters
-Within a macro line, the following characters are reserved:
+.Ss Reserved Terms
+Within a macro line, the following terms are reserved:
.Pp
.Bl -tag -width Ds -offset indent -compact
.It \&.
.Pq period
+.It \e.
+.Pq escaped period
.It \&,
.Pq comma
.It \&:
@@ -91,14 +93,15 @@ Within a macro line, the following characters are reserved:
.Pq exclamation
.It \&|
.Pq vertical bar
+.It \e*(Ba
+.Pq reserved-word vertical bar
.El
.Pp
-Use of reserved characters is described in
+Use of reserved terms is described in
.Sx MACRO SYNTAX .
-For general use in macro lines, these characters can either be escaped
-with a non-breaking space
-.Pq Sq \e&
-or, if applicable, an appropriate escape sequence can be used.
+For general use in macro lines, these can be escaped with a non-breaking
+space
+.Pq Sq \e& .
.Ss Special Characters
Special characters may occur in both macro and free-form lines.
Sequences begin with the escape character
@@ -706,7 +709,7 @@ and/or tail
.El
.Ss Block partial-implicit
Like block full-implicit, but with single-line scope closed by
-.Sx Reserved Characters
+.Sx Reserved Terms
or end of line.
.Bd -literal -offset indent
\&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBbody...\(rB \(lBres...\(rB
@@ -739,7 +742,7 @@ section line, else it is
.Sx In-line .
.Ss In-line
Closed by
-.Sx Reserved Characters ,
+.Sx Reserved Terms ,
end of line, fixed argument lengths, and/or subsequent macros.
In-line macros have only text children.
If a number (or inequality) of arguments is