=================================================================== RCS file: /cvs/mandoc/Attic/mdocterm.1,v retrieving revision 1.21 retrieving revision 1.25 diff -u -p -r1.21 -r1.25 --- mandoc/Attic/mdocterm.1 2009/03/15 07:08:52 1.21 +++ mandoc/Attic/mdocterm.1 2009/03/17 00:40:17 1.25 @@ -1,6 +1,6 @@ -.\" $Id: mdocterm.1,v 1.21 2009/03/15 07:08:52 kristaps Exp $ +.\" $Id: mdocterm.1,v 1.25 2009/03/17 00:40:17 kristaps Exp $ .\" -.\" Copyright (c) 2009 Kristaps Dzonsons +.\" Copyright (c) 2009 Kristaps Dzonsons .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the @@ -16,7 +16,7 @@ .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: March 15 2009 $ +.Dd $Mdocdate: March 17 2009 $ .Dt mdocterm 1 .Os .\" SECTION @@ -60,7 +60,7 @@ Override default compiler behaviour. See for details. .\" ITEM .It Fl O Ns Ar option... -Terminal-encoding options. See +Front-end options. See .Sx Front-end Options for details. .\" ITEM @@ -122,7 +122,7 @@ can't be parsed (isn't valid mdoc, doesn't contain val is invoked. If no .Xr nroff 1 command-line argumnets aren't provided, -.Fl m Ar Ns andoc +.Fl m Ns Ar andoc is implied. .\" PARAGRAPH .Pp @@ -139,8 +139,6 @@ Don't punt to if .Ar infile may not be parsed. -.It Fl O Ns Ar ansi -Use ANSI/VT100 output encoding instead of backspaces. .El .\" SUB-SECTION .Ss Compiler Options @@ -169,134 +167,23 @@ options may be grouped and delimited with a comma. Us for example, will try to ignore scope and character-escape errors. .\" SUB-SECTION .Ss Character Escapes -The following table shows all +The +.Nm +utility correctly renders all +.Sx Special Characters +in .Xr mdoc 7 -character escapes rendered by -.Nm . -Note that the -.Em Output -column will render differently whether executed with -.Xr mdocterm 1 -or another output filter. -.\" PARAGRAPH +in 7-bit ASCII. .Pp -Grammatic: -.Pp -.Bl -tag -width "OutputXXXX" -offset "XXXX" -compact -.It Em Output -.Em Input (Name) -.It \(em -\\(em (em-dash) -.It \(en -\\(en (en-dash) -.It \- -\\- (hyphen) -.It \\ -\\\\ (back-slash) -.El -.\" PARAGRAPH -.Pp -Enclosures: -.Pp -.Bl -tag -width "OutputXXXX" -offset "XXXX" -compact -.It Em Output -.Em Input (Name) -.It \(rC -\\(rC (right brace) -.It \(lC -\\(lC (left brace) -.It \(ra -\\(ra (right angle) -.It \(la -\\(la (left angle) -.It \(rB -\\(rB (right bracket) -.It \(lB -\\(lB (left bracket) -.It \q -\\q (double-quote) -.It \(lq -\\(lq (left double-quote) -.It \(rq -\\(rq (right double-quote) -.It \(oq -\\(oq, \\` (left single-quote) -.It \(aq -\\(aq, \\' (right single-quote, apostrophe) -.El -.\" PARAGRAPH -.Pp -Indicatives: -.Pp -.Bl -tag -width "OutputXXXX" -offset "XXXX" -compact -.It Em Output -.Em Input (Name) -.It \(<- -\\(<- (left arrow) -.It \(-> -\\(-> (right arrow) -.It \(ua -\\(ua (up arrow) -.It \(da -\\(da (down arrow) -.El -.\" PARAGRAPH -.Pp -Mathematical: -.Pp -.Bl -tag -width "OutputXXXX" -offset "XXXX" -compact -.It Em Output -.Em Input (Name) -.It \(<= -\\(<= (less-than-equal) -.It \(>= -\\(>= (greater-than-equal) -.It \(== -\\(== (equal) -.It \(!= -\\(!= (not equal) -.It \(if -\\(if (infinity) -.It \(na -\\(na (NaN)* -.It \(+- -\\(+- (plus-minus) -.It \(** -\\(** (asterisk) -.El -.\" PARAGRAPH -.Pp -Diacritics: -.Pp -.Bl -tag -width "OutputXXXX" -offset "XXXX" -compact -.It Em Output -.Em Input (Name) -.It \(ga -\\(ga (accent grave) -.It \(aa -\\(aa (accent accute) -.El -.\" PARAGRAPH -.Pp -Special symbols: -.Pp -.Bl -tag -width "OutputXXXX" -offset "XXXX" -compact -.It Em Output -.Em Input (Name) -.It \(bu -\\(bu (bullet) -.It \(ba -\\(ba (bar) -.It \(co -\\(co (copyright) -.El -.Pp -*This is a deviation from the standard, as NaN is usually rendered as -\\*(Na, which is a deprecated form. We introduce \\(na, which follows -the more general syntax. +In the general sense, +.Nm +will make a +.Pq best-effort +to render complex characters; however, if a manual is using considerable +special characters, some meaning may be lost in translation. .\" SECTION .Sh EXAMPLES -To display this manual page on ANSI-capable terminal: +To display this manual page: .\" PARAGRAPH .Pp .D1 % mdocterm \-Wall,error mdocterm.1 @@ -316,7 +203,7 @@ To pipe a manual page to the pager: The .Nm utility was written by -.An Kristaps Dzonsons Aq kristaps@kth.se . +.An Kristaps Dzonsons Aq kristaps@openbsd.org . .\" SECTION .Sh CAVEATS See