Add groff 1.19.1, stripped down appropriately.
[dragonfly.git] / contrib / groff-1.19 / 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 \(wp has been mapped to 0x2118, because according to unicode.org's
13 NamesList-3.0.0.txt, U+2118 "SCRIPT CAPITAL P" is really a Weierstrass p,
14 neither SCRIPT not CAPITAL.
15
16 The following line could be added; "space" is known to "devps" but are not
17 documented and not known to "devdvi" (actually, there is no space glyph
18 within the TeX system).
19
20 space   24      0       0x0020
21
22 "devps" maps \(a~ and ~ to asciitilde, which is equivalent to 0x02DC, but
23 this glyph is just too small.  We map them to 0x007E instead.
24
25 "devps" maps \(a^ and ^ to circumflex, which is equivalent to 0x02C6, but
26 this glyph is just too small.  We map them to 0x005E instead.
27
28 "devps" maps *U to Upsilon1, which is equivalent to 0x03D2.  We map it to
29 0x03A5 instead.
30
31 "devps" maps *W to Omega, which is equivalent to either 0x2126 or 0x03A9.
32 We map it to 0x03A9.
33
34 "devps" maps *D to Delta, which is equivalent to either 0x2206 or 0x0394.
35 We map it to 0x0394.
36
37
38 Using unnamed characters
39 ------------------------
40
41 Assume you want to use a Unicode character not provided in the list, say
42 U+20AC. You need to do two things:
43
44 - Add a line
45
46     --- 24      0       0x20AC
47
48   (the second column is computed as 24 * wcwidth(0x20AC)) to the file
49   R.proto, or, when groff is already installed, to the four fonts files in
50   $(prefix)/share/groff/<version>/font/devutf8/.
51
52 - In your source file, use the notation \N'8364' where 8364 is the decimal
53   representation of 0x20AC.