Sync usage with man page.
[netbsd-mini2440.git] / gnu / dist / groff / font / devutf8 / NOTES
blob8e724703ddc70e86356900573a8d3aa35118fd4f
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 entity from the original troff manual (by Ossanna and
5 Kernighan) is 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 is unusable for serious typographic
11 use.
13 \[wp] has been mapped to 0x2118, because according to Unicode 4.1's
14 NamesList.txt, U+2118 SCRIPT CAPITAL P is really a Weierstrass `p',
15 neither SCRIPT not CAPITAL.
17 The following line could be added; \[space] is known to devps but is not
18 documented and not known to devdvi (actually, there is no space glyph within
19 the TeX system).
21   space   24   0   0x0020
23 devps maps \[a~] and `~' to `asciitilde', which is equivalent to 0x02DC, but
24 this glyph is just too small.  We map them to 0x007E instead.
26 devps maps \[a^] and `^' to `circumflex', which is equivalent to 0x02C6, but
27 this glyph is just too small.  We map them to 0x005E instead.
29 devps maps \[*U] to `Upsilon1', which is equivalent to 0x03D2.  We map it to
30 0x03A5 instead.
32 devps maps \[*W] to `Omega', which is equivalent to either 0x2126 or 0x03A9.
33 We map it to 0x03A9.
35 devps maps \[*D] to `Delta', which is equivalent to either 0x2206 or 0x0394.
36 We map it to 0x0394.
39 Adding Unicode characters
40 -------------------------
42 Assume you want to use a Unicode character not provided in the list, say
43 U+20AC. You need to do two things:
45 - Add a line
47     u20AC   24   0   0x20AC
49   (the second column is computed as 24 * wcwidth(0x20AC)) to the file
50   R.proto, or, when groff is already installed, to the four fonts files in
51   $(prefix)/share/groff/<version>/font/devutf8/.
53 - In your source file, use the notation \[u20AC] to access it.