From 220b0aefa44e51fdbb7057b36adc3210b096e100 Mon Sep 17 00:00:00 2001 From: Kristaps Dzonsons Date: Thu, 15 Oct 2009 02:42:53 +0000 Subject: Fix in mandoc.1 and mandoc_char.7 syntax (submitted Joerg Sonnenberger). Added note on character format per output type. --- mandoc_char.7 | 42 +++++++++++++++++++++++++++++++++++++----- 1 file changed, 37 insertions(+), 5 deletions(-) (limited to 'mandoc_char.7') diff --git a/mandoc_char.7 b/mandoc_char.7 index 95410f21..fbcb9ee5 100644 --- a/mandoc_char.7 +++ b/mandoc_char.7 @@ -76,13 +76,32 @@ Note that each output mode will have a different rendering of the characters. It's guaranteed that each input symbol will correspond to a (more or less) meaningful output rendering, regardless the mode. . -. -.Sh Special Characters +.Ss ASCII output +Formatting documents with ASCII output results in a 7-bit ASCII +approximation of zero or more characters, for example, the +.Dq aleph +character +.Sq \e(Ah +will render as +.Sq N . +Approximations are a best-effort, and naturally some clarity will be lost. +. +.Ss HTML output +The HTML output mode uses decimal-encoded UTF-8 for sequences, for +example, the +.Dq aleph +character +.Sq \e(Ah +will render as +.Sq ℵ . +. +. +.Sh SPECIAL CHARACTERS These are the preferred input symbols for producing special characters. . .Pp Spacing: -.Bl -compact -offset indent -column 10m 20m +.Bl -column -compact -offset indent 10m 20m .It Em Input Ta Em Description .It \e~ Ta non-breaking, non-collapsing space .It \e Ta breaking, non-collapsing n-width space @@ -95,7 +114,7 @@ Spacing: . .Pp Lines: -.Bl -compact -offset indent -column 10m 10m 10m +.Bl -column -compact -offset indent 10m 10m 10m .It Em Input Ta Em Rendered Ta Em Description .It \e(ba Ta \(ba Ta bar .It \e(br Ta \(br Ta box rule @@ -108,7 +127,7 @@ Lines: . .Pp Text markers: -.Bl -compact -offset indent -column 10m 10m 10m +.Bl -column -compact -offset indent 10m 10m 10m .It Em Input Ta Em Rendered Ta Em Description .It \e(ci Ta \(ci Ta circle .It \e(bu Ta \(bu Ta bullet @@ -577,6 +596,19 @@ having no known representation: .Xr mandoc 1 . . +.Sh STANDARDS +.Rs +.%A The Unicode Consortium +.%T The Unicode Standard: Worldwide Character Encoding, Version 5.2 +.%D 1991 +.Re +.Rs +.%A W3C +.%T HTML 4.01 Specification +.%D December, 1999 +.Re +. +. .Sh AUTHORS The .Nm -- cgit