aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/mandoc_char.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-10-15 02:42:53 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-10-15 02:42:53 +0000
commit8365adaefaacd65afe12a9bcdafa08c0d0e53d5d (patch)
tree9694420e057f76fe8ed7100211bc6ded906f52e8 /mandoc_char.7
parent8617f74b0b3a07a14195042b4171e598e117c146 (diff)
downloadmandoc-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.
Diffstat (limited to 'mandoc_char.7')
-rw-r--r--mandoc_char.746
1 files changed, 39 insertions, 7 deletions
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 &#8501; .
+.
+.
+.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