version 1.59, 2015/01/20 19:39:34 |
version 1.63, 2015/09/02 15:38:35 |
|
|
.\" |
.\" |
.\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org> |
.\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org> |
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2011 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2011, 2013, 2015 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
.\" 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 |
Line 49 names; instead, provide ASCII transcriptions of the na |
|
Line 49 names; instead, provide ASCII transcriptions of the na |
|
.Ss Dashes and Hyphens |
.Ss Dashes and Hyphens |
In typography there are different types of dashes of various width: |
In typography there are different types of dashes of various width: |
the hyphen (-), |
the hyphen (-), |
the minus sign (\-), |
the minus sign (\(mi), |
the en-dash (\(en), |
the en-dash (\(en), |
and the em-dash (\(em). |
and the em-dash (\(em). |
.Pp |
.Pp |
|
|
.Pp |
.Pp |
The mathematical minus sign is used for negative numbers or subtraction. |
The mathematical minus sign is used for negative numbers or subtraction. |
It should be written as |
It should be written as |
.Sq \e- : |
.Sq \e(mi : |
.Bd -unfilled -offset indent |
.Bd -unfilled -offset indent |
a = 3 \e- 1; |
a = 3 \e(mi 1; |
b = \e-2; |
b = \e(mi2; |
.Ed |
.Ed |
.Pp |
.Pp |
The en-dash is used to separate the two elements of a range, |
The en-dash is used to separate the two elements of a range, |
Line 142 Note that on text lines, literal double-quote characte |
|
Line 142 Note that on text lines, literal double-quote characte |
|
verbatim. |
verbatim. |
All other quote-like characters can be used verbatim as well, |
All other quote-like characters can be used verbatim as well, |
even on request and macro lines. |
even on request and macro lines. |
|
.Ss Accents |
|
In output modes supporting such special output characters, for example |
|
.Fl T Cm pdf , |
|
some |
|
.Xr roff 7 |
|
formatters convert the following ASCII input characters to the |
|
following Unicode special output characters: |
|
.Bl -column x(ga U+2018 -offset indent |
|
.It \(ga Ta U+2018 Ta left single quotation mark |
|
.It \(aq Ta U+2019 Ta right single quotation mark |
|
.It \(ti Ta U+02DC Ta small tilde |
|
.El |
|
.Pp |
|
In prose, this automatic substitution is often desirable; |
|
but when these characters have to be displayed as plain ASCII |
|
characters, for example in source code samples, they require |
|
escaping to render as follows: |
|
.Bl -column x(ga U+2018 -offset indent |
|
.It \e(ga Ta U+0060 Ta grave accent |
|
.It \e(aq Ta U+0027 Ta apostrophe |
|
.It \e(ti Ta U+007E Ta tilde |
|
.El |
.Ss Periods |
.Ss Periods |
The period |
The period |
.Pq Sq \&. |
.Pq Sq \&. |
|
|
.Bl -column "Input" "Description" -offset indent -compact |
.Bl -column "Input" "Description" -offset indent -compact |
.It Em Input Ta Em Description |
.It Em Input Ta Em Description |
.It Sq \e\ \& Ta unpaddable non-breaking space |
.It Sq \e\ \& Ta unpaddable non-breaking space |
.It \e~ Ta paddable non-breaking space |
.It \e\(ti Ta paddable non-breaking space |
.It \e0 Ta unpaddable, breaking digit-width space |
.It \e0 Ta unpaddable, breaking digit-width space |
.It \e| Ta one-sixth \e(em narrow space, zero width in nroff mode |
.It \e| Ta one-sixth \e(em narrow space, zero width in nroff mode |
.It \e^ Ta one-twelfth \e(em half-narrow space, zero width in nroff |
.It \e^ Ta one-twelfth \e(em half-narrow space, zero width in nroff |
|
|
.It \e(ne Ta \(ne Ta not equivalent |
.It \e(ne Ta \(ne Ta not equivalent |
.It \e(ap Ta \(ap Ta tilde operator |
.It \e(ap Ta \(ap Ta tilde operator |
.It \e(|= Ta \(|= Ta asymptotically equal |
.It \e(|= Ta \(|= Ta asymptotically equal |
.It \e(=~ Ta \(=~ Ta approximately equal |
.It \e(=\(ti Ta \(=~ Ta approximately equal |
.It \e(~~ Ta \(~~ Ta almost equal |
.It \e(\(ti\(ti Ta \(~~ Ta almost equal |
.It \e(~= Ta \(~= Ta almost equal |
.It \e(\(ti= Ta \(~= Ta almost equal |
.It \e(pt Ta \(pt Ta proportionate |
.It \e(pt Ta \(pt Ta proportionate |
.It \e(es Ta \(es Ta empty set |
.It \e(es Ta \(es Ta empty set |
.It \e(mo Ta \(mo Ta element |
.It \e(mo Ta \(mo Ta element |
|
|
.It \e(a. Ta \(a. Ta dotted |
.It \e(a. Ta \(a. Ta dotted |
.It \e(a^ Ta \(a^ Ta circumflex |
.It \e(a^ Ta \(a^ Ta circumflex |
.It \e(aa Ta \(aa Ta acute |
.It \e(aa Ta \(aa Ta acute |
.It \e' Ta \' Ta acute |
.It \e\(aq Ta \' Ta acute |
.It \e(ga Ta \(ga Ta grave |
.It \e(ga Ta \(ga Ta grave |
.It \e` Ta \` Ta grave |
.It \e\(ga Ta \` Ta grave |
.It \e(ab Ta \(ab Ta breve |
.It \e(ab Ta \(ab Ta breve |
.It \e(ac Ta \(ac Ta cedilla |
.It \e(ac Ta \(ac Ta cedilla |
.It \e(ad Ta \(ad Ta dieresis |
.It \e(ad Ta \(ad Ta dieresis |
.It \e(ah Ta \(ah Ta caron |
.It \e(ah Ta \(ah Ta caron |
.It \e(ao Ta \(ao Ta ring |
.It \e(ao Ta \(ao Ta ring |
.It \e(a~ Ta \(a~ Ta tilde |
.It \e(a\(ti Ta \(a~ Ta tilde |
.It \e(ho Ta \(ho Ta ogonek |
.It \e(ho Ta \(ho Ta ogonek |
.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) |
|
|
Accented letters: |
Accented letters: |
.Bl -column "Input" "Rendered" "Description" -offset indent -compact |
.Bl -column "Input" "Rendered" "Description" -offset indent -compact |
.It Em Input Ta Em Rendered Ta Em Description |
.It Em Input Ta Em Rendered Ta Em Description |
.It \e('A Ta \('A Ta acute A |
.It \e(\(aqA Ta \('A Ta acute A |
.It \e('E Ta \('E Ta acute E |
.It \e(\(aqE Ta \('E Ta acute E |
.It \e('I Ta \('I Ta acute I |
.It \e(\(aqI Ta \('I Ta acute I |
.It \e('O Ta \('O Ta acute O |
.It \e(\(aqO Ta \('O Ta acute O |
.It \e('U Ta \('U Ta acute U |
.It \e(\(aqU Ta \('U Ta acute U |
.It \e('a Ta \('a Ta acute a |
.It \e(\(aqa Ta \('a Ta acute a |
.It \e('e Ta \('e Ta acute e |
.It \e(\(aqe Ta \('e Ta acute e |
.It \e('i Ta \('i Ta acute i |
.It \e(\(aqi Ta \('i Ta acute i |
.It \e('o Ta \('o Ta acute o |
.It \e(\(aqo Ta \('o Ta acute o |
.It \e('u Ta \('u Ta acute u |
.It \e(\(aqu Ta \('u Ta acute u |
.It \e(`A Ta \(`A Ta grave A |
.It \e(\(gaA Ta \(`A Ta grave A |
.It \e(`E Ta \(`E Ta grave E |
.It \e(\(gaE Ta \(`E Ta grave E |
.It \e(`I Ta \(`I Ta grave I |
.It \e(\(gaI Ta \(`I Ta grave I |
.It \e(`O Ta \(`O Ta grave O |
.It \e(\(gaO Ta \(`O Ta grave O |
.It \e(`U Ta \(`U Ta grave U |
.It \e(\(gaU Ta \(`U Ta grave U |
.It \e(`a Ta \(`a Ta grave a |
.It \e(\(gaa Ta \(`a Ta grave a |
.It \e(`e Ta \(`e Ta grave e |
.It \e(\(gae Ta \(`e Ta grave e |
.It \e(`i Ta \(`i Ta grave i |
.It \e(\(gai Ta \(`i Ta grave i |
.It \e(`o Ta \(`i Ta grave o |
.It \e(\(gao Ta \(`i Ta grave o |
.It \e(`u Ta \(`u Ta grave u |
.It \e(\(gau Ta \(`u Ta grave u |
.It \e(~A Ta \(~A Ta tilde A |
.It \e(\(tiA Ta \(~A Ta tilde A |
.It \e(~N Ta \(~N Ta tilde N |
.It \e(\(tiN Ta \(~N Ta tilde N |
.It \e(~O Ta \(~O Ta tilde O |
.It \e(\(tiO Ta \(~O Ta tilde O |
.It \e(~a Ta \(~a Ta tilde a |
.It \e(\(tia Ta \(~a Ta tilde a |
.It \e(~n Ta \(~n Ta tilde n |
.It \e(\(tin Ta \(~n Ta tilde n |
.It \e(~o Ta \(~o Ta tilde o |
.It \e(\(tio Ta \(~o Ta tilde o |
.It \e(:A Ta \(:A Ta dieresis A |
.It \e(:A Ta \(:A Ta dieresis A |
.It \e(:E Ta \(:E Ta dieresis E |
.It \e(:E Ta \(:E Ta dieresis E |
.It \e(:I Ta \(:I Ta dieresis I |
.It \e(:I Ta \(:I Ta dieresis I |
|
|
.Sh UNICODE CHARACTERS |
.Sh UNICODE CHARACTERS |
The escape sequences |
The escape sequences |
.Pp |
.Pp |
.Dl \e[uXXXX] and \eC'uXXXX' |
.Dl \e[uXXXX] and \eC\(aquXXXX\(aq |
.Pp |
.Pp |
are interpreted as Unicode codepoints. |
are interpreted as Unicode codepoints. |
The codepoint must be in the range above U+0080 and less than U+10FFFF. |
The codepoint must be in the range above U+0080 and less than U+10FFFF. |
Line 669 must be given as uppercase characters, |
|
Line 691 must be given as uppercase characters, |
|
and points must be zero-padded to four characters; if |
and points must be zero-padded to four characters; if |
greater than four characters, no zero padding is allowed. |
greater than four characters, no zero padding is allowed. |
Unicode surrogates are not allowed. |
Unicode surrogates are not allowed. |
.\" .Pp |
|
.\" Unicode glyphs attenuate to the |
|
.\" .Sq \&? |
|
.\" character if invalid or not rendered by current output media. |
|
.Sh NUMBERED CHARACTERS |
.Sh NUMBERED CHARACTERS |
For backward compatibility with existing manuals, |
For backward compatibility with existing manuals, |
.Xr mandoc 1 |
.Xr mandoc 1 |
Line 685 escape sequence, inserting the character |
|
Line 703 escape sequence, inserting the character |
|
from the current character set into the output. |
from the current character set into the output. |
Of course, this is inherently non-portable and is already marked |
Of course, this is inherently non-portable and is already marked |
as deprecated in the Heirloom roff manual. |
as deprecated in the Heirloom roff manual. |
For example, do not use \eN'34', use \e(dq, or even the plain |
For example, do not use \eN\(aq34\(aq, use \e(dq, or even the plain |
.Sq \(dq |
.Sq \(dq |
character where possible. |
character where possible. |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
|
|
.Fl T Ns Cm ascii , |
.Fl T Ns Cm ascii , |
the |
the |
\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, and \e(a. special characters render |
\e[coproduct], \e(gr, \e(-h, and \e(a. special characters render |
differently between mandoc and groff. |
differently between mandoc and groff. |
.It |
.It |
In |
In |
.Fl T Ns Cm html |
.Fl T Ns Cm html |
and |
and |
.Fl T Ns Cm xhtml , |
.Fl T Ns Cm xhtml , |
the \e(~=, \e(nb, and \e(nc special characters render differently |
the \e(\(ti=, \e(nb, and \e(nc special characters render differently |
between mandoc and groff. |
between mandoc and groff. |
.It |
.It |
The |
The |