Initial import from FreeBSD RELENG_4:
[dragonfly.git] / contrib / groff / font / devutf8 / NOTES
1 Note that all `charXXX' entity names have been removed from the font files.
2 They don't make sense for Unicode.
3
4 The following from the original troff manual (by Ossanna and Kernighan) is
5 unmapped:
6
7   \(bs    shaded solid ball (Bell System logo, AT&T logo)
8
9 Character 0x002D has not been given a name because its Unicode name
10 "HYPHEN-MINUS" is so ambiguous that it's unusable for serious typographic use.
11
12 The following, mentioned in the original troff manual, are only approximate:
13
14   \(lk    middle part of big left curly brace
15   \(rk    middle part of big right curly brace
16
17 \(wp has been mapped to 0x2118, because according to unicode.org's
18 NamesList-3.0.0.txt, U+2118 "SCRIPT CAPITAL P" is really a Weierstrass p,
19 neither SCRIPT not CAPITAL.
20
21 The following line could be added; "space" is known to "devps" but are not
22 documented and not known to "devdvi" (actually, there is no space glyph
23 within the TeX system).
24
25 space   24      0       0x0020
26
27 The following lines could be added, to define names which are known to e.g.
28 "devdvi" but are not known to "devps".
29
30 <<      24      0       0x226A
31 >>      24      0       0x226B
32
33 "devps" maps \(a~ and ~ to asciitilde, which is equivalent to 0x02DC, but
34 this glyph is just too small.  We map them to 0x007E instead.
35
36 "devps" maps \(a^ and ^ to circumflex, which is equivalent to 0x02C6, but
37 this glyph is just too small.  We map them to 0x005E instead.
38
39 "devps" maps *U to Upsilon1, which is equivalent to 0x03D2.  We map it to
40 0x03A5 instead.
41
42 "devps" maps *W to Omega, which is equivalent to either 0x2126 or 0x03A9.
43 We map it to 0x03A9.
44
45 "devps" maps *D to Delta, which is equivalent to either 0x2206 or 0x0394.
46 We map it to 0x0394.
47
48 "devps" maps CR to carriagereturn, which is equivalent to 0x21B5.  We map
49 it to 0x240D instead.
50
51
52 Using unnamed characters
53 ------------------------
54
55 Assume you want to use a Unicode character not provided in the list, say
56 U+20AC. You need to do two things:
57
58 - Add a line
59
60     --- 24      0       0x20AC
61
62   (the second column is computed as 24 * wcwidth(0x20AC)) to the file
63   R.proto, or, when groff is already installed, to the four fonts files in
64   $(prefix)/share/groff/<version>/font/devutf8/.
65
66 - In your source file, use the notation \N'8364' where 8364 is the decimal
67   representation of 0x20AC.