ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/README.unicode
Revision: 1.6
Committed: Wed Feb 25 12:38:30 2004 UTC (20 years, 3 months ago) by pcg
Branch: MAIN
CVS Tags: rel-2_1_0, rxvt-2-0, rel-2_4, rel-2_5, rel-2_2, rel-2_3, rel-2_0, rel-1-9, rel-1_9
Changes since 1.5: +11 -3 lines
Log Message:
*** empty log message ***

File Contents

# Content
1 Sketchy overview of the details:
2
3 - gcc-3.x is probably required to compile this release, g++-3.x, too, as it
4 has been re-written in C++ (and a corresponding version of libstdc++).
5
6 - the options used in the ./reconf script should work. everything else
7 might work and might be broken.
8
9 - wchar_t MUST be UNICODE or ISO-10646-1 on your system, or various things
10 will break down. On GNU/Linux, this is true for all locales, on Solaris,
11 this might be true only for locales ending in "@ucs", but you should
12 have plenty of them, as there should be a corresponding @ucs-locale for
13 every normal locale.
14
15 If you know details for other operating systems, please notify me (in
16 general, if your env defines __STDC_ISO_10646__ then everything should
17 be fine).
18
19 - rxvt will use unicode internally, but does input/output in the current
20 locale. so to get a utf-8 terminal, use "LC_CTYPE=en_US.UTF-8 rxvt" or
21 equivalent.
22
23 - you can specify a different locale to be used for your input method
24 using the imLocale ressource or switch, e.g.:
25 LC_CTYPE=ja_JP.UTF-8 rxvt -imlocale ja_JP.EUC-JP
26
27 - keyboard input is limited by the selected locale (and X's support for it),
28 tty input and output likewise. selection support is mostly independent
29 of the locale.
30
31 - "-fn" commandline switch and *.font ressource accepts a comma
32 seperated list of fontnames:
33
34 x:9x15bold a x11 font
35 9x15bold the same
36 xft:Andale Mono a xft font
37 xft:Andale Mono:pixelsize=20
38
39 - the _first_ font in the list selects the cell width/height. All other
40 fonts must be smaller or same sized, or they will be ignored or worse.
41 xft fonts will automatically be rescaled, x11-fonts, too, if their
42 size is not specified in the XLFD.
43
44 - the fonts will be tried in the order given when searching for a font
45 to display a specific character. if you are e.g. mainly interested in
46 japanese you might want to put a japanese font first to get the ascii
47 characters in it. If you are mainly interested in a text terminal and
48 only want to display other characters you should put a ascii/is8859 text
49 font first (e.g. "9x15bold") and let rxvt sort it out.
50
51 - xft fonts require gobs of memory and generally are slow. try not to
52 antialias them ("Font:antialias=false") when possible. Often looks
53 better, too, as they then match other fonts in weight.
54
55 - src/defaultfont.C lists the fallback fonts that are tried when a
56 character cannot be displayed with the current list of fonts.
57
58 - using bold fonts for the bold attribute is not supported by xft
59 and will not be supported by rxvt-unicode, either, even for normal x11
60 fonts.
61
62 - normal bold text will use reverse video unless the colorBD resource has
63 been set. coloured text will use high-intensity colours for bold.
64
65 Marc <rxvt@plan9.de>
66