* aclocal.m4 (GROFF_EBCDIC): Don't include `font/devutf8' in
[s-roff.git] / font / devutf8 / NOTES
blob12a736f9ddcaaea1a28667b017aa4f04fbfde725
1 Note that all `charXXX' entity names have been removed from the font files.
2 They don't make sense for Unicode.
4 The following from the original troff manual (by Ossanna and Kernighan) is
5 unmapped:
7                 \(bs    shaded solid ball (Bell System logo, AT&T logo)
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.
12 The following, mentioned in the original troff manual, are only approximate:
14                 \(lk    middle part of big left curly brace
15                 \(rk    middle part of big right curly brace
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.
21 The following lines could be added, to define names which are known to
22 "devps" but are not documented and not known to "devdvi".
23 space   24      0       0x0020
24 vS      24      0       0x0160
25 vs      24      0       0x0161
26 :Y      24      0       0x0178
27 vZ      24      0       0x017D
28 vz      24      0       0x017E
29 3d      24      0       0x2234
30 nb      24      0       0x2284
31 product 24      0       0x220F
32 sum     24      0       0x2211
33 SP      24      0       0x2660
34 CL      24      0       0x2663
35 HE      24      0       0x2665
36 DI      24      0       0x2666
38 The following lines could be added, to define names which are known to e.g.
39 "devdvi" but are not known to "devps".
40 <<      24      0       0x226A
41 >>      24      0       0x226B
43 "devps" maps \(a~ and ~ to asciitilde, which is equivalent to 0x02DC, but
44 this glyph is just too small. We map them to 0x007E instead.
46 "devps" maps \(a^ and ^ to circumflex, which is equivalent to 0x02C6, but
47 this glyph is just too small. We map them to 0x005E instead.
49 "devps" maps *U to Upsilon1, which is equivalent to 0x03D2. We map it to
50 0x03A5 instead.
52 "devps" maps *W to Omega, which is equivalent to either 0x2126 or 0x03A9. We
53 map it to 0x03A9.
55 "devps" maps *D to Delta, which is equivalent to either 0x2206 or 0x0394. We
56 map it to 0x0394.
58 "devps" maps CR to carriagereturn, which is equivalent to 0x21B5. We map it
59 to 0x240D instead.
61 Using unnamed characters:
63 Assume you want to use a Unicode character not provided in the list, say
64 U+20AC. You need to do two things:
66 - Add a line
68     --- 24      0       0x20AC
70   (the second column is computed as 24 * wcwidth(0x20AC)) to the file
71   R.proto, or, when groff is already installed, to the four fonts files in
72   $(prefix)/share/groff/<version>/font/devutf8/.
74 - In your source file, use the notation \N'8364' where 8364 is the decimal
75   representation of 0x20AC.