diff options
author | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-10-15 02:42:53 +0000 |
---|---|---|
committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-10-15 02:42:53 +0000 |
commit | 8365adaefaacd65afe12a9bcdafa08c0d0e53d5d (patch) | |
tree | 9694420e057f76fe8ed7100211bc6ded906f52e8 | |
parent | 8617f74b0b3a07a14195042b4171e598e117c146 (diff) | |
download | mandoc-8365adaefaacd65afe12a9bcdafa08c0d0e53d5d.tar.gz mandoc-8365adaefaacd65afe12a9bcdafa08c0d0e53d5d.tar.zst mandoc-8365adaefaacd65afe12a9bcdafa08c0d0e53d5d.zip |
Fix in mandoc.1 and mandoc_char.7 syntax (submitted Joerg Sonnenberger).
Added note on character format per output type.
-rw-r--r-- | mandoc.1 | 8 | ||||
-rw-r--r-- | mandoc_char.7 | 46 |
2 files changed, 43 insertions, 11 deletions
@@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.42 2009/10/10 11:05:23 kristaps Exp $ +.\" $Id: mandoc.1,v 1.43 2009/10/15 02:42:53 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: October 10 2009 $ +.Dd $Mdocdate: October 15 2009 $ .Dt MANDOC 1 .Os . @@ -268,7 +268,7 @@ for example, is used as a template for linked header files (usually via the .Sq \&In macro). Instances of -.Sq %I +.Sq \&%I are replaced with the include filename. The default is not to present a hyperlink. .It Fl o Ns Ar man=fmt @@ -279,7 +279,7 @@ for example, is used as a template for linked manuals (usually via the .Sq \&Xr macro). Instances of -.Sq %N +.Sq \&%N and .Sq %S are replaced with the linked manual's name and section, respectively. diff --git a/mandoc_char.7 b/mandoc_char.7 index cf8ba598..e62a551d 100644 --- a/mandoc_char.7 +++ b/mandoc_char.7 @@ -1,4 +1,4 @@ -.\" $Id: mandoc_char.7,v 1.25 2009/10/07 14:37:13 kristaps Exp $ +.\" $Id: mandoc_char.7,v 1.26 2009/10/15 02:42:53 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: October 7 2009 $ +.Dd $Mdocdate: October 15 2009 $ .Dt MANDOC_CHAR 7 .Os . @@ -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 |