2 Installation Instructions for Window Maker
8 (ie: I've heard someone has compiled it on...)
10 - Intel GNU/Linux Slackware 3.5 (primary platform)
11 - Intel GNU/Linux other distributions
12 - Sparc GNU/Linux RedHat 5.1
14 - Alpha GNU/Linux RedHat 5.1
19 - Solaris 2.5.1, 2.5.2
26 - AIX 4.1.4 / IBM PowerPC
27 - AIX 4.3.1 / IBM CC compiler
28 - AIX 4.3.2 / IBM PowerPC
30 - DEC Alpha/Digital UNIX 4.x
34 - PowerMac / Power MachTen 4.1.1 over MacOS
35 - Amiga 3000 running RedHat Linux 5.1 (Rawhide)
37 Patches to make it work on other platforms are welcome.
39 If the latest version doesn't work for you, try 0.19.3,
40 which is known to be pretty stable on many platforms.
46 The following software is required to use Window Maker:
49 Window Maker can be compiled in older versions of X, like X11R5
50 (Solaris) or X11R4 (OpenWindows) but it will not work 100% correctly.
51 In such servers there will not be application icons and you'll have
52 trouble using the dock. Upgrading the client libraries (Xlib, Xt etc)
53 will help if you can't upgrade the server.
55 The following is required to build Window Maker:
58 If you will build Window Maker, make sure you have gcc (or some
59 other ANSI C compiler) and the X header files installed. Specially
60 for newbie Linux users: you must install all X development packages
61 and the gcc suite. Otherwise you won't be able to build any X
62 program, including Window Maker.
65 This library can be found in ftp://ftp.windowmaker.org/pub/libs
66 or in ftp://ftp.gnome.org/pub/libPropList
67 Install it before building Window Maker.
69 - autoconf, automake and libtool
70 These tools are NOT needed, but IF you have one or
71 more of them installed, make sure you have ALL of the following
72 with exactly these versions:
76 If you have a different version, disable them by temporarily
77 renaming them to something else or uninstalling them from your
78 system. If you don't develop software you don't need them,
79 so you can safely uninstall.
81 - lex (or flex) and yacc (or bison)
82 These are used by libPropList. lex is actually not needed since
83 it's output file is included, but either me or automake is stupid,
84 causing the configure script for libPropList to simply abort for no
85 convincent reason if lex is not found.
91 These libraries are not required to make Window Maker work, but they
92 are supported in case you want to use them. Version numbers are those
93 that I have (and therefore, guraranteed to work), but other versions
98 Older versions may not work!!!
99 Available at ftp://sunsite.unc.edu/pub/Linux/libs/X/
101 There is builtin support for XPM files, but it will not
102 load images in some uncommon encodings.
104 - libpng 0.96 or newer and zlib
105 For PNG image support.
107 - libtiff 3.4 or newer
108 For TIFF image support.
109 You can get it at ftp://ftp.sgi.com/graphics/tiff
111 - libjpeg 6.0.1 or newer
112 For JPEG image support
114 - libgif 2.2 or libungif
115 For GIF image support
118 If you want to use translated messages, you will need GNU gettext.
119 Other versions of gettext are not compatible and will not work.
120 Get the GNU version from ftp://ftp.gnu.org
122 Most of these can be get from ftp.uu.net/pub/graphics
128 These options can be passed to the configure script to enable/disable
129 some Window Maker features. Example:
131 ./configure --enable-kanji
133 will configure Window Maker with kanji (and other multi-byte) characters
137 To get a list of other options, run ./configure --help
140 specify additional paths for libraries to be searched.
141 The -L flag must precede each path, like:
142 --with-libs-from="-L/opt/libs -L/usr/local/lib"
145 specify additional paths for header files to be searched.
146 The -I flag must precede each paths, like:
147 --with-incs-from="-I/opt/headers -I/usr/local/include"
150 support to display Kanji characters, Korean, Chinese and other
151 languagues that require special characters.
154 enables the collapsing of all appicons of the WM_CLASS+WM_INSTANCE
155 into a single one. This feature is not supported at all by the
156 developers. If you have some trouble with it, contact it's author:
157 Christopher Seawood <cls@seawood.org>
160 disable use of the MIT shared memory extension. This will slow down
161 texture generation a little bit, but in some cases it seems to be
162 necessary due to a bug that manifests as messed icons and textures.
165 disable support for mwm window manager hints
168 enable support for OPEN LOOK(tm) window manager hints
171 enable support for GNOME window manager hints
174 enable support for kde/kwm window manager hints
177 remove things that are already supported in desktop environments,
178 like KDE and GNOME. Disabled things are: window list, root
179 applications menu, multiple window selection. Note that you will not
180 be able to exit Window Maker from itself anymore; you will have to
181 use kill with the SIGTERM signal or exit it from KDE. It is not
182 advisable to enable it.
185 XKB language status lock support. If you don't know what it is you
186 probably don't need it.
189 enable support of sound effects module
192 disables use of the XPM library even if it is available on your
196 disables use of PNG library
199 disable use of TIFF library
202 disable use of GIF library
205 disable use of JPEG library
208 disables shaped windows (for oclock, xeyes etc.)
211 Do not use it unless you know what you're doing.
214 PLATFORM SPECIFIC NOTES:
215 ========================
218 You might need to pass the --disable-shm flag to configure, like
219 ./configure --disable-shm
221 - SCO Unix - run configure like
222 CFLAGS="-belf -DANSICPP" ./configure
225 If you have gcc installed, run configure as:
226 CPP_PATH="gcc -E -x c" ./configure
227 Sun's cpp lacks some features needed by Window Maker and it can
228 cause problems when parsing the config files.
229 You also might need to use the --with-libs-from and --with-incs-from
230 to supply the directory where libtiff is located.
231 Someone mailed me that you also must make /usr/local/lib be the
232 first path in LD_LIBRARY_PATH to make it work.
234 If you have a Ultra Creator 3D or some other machine with high-end
235 graphics, be sure to start the X server with the default visual
236 set to 24bpp or you might experience problems with mangled colors.
237 This is a wmaker bug and will be fixed.
239 - GNU/Linux in general
240 Make sure you have /usr/local/lib in /etc/ld.so.conf and that you
241 run ldconfig after installing.
242 Uninstall any packaged version of Window Maker before installing a new
246 RedHat systems have several annoying problems. If you use it,
247 be sure to follow the steps below or Window Maker will not work:
249 * if you installed the Window Maker that comes with RedHat, uninstall
252 * make sure you don't have the LANG and LINGUAS environment variables
255 * make sure you have /usr/local/bin in your PATH environment
258 * make sure you have /usr/local/lib in /etc/ld.so.conf before running
261 * if you have problems that mention an error message with --no-reexec
262 uninstall libtool-1.2b and install libtool-1.2 instead. libtool-1.2
263 can be found in ftp.gnu.org Also read the TROUBLESHOOTING section;
265 * if you installed the Window Maker package from RedHat and are
266 installing a new version of it by hand (compiling yourself), uninstall
267 the package from RedHat before.
269 * make sure you have a symbolic link from /usr/include/X11 to
270 /usr/X11R6/include/X11 (if not, type ln -s /usr/X11R6/include/X11
273 * make sure you have /lib/cpp pointing to the cpp program
275 If you have any doubts in doing any of the stuff above, please
276 don't hesitate to contact the RedHat user support. They will
277 kindly answer to all your questions regarding their system.
278 They also know much more about their own system than us
279 (we don't use RedHat).
283 You will need to have the latest version of Xpmac. Older versions
284 seem to have bugs that cause the system to hang.
287 If you want JPEG and TIFF support, make sure you have libtiff-dev
288 and libjpeg-dev installed.
291 If you installed the Window Maker package from SuSE,
292 uninstall it before trying to compile wmaker or you
295 - MetroX (unknown version)
296 MetroX has a bug that corrupts pixmaps that are set as window
297 backgrounds. If you use MetroX and has weird problems with
298 textures, do not use textures in titlebars. Or use a different
304 Unpack WindowMaker-extra-<version-number>.tar.gz in /usr/local/share
306 You can get the file at ftp://ftp.windowmaker.org. This file is optional
307 and only have a few icons, and themes. Look for the latest <version-number>
309 Also there is a WindowMaker-extra.readme to instruct you where that package
315 For a quick start, type the following in your shell prompt:
320 then, login as root and type:
325 or if you want to strip the debugging symbols from the binaries and make them
326 smaller, you can instead type:
331 This will build and install Window Maker with default parameters.
333 If you want to customize some compile-time options, you can do the
336 1. (optional) Look at the CONFIGURE OPTIONS section above for the
337 options available. Also run:
341 to get a complete listing of other options that are available.
343 2. Run configure with the options you want. For example, if you
344 want to use the --enable-kanji option, type:
346 ./configure --enable-kanji
348 3. (optional) Edit src/wconfig.h with your favorite text editor
349 and browse through it for some options you might want to change.
351 4. Compile. Just type:
355 5. Login as root (if you can't do that, read the "I don't have the
356 root password :-(" section) and install Window Maker in your system:
361 User specific configuration
362 ---------------------------
364 These instructions do not need to be followed when upgrading Window Maker
365 from an older version, unless stated differently in the NEWS file.
367 Every user on your system that wishes to run Window Maker must do the
370 1. Install Window Maker configuration files in your home directory.
374 wmaker.inst will install Window Maker configuration files and will
375 setup X to automatically launch Window Maker at startup.
379 You can type "man wmaker" to get some general help for configuration
382 Read the User Guide for a more in-depth explanation of Window Maker.
384 You might want to take a look at the FAQ too.
387 I don't have the root password :(
388 ---------------------------------
390 If you can't get superuser privileges (can't be root) you can install
391 wmaker in your own home directory. For that, supply the --prefix option
392 when running configure in step 2 of building Window Maker. You will
393 also need to supply the --with-appspath option, to specify the path for
396 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps
399 Then make /home/jshmoe/bin be included in your search PATH, add
400 /home/jshmoe/lib to your LD_LIBRARY_PATH environment variable and run
403 Of course, /home/jshmoe is supposed to be replaced with your actual home
411 If you are upgrading from an older version of Window Maker:
413 1. Configure and build Window Maker as always
414 2. Install Window Maker (but do not run wmaker.inst)
415 3. Read the NEWS file and update your configuration files,
421 When you have some trouble during configuration (while running configure),
422 like not being able to use a graphic format library you think you have
423 installed, look at the config.log file for clues of the problem.
426 == Error with loading fonts, even if they exist.
428 Try rebuilding without NLS support.
430 == Error when configuring
432 ltconfig: unrecognized option `--no-reexec'
433 Try `ltconfig --help' for more information.
434 configure: error: libtool configure failed
436 remove the --no-reexec option from aclocal.m4 and libPropList/aclocal.m4
438 Also make sure the autoconf and automake versions you have installed are:
443 Note that it must not be libtool 1.2b, it must be libtool 1.2,
446 == Cant find proplist.h or libPropList.something
448 Download and install libPropList from the places pointed to
449 somewhere else in this file.
452 == configure doesn't detect libtiff, or other graphic libraries.
454 Delete config.cache, then rerun configure adding the following options to
455 configure (among the other options you use):
456 --with-libs-from="-L/usr/local/lib"
457 --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
458 Put the paths where your graphic libs and their corresponding header files are
459 located. You can put multiple paths in any of these options, as the example
460 of --with-incs-from shows. Just put a space between them.
463 == configure doesn't detect libXpm.
465 * Check if you have a symbolic link from libXpm.so.4.9 to libXpm.so
468 == Segmentation fault on startup
470 * Check if the version of libXPM you have is at least 4.7
472 * Check if you have an updated version of ~/GNUstep/Defaults/WindowMaker
474 If you're not sure, try renaming ~/GNUstep to ~/GNUtmp and then run wmaker.inst
476 == "...: your machine is misconfigured. gethostname() returned (none)"
478 * the hostname of your machine is set to something invalid, that starts
479 with a parenthesis. Do a man hostname for info about how to set it.
482 == The root menu contains only 2 entries. ("XTerm" and "Exit...")
484 * Window Maker is not finding cpp (the C preprocessor). If your cpp is
485 not located in /lib/cpp, edit src/config.h and correct the path in
488 == checking lex output file root... configure: error: cannot find output from true; giving up
490 * Read the REQUIREMENTS section of this file.
493 LOCALES/INTERNATIONALIZATION
494 ============================
496 Window Maker has national language support. To enable national language
497 support, you must compile Window Maker with some additional parameters.
500 0 - You must have the GNU gettext package installed. It can be
501 obtained at ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
503 Steps 1 to 3 can be skipped if you use the Install script.
505 1 - You have to select the languages you want to support. Set the
506 LINGUAS to the list of locales you want. English is always
509 setenv LINGUAS "pt ja de"
514 export LINGUAS;LINGUAS="pt ja de"
517 The list of supported locales can be found in po/README.
518 English is the default language.
520 Read po/README if you wish to translate and maintain locale files
523 2 - Additionally, if your language uses multi-byte characters, such
524 as Japanese or Korean, you must supply the --enable-kanji flag to configure.
526 3 - Configure, build and install Window Maker normally.
528 4 - To select a particular locale at runtime you must set the LANG
529 environment variable to the locale you want. For example, if you want to set
530 the portuguese locale, you must run
538 in Bourne sh and similars
540 Note: If you have the LC_CTYPE environment variable set, you must
541 unset it before running wmaker.
543 For menu definition files, Window Maker searches for them in the
544 following order (for brazilian portuguese, in this case):
551 5 - If you chose a language that uses multi-byte characters, you must
552 configure the fonts appropriately. Read the manual page for XCreateFontSet
553 to have more details about it. You must change the ~/G/D/WindowMaker file
554 for fonts used in titlebars, menus and other things. For fonts used in
555 dialog windows, change ~/G/D/WMGLOBAL. The %d in the font names must not be
556 removed. You can also use the supplied wsetfont script for the task.
557 Read the script itself for instructions.
559 For example, you can specify the following in ~/G/D/WindowMaker:
561 WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
562 MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
563 MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
564 IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
565 ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
566 DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
568 and in ~/G/D/WMGLOBAL:
570 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
571 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
573 The above 2 fonts are only used by applications that use WINGs (WindowMaker