[BACK]Return to mandoc_char.7 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc_char.7 between version 1.58 and 1.63

version 1.58, 2014/12/16 19:50:03 version 1.63, 2015/09/02 15:38:35
Line 2 
Line 2 
 .\"  .\"
 .\" 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
Line 64  lorry-driver
Line 64  lorry-driver
 .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 \&.
Line 196  Spacing:
Line 218  Spacing:
 .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
Line 352  Mathematical:
Line 374  Mathematical:
 .It \e(-+    Ta \(-+        Ta minus-plus  .It \e(-+    Ta \(-+        Ta minus-plus
 .It \e(+-    Ta \(+-        Ta plus-minus  .It \e(+-    Ta \(+-        Ta plus-minus
 .It \e[t+-]  Ta \[t+-]      Ta plus-minus (text)  .It \e[t+-]  Ta \[t+-]      Ta plus-minus (text)
 .It \e(pc    Ta \(pc        Ta centre-dot  .It \e(pc    Ta \(pc        Ta center-dot
 .It \e(mu    Ta \(mu        Ta multiply  .It \e(mu    Ta \(mu        Ta multiply
 .It \e[tmu]  Ta \[tmu]      Ta multiply (text)  .It \e[tmu]  Ta \[tmu]      Ta multiply (text)
 .It \e(c*    Ta \(c*        Ta circle-multiply  .It \e(c*    Ta \(c*        Ta circle-multiply
Line 371  Mathematical:
Line 393  Mathematical:
 .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
Line 436  Accents:
Line 458  Accents:
 .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)
Line 453  Accents:
Line 475  Accents:
 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
Line 657  manual.
Line 679  manual.
 .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
Line 702  In
Line 720  In
 .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
Legend:
Removed from v.1.58  
changed lines
  Added in v.1.63
CVSweb