summaryrefslogtreecommitdiffstats
path: root/mdoctree.1
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-03-09 13:04:01 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-03-09 13:04:01 +0000
commit3c250f9844dc2759a6887a574ce490316f7d1939 (patch)
treee1d3729c8ebbf735e45a2a9bec594ec0e4fe6da7 /mdoctree.1
parentf4bf03d97398f8f37ba7e8df8d5a0e3f1b53520c (diff)
downloadmandoc-3c250f9844dc2759a6887a574ce490316f7d1939.tar.gz
Added "Input Encoding" section to mdoc*.1.VERSION.1.4.4
Newline-escaped lines are concatenated. Added -fign-macro option.
Diffstat (limited to 'mdoctree.1')
-rw-r--r--mdoctree.123
1 files changed, 23 insertions, 0 deletions
diff --git a/mdoctree.1 b/mdoctree.1
index fcd20fec..d494ae43 100644
--- a/mdoctree.1
+++ b/mdoctree.1
@@ -103,6 +103,8 @@ When rewinding the scope of a block macro, forces the compiler to ignore
scope violations. This can seriously mangle the resulting tree.
.It Fl f Ns Ar ign-escape
Ignore invalid escape sequences.
+.It Fl f Ns Ar ign-macro
+Ignore unknown macros at the start of input lines.
.El
.\" PARAGRAPH
.Pp
@@ -113,6 +115,27 @@ flag, multiple
options may be grouped and delimited with a comma. Using
.Fl f Ns Ar ign-scope,ign-escape ,
for example, will try to ignore scope and character-escape errors.
+.\" SUB-SECTION
+.Ss Input Encoding
+The
+.Nm
+utility expects its input to be 7-bit ASCII as defined in
+.Xr ascii 7 .
+The only non-graphing characters accepted are spaces,
+.Sq \ ,
+and tabs,
+.Sq \et .
+Tabs are only accepted in literal block-displays and as column
+delimiters.
+.Pp
+Only Unix-style newlines (\en) are accepted; if the newline is escaped,
+the line is concatenated with the next.
+.\" SUB-SECTION
+.Ss Character Escapes
+Since
+.Nm
+doesn't format its output, character escapes are displayed as passed
+into the compiler.
.\" SECTION
.Sh EXAMPLES
To validate this manual page: