summaryrefslogtreecommitdiffstats
path: root/mdocterm.1
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-03-14 12:35:02 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-03-14 12:35:02 +0000
commitc4b5d8a0192a406d9f04a23e2c8a768a29e01371 (patch)
treedb36bf96544a33bbc1913af7b929977a718202ce /mdocterm.1
parentc7786fc13e7b2236e756f79950f7ababcac56545 (diff)
downloadmandoc-c4b5d8a0192a406d9f04a23e2c8a768a29e01371.tar.gz
Added colour styles (not being used) to struct termp.
Added nroff style-escape encoding. Removed ANSI schema string tables (there's only ANSI and nroff/backspace). Pushed styling directly into pword (simpler).
Diffstat (limited to 'mdocterm.1')
-rw-r--r--mdocterm.141
1 files changed, 16 insertions, 25 deletions
diff --git a/mdocterm.1 b/mdocterm.1
index e19495b4..7bb8f7e9 100644
--- a/mdocterm.1
+++ b/mdocterm.1
@@ -28,6 +28,7 @@
.Nm mdocmterm
.Op Fl vV
.Op Fl f Ns Ar option...
+.Op Fl O Ns Ar option...
.Op Fl W Ns Ar err...
.Op Ar infile
.\" SECTION
@@ -50,6 +51,15 @@ Override default compiler behaviour. See
.Sx Compiler Options
for details.
.\" ITEM
+.It Fl O Ns Ar option...
+Terminal-encoding options. May be set to
+.Fl O Ns Ar ansi
+for ANSI/VT100-encoded output (the default) or
+.Fl O Ns Ar nroff
+for nroff-encoded
+.Qq backspace
+output.
+.\" ITEM
.It Fl W Ns Ar err...
Print warning messages. May be set to
.Fl W Ns Ar all
@@ -119,30 +129,11 @@ 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
-This section documents the character-escapes accepted by
-.Xr mdocterm 1 .
-Note that the \\x, \\(xx and \\[n] forms are described here; the \\*(xx,
-\\*[n] and \\*x forms described in
-.Xr mdoc.samples 7
-are deprecated, but still rendered. All one- and two-character
-sequences may be used in the n-character sequence \\[n].
-.Pp
+The following table shows all
+.Xr mdoc 7
+character escapes rendered by
+.Nm .
Note that the
.Em Output
column will render differently whether executed with
@@ -266,7 +257,7 @@ Special symbols:
the more general syntax.
.\" SECTION
.Sh EXAMPLES
-To display this manual page:
+To display this manual page on ANSI-capable terminal:
.\" PARAGRAPH
.Pp
.D1 % mdocmterm \-Wall,error mdocmterm.1
@@ -274,7 +265,7 @@ To display this manual page:
.Pp
To pipe a manual page to the pager:
.Pp
-.D1 % mdocterm mdocterm.1 2>&1 | less \-R
+.D1 % mdocterm -Onroff mdocterm.1 | less
.\" SECTION
.Sh SEE ALSO
.Xr mdoctree 1 ,