aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/mandoc_char.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-07-27 12:35:53 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-07-27 12:35:53 +0000
commit29761020ae538441c939e621297260904dba1160 (patch)
treec981779692d5388acb0c6bcc7c82fdbd290cbd4c /mandoc_char.7
parent0441b4f4454e1e8fa3005d8b12b9731e24099509 (diff)
downloadmandoc-29761020ae538441c939e621297260904dba1160.tar.gz
mandoc-29761020ae538441c939e621297260904dba1160.tar.zst
mandoc-29761020ae538441c939e621297260904dba1160.zip
Clarified special chars/predefined chars in mandoc_char.7.
Cleaned up escape section in man.7, mdoc.7. Cleaned up function names in term.c.
Diffstat (limited to 'mandoc_char.7')
-rw-r--r--mandoc_char.786
1 files changed, 79 insertions, 7 deletions
diff --git a/mandoc_char.7 b/mandoc_char.7
index f4ce7041..c7199604 100644
--- a/mandoc_char.7
+++ b/mandoc_char.7
@@ -1,4 +1,4 @@
-.\" $Id: mandoc_char.7,v 1.9 2009/07/27 12:02:49 kristaps Exp $
+.\" $Id: mandoc_char.7,v 1.10 2009/07/27 12:35:53 kristaps Exp $
.\"
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
.\"
@@ -23,7 +23,7 @@
.Nd mandoc special characters
.\" SECTION
.Sh DESCRIPTION
-This documents the special characters accepted by
+This documents the special characters and predefined strings accepted by
.Xr mandoc 1
to format
.Xr mdoc 7
@@ -34,12 +34,13 @@ documents. Specific output devices of
dictated by the
.Fl T Ns Ar output
argument, will properly render these sequences.
+.\" PARAGRAPH
.Pp
Both
.Xr mdoc 7
and
.Xr man 7
-encode these special characters with
+encode special characters with
.Sq \eX
.Pq for a one-character escape ,
.Sq \e(XX
@@ -50,7 +51,30 @@ and
One may generalise
.Sq \e(XX
as
-.Sq \e[XX] .
+.Sq \e[XX]
+and
+.Sq \eX
+as
+.Sq \e[X] .
+Predefined strings are functionally similar to special characters, using
+.Sq \e*X
+.Pq for a one-character escape ,
+.Sq \e*(XX
+.Pq two-character ,
+and
+.Sq \e*[N]
+.Pq N-character .
+One may generalise
+.Sq \e*(XX
+as
+.Sq \e*[XX]
+and
+.Sq \e*X
+as
+.Sq \e*[X] .
+.\" SECTION
+.Sh Special Characters
+These are the preferred input symbols for producing special characters.
.\" PARAGRAPH
.Pp
Typographic:
@@ -119,8 +143,6 @@ Enclosures:
.Pq right bracket
.It \e(lB
.Pq left bracket
-.It \eq
-.Pq double-quote
.It \e(lq
.Pq left double-quote
.It \e(rq
@@ -230,7 +252,7 @@ Mathematical:
.It \e(if
.Pq infinity
.It \e(na
-.Pq NaN , an extension
+.Pq NaN, an extension
.It \e(+-
.Pq plus-minus
.It \e(**
@@ -459,6 +481,56 @@ Special symbols:
.Pq escape
.El
.\" SECTION
+.Sh PREDEFINED STRINGS
+These are not recommended for use, as they differ across
+implementations:
+.Pp
+Mathematical:
+.Bl -tag -width Ds -offset indent -compact
+.It \e*(Ne
+.Pq not equal
+.It \e*(Ge
+.Pq greater-than-equal
+.It \e*(Le
+.Pq less-than-equal
+.It \e*(Gt
+.Pq greater-than
+.It \e*(Lt
+.Pq greater-than
+.It \e*(Pm
+.Pq plus-minus
+.It \e*(If
+.Pq infinity
+.It \e*(Pi
+.Pq pi
+.It \e*(Na
+.Pq NaN
+.El
+.\" PARAGRAPH
+.Pp
+Special symbols:
+.Bl -tag -width Ds -offset indent -compact
+.It \e*(Ba
+.Pq vertical bar
+.It \e*(Am
+.Pq ampersand
+.El
+.\" PARAGRAPH
+.Pp
+Enclosures:
+.Bl -tag -width Ds -offset indent -compact
+.It \e*q
+.Pq double-quote
+.It \e*(Rq
+.Pq right-double-quote
+.It \e*(Lq
+.Pq left-double-quote
+.It \e*(lp
+.Pq right-parenthesis
+.It \e*(rp
+.Pq left-parenthesis
+.El
+.\" SECTION
.Sh COMPATIBILITY
This section documents compatibility of
.Nm