Use inotify to check for changes to the defaults database. Workaround for
[wmaker-crm.git] / INSTALL
Commit [+]AuthorDateLineData
9d2e6ef9 scottc1998-09-29 22:36:29 +00001
9af1c6c4 dan1998-10-21 14:43:47 +00002 Installation Instructions for Window Maker
9d2e6ef9 scottc1998-09-29 22:36:29 +00003
4
5
6SUPPORTED PLATFORMS
7===================
8(ie: I've heard someone has compiled it on...)
9
f813ff12 kojima2000-08-22 13:42:12 +000010- Intel GNU/Linux Conectiva 5.9 (beta)
11- Intel GNU/Linux Slackware
12- Intel GNU/Linux Debian
416e3a82 dan1999-01-25 19:06:50 +000013- Intel GNU/Linux other distributions
14- Sparc GNU/Linux RedHat 5.1
15- PowerPC GNU/MkLinux
16- Alpha GNU/Linux RedHat 5.1
9d2e6ef9 scottc1998-09-29 22:36:29 +000017- FreeBSD
0261c326 dan1999-01-06 15:22:33 +000018- NetBSD
931a37b1 dan1999-01-29 08:11:17 +000019- OpenBSD
714e2ef4 dan1999-05-01 23:46:27 +000020- BSDI 4.0
9d2e6ef9 scottc1998-09-29 22:36:29 +000021- Solaris 2.5.1, 2.5.2
22- Solaris 2.6.0
23- Solaris 2.7beta
e0f72841 dan2001-09-12 23:32:58 +000024- Solaris 2.8 on Ultra Sparc 10 and E450
9d2e6ef9 scottc1998-09-29 22:36:29 +000025- SCO Unix
088c0ac2 dan1999-03-09 14:58:01 +000026- SGI Irix 5.x, 6.5
9d2e6ef9 scottc1998-09-29 22:36:29 +000027- OSF/1
28- HP-UX
5e4625da kojima1999-05-29 21:41:25 +000029- AIX 3.2.5
9d2e6ef9 scottc1998-09-29 22:36:29 +000030- AIX 4.1.4 / IBM PowerPC
64d13678 dan1999-01-07 16:22:35 +000031- AIX 4.3.1 / IBM CC compiler
0261c326 dan1999-01-06 15:22:33 +000032- AIX 4.3.2 / IBM PowerPC
9af1c6c4 dan1998-10-21 14:43:47 +000033- AIX 5.3
9d2e6ef9 scottc1998-09-29 22:36:29 +000034- DEC Alpha/Digital UNIX 4.x
35- XFree86 / OS/2
59eb9475 dan1998-11-03 12:53:26 +000036- Corel NetWinder
9007a657 dan1998-11-23 11:32:19 +000037- SunOS 4.x
0261c326 dan1999-01-06 15:22:33 +000038- PowerMac / Power MachTen 4.1.1 over MacOS
416e3a82 dan1999-01-25 19:06:50 +000039- Amiga 3000 running RedHat Linux 5.1 (Rawhide)
f813ff12 kojima2000-08-22 13:42:12 +000040- IBM S/390 running Linux
fa994f62 kojima2001-08-20 18:11:40 +000041- IBM S/390 running Conectiva Linux (experimental)
581ab58f dan2000-10-28 01:45:29 +000042- iBook running Darwin
77b8fe05 dan2002-02-20 22:22:40 +000043- Darwin PPC / Macos X
ddde2296 dan2001-05-10 00:16:28 +000044- Windows NT with Cygwin/XFree86
882b9a8e kojima2001-07-23 20:31:32 +000045- Sony PlayStation2 running Linux
46
47All registered trademarks are registered by their owners. (duh)
9d2e6ef9 scottc1998-09-29 22:36:29 +000048
0261c326 dan1999-01-06 15:22:33 +000049Patches to make it work on other platforms are welcome.
50
9d2e6ef9 scottc1998-09-29 22:36:29 +000051
52REQUIREMENTS:
53=============
54
59eb9475 dan1998-11-03 12:53:26 +000055The following software is required to use Window Maker:
9d2e6ef9 scottc1998-09-29 22:36:29 +000056
57- X11R6.x
9af1c6c4 dan1998-10-21 14:43:47 +000058 Window Maker can be compiled in older versions of X, like X11R5
9d2e6ef9 scottc1998-09-29 22:36:29 +000059 (Solaris) or X11R4 (OpenWindows) but it will not work 100% correctly.
60 In such servers there will not be application icons and you'll have
9af1c6c4 dan1998-10-21 14:43:47 +000061 trouble using the dock. Upgrading the client libraries (Xlib, Xt etc)
62 will help if you can't upgrade the server.
9d2e6ef9 scottc1998-09-29 22:36:29 +000063
59eb9475 dan1998-11-03 12:53:26 +000064The following is required to build Window Maker:
65
66- Basic obvious stuff
45c55a3e kojima2004-10-23 00:00:58 +000067 gcc (or some other ANSI C compiler)
68 glibc development files (usually glibc-devel in Linux distributions)
69 X development files (XFree86-devel or something similar)
59eb9475 dan1998-11-03 12:53:26 +000070
cb320b2f dan1999-01-11 12:28:12 +000071- autoconf, automake and libtool
45c55a3e kojima2004-10-23 00:00:58 +000072 autoconf 2.54
73 automake 1.4
74 libtool 1.4.2
1e3a4037 kojima2004-10-18 01:37:17 +000075
45c55a3e kojima2004-10-23 00:00:58 +000076- Xft2
77 and its dependencies (such as freetype2 and fontconfig)
78 You will also need the development files for it (xft2-devel)
cb320b2f dan1999-01-11 12:28:12 +000079
9d2e6ef9 scottc1998-09-29 22:36:29 +000080
81OPTIONAL:
82=========
83
9af1c6c4 dan1998-10-21 14:43:47 +000084These libraries are not required to make Window Maker work, but they
9d2e6ef9 scottc1998-09-29 22:36:29 +000085are supported in case you want to use them. Version numbers are those
86that I have (and therefore, guraranteed to work), but other versions
0261c326 dan1999-01-06 15:22:33 +000087might work too.
9d2e6ef9 scottc1998-09-29 22:36:29 +000088
89
9af1c6c4 dan1998-10-21 14:43:47 +000090- libXPM 4.7 or newer
9d2e6ef9 scottc1998-09-29 22:36:29 +000091 Older versions may not work!!!
92 Available at ftp://sunsite.unc.edu/pub/Linux/libs/X/
93
94 There is builtin support for XPM files, but it will not
95 load images in some uncommon encodings.
96
97- libpng 0.96 or newer and zlib
98 For PNG image support.
54e241d2 kojima1999-09-22 02:03:39 +000099 http://www.cdrom.com/pub/png/
9d2e6ef9 scottc1998-09-29 22:36:29 +0000100
101- libtiff 3.4 or newer
102 For TIFF image support.
103 You can get it at ftp://ftp.sgi.com/graphics/tiff
104
9af1c6c4 dan1998-10-21 14:43:47 +0000105- libjpeg 6.0.1 or newer
9d2e6ef9 scottc1998-09-29 22:36:29 +0000106 For JPEG image support
54e241d2 kojima1999-09-22 02:03:39 +0000107 http://www.ijg.org/
9d2e6ef9 scottc1998-09-29 22:36:29 +0000108
109- libgif 2.2 or libungif
54e241d2 kojima1999-09-22 02:03:39 +0000110 For GIF image support
111 ftp://prtr-13.ucsc.edu/pub/libungif/
9d2e6ef9 scottc1998-09-29 22:36:29 +0000112
113- GNU xgettext
114 If you want to use translated messages, you will need GNU gettext.
115 Other versions of gettext are not compatible and will not work.
e7495baf dan1999-02-17 11:06:40 +0000116 Get the GNU version from ftp://ftp.gnu.org
9d2e6ef9 scottc1998-09-29 22:36:29 +0000117
9d2e6ef9 scottc1998-09-29 22:36:29 +0000118
119
120CONFIGURE OPTIONS:
121==================
122
56d85687
RP
Rodney Padgett2008-08-09 11:39:24 +0100123If you downloaded the cvs or git versions, type
124
125./autogen.sh
126
127to generate the config files.
128
9d2e6ef9 scottc1998-09-29 22:36:29 +0000129These options can be passed to the configure script to enable/disable
9af1c6c4 dan1998-10-21 14:43:47 +0000130some Window Maker features. Example:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000131
0c09179f dan2004-10-14 23:05:20 +0000132./configure --enable-modelock --disable-gif
9d2e6ef9 scottc1998-09-29 22:36:29 +0000133
0c09179f dan2004-10-14 23:05:20 +0000134will configure Window Maker with modelock supported and disable gif support.
45c55a3e kojima2004-10-23 00:00:58 +0000135Normally, you won't need any of them.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000136
9af1c6c4 dan1998-10-21 14:43:47 +0000137To get a list of other options, run ./configure --help
138
e7495baf dan1999-02-17 11:06:40 +0000139--with-libs-from
140 specify additional paths for libraries to be searched.
141 The -L flag must precede each path, like:
c56756dc dan1999-03-14 22:35:50 +0000142 --with-libs-from="-L/opt/libs -L/usr/local/lib"
e7495baf dan1999-02-17 11:06:40 +0000143
144--with-incs-from
145 specify additional paths for header files to be searched.
146 The -I flag must precede each paths, like:
c56756dc dan1999-03-14 22:35:50 +0000147 --with-incs-from="-I/opt/headers -I/usr/local/include"
e7495baf dan1999-02-17 11:06:40 +0000148
416e3a82 dan1999-01-25 19:06:50 +0000149--disable-shm
150 disable use of the MIT shared memory extension. This will slow down
151 texture generation a little bit, but in some cases it seems to be
152 necessary due to a bug that manifests as messed icons and textures.
0261c326 dan1999-01-06 15:22:33 +0000153
416e3a82 dan1999-01-25 19:06:50 +0000154--disable-motif
155 disable support for mwm window manager hints
0261c326 dan1999-01-06 15:22:33 +0000156
416e3a82 dan1999-01-25 19:06:50 +0000157--enable-lite
158 remove things that are already supported in desktop environments,
159 like KDE and GNOME. Disabled things are: window list, root
160 applications menu, multiple window selection. Note that you will not
161 be able to exit Window Maker from itself anymore; you will have to
162 use kill with the SIGTERM signal or exit it from KDE. It is not
163 advisable to enable it.
0261c326 dan1999-01-06 15:22:33 +0000164
416e3a82 dan1999-01-25 19:06:50 +0000165--enable-modelock
166 XKB language status lock support. If you don't know what it is you
167 probably don't need it.
9af1c6c4 dan1998-10-21 14:43:47 +0000168
416e3a82 dan1999-01-25 19:06:50 +0000169--disable-xpm
170 disables use of the XPM library even if it is available on your
171 system.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000172
416e3a82 dan1999-01-25 19:06:50 +0000173--disable-png
174 disables use of PNG library
9d2e6ef9 scottc1998-09-29 22:36:29 +0000175
416e3a82 dan1999-01-25 19:06:50 +0000176--disable-tiff
177 disable use of TIFF library
9d2e6ef9 scottc1998-09-29 22:36:29 +0000178
416e3a82 dan1999-01-25 19:06:50 +0000179--disable-gif
180 disable use of GIF library
9d2e6ef9 scottc1998-09-29 22:36:29 +0000181
416e3a82 dan1999-01-25 19:06:50 +0000182--disable-jpeg
183 disable use of JPEG library
9d2e6ef9 scottc1998-09-29 22:36:29 +0000184
416e3a82 dan1999-01-25 19:06:50 +0000185--disable-shape
186 disables shaped windows (for oclock, xeyes etc.)
9d2e6ef9 scottc1998-09-29 22:36:29 +0000187
9d2e6ef9 scottc1998-09-29 22:36:29 +0000188
189PLATFORM SPECIFIC NOTES:
190========================
e7495baf dan1999-02-17 11:06:40 +0000191
192- DEC/Alpha machines
f813ff12 kojima2000-08-22 13:42:12 +0000193
194#>>>>>>>>>>>
195From: Anton Ivanov <aivanov@eu.level3.net>
196To: Marcelo E. Magallon <mmagallo@debian.org>
197Subject: Re: Is the WindowMaker package working ok on Alpha?
198
199> Hi,
200>
201> I was reading some docs on the WindowMaker tarball, and found this:
202>
203> | - DEC/Alpha machines
204> | You might need to pass the --disable-shm flag to configure,
205> | like ./configure --disable-shm
206>
207> is anyone having problems with WindowMaker on Alpha? Can someone
208> please test this? Should the flag be passed when building on Alpha?
209
210Disclaimer: alphas under my command have never run X and are least likely to
211suddenly start running it anytime soon.
212
213 Alpha used to have some ridiculously low amount of shared memory
214configured.
215So quite a lot of apps used to barf. Namely - cdrecord, mysql server, etc.
216
217 Check where is yours at the moment and raise it to a more appropriate
218value by either catting to the appropriate /proc entry or changing the
219/usr/src/linux/include/asm/shmparam.h.
220
221 Otherwise the shared memory on alpha should be fully functional and I
222see no reason to disable it. Mine are bumped up to 32 or more on most
223machines.
224
225 And If I recall correctly the comments in that file are actually
226wrong. Value is not bytes, but in machine size word. For alpha *8.
227
228 As I said - I do not run X on them so all #include "stdisclaimer.h"
229apply.
230#<<<<<<<<<<<<
231
e7495baf dan1999-02-17 11:06:40 +0000232
9d2e6ef9 scottc1998-09-29 22:36:29 +0000233- SCO Unix - run configure like
234 CFLAGS="-belf -DANSICPP" ./configure
235
236- SunOS, Solaris
59eb9475 dan1998-11-03 12:53:26 +0000237 If you have gcc installed, run configure as:
238 CPP_PATH="gcc -E -x c" ./configure
9af1c6c4 dan1998-10-21 14:43:47 +0000239 Sun's cpp lacks some features needed by Window Maker and it can
9d2e6ef9 scottc1998-09-29 22:36:29 +0000240 cause problems when parsing the config files.
e7495baf dan1999-02-17 11:06:40 +0000241 You also might need to use the --with-libs-from and --with-incs-from
9af1c6c4 dan1998-10-21 14:43:47 +0000242 to supply the directory where libtiff is located.
e7495baf dan1999-02-17 11:06:40 +0000243 Someone mailed me that you also must make /usr/local/lib be the
244 first path in LD_LIBRARY_PATH to make it work.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000245
0261c326 dan1999-01-06 15:22:33 +0000246 If you have a Ultra Creator 3D or some other machine with high-end
247 graphics, be sure to start the X server with the default visual
248 set to 24bpp or you might experience problems with mangled colors.
416e3a82 dan1999-01-25 19:06:50 +0000249 This is a wmaker bug and will be fixed.
250
251- GNU/Linux in general
252 Make sure you have /usr/local/lib in /etc/ld.so.conf and that you
253 run ldconfig after installing.
e7495baf dan1999-02-17 11:06:40 +0000254 Uninstall any packaged version of Window Maker before installing a new
255 version.
416e3a82 dan1999-01-25 19:06:50 +0000256
257- RedHat GNU/Linux
258 RedHat systems have several annoying problems. If you use it,
259 be sure to follow the steps below or Window Maker will not work:
260
e7495baf dan1999-02-17 11:06:40 +0000261 * if you installed the Window Maker that comes with RedHat, uninstall
262 it before upgrading;
263
416e3a82 dan1999-01-25 19:06:50 +0000264 * make sure you don't have the LANG and LINGUAS environment variables
265 set to en_RN;
266
267 * make sure you have /usr/local/bin in your PATH environment
e7495baf dan1999-02-17 11:06:40 +0000268 variable;
416e3a82 dan1999-01-25 19:06:50 +0000269
270 * make sure you have /usr/local/lib in /etc/ld.so.conf before running
271 ldconfig;
272
9d2e6ef9 scottc1998-09-29 22:36:29 +0000273- PowerPC MkLinux
274 You will need to have the latest version of Xpmac. Older versions
275 seem to have bugs that cause the system to hang.
276
416e3a82 dan1999-01-25 19:06:50 +0000277- Debian GNU/Linux
9d2e6ef9 scottc1998-09-29 22:36:29 +0000278 If you want JPEG and TIFF support, make sure you have libtiff-dev
279 and libjpeg-dev installed.
abde3e0c dan1998-10-23 17:07:08 +0000280
416e3a82 dan1999-01-25 19:06:50 +0000281- SuSE GNU/Linux
abde3e0c dan1998-10-23 17:07:08 +0000282 If you installed the Window Maker package from SuSE,
283 uninstall it before trying to compile wmaker or you
284 might have problems.
285
9d2e6ef9 scottc1998-09-29 22:36:29 +0000286- MetroX (unknown version)
287 MetroX has a bug that corrupts pixmaps that are set as window
288 backgrounds. If you use MetroX and has weird problems with
289 textures, do not use textures in titlebars. Or use a different
290 X server.
291
9d2e6ef9 scottc1998-09-29 22:36:29 +0000292INSTALLATION:
293=============
294
9af1c6c4 dan1998-10-21 14:43:47 +0000295Build Window Maker
296------------------
297 For a quick start, type the following in your shell prompt:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000298
299 ./configure
300 make
301
302then, login as root and type:
303
304 make install
416e3a82 dan1999-01-25 19:06:50 +0000305 ldconfig
9d2e6ef9 scottc1998-09-29 22:36:29 +0000306
9af1c6c4 dan1998-10-21 14:43:47 +0000307or if you want to strip the debugging symbols from the binaries and make them
9d2e6ef9 scottc1998-09-29 22:36:29 +0000308smaller, you can instead type:
309
310 make install-strip
416e3a82 dan1999-01-25 19:06:50 +0000311 ldconfig
9d2e6ef9 scottc1998-09-29 22:36:29 +0000312
9af1c6c4 dan1998-10-21 14:43:47 +0000313This will build and install Window Maker with default parameters.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000314
315If you want to customize some compile-time options, you can do the
316following.
317
318 1. (optional) Look at the CONFIGURE OPTIONS section above for the
319 options available. Also run:
320
321 ./configure --help
322
323 to get a complete listing of other options that are available.
324
9d2e6ef9 scottc1998-09-29 22:36:29 +0000325 2. Run configure with the options you want. For example, if you
0c09179f dan2004-10-14 23:05:20 +0000326 want to use the --enable-modelock option, type:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000327
0c09179f dan2004-10-14 23:05:20 +0000328 ./configure --enable-modelock
9d2e6ef9 scottc1998-09-29 22:36:29 +0000329
330 3. (optional) Edit src/wconfig.h with your favorite text editor
331 and browse through it for some options you might want to change.
332
9af1c6c4 dan1998-10-21 14:43:47 +0000333 4. Compile. Just type:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000334
335 make
336
337 5. Login as root (if you can't do that, read the "I don't have the
9af1c6c4 dan1998-10-21 14:43:47 +0000338 root password :-(" section) and install Window Maker in your system:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000339 su root
340 make install
341
9af1c6c4 dan1998-10-21 14:43:47 +0000342
9d2e6ef9 scottc1998-09-29 22:36:29 +0000343User specific configuration
344---------------------------
345
9af1c6c4 dan1998-10-21 14:43:47 +0000346These instructions do not need to be followed when upgrading Window Maker
9d2e6ef9 scottc1998-09-29 22:36:29 +0000347from an older version, unless stated differently in the NEWS file.
348
9af1c6c4 dan1998-10-21 14:43:47 +0000349Every user on your system that wishes to run Window Maker must do the
9d2e6ef9 scottc1998-09-29 22:36:29 +0000350following:
351
9af1c6c4 dan1998-10-21 14:43:47 +0000352 1. Install Window Maker configuration files in your home directory.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000353Type:
354 wmaker.inst
355
9af1c6c4 dan1998-10-21 14:43:47 +0000356 wmaker.inst will install Window Maker configuration files and will
357setup X to automatically launch Window Maker at startup.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000358
9af1c6c4 dan1998-10-21 14:43:47 +0000359 That's it!
360
361 You can type "man wmaker" to get some general help for configuration
362and other stuff.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000363
9af1c6c4 dan1998-10-21 14:43:47 +0000364Read the User Guide for a more in-depth explanation of Window Maker.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000365
366You might want to take a look at the FAQ too.
367
368
1b587b01 dan2001-01-18 01:33:44 +0000369
370Installing the extras package
371-----------------------------
372
373Unpack WindowMaker-extra-<version-number>.tar.gz in /usr/local/share
374
90c0e656 dan2006-04-25 19:35:14 +0000375You can get the file at ftp://ftp.windowmaker.info. This file is optional
1b587b01 dan2001-01-18 01:33:44 +0000376and only have a few icons, and themes. Look for the latest <version-number>
377available.
378Also there is a WindowMaker-extra.readme to instruct you where that package
379should go.
380
381
382
9d2e6ef9 scottc1998-09-29 22:36:29 +0000383I don't have the root password :(
384---------------------------------
385
386If you can't get superuser privileges (can't be root) you can install
387wmaker in your own home directory. For that, supply the --prefix option
9af1c6c4 dan1998-10-21 14:43:47 +0000388when running configure in step 2 of building Window Maker. You will
389also need to supply the --with-appspath option, to specify the path for
390WPrefs.app Example:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000391
67a9ea74 dan2004-10-24 03:20:29 +0000392./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Applications
9d2e6ef9 scottc1998-09-29 22:36:29 +0000393
9d2e6ef9 scottc1998-09-29 22:36:29 +0000394
e7495baf dan1999-02-17 11:06:40 +0000395Then make /home/jshmoe/bin be included in your search PATH, add
396/home/jshmoe/lib to your LD_LIBRARY_PATH environment variable and run
9d2e6ef9 scottc1998-09-29 22:36:29 +0000397bin/wmaker.inst
398
e7495baf dan1999-02-17 11:06:40 +0000399Of course, /home/jshmoe is supposed to be replaced with your actual home
400directory path.
401
402
9d2e6ef9 scottc1998-09-29 22:36:29 +0000403
404UPGRADING
405=========
406
9af1c6c4 dan1998-10-21 14:43:47 +0000407If you are upgrading from an older version of Window Maker:
9d2e6ef9 scottc1998-09-29 22:36:29 +0000408
33cc542e dan2001-10-04 03:07:34 +0000409 1. Configure and build Window Maker as always
410 2. Install Window Maker (but do not run wmaker.inst)
411 3. Read the NEWS file and update your configuration files if necessary.
412
9d2e6ef9 scottc1998-09-29 22:36:29 +0000413
414TROUBLESHOOTING
415===============
416
417When you have some trouble during configuration (while running configure),
418like not being able to use a graphic format library you think you have
419installed, look at the config.log file for clues of the problem.
420
421
088c0ac2 dan1999-03-09 14:58:01 +0000422== Error with loading fonts, even if they exist.
423
424Try rebuilding without NLS support.
425
64d13678 dan1999-01-07 16:22:35 +0000426== Error when configuring
427
428ltconfig: unrecognized option `--no-reexec'
429Try `ltconfig --help' for more information.
430configure: error: libtool configure failed
431
33cc542e dan2001-10-04 03:07:34 +0000432remove the --no-reexec option from aclocal.m4 and reconfigure
416e3a82 dan1999-01-25 19:06:50 +0000433Also make sure the autoconf and automake versions you have installed are:
e7495baf dan1999-02-17 11:06:40 +0000434autoconf 2.13
435automake 1.4
5e4625da kojima1999-05-29 21:41:25 +0000436libtool 1.3
64d13678 dan1999-01-07 16:22:35 +0000437
5e4625da kojima1999-05-29 21:41:25 +0000438Note that it must not be libtool 1.2b, it must be libtool 1.3,
cb320b2f dan1999-01-11 12:28:12 +0000439from the GNU sites.
440
9d2e6ef9 scottc1998-09-29 22:36:29 +0000441== configure doesn't detect libtiff, or other graphic libraries.
442
443Delete config.cache, then rerun configure adding the following options to
444configure (among the other options you use):
e7495baf dan1999-02-17 11:06:40 +0000445--with-libs-from="-L/usr/local/lib"
446--with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
9d2e6ef9 scottc1998-09-29 22:36:29 +0000447Put the paths where your graphic libs and their corresponding header files are
448located. You can put multiple paths in any of these options, as the example
e7495baf dan1999-02-17 11:06:40 +0000449of --with-incs-from shows. Just put a space between them.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000450
451
452== configure doesn't detect libXpm.
453
454* Check if you have a symbolic link from libXpm.so.4.9 to libXpm.so
455
456
457== Segmentation fault on startup
458
459* Check if the version of libXPM you have is at least 4.7
460
461* Check if you have an updated version of ~/GNUstep/Defaults/WindowMaker
462
463If you're not sure, try renaming ~/GNUstep to ~/GNUtmp and then run wmaker.inst
464
465== "...: your machine is misconfigured. gethostname() returned (none)"
466
467* the hostname of your machine is set to something invalid, that starts
468 with a parenthesis. Do a man hostname for info about how to set it.
469
470
471== The root menu contains only 2 entries. ("XTerm" and "Exit...")
472
9af1c6c4 dan1998-10-21 14:43:47 +0000473* Window Maker is not finding cpp (the C preprocessor). If your cpp is
9d2e6ef9 scottc1998-09-29 22:36:29 +0000474not located in /lib/cpp, edit src/config.h and correct the path in
475CPP_PATH.
476
59eb9475 dan1998-11-03 12:53:26 +0000477== checking lex output file root... configure: error: cannot find output from true; giving up
478
479* Read the REQUIREMENTS section of this file.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000480
9af1c6c4 dan1998-10-21 14:43:47 +0000481
9d2e6ef9 scottc1998-09-29 22:36:29 +0000482LOCALES/INTERNATIONALIZATION
483============================
484
088c0ac2 dan1999-03-09 14:58:01 +0000485Window Maker has national language support. To enable national language
486support, you must compile Window Maker with some additional parameters.
487
9d2e6ef9 scottc1998-09-29 22:36:29 +0000488
4890 - You must have the GNU gettext package installed. It can be
490obtained at ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
491
492Steps 1 to 3 can be skipped if you use the Install script.
493
4941 - You have to select the languages you want to support. Set the
495LINGUAS to the list of locales you want. English is always
496suported. Example:
497
498setenv LINGUAS "pt ja de"
499in csh
500
501or
502
503export LINGUAS;LINGUAS="pt ja de"
504in sh
505
506The list of supported locales can be found in po/README.
507English is the default language.
508
509Read po/README if you wish to translate and maintain locale files
510for other languages.
511
5122 - Additionally, if your language uses multi-byte characters, such
f9a04a64 kojima1999-05-30 14:14:57 +0000513as Japanese or Korean, you must set the MultiByteText option to YES
f813ff12 kojima2000-08-22 13:42:12 +0000514in ~/GNUstep/Defaults/WMGLOBAL
9d2e6ef9 scottc1998-09-29 22:36:29 +0000515
9af1c6c4 dan1998-10-21 14:43:47 +00005163 - Configure, build and install Window Maker normally.
9d2e6ef9 scottc1998-09-29 22:36:29 +0000517
5184 - To select a particular locale at runtime you must set the LANG
519environment variable to the locale you want. For example, if you want to set
520the portuguese locale, you must run
521
522setenv LANG pt
523
524in csh or
525
526export LANG; LANG=pt
527
528in Bourne sh and similars
529
530Note: If you have the LC_CTYPE environment variable set, you must
531unset it before running wmaker.
532
9af1c6c4 dan1998-10-21 14:43:47 +0000533For menu definition files, Window Maker searches for them in the
9d2e6ef9 scottc1998-09-29 22:36:29 +0000534following order (for brazilian portuguese, in this case):
535
536menu.pt_BR
537menu.pt
538menu
539
540