| mandoc_char.7 (302408) | mandoc_char.7 (241675) |
|---|---|
| 1.\" $Id: mandoc_char.7,v 1.63 2015/09/02 15:38:35 schwarze Exp $ | 1.\" $Id: mandoc_char.7,v 1.51 2011/11/23 10:09:30 kristaps Exp $ |
| 2.\" 3.\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org> 4.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> | 2.\" 3.\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org> 4.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
| 5.\" Copyright (c) 2011, 2013, 2015 Ingo Schwarze <schwarze@openbsd.org> | 5.\" Copyright (c) 2011 Ingo Schwarze |
| 6.\" 7.\" Permission to use, copy, modify, and distribute this software for any 8.\" purpose with or without fee is hereby granted, provided that the above 9.\" copyright notice and this permission notice appear in all copies. 10.\" 11.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 12.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 13.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 14.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 15.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 16.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 17.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 18.\" | 6.\" 7.\" Permission to use, copy, modify, and distribute this software for any 8.\" purpose with or without fee is hereby granted, provided that the above 9.\" copyright notice and this permission notice appear in all copies. 10.\" 11.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 12.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 13.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 14.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 15.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 16.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 17.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 18.\" |
| 19.Dd $Mdocdate: September 2 2015 $ | 19.Dd $Mdocdate: November 23 2011 $ |
| 20.Dt MANDOC_CHAR 7 21.Os 22.Sh NAME 23.Nm mandoc_char 24.Nd mandoc special characters 25.Sh DESCRIPTION 26This page documents the 27.Xr roff 7 --- 16 unchanged lines hidden (view full) --- 44compatibility with existing documents. 45.Pp 46In particular, in English manual pages, do not use special-character 47escape sequences to represent national language characters in author 48names; instead, provide ASCII transcriptions of the names. 49.Ss Dashes and Hyphens 50In typography there are different types of dashes of various width: 51the hyphen (-), | 20.Dt MANDOC_CHAR 7 21.Os 22.Sh NAME 23.Nm mandoc_char 24.Nd mandoc special characters 25.Sh DESCRIPTION 26This page documents the 27.Xr roff 7 --- 16 unchanged lines hidden (view full) --- 44compatibility with existing documents. 45.Pp 46In particular, in English manual pages, do not use special-character 47escape sequences to represent national language characters in author 48names; instead, provide ASCII transcriptions of the names. 49.Ss Dashes and Hyphens 50In typography there are different types of dashes of various width: 51the hyphen (-), |
| 52the minus sign (\(mi), | 52the minus sign (\-), |
| 53the en-dash (\(en), 54and the em-dash (\(em). 55.Pp 56Hyphens are used for adjectives; 57to separate the two parts of a compound word; 58or to separate a word across two successive lines of text. 59The hyphen does not need to be escaped: 60.Bd -unfilled -offset indent 61blue-eyed 62lorry-driver 63.Ed 64.Pp 65The mathematical minus sign is used for negative numbers or subtraction. 66It should be written as | 53the en-dash (\(en), 54and the em-dash (\(em). 55.Pp 56Hyphens are used for adjectives; 57to separate the two parts of a compound word; 58or to separate a word across two successive lines of text. 59The hyphen does not need to be escaped: 60.Bd -unfilled -offset indent 61blue-eyed 62lorry-driver 63.Ed 64.Pp 65The mathematical minus sign is used for negative numbers or subtraction. 66It should be written as |
| 67.Sq \e(mi : | 67.Sq \e- : |
| 68.Bd -unfilled -offset indent | 68.Bd -unfilled -offset indent |
| 69a = 3 \e(mi 1; 70b = \e(mi2; | 69a = 3 \e- 1; 70b = \e-2; |
| 71.Ed 72.Pp 73The en-dash is used to separate the two elements of a range, 74or can be used the same way as an em-dash. 75It should be written as 76.Sq \e(en : 77.Bd -unfilled -offset indent 78pp. 95\e(en97. --- 14 unchanged lines hidden (view full) --- 93Other formats, such as PostScript, render them correctly, 94with differing widths. 95.Ss Spaces 96To separate words in normal text, for indenting and alignment 97in literal context, and when none of the following special cases apply, 98just use the normal space character 99.Pq Sq \ . 100.Pp | 71.Ed 72.Pp 73The en-dash is used to separate the two elements of a range, 74or can be used the same way as an em-dash. 75It should be written as 76.Sq \e(en : 77.Bd -unfilled -offset indent 78pp. 95\e(en97. --- 14 unchanged lines hidden (view full) --- 93Other formats, such as PostScript, render them correctly, 94with differing widths. 95.Ss Spaces 96To separate words in normal text, for indenting and alignment 97in literal context, and when none of the following special cases apply, 98just use the normal space character 99.Pq Sq \ . 100.Pp |
| 101When filling text, output lines may be broken between words, i.e. at space | 101When filling text, lines may be broken between words, i.e. at space |
| 102characters. 103To prevent a line break between two particular words, | 102characters. 103To prevent a line break between two particular words, |
| 104use the unpaddable non-breaking space escape sequence 105.Pq Sq \e\ \& | 104use the non-breaking space escape sequence 105.Pq Sq \e~ |
| 106instead of the normal space character. 107For example, the input string | 106instead of the normal space character. 107For example, the input string |
| 108.Dq number\e\ 1 | 108.Dq number\e~1 |
| 109will be kept together as | 109will be kept together as |
| 110.Dq number\ 1 | 110.Dq number\~1 |
| 111on the same output line. 112.Pp 113On request and macro lines, the normal space character serves as an 114argument delimiter. | 111on the same output line. 112.Pp 113On request and macro lines, the normal space character serves as an 114argument delimiter. |
| 115To include whitespace into arguments, quoting is usually the best choice; 116see the MACRO SYNTAX section in 117.Xr roff 7 . 118In some cases, using the non-breaking space escape sequence | 115To include whitespace into arguments, quoting is usually the best choice. 116In some cases, using either the non-breaking 117.Pq Sq \e~ 118or the breaking |
| 119.Pq Sq \e\ \& | 119.Pq Sq \e\ \& |
| 120may be preferable. 121.Pp | 120space escape sequence may be preferable. |
| 122To escape macro names and to protect whitespace at the end 123of input lines, the zero-width space 124.Pq Sq \e& 125is often useful. 126For example, in 127.Xr mdoc 7 , 128a normal space character can be displayed in single quotes in either 129of the following ways: --- 7 unchanged lines hidden (view full) --- 137One way to prevent this special handling is by using the 138.Sq \e(dq 139escape sequence. 140.Pp 141Note that on text lines, literal double-quote characters can be used 142verbatim. 143All other quote-like characters can be used verbatim as well, 144even on request and macro lines. | 121To escape macro names and to protect whitespace at the end 122of input lines, the zero-width space 123.Pq Sq \e& 124is often useful. 125For example, in 126.Xr mdoc 7 , 127a normal space character can be displayed in single quotes in either 128of the following ways: --- 7 unchanged lines hidden (view full) --- 136One way to prevent this special handling is by using the 137.Sq \e(dq 138escape sequence. 139.Pp 140Note that on text lines, literal double-quote characters can be used 141verbatim. 142All other quote-like characters can be used verbatim as well, 143even on request and macro lines. |
| 145.Ss Accents 146In output modes supporting such special output characters, for example 147.Fl T Cm pdf , 148some 149.Xr roff 7 150formatters convert the following ASCII input characters to the 151following Unicode special output characters: 152.Bl -column x(ga U+2018 -offset indent 153.It \(ga Ta U+2018 Ta left single quotation mark 154.It \(aq Ta U+2019 Ta right single quotation mark 155.It \(ti Ta U+02DC Ta small tilde 156.El 157.Pp 158In prose, this automatic substitution is often desirable; 159but when these characters have to be displayed as plain ASCII 160characters, for example in source code samples, they require 161escaping to render as follows: 162.Bl -column x(ga U+2018 -offset indent 163.It \e(ga Ta U+0060 Ta grave accent 164.It \e(aq Ta U+0027 Ta apostrophe 165.It \e(ti Ta U+007E Ta tilde 166.El | |
| 167.Ss Periods 168The period 169.Pq Sq \&. 170is handled specially at the beginning of an input line, 171where it introduces a 172.Xr roff 7 173request or a macro, and when appearing alone as a macro argument in 174.Xr mdoc 7 . --- 37 unchanged lines hidden (view full) --- 212.Em Special Characters 213subsection of the 214.Xr roff 7 215manual. 216.Pp 217Spacing: 218.Bl -column "Input" "Description" -offset indent -compact 219.It Em Input Ta Em Description | 144.Ss Periods 145The period 146.Pq Sq \&. 147is handled specially at the beginning of an input line, 148where it introduces a 149.Xr roff 7 150request or a macro, and when appearing alone as a macro argument in 151.Xr mdoc 7 . --- 37 unchanged lines hidden (view full) --- 189.Em Special Characters 190subsection of the 191.Xr roff 7 192manual. 193.Pp 194Spacing: 195.Bl -column "Input" "Description" -offset indent -compact 196.It Em Input Ta Em Description |
| 220.It Sq \e\ \& Ta unpaddable non-breaking space 221.It \e\(ti Ta paddable non-breaking space 222.It \e0 Ta unpaddable, breaking digit-width space 223.It \e| Ta one-sixth \e(em narrow space, zero width in nroff mode 224.It \e^ Ta one-twelfth \e(em half-narrow space, zero width in nroff | 197.It \e~ Ta non-breaking, non-collapsing space 198.It \e Ta breaking, non-collapsing n-width space 199.It \e^ Ta zero-width space 200.It \e% Ta zero-width space |
| 225.It \e& Ta zero-width space | 201.It \e& Ta zero-width space |
| 226.It \e% Ta zero-width space allowing hyphenation | 202.It \e| Ta zero-width space 203.It \e0 Ta breaking, non-collapsing digit-width space 204.It \ec Ta removes any trailing space (if applicable) |
| 227.El 228.Pp 229Lines: 230.Bl -column "Input" "Rendered" "Description" -offset indent -compact 231.It Em Input Ta Em Rendered Ta Em Description 232.It \e(ba Ta \(ba Ta bar 233.It \e(br Ta \(br Ta box rule 234.It \e(ul Ta \(ul Ta underscore | 205.El 206.Pp 207Lines: 208.Bl -column "Input" "Rendered" "Description" -offset indent -compact 209.It Em Input Ta Em Rendered Ta Em Description 210.It \e(ba Ta \(ba Ta bar 211.It \e(br Ta \(br Ta box rule 212.It \e(ul Ta \(ul Ta underscore |
| 235.It \e(rn Ta \(rn Ta overline | 213.It \e(rl Ta \(rl Ta overline |
| 236.It \e(bb Ta \(bb Ta broken bar 237.It \e(sl Ta \(sl Ta forward slash 238.It \e(rs Ta \(rs Ta backward slash 239.El 240.Pp 241Text markers: 242.Bl -column "Input" "Rendered" "Description" -offset indent -compact 243.It Em Input Ta Em Rendered Ta Em Description --- 46 unchanged lines hidden (view full) --- 290.It \e(dq Ta \(dq Ta double quote (text) 291.It \e(Fo Ta \(Fo Ta left guillemet 292.It \e(Fc Ta \(Fc Ta right guillemet 293.It \e(fo Ta \(fo Ta left single guillemet 294.It \e(fc Ta \(fc Ta right single guillemet 295.El 296.Pp 297Brackets: | 214.It \e(bb Ta \(bb Ta broken bar 215.It \e(sl Ta \(sl Ta forward slash 216.It \e(rs Ta \(rs Ta backward slash 217.El 218.Pp 219Text markers: 220.Bl -column "Input" "Rendered" "Description" -offset indent -compact 221.It Em Input Ta Em Rendered Ta Em Description --- 46 unchanged lines hidden (view full) --- 268.It \e(dq Ta \(dq Ta double quote (text) 269.It \e(Fo Ta \(Fo Ta left guillemet 270.It \e(Fc Ta \(Fc Ta right guillemet 271.It \e(fo Ta \(fo Ta left single guillemet 272.It \e(fc Ta \(fc Ta right single guillemet 273.El 274.Pp 275Brackets: |
| 298.Bl -column "xxbracketrightbtx" Rendered Description -offset indent -compact | 276.Bl -column "xxbracketrightbpx" Rendered Description -offset indent -compact |
| 299.It Em Input Ta Em Rendered Ta Em Description 300.It \e(lB Ta \(lB Ta left bracket 301.It \e(rB Ta \(rB Ta right bracket 302.It \e(lC Ta \(lC Ta left brace 303.It \e(rC Ta \(rC Ta right brace 304.It \e(la Ta \(la Ta left angle 305.It \e(ra Ta \(ra Ta right angle 306.It \e(bv Ta \(bv Ta brace extension 307.It \e[braceex] Ta \[braceex] Ta brace extension 308.It \e[bracketlefttp] Ta \[bracketlefttp] Ta top-left hooked bracket | 277.It Em Input Ta Em Rendered Ta Em Description 278.It \e(lB Ta \(lB Ta left bracket 279.It \e(rB Ta \(rB Ta right bracket 280.It \e(lC Ta \(lC Ta left brace 281.It \e(rC Ta \(rC Ta right brace 282.It \e(la Ta \(la Ta left angle 283.It \e(ra Ta \(ra Ta right angle 284.It \e(bv Ta \(bv Ta brace extension 285.It \e[braceex] Ta \[braceex] Ta brace extension 286.It \e[bracketlefttp] Ta \[bracketlefttp] Ta top-left hooked bracket |
| 309.It \e[bracketleftbt] Ta \[bracketleftbt] Ta bottom-left hooked bracket | 287.It \e[bracketleftbp] Ta \[bracketleftbp] Ta bottom-left hooked bracket |
| 310.It \e[bracketleftex] Ta \[bracketleftex] Ta left hooked bracket extension 311.It \e[bracketrighttp] Ta \[bracketrighttp] Ta top-right hooked bracket | 288.It \e[bracketleftex] Ta \[bracketleftex] Ta left hooked bracket extension 289.It \e[bracketrighttp] Ta \[bracketrighttp] Ta top-right hooked bracket |
| 312.It \e[bracketrightbt] Ta \[bracketrightbt] Ta bottom-right hooked bracket | 290.It \e[bracketrightbp] Ta \[bracketrightbp] Ta bottom-right hooked bracket |
| 313.It \e[bracketrightex] Ta \[bracketrightex] Ta right hooked bracket extension 314.It \e(lt Ta \(lt Ta top-left hooked brace 315.It \e[bracelefttp] Ta \[bracelefttp] Ta top-left hooked brace 316.It \e(lk Ta \(lk Ta mid-left hooked brace 317.It \e[braceleftmid] Ta \[braceleftmid] Ta mid-left hooked brace 318.It \e(lb Ta \(lb Ta bottom-left hooked brace | 291.It \e[bracketrightex] Ta \[bracketrightex] Ta right hooked bracket extension 292.It \e(lt Ta \(lt Ta top-left hooked brace 293.It \e[bracelefttp] Ta \[bracelefttp] Ta top-left hooked brace 294.It \e(lk Ta \(lk Ta mid-left hooked brace 295.It \e[braceleftmid] Ta \[braceleftmid] Ta mid-left hooked brace 296.It \e(lb Ta \(lb Ta bottom-left hooked brace |
| 319.It \e[braceleftbt] Ta \[braceleftbt] Ta bottom-left hooked brace | 297.It \e[braceleftbp] Ta \[braceleftbp] Ta bottom-left hooked brace |
| 320.It \e[braceleftex] Ta \[braceleftex] Ta left hooked brace extension 321.It \e(rt Ta \(rt Ta top-left hooked brace 322.It \e[bracerighttp] Ta \[bracerighttp] Ta top-right hooked brace 323.It \e(rk Ta \(rk Ta mid-right hooked brace 324.It \e[bracerightmid] Ta \[bracerightmid] Ta mid-right hooked brace 325.It \e(rb Ta \(rb Ta bottom-right hooked brace | 298.It \e[braceleftex] Ta \[braceleftex] Ta left hooked brace extension 299.It \e(rt Ta \(rt Ta top-left hooked brace 300.It \e[bracerighttp] Ta \[bracerighttp] Ta top-right hooked brace 301.It \e(rk Ta \(rk Ta mid-right hooked brace 302.It \e[bracerightmid] Ta \[bracerightmid] Ta mid-right hooked brace 303.It \e(rb Ta \(rb Ta bottom-right hooked brace |
| 326.It \e[bracerightbt] Ta \[bracerightbt] Ta bottom-right hooked brace | 304.It \e[bracerightbp] Ta \[bracerightbp] Ta bottom-right hooked brace |
| 327.It \e[bracerightex] Ta \[bracerightex] Ta right hooked brace extension 328.It \e[parenlefttp] Ta \[parenlefttp] Ta top-left hooked parenthesis | 305.It \e[bracerightex] Ta \[bracerightex] Ta right hooked brace extension 306.It \e[parenlefttp] Ta \[parenlefttp] Ta top-left hooked parenthesis |
| 329.It \e[parenleftbt] Ta \[parenleftbt] Ta bottom-left hooked parenthesis | 307.It \e[parenleftbp] Ta \[parenleftbp] Ta bottom-left hooked parenthesis |
| 330.It \e[parenleftex] Ta \[parenleftex] Ta left hooked parenthesis extension 331.It \e[parenrighttp] Ta \[parenrighttp] Ta top-right hooked parenthesis | 308.It \e[parenleftex] Ta \[parenleftex] Ta left hooked parenthesis extension 309.It \e[parenrighttp] Ta \[parenrighttp] Ta top-right hooked parenthesis |
| 332.It \e[parenrightbt] Ta \[parenrightbt] Ta bottom-right hooked parenthesis | 310.It \e[parenrightbp] Ta \[parenrightbp] Ta bottom-right hooked parenthesis |
| 333.It \e[parenrightex] Ta \[parenrightex] Ta right hooked parenthesis extension 334.El 335.Pp 336Arrows: 337.Bl -column "Input" "Rendered" "Description" -offset indent -compact 338.It Em Input Ta Em Rendered Ta Em Description 339.It \e(<- Ta \(<- Ta left arrow 340.It \e(-> Ta \(-> Ta right arrow --- 28 unchanged lines hidden (view full) --- 369.Bl -column "xxcoproductxx" "Rendered" "Description" -offset indent -compact 370.It Em Input Ta Em Rendered Ta Em Description 371.It \e(pl Ta \(pl Ta plus 372.It \e(mi Ta \(mi Ta minus 373.It \e- Ta \- Ta minus (text) 374.It \e(-+ Ta \(-+ Ta minus-plus 375.It \e(+- Ta \(+- Ta plus-minus 376.It \e[t+-] Ta \[t+-] Ta plus-minus (text) | 311.It \e[parenrightex] Ta \[parenrightex] Ta right hooked parenthesis extension 312.El 313.Pp 314Arrows: 315.Bl -column "Input" "Rendered" "Description" -offset indent -compact 316.It Em Input Ta Em Rendered Ta Em Description 317.It \e(<- Ta \(<- Ta left arrow 318.It \e(-> Ta \(-> Ta right arrow --- 28 unchanged lines hidden (view full) --- 347.Bl -column "xxcoproductxx" "Rendered" "Description" -offset indent -compact 348.It Em Input Ta Em Rendered Ta Em Description 349.It \e(pl Ta \(pl Ta plus 350.It \e(mi Ta \(mi Ta minus 351.It \e- Ta \- Ta minus (text) 352.It \e(-+ Ta \(-+ Ta minus-plus 353.It \e(+- Ta \(+- Ta plus-minus 354.It \e[t+-] Ta \[t+-] Ta plus-minus (text) |
| 377.It \e(pc Ta \(pc Ta center-dot | 355.It \e(pc Ta \(pc Ta centre-dot |
| 378.It \e(mu Ta \(mu Ta multiply 379.It \e[tmu] Ta \[tmu] Ta multiply (text) 380.It \e(c* Ta \(c* Ta circle-multiply 381.It \e(c+ Ta \(c+ Ta circle-plus 382.It \e(di Ta \(di Ta divide 383.It \e[tdi] Ta \[tdi] Ta divide (text) 384.It \e(f/ Ta \(f/ Ta fraction 385.It \e(** Ta \(** Ta asterisk 386.It \e(<= Ta \(<= Ta less-than-equal 387.It \e(>= Ta \(>= Ta greater-than-equal 388.It \e(<< Ta \(<< Ta much less 389.It \e(>> Ta \(>> Ta much greater 390.It \e(eq Ta \(eq Ta equal 391.It \e(!= Ta \(!= Ta not equal 392.It \e(== Ta \(== Ta equivalent 393.It \e(ne Ta \(ne Ta not equivalent | 356.It \e(mu Ta \(mu Ta multiply 357.It \e[tmu] Ta \[tmu] Ta multiply (text) 358.It \e(c* Ta \(c* Ta circle-multiply 359.It \e(c+ Ta \(c+ Ta circle-plus 360.It \e(di Ta \(di Ta divide 361.It \e[tdi] Ta \[tdi] Ta divide (text) 362.It \e(f/ Ta \(f/ Ta fraction 363.It \e(** Ta \(** Ta asterisk 364.It \e(<= Ta \(<= Ta less-than-equal 365.It \e(>= Ta \(>= Ta greater-than-equal 366.It \e(<< Ta \(<< Ta much less 367.It \e(>> Ta \(>> Ta much greater 368.It \e(eq Ta \(eq Ta equal 369.It \e(!= Ta \(!= Ta not equal 370.It \e(== Ta \(== Ta equivalent 371.It \e(ne Ta \(ne Ta not equivalent |
| 394.It \e(ap Ta \(ap Ta tilde operator 395.It \e(|= Ta \(|= Ta asymptotically equal 396.It \e(=\(ti Ta \(=~ Ta approximately equal 397.It \e(\(ti\(ti Ta \(~~ Ta almost equal 398.It \e(\(ti= Ta \(~= Ta almost equal | 372.It \e(=~ Ta \(=~ Ta congruent 373.It \e(-~ Ta \(-~ Ta asymptotically congruent 374.It \e(ap Ta \(ap Ta asymptotically similar 375.It \e(~~ Ta \(~~ Ta approximately similar 376.It \e(~= Ta \(~= Ta approximately equal |
| 399.It \e(pt Ta \(pt Ta proportionate 400.It \e(es Ta \(es Ta empty set 401.It \e(mo Ta \(mo Ta element 402.It \e(nm Ta \(nm Ta not element 403.It \e(sb Ta \(sb Ta proper subset 404.It \e(nb Ta \(nb Ta not subset 405.It \e(sp Ta \(sp Ta proper superset 406.It \e(nc Ta \(nc Ta not superset --- 46 unchanged lines hidden (view full) --- 453Accents: 454.Bl -column "Input" "Rendered" "Description" -offset indent -compact 455.It Em Input Ta Em Rendered Ta Em Description 456.It \e(a" Ta \(a" Ta Hungarian umlaut 457.It \e(a- Ta \(a- Ta macron 458.It \e(a. Ta \(a. Ta dotted 459.It \e(a^ Ta \(a^ Ta circumflex 460.It \e(aa Ta \(aa Ta acute | 377.It \e(pt Ta \(pt Ta proportionate 378.It \e(es Ta \(es Ta empty set 379.It \e(mo Ta \(mo Ta element 380.It \e(nm Ta \(nm Ta not element 381.It \e(sb Ta \(sb Ta proper subset 382.It \e(nb Ta \(nb Ta not subset 383.It \e(sp Ta \(sp Ta proper superset 384.It \e(nc Ta \(nc Ta not superset --- 46 unchanged lines hidden (view full) --- 431Accents: 432.Bl -column "Input" "Rendered" "Description" -offset indent -compact 433.It Em Input Ta Em Rendered Ta Em Description 434.It \e(a" Ta \(a" Ta Hungarian umlaut 435.It \e(a- Ta \(a- Ta macron 436.It \e(a. Ta \(a. Ta dotted 437.It \e(a^ Ta \(a^ Ta circumflex 438.It \e(aa Ta \(aa Ta acute |
| 461.It \e\(aq Ta \' Ta acute | 439.It \e' Ta \' Ta acute |
| 462.It \e(ga Ta \(ga Ta grave | 440.It \e(ga Ta \(ga Ta grave |
| 463.It \e\(ga Ta \` Ta grave | 441.It \e` Ta \` Ta grave |
| 464.It \e(ab Ta \(ab Ta breve 465.It \e(ac Ta \(ac Ta cedilla 466.It \e(ad Ta \(ad Ta dieresis 467.It \e(ah Ta \(ah Ta caron 468.It \e(ao Ta \(ao Ta ring | 442.It \e(ab Ta \(ab Ta breve 443.It \e(ac Ta \(ac Ta cedilla 444.It \e(ad Ta \(ad Ta dieresis 445.It \e(ah Ta \(ah Ta caron 446.It \e(ao Ta \(ao Ta ring |
| 469.It \e(a\(ti Ta \(a~ Ta tilde | 447.It \e(a~ Ta \(a~ Ta tilde |
| 470.It \e(ho Ta \(ho Ta ogonek 471.It \e(ha Ta \(ha Ta hat (text) 472.It \e(ti Ta \(ti Ta tilde (text) 473.El 474.Pp 475Accented letters: 476.Bl -column "Input" "Rendered" "Description" -offset indent -compact 477.It Em Input Ta Em Rendered Ta Em Description | 448.It \e(ho Ta \(ho Ta ogonek 449.It \e(ha Ta \(ha Ta hat (text) 450.It \e(ti Ta \(ti Ta tilde (text) 451.El 452.Pp 453Accented letters: 454.Bl -column "Input" "Rendered" "Description" -offset indent -compact 455.It Em Input Ta Em Rendered Ta Em Description |
| 478.It \e(\(aqA Ta \('A Ta acute A 479.It \e(\(aqE Ta \('E Ta acute E 480.It \e(\(aqI Ta \('I Ta acute I 481.It \e(\(aqO Ta \('O Ta acute O 482.It \e(\(aqU Ta \('U Ta acute U 483.It \e(\(aqa Ta \('a Ta acute a 484.It \e(\(aqe Ta \('e Ta acute e 485.It \e(\(aqi Ta \('i Ta acute i 486.It \e(\(aqo Ta \('o Ta acute o 487.It \e(\(aqu Ta \('u Ta acute u 488.It \e(\(gaA Ta \(`A Ta grave A 489.It \e(\(gaE Ta \(`E Ta grave E 490.It \e(\(gaI Ta \(`I Ta grave I 491.It \e(\(gaO Ta \(`O Ta grave O 492.It \e(\(gaU Ta \(`U Ta grave U 493.It \e(\(gaa Ta \(`a Ta grave a 494.It \e(\(gae Ta \(`e Ta grave e 495.It \e(\(gai Ta \(`i Ta grave i 496.It \e(\(gao Ta \(`i Ta grave o 497.It \e(\(gau Ta \(`u Ta grave u 498.It \e(\(tiA Ta \(~A Ta tilde A 499.It \e(\(tiN Ta \(~N Ta tilde N 500.It \e(\(tiO Ta \(~O Ta tilde O 501.It \e(\(tia Ta \(~a Ta tilde a 502.It \e(\(tin Ta \(~n Ta tilde n 503.It \e(\(tio Ta \(~o Ta tilde o | 456.It \e('A Ta \('A Ta acute A 457.It \e('E Ta \('E Ta acute E 458.It \e('I Ta \('I Ta acute I 459.It \e('O Ta \('O Ta acute O 460.It \e('U Ta \('U Ta acute U 461.It \e('a Ta \('a Ta acute a 462.It \e('e Ta \('e Ta acute e 463.It \e('i Ta \('i Ta acute i 464.It \e('o Ta \('o Ta acute o 465.It \e('u Ta \('u Ta acute u 466.It \e(`A Ta \(`A Ta grave A 467.It \e(`E Ta \(`E Ta grave E 468.It \e(`I Ta \(`I Ta grave I 469.It \e(`O Ta \(`O Ta grave O 470.It \e(`U Ta \(`U Ta grave U 471.It \e(`a Ta \(`a Ta grave a 472.It \e(`e Ta \(`e Ta grave e 473.It \e(`i Ta \(`i Ta grave i 474.It \e(`o Ta \(`i Ta grave o 475.It \e(`u Ta \(`u Ta grave u 476.It \e(~A Ta \(~A Ta tilde A 477.It \e(~N Ta \(~N Ta tilde N 478.It \e(~O Ta \(~O Ta tilde O 479.It \e(~a Ta \(~a Ta tilde a 480.It \e(~n Ta \(~n Ta tilde n 481.It \e(~o Ta \(~o Ta tilde o |
| 504.It \e(:A Ta \(:A Ta dieresis A 505.It \e(:E Ta \(:E Ta dieresis E 506.It \e(:I Ta \(:I Ta dieresis I 507.It \e(:O Ta \(:O Ta dieresis O 508.It \e(:U Ta \(:U Ta dieresis U 509.It \e(:a Ta \(:a Ta dieresis a 510.It \e(:e Ta \(:e Ta dieresis e 511.It \e(:i Ta \(:i Ta dieresis i --- 160 unchanged lines hidden (view full) --- 672.It \e*(<= Ta \*(<= Ta less-than-equal 673.It \e*(>= Ta \*(>= Ta greater-than-equal 674.It \e*(aa Ta \*(aa Ta acute 675.It \e*(ga Ta \*(ga Ta grave 676.It \e*(Px Ta \*(Px Ta POSIX standard name 677.It \e*(Ai Ta \*(Ai Ta ANSI standard name 678.El 679.Sh UNICODE CHARACTERS | 482.It \e(:A Ta \(:A Ta dieresis A 483.It \e(:E Ta \(:E Ta dieresis E 484.It \e(:I Ta \(:I Ta dieresis I 485.It \e(:O Ta \(:O Ta dieresis O 486.It \e(:U Ta \(:U Ta dieresis U 487.It \e(:a Ta \(:a Ta dieresis a 488.It \e(:e Ta \(:e Ta dieresis e 489.It \e(:i Ta \(:i Ta dieresis i --- 160 unchanged lines hidden (view full) --- 650.It \e*(<= Ta \*(<= Ta less-than-equal 651.It \e*(>= Ta \*(>= Ta greater-than-equal 652.It \e*(aa Ta \*(aa Ta acute 653.It \e*(ga Ta \*(ga Ta grave 654.It \e*(Px Ta \*(Px Ta POSIX standard name 655.It \e*(Ai Ta \*(Ai Ta ANSI standard name 656.El 657.Sh UNICODE CHARACTERS |
| 680The escape sequences | 658The escape sequence |
| 681.Pp | 659.Pp |
| 682.Dl \e[uXXXX] and \eC\(aquXXXX\(aq | 660.Dl \e[uXXXX] |
| 683.Pp | 661.Pp |
| 684are interpreted as Unicode codepoints. | 662is interpreted as a Unicode codepoint. |
| 685The codepoint must be in the range above U+0080 and less than U+10FFFF. | 663The codepoint must be in the range above U+0080 and less than U+10FFFF. |
| 686For compatibility, the hexadecimal digits 687.Sq A 688to 689.Sq F 690must be given as uppercase characters, 691and points must be zero-padded to four characters; if | 664For compatibility, points must be zero-padded to four characters; if |
| 692greater than four characters, no zero padding is allowed. 693Unicode surrogates are not allowed. | 665greater than four characters, no zero padding is allowed. 666Unicode surrogates are not allowed. |
| 667.\" .Pp 668.\" Unicode glyphs attenuate to the 669.\" .Sq \&? 670.\" character if invalid or not rendered by current output media. |
|
| 694.Sh NUMBERED CHARACTERS 695For backward compatibility with existing manuals, 696.Xr mandoc 1 697also supports the 698.Pp 699.Dl \eN\(aq Ns Ar number Ns \(aq 700.Pp 701escape sequence, inserting the character 702.Ar number 703from the current character set into the output. 704Of course, this is inherently non-portable and is already marked 705as deprecated in the Heirloom roff manual. | 671.Sh NUMBERED CHARACTERS 672For backward compatibility with existing manuals, 673.Xr mandoc 1 674also supports the 675.Pp 676.Dl \eN\(aq Ns Ar number Ns \(aq 677.Pp 678escape sequence, inserting the character 679.Ar number 680from the current character set into the output. 681Of course, this is inherently non-portable and is already marked 682as deprecated in the Heirloom roff manual. |
| 706For example, do not use \eN\(aq34\(aq, use \e(dq, or even the plain | 683For example, do not use \eN'34', use \e(dq, or even the plain |
| 707.Sq \(dq 708character where possible. 709.Sh COMPATIBILITY | 684.Sq \(dq 685character where possible. 686.Sh COMPATIBILITY |
| 710This section documents compatibility between mandoc and other | 687This section documents compatibility between mandoc and other other |
| 711troff implementations, at this time limited to GNU troff 712.Pq Qq groff . 713.Pp 714.Bl -dash -compact 715.It 716The \eN\(aq\(aq escape sequence is limited to printable characters; in 717groff, it accepts arbitrary character numbers. 718.It 719In 720.Fl T Ns Cm ascii , 721the 722\e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product], | 688troff implementations, at this time limited to GNU troff 689.Pq Qq groff . 690.Pp 691.Bl -dash -compact 692.It 693The \eN\(aq\(aq escape sequence is limited to printable characters; in 694groff, it accepts arbitrary character numbers. 695.It 696In 697.Fl T Ns Cm ascii , 698the 699\e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product], |
| 723\e[coproduct], \e(gr, \e(-h, and \e(a. special characters render | 700\e[coproduct], \e(gr, \e(\-h, and \e(a. special characters render |
| 724differently between mandoc and groff. 725.It 726In 727.Fl T Ns Cm html 728and 729.Fl T Ns Cm xhtml , | 701differently between mandoc and groff. 702.It 703In 704.Fl T Ns Cm html 705and 706.Fl T Ns Cm xhtml , |
| 730the \e(\(ti=, \e(nb, and \e(nc special characters render differently | 707the \e(~=, \e(nb, and \e(nc special characters render differently |
| 731between mandoc and groff. 732.It 733The 734.Fl T Ns Cm ps 735and 736.Fl T Ns Cm pdf 737modes format like 738.Fl T Ns Cm ascii --- 7 unchanged lines hidden (view full) --- 746.Xr mandoc 1 , 747.Xr man 7 , 748.Xr mdoc 7 , 749.Xr roff 7 750.Sh AUTHORS 751The 752.Nm 753manual page was written by | 708between mandoc and groff. 709.It 710The 711.Fl T Ns Cm ps 712and 713.Fl T Ns Cm pdf 714modes format like 715.Fl T Ns Cm ascii --- 7 unchanged lines hidden (view full) --- 723.Xr mandoc 1 , 724.Xr man 7 , 725.Xr mdoc 7 , 726.Xr roff 7 727.Sh AUTHORS 728The 729.Nm 730manual page was written by |
| 754.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . | 731.An Kristaps Dzonsons , 732.Mt kristaps@bsd.lv . |
| 755.Sh CAVEATS | 733.Sh CAVEATS |
| 756The predefined string | 734The |
| 757.Sq \e*(Ba | 735.Sq \e*(Ba |
| 758mimics the behaviour of the | 736escape mimics the behaviour of the |
| 759.Sq \&| 760character in 761.Xr mdoc 7 ; 762thus, if you wish to render a vertical bar with no side effects, use 763the 764.Sq \e(ba 765escape. | 737.Sq \&| 738character in 739.Xr mdoc 7 ; 740thus, if you wish to render a vertical bar with no side effects, use 741the 742.Sq \e(ba 743escape. |