ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/README.unicode
(Generate patch)

Comparing rxvt-unicode/README.unicode (file contents):
Revision 1.1 by pcg, Mon Nov 24 17:28:07 2003 UTC vs.
Revision 1.9 by root, Sat Aug 14 19:38:27 2004 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines