summaryrefslogtreecommitdiffstats
path: root/mdoc.3
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-02-24 13:46:54 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-02-24 13:46:54 +0000
commit38fefdf005d8237391f4aabfb145c4a96d930b8b (patch)
tree3140d1ac71c9d4d0d8ed643bc9937302d4cf9379 /mdoc.3
parentc8bf126a0b893c247fa4ec7b271fa51308fe257f (diff)
downloadmandoc-38fefdf005d8237391f4aabfb145c4a96d930b8b.tar.gz
Character-encoding checked for all text (arguments/values).
Diffstat (limited to 'mdoc.3')
-rw-r--r--mdoc.319
1 files changed, 18 insertions, 1 deletions
diff --git a/mdoc.3 b/mdoc.3
index fe09e890..7bddf115 100644
--- a/mdoc.3
+++ b/mdoc.3
@@ -89,7 +89,9 @@ This section further defines the
.Sx Functions
and
.Sx Variables
-available to programmers. The last sub-section,
+available to programmers. Following that,
+.Sx Character Encoding
+describes input format. Lastly,
.Sx Abstract Syntax Tree ,
documents the output tree.
.\" SUBSECTION
@@ -174,6 +176,21 @@ An array of string-ified token names.
An array of string-ified token argument names.
.El
.\" SUBSECTION
+.Ss Character Encoding
+The
+.Xr mdoc 3
+library accepts only printable ASCII characters as defined by
+.Xr isprint 3 .
+Non-ASCII character sequences are escaped with an escape character
+.Sq \\
+and followed by either an open-parenthesis
+.Sq \&(
+for two-character sequences; an open-bracket
+.Sq \&[
+for n-character sequences (terminated at a close-bracket
+.Sq \&] ) ;
+or one of a small set of single characters for other escapes.
+.\" SUBSECTION
.Ss Abstract Syntax Tree
The
.Nm