ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/README.configure
Revision: 1.11
Committed: Thu Mar 11 20:26:48 2004 UTC (20 years, 3 months ago) by pcg
Branch: MAIN
CVS Tags: rel-2_4, rel-2_5, rel-2_3
Changes since 1.10: +7 -0 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 pcg 1.11 General hint: if you get compile errors, then likely your configuration
2     hasn't been tested well. Either try with --enable-everything or use the
3     ./reconf script as a base for experiments. ./reconf is used by myself,
4     so it should generally be a working config. Of course, you should always
5     report when a combination doesn't work, so it cnya be fixed. Marc Lehmann
6     <rxvt@schmorp.de>.
7    
8 pcg 1.1 --enable-everything
9 pcg 1.7 add support for all non-multichoice options listed in "./configure
10     --help". Note that unlike other enable options this is order
11     dependant. You can specify this and then disable options which
12     this enables by _following_ this with the appropriate commands.
13 pcg 1.2 --enable-xft
14     add support for xft (anti-aliases, among others) fonts. xft fonts are
15     slower and require lots of memory, but as long as you don't use them,
16     you don't pay for them.
17     --with-codesets=NAME,...
18     compile in support for additional codeset groups:
19     jp common japanese encodings
20     jp_ext rarely used but big japanese encodings
21     kr korean encodings
22     cn common chinese encodings
23     cn_ext rarely used but very big chinese encodigs
24 pcg 1.7 all all of the above
25 pcg 1.8 --enable-xim
26     add support for XIM (X Input Method) protocol. This allows using
27     alternative input methods (e.g. kinput2) and will also correctly
28     set up the input for people using dead keys or compose keys.
29 pcg 1.2 --enable-unicode3
30 pcg 1.10 enable support for unicode codepoints above 65535 (the basic
31     multilingual page). This increases storage requirements per
32     character from 2 to 4 bytes. X11 fonts do not yet support these
33     extra characters, but Xft does.
34     --enable-combining
35     enable automatic composition of combining characters into
36     composite characters. This is required for proper viewing of text
37     where accents are encoded as seperate unicode characters. This is
38     done by using precomposited characters when available or creating
39     new pseudo-characters when no precomposed form exists. Without
40     --enable-unicode3, the number of additional precomposed characters
41     is rather limited (2048, if this is full, rxvt will use the
42     private use area, extending the number of combinations to
43     8448). With --enable-unicode3, no practical limit exists. This
44     will also enable storage of characters >16bit. They currently
45     won't display properly, but they will paste correctly.
46     The combining table also contains entries for arabic presentation
47     forms, but these are not currently used. Bug me if you want
48     these to be used.
49 pcg 1.8 --enable-fallback(=CLASS)
50     when reading resource settings, also read settings for class CLASS
51     (default: Rxvt). To disable resource fallback use --disable-fallback.
52     --with-res-name=NAME
53     use the given name (default: urxvt) as default application name
54     when reading resources. Specify --with-res-name=rxvt to replace
55     rxvt.
56     --with-res-class=CLASS
57     use the given class (default: URxvt) as default application class
58     when reading resources. Specify --with-res-class=Rxvt to replace
59     rxvt.
60 pcg 1.1 --enable-utmp
61     write user and tty to utmp file (used by programs like ``w'') at
62     start of rxvt execution and delete information when rxvt exits.
63     --enable-wtmp
64     write user and tty to wtmp file (used by programs like ``last'') at
65     start of rxvt execution and write logout when rxvt exits. This
66     option requires --enable-utmp to also be specified.
67     --enable-lastlog
68     write user and tty to lastlog file (used by programs like
69     ``lastlogin'') at start of rxvt execution. This option requires
70     --enable-utmp to also be specified.
71     --enable-xpm-background
72     add support for XPM background pixmaps
73     --enable-transparency
74     add support for inheriting parent backgrounds thus giving a fake
75     transparency to the term
76     --enable-menubar
77 pcg 1.7 add support for our menu bar system (this interacts badly with
78     dynamic locale switching currently)
79 pcg 1.1 --enable-rxvt-scroll
80     add support for the original rxvt scrollbar
81     --enable-next-scroll
82     add support for a NeXT-like scrollbar
83     --enable-xterm-scroll
84     add support for an Xterm-like scrollbar
85 pcg 1.5 --enable-plain-scroll
86 pcg 1.7 add support for a very unobtrusive, plain-looking scrollbar that
87     is the favourite of the rxvt-unicode author, having used it for
88     many years.
89 pcg 1.1 --enable-half-shadow
90     make shadows on the scrollbar only half the normal width & height.
91     only applicable to rxvt scrollbars
92     --enable-ttygid
93     change tty device setting to group "tty" - only use this if
94     your system uses this type of security
95     --disable-backspace-key
96     disable any handling of the backspace key by us - let the X server
97     do it
98     --disable-delete-key
99     disable any handling of the delete key by us - let the X server
100     do it
101     --disable-resources
102     remove all resources checking
103     --enable-xgetdefault
104     make resources checking via XGetDefault() instead of our small
105     version which only checks ~/.Xdefaults, or if that doesn't exist
106     then ~/.Xresources
107     --enable-strings
108     add support for our possibly faster memset() function and other
109     various routines, overriding your system's versions which may
110     have been hand-crafted in assembly or may require extra libraries
111 pcg 1.7 to link in. (this breaks ANSI-C rules and has problems on many
112     GNU/Linux systems).
113 pcg 1.1 --disable-swapscreen
114     remove support for swap screen
115     --enable-frills
116     add support for some lesser used features
117     --enable-linespace
118     add support to provide user specified line spacing between text rows
119     --enable-keepscrolling
120     add support for continual scrolling of the display when you hold
121     the mouse button down on a scrollbar arrow
122     --enable-mousewheel
123     add support for scrolling via mouse wheel or buttons 4 & 5
124 pcg 1.3 --enable-slipwheeling
125 pcg 1.1 add support for continual scrolling (using the mouse wheel as an
126     accelerator) while the control key is held down. This option
127     requires --enable-mousewheel to also be specified.
128     --enable-old-selection
129     remove support for reverting the mouse selection style to that
130     of v2.20 (and prior)
131     --disable-new-selection
132     remove support for mouse selection style like that of xterm
133     --enable-dmalloc
134     use Gray Watson's malloc - which is good for debugging
135     See http://www.letters.com/dmalloc/ for details
136     If you use either this or the next option, you may need to
137     edit src/Makefile after compiling to point DINCLUDE and DLIB to
138     the right places.
139     You can only use either this option and the following (should
140     you use either)
141     --enable-dlmalloc
142     use Doug Lea's malloc - which is good for a production version
143     See http://g.oswego.edu/dl/html/malloc.html for details
144     --enable-smart-resize
145     add smart growth/shrink behaviour when changing font size
146     via from hot keys. This should keep in a fixed position the
147     rxvt corner which is closest to a corner of the screen
148     --enable-256-color
149 pcg 1.3 add support for 256 colours rather than the base 16 colours
150 pcg 1.1 --enable-cursor-blink
151     add support for a blinking cursor
152     --enable-pointer-blank
153     add support to have the pointer disappear when typing or inactive
154 pcg 1.8 --with-name=NAME
155     set the basename for the installed binaries (default: urxvt, resulting
156     in urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt.
157 pcg 1.1 --with-term=NAME
158     change the environmental variable for the terminal to NAME
159 pcg 1.5 (default "rxvt")
160 pcg 1.1 --with-terminfo=PATH
161     change the environmental variable for the path to the terminfo
162     tree to PATH
163     --with-x
164     use the X Window System (pretty much default, eh?)
165     --with-xpm-includes=DIR
166     look for the XPM includes in DIR
167     --with-xpm-library=DIR
168     look for the XPM library in DIR
169     --with-xpm
170     not needed - define via --enable-xpm-background
171 pcg 1.7