version 1.35, 2010/04/05 10:33:20 |
version 1.38, 2010/05/09 21:11:22 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se> |
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
.Dd $Mdocdate$ |
.Dd $Mdocdate$ |
.Dt MANDOC_CHAR 7 |
.Dt MANDOC_CHAR 7 |
.Os |
.Os |
. |
|
. |
|
.Sh NAME |
.Sh NAME |
.Nm mandoc_char |
.Nm mandoc_char |
.Nd mandoc special characters |
.Nd mandoc special characters |
. |
|
. |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
This page documents the special characters and predefined strings accepted by |
This page documents the special characters and predefined strings accepted by |
.Xr mandoc 1 |
.Xr mandoc 1 |
|
|
and |
and |
.Xr man 7 |
.Xr man 7 |
documents. |
documents. |
. |
|
.Pp |
.Pp |
Both |
Both |
.Xr mdoc 7 |
.Xr mdoc 7 |
|
|
.Sq \e*X |
.Sq \e*X |
as |
as |
.Sq \e*[X] . |
.Sq \e*[X] . |
. |
|
.Pp |
.Pp |
Note that each output mode will have a different rendering of the |
Note that each output mode will have a different rendering of the |
characters. |
characters. |
It's guaranteed that each input symbol will correspond to a |
It's guaranteed that each input symbol will correspond to a |
(more or less) meaningful output rendering, regardless the mode. |
(more or less) meaningful output rendering, regardless the mode. |
. |
|
. |
|
.Sh SPECIAL CHARACTERS |
.Sh SPECIAL CHARACTERS |
These are the preferred input symbols for producing special characters. |
These are the preferred input symbols for producing special characters. |
. |
|
.Pp |
.Pp |
Spacing: |
Spacing: |
.Bl -column -compact -offset indent "Input" "Description" |
.Bl -column -compact -offset indent "Input" "Description" |
|
|
.It \e0 Ta breaking, non-collapsing digit-width space |
.It \e0 Ta breaking, non-collapsing digit-width space |
.It \ec Ta removes any trailing space (if applicable) |
.It \ec Ta removes any trailing space (if applicable) |
.El |
.El |
. |
|
.Pp |
.Pp |
Lines: |
Lines: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(sl Ta \(sl Ta forward slash |
.It \e(sl Ta \(sl Ta forward slash |
.It \e(rs Ta \(rs Ta backward slash |
.It \e(rs Ta \(rs Ta backward slash |
.El |
.El |
. |
|
.Pp |
.Pp |
Text markers: |
Text markers: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(CR Ta \(CR Ta carriage return |
.It \e(CR Ta \(CR Ta carriage return |
.It \e(OK Ta \(OK Ta check mark |
.It \e(OK Ta \(OK Ta check mark |
.El |
.El |
. |
|
.Pp |
.Pp |
Legal symbols: |
Legal symbols: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(rg Ta \(rg Ta registered |
.It \e(rg Ta \(rg Ta registered |
.It \e(tm Ta \(tm Ta trademarked |
.It \e(tm Ta \(tm Ta trademarked |
.El |
.El |
. |
|
.Pp |
.Pp |
Punctuation: |
Punctuation: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(r! Ta \(r! Ta upside-down exclamation |
.It \e(r! Ta \(r! Ta upside-down exclamation |
.It \e(r? Ta \(r? Ta upside-down question |
.It \e(r? Ta \(r? Ta upside-down question |
.El |
.El |
. |
|
.Pp |
.Pp |
Quotes: |
Quotes: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(fo Ta \(fo Ta left single guillemet |
.It \e(fo Ta \(fo Ta left single guillemet |
.It \e(fc Ta \(fc Ta right single guillemet |
.It \e(fc Ta \(fc Ta right single guillemet |
.El |
.El |
. |
|
.Pp |
.Pp |
Brackets: |
Brackets: |
.Bl -column -compact -offset indent "x[bracketrightbp]" Rendered Description |
.Bl -column -compact -offset indent "xxbracketrightbpx" Rendered Description |
.It Em Input Ta Em Rendered Ta Em Description |
.It Em Input Ta Em Rendered Ta Em Description |
.It \e(lB Ta \(lB Ta left bracket |
.It \e(lB Ta \(lB Ta left bracket |
.It \e(rB Ta \(rB Ta right bracket |
.It \e(rB Ta \(rB Ta right bracket |
|
|
.It \e[parenrightbp] Ta \[parenrightbp] Ta bottom-right hooked parenthesis |
.It \e[parenrightbp] Ta \[parenrightbp] Ta bottom-right hooked parenthesis |
.It \e[parenrightex] Ta \[parenrightex] Ta right hooked parenthesis extension |
.It \e[parenrightex] Ta \[parenrightex] Ta right hooked parenthesis extension |
.El |
.El |
. |
|
.Pp |
.Pp |
Arrows: |
Arrows: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(dA Ta \(dA Ta down double-arrow |
.It \e(dA Ta \(dA Ta down double-arrow |
.It \e(vA Ta \(vA Ta up-down double-arrow |
.It \e(vA Ta \(vA Ta up-down double-arrow |
.El |
.El |
. |
|
.Pp |
.Pp |
Logical: |
Logical: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(3d Ta \(3d Ta therefore |
.It \e(3d Ta \(3d Ta therefore |
.It \e(or Ta \(or Ta bitwise or |
.It \e(or Ta \(or Ta bitwise or |
.El |
.El |
. |
|
.Pp |
.Pp |
Mathematical: |
Mathematical: |
.Bl -column -compact -offset indent "\[coproduct]X" "Rendered" "Description" |
.Bl -column -compact -offset indent "xxcoproductxx" "Rendered" "Description" |
.It Em Input Ta Em Rendered Ta Em Description |
.It Em Input Ta Em Rendered Ta Em Description |
.It \e(pl Ta \(pl Ta plus |
.It \e(pl Ta \(pl Ta plus |
.It \e(mi Ta \(mi Ta minus |
.It \e(mi Ta \(mi Ta minus |
|
|
.It \e(pd Ta \(pd Ta partial differential |
.It \e(pd Ta \(pd Ta partial differential |
.It \e(-h Ta \(-h Ta Planck constant over 2\(*p |
.It \e(-h Ta \(-h Ta Planck constant over 2\(*p |
.El |
.El |
. |
|
.Pp |
.Pp |
Ligatures: |
Ligatures: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(IJ Ta \(IJ Ta IJ ligature |
.It \e(IJ Ta \(IJ Ta IJ ligature |
.It \e(ij Ta \(ij Ta ij ligature |
.It \e(ij Ta \(ij Ta ij ligature |
.El |
.El |
. |
|
.Pp |
.Pp |
Accents: |
Accents: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(ha Ta \(ha Ta hat (text) |
.It \e(ha Ta \(ha Ta hat (text) |
.It \e(ti Ta \(ti Ta tilde (text) |
.It \e(ti Ta \(ti Ta tilde (text) |
.El |
.El |
. |
|
.Pp |
.Pp |
Accented letters: |
Accented letters: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
Line 409 Accented letters: |
|
Line 388 Accented letters: |
|
.It \e(oA Ta \(oA Ta ring A |
.It \e(oA Ta \(oA Ta ring A |
.It \e(oa Ta \(oa Ta ring a |
.It \e(oa Ta \(oa Ta ring a |
.El |
.El |
. |
|
.Pp |
.Pp |
Special letters: |
Special letters: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
Line 421 Special letters: |
|
Line 399 Special letters: |
|
.It \e(.i Ta \(.i Ta dotless i |
.It \e(.i Ta \(.i Ta dotless i |
.It \e(.j Ta \(.j Ta dotless j |
.It \e(.j Ta \(.j Ta dotless j |
.El |
.El |
. |
|
.Pp |
.Pp |
Currency: |
Currency: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(Cs Ta \(Cs Ta Scandinavian |
.It \e(Cs Ta \(Cs Ta Scandinavian |
.It \e(Fn Ta \(Fn Ta florin |
.It \e(Fn Ta \(Fn Ta florin |
.El |
.El |
. |
|
.Pp |
.Pp |
Units: |
Units: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(sd Ta \(sd Ta second |
.It \e(sd Ta \(sd Ta second |
.It \e(mc Ta \(mc Ta micro |
.It \e(mc Ta \(mc Ta micro |
.El |
.El |
. |
|
.Pp |
.Pp |
Greek letters: |
Greek letters: |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
|
|
.It \e(+e Ta \(+e Ta epsilon variant |
.It \e(+e Ta \(+e Ta epsilon variant |
.It \e(ts Ta \(ts Ta sigma terminal |
.It \e(ts Ta \(ts Ta sigma terminal |
.El |
.El |
. |
|
. |
|
.Sh PREDEFINED STRINGS |
.Sh PREDEFINED STRINGS |
These are not recommended for use, as they differ across |
These are not recommended for use, as they differ across |
implementations: |
implementations: |
. |
|
.Pp |
.Pp |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.Bl -column -compact -offset indent "Input" "Rendered" "Description" |
.It Em Input Ta Em Rendered Ta Em Description |
.It Em Input Ta Em Rendered Ta Em Description |
Line 541 implementations: |
|
Line 513 implementations: |
|
.It \e*(aa Ta \*(aa Ta acute |
.It \e*(aa Ta \*(aa Ta acute |
.It \e*(ga Ta \*(ga Ta grave |
.It \e*(ga Ta \*(ga Ta grave |
.El |
.El |
. |
|
. |
|
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section documents compatibility of |
This section documents compatibility of |
.Nm |
.Nm |
with older or existing versions of |
with older or existing versions of |
.Xr groff 1 . |
.Xr groff 1 . |
. |
|
.Pp |
.Pp |
The following render differently in |
The following render differently in |
.Fl T Ns Ar ascii |
.Fl T Ns Ar ascii |
|
|
\e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product], |
\e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product], |
\e[coproduct], \e(gr, \e(-h, \e(a. |
\e[coproduct], \e(gr, \e(-h, \e(a. |
.Ed |
.Ed |
. |
|
.Pp |
.Pp |
The following render differently in |
The following render differently in |
.Fl T Ns Ar html |
.Fl T Ns Ar html |
|
|
.Bd -ragged -offset indent |
.Bd -ragged -offset indent |
\e(~=, \e(nb, \e(nc |
\e(~=, \e(nb, \e(nc |
.Ed |
.Ed |
. |
|
.Pp |
.Pp |
Finally, the following have been omitted by being poorly documented or |
Finally, the following have been omitted by being poorly documented or |
having no known representation: |
having no known representation: |
.Bd -ragged -offset indent |
.Bd -ragged -offset indent |
\e[radicalex], \e[sqrtex], \e(ru |
\e[radicalex], \e[sqrtex], \e(ru |
.Ed |
.Ed |
. |
|
. |
|
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr mandoc 1 |
.Xr mandoc 1 |
. |
|
. |
|
.Sh AUTHORS |
.Sh AUTHORS |
The |
The |
.Nm |
.Nm |
manual page was written by |
manual page was written by |
.An Kristaps Dzonsons Aq kristaps@kth.se . |
.An Kristaps Dzonsons Aq kristaps@bsd.lv . |
|
.Sh CAVEATS |
|
The |
|
.Sq \e*(Ba |
|
escape mimics the behaviour of the |
|
.Sq \*(Ba |
|
character in |
|
.Xr mdoc 7 ; |
|
thus, if you wish to render a vertical bar with no side effects, use |
|
the |
|
.Sq \e(ba |
|
escape. |