A guide to configure, compile and install WINDOW MAKER from sources.
This manual is for Window Maker, version git#next.
Patches to make it work on other platforms are welcome.
The following software is required to use WINDOW MAKER:
Window Maker can be compiled in older versions of X, like X11R5 (Solaris) or X11R4 (OpenWindows) but it will not work 100% correctly. In such servers there will not be application icons and you’ll have trouble using the dock. Upgrading the client libraries (Xlib, Xt, etc.) will help if you can’t upgrade the server.
The following is required to build WINDOW MAKER:
Dependencies include freetype2 and fontconfig. You will also need the development files for them (xft2-devel). Sources are available at: http://www.freedesktop.org/wiki/Software/Xft/
Note: WINDOW MAKER is known to compile with gcc and clang; the code source is mostly ANSI C (also known as C89 and C90) but is uses very few of the C99 novelties; it also uses a few attributes introduced in the C11 standard but those are detected automatically, so most compilers should work.
If you want to compile using the sources from the git repository instead of the distribution package, you will also need:
These libraries are not required to make WINDOW MAKER work, but they are supported in case you want to use them. Version numbers are indicative, but other versions might work too.
Older versions may not work!
Available from http://xlibs.freedesktop.org/release/
There is built-in support for XPM files, but it will not load images in some uncommon encodings.
For PNG image support, http://www.libpng.org/pub/png/libpng.html
For TIFF image support, http://www.libtiff.org/
For JPEG image support, http://www.ijg.org/
Note that if you don’t have it, configure will issue a big warning in the end,
this is because JPEG images are often used in themes and for background images
so you probably want this format supported.
For GIF image support, http://giflib.sourceforge.net/
The reference library from Google for their image format, https://developers.google.com/speed/webp/download
If you want to use translated messages, you will need GNU gettext. Other versions of gettext are not compatible and will not work. Get the GNU version from http://www.gnu.org/software/gettext/
This library can be used by the WINGs toolkit to improve support for UTF-8 and for languages written in right-to-left direction, in some widgets. You have to explicitly ask for its support through (see Configure Options). You can get it from http://www.pango.org/Download
This library can be used by the WINGs utility library to make use of strlcat and
strlcpy instead of using built-in functions if your system does not provide them in its
core libc.
You should let WINDOW MAKER’s configure detect this for you.
You can get it from http://libbsd.freedesktop.org/wiki/
If you have Linux’s inotify support, WINDOW MAKER will use it to check for configuration updates instead of polling regularly the file. The needed header comes with the kernel, typical packages names include:
If found, then the library WRaster can use the ImageMagick library to let WINDOW MAKER support more image formats, like SVG, BMP, TGA, ... You can get it from http://www.imagemagick.org/
This library can be used by the WINGs utility toolkit to use a
Boehm-Demers-Weiser Garbage Collector instead of the traditional
malloc/free functions from the libc.
You have to explicitly ask for its support though (see Configure Options).
You can get it from http://www.hboehm.info/gc/
The latest version of WINDOW MAKER (-crm) can be downloaded from http://www.windowmaker.org/
Alternatively, the development branch, called #next is in the git repository at http://repo.or.cz/w/wmaker-crm.git
If you want to use the git versions, you can get it with:
git clone -b next git://repo.or.cz/wmaker-crm.git
then, assuming you have the dependencies listed in Special Dependencies, you have to type:
./autogen.sh
to generate the configuration script.
For a quick start, type the following in your shell prompt:
./configure make
then, login as root and type:
make install ldconfig
or if you want to strip the debugging symbols from the binaries to make them smaller, you can type instead:
make install-strip ldconfig
This will build and install WINDOW MAKER with default parameters.
If you want to customise some compile-time options, you can do the following:
./configure --help
to get a complete list of options that are available.
./configure --enable-modelock
make
su root make install
These instructions do not need to be followed when upgrading WINDOW MAKER from an older version, unless stated differently in the NEWS file.
Every user on your system that wishes to run WINDOW MAKER must do the following:
wmaker.inst
wmaker.inst will install WINDOW MAKER configuration files and will
setup X to automatically launch WINDOW MAKER at startup.
That’s it!
You can type man wmaker to get some general help for configuration
and other stuff.
Read the User Guide for a more in-depth explanation of WINDOW MAKER.
You might want to take a look at the FAQ too.
WINDOW MAKER has national language support. The procedure to enable national language support is described in the dedicated Enabling Languages support in README.i18n.
These options can be passed to the configure script to enable/disable some WINDOW MAKER features. Example:
./configure --enable-modelock --disable-gif
will configure WINDOW MAKER with modelock supported and disable gif support. Normally, you won’t need any of them.
To get the list of all options, run ./configure --help
The default installation path will be in the /usr/local hierarchy; a number of option can customise this:
Standard options from autoconf to define target paths, you probably want to read Installation Names in INSTALL.
More standard options from autoconf, today these are not used by WINDOW MAKER; they are provided automatically by autoconf for consistency.
Specific to WINDOW MAKER, defines the directory where WPrefs.app will be installed, if you want to install it like a GNUstep applications. If not specified, it will be installed like usual programs.
Specific to WINDOW MAKER, this option defines an additional path where pixmaps will be searched. Nothing will be installed there; the default path taken is DATADIR/pixmaps, where DATADIR is the path defined from --datadir.
Specific to WINDOW MAKER, defines the directory where system configuration files, e.g., WindowMaker, WMRootMenu, etc., are installed. The default value is SYSCONFDIR/WindowMaker, where SYSCONFDIR is the path defined from --sysconfdir.
Unless specifically written, configure will try to detect automatically for the libraries;
if you explicitly provide --enable-FEATURE then it will break with an error message
if the library cannot be linked;
if you specify --disable-FEATURE then it will not try to search for the library.
You can find more information about the libraries in the
Optional Dependencies.
Never enabled by default, use Boehm GC instead of the default libc malloc()
Disable GIF support in WRaster library; when enabled use libgif or libungif.
Disable JPEG support in WRaster library; when enabled use libjpeg.
Refuse use of the libbsd compatibility library in WINGs utility library, even if your system provides it.
Disable ImageMagick’s MagickWand support in WRaster, used to support for image formats.
Disabled by default, enable Pango text layout support in WINGs.
Disable PNG support in WRaster; when enabled use libpng.
Disable TIFF support in WRaster. when enabled use libtiff.
Disable WEBP support in WRaster. when enabled use libwebp.
Disable use of libXpm for XPM support in WRaster, use internal code instead.
The following options can be used to tell configure about extra paths that needs to be
used when compiling against libraries:
specify additional paths for libraries to be searched. The -L flag must precede each path, like:
--with-libs-from="-L/opt/libs -L/usr/local/lib"
specify additional paths for header files to be searched. The -I flag must precede each paths, like:
--with-incs-from="-I/opt/headers -I/usr/local/include"
configure will try to detect automatically the compilation paths for X11 headers and
libraries, and which X Extensions support can be enabled.
if you explicitly provide --enable-FEATURE then it will break with an error message
if the extension cannot be used;
if you specify --disable-FEATURE then it will not check for the extension.
Autoconf’s option to specify search paths for X11, for the case were it would not have been able to detect it automatically.
If you activated support for Native Languages, then X11 may use a hack to also configure its
locale support when the program configure the locale for itself.
The configure script detects if the Xlib supports this or not;
this options explicitly disable this initialisation mechanism.
XKB language status lock support. If you don’t know what it is you probably don’t need it. The default is to not enable it.
Disable use of the MIT shared memory extension. This will slow down texture generation a little bit, but in some cases it seems to be necessary due to a bug that manifests as messed icons and textures.
Disables support for shaped windows (for oclock, xeyes, etc.).
The Xinerama extension provides information about the different screens connected when running a multi-head setting (if you plug more than one monitor).
The RandR extension provides feedback when changing the multiple-monitor configuration in X11 and allows to re-configure how screens are organised.
At current time, it is not enabled by default because it is NOT recommended (buggy); WINDOW MAKER only restart itself when the configuration change, to take into account the new screen size.
Disable animations permanently, by not compiling the corresponding code into WINDOW MAKER. When enabled (the default), you still have a run-time configuration option in WPrefs.
Disable support for Motif’s MWM Window Manager hints. These attributes were introduced by the Motif toolkit to ask for special window appearance requests. Nowadays this is covered by the NetWM/EWMH specification, but there are still applications that rely on MWM Hints.
Add support for the ICCCM protocol for cooperative window manager replacement. This feature is disabled by default because you probably don’t need to switch seamlessly the window manager; if you are making a package for a distribution you’d probably want to enable this because it allows users to give a try to different window managers without restarting everything for an extra cost that is not really big.
Disable support for dragging and dropping files on the dock, which launches a user-specified command with that file. Starting from version 0.65.6 this feature is enabled by default.
This feature is auto-detected, and you should not use this option. When compiling a library (wrlib, ...), gcc has the possibility to filter the list of functions that will be visible, to keep only the public API, because it helps running programs faster.
The configure script checks if this feature is available;
if you specify this option it will not check anymore and blindly trust you that it is supposed to
work, which is not a good idea as you may encounter problems later when compiling.
This feature, disabled by default, allows to add a user-defined custom menu to applications; when choosing an entry of the menu it will send the key combination defined by the user to that application. See Application User Menu in NEWS for more information.
Selection of the domain used for translation of the menus; see Translations for Menus in README.i18n.
These options are disabled by default:
If you intend to re-run the configure script often, you probably want to include this
option, so it will save and re-use the status of what have been detected in the file
config.cache.
Enable debugging features (debug symbol, some extra verbosity and checks) and add a number of check flags (warnings) for the compiler (in gcc fashion).
Enable generation of code coverage and profiling data; if the DIRECTORY is not specified, use coverage-report.
This option was meant to be use with gcc;
it was not used recently so it is probable that is does not work anymore;
the configure script will not even check that your compiling environment has the
appropriate requirements and works with this.
Despite all this, if you think there’s a use for it and feel in the mood to help, do not hesitate to
discuss on the mailing list wmaker-dev@lists.windowmaker.org to get it working.
Make sure you have /usr/local/lib in /etc/ld.so.conf and that you
run ldconfig after installing.
Uninstall any packaged version of WINDOW MAKER before installing a new version.
RedHat systems have several annoying problems. If you use it, be sure to follow the steps below or WINDOW MAKER will not work:
PATH environment variable;
ldconfig;
You will need to have the latest version of Xpmac. Older versions seem to have bugs that cause the system to hang.
If you want JPEG and TIFF support, make sure you have libtiff-dev and libjpeg-dev installed.
If you installed the WINDOW MAKER package from SuSE, uninstall it before trying to compile Window Maker or you might have problems.
MetroX has a bug that corrupts pixmaps that are set as window backgrounds. If you use MetroX and have weird problems with textures, do not use textures in title bars. Or use a different X server.
If you can’t get superuser privileges (can’t be root) you can install Window Maker in your own
home directory.
For that, supply the --prefix option when running configure in step 2 of building
WINDOW MAKER.
You will also need to supply the --with-gnustepdir option, to specify the path for
WPrefs.app.
Example:
./configure --prefix=/home/jshmoe --with-gnustepdir=/home/jshmoe/GNUstep/Applications
Then make /home/jshmoe/bin be included in your search PATH, add /home/jshmoe/lib
to your LD_LIBRARY_PATH environment variable and run bin/wmaker.inst
Of course, /home/jshmoe is supposed to be replaced by your actual home directory path.
If you are upgrading from an older version of WINDOW MAKER:
wmaker.inst)
When you have some trouble during configuration (while running configure), like not being able to use a graphic format library you think you have installed, look at the config.log file for clues of the problem.
This is probably a problem with NLS (Native Language Support), you probably want to look at the Troubleshooting in README.i18n or try rebuilding without NLS support, which is done with:
./configure LINGUAS=""
Delete config.cache, then rerun configure adding the following options to configure
(among the other options you use):
--with-libs-from="-L/usr/local/lib" --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
Put the paths where your graphic libs and their corresponding header files are located. You can put multiple paths in any of these options, as the example of --with-incs-from shows. Just put a space between them.
Check if you have a symbolic link from libXpm.so.4.9 to libXpm.so
If you’re not sure, try renaming ~/GNUstep to ~/GNUtmp
and then run wmaker.inst
the host name of your machine is set to something invalid, that starts with a parenthesis.
Do a man hostname for info about how to set it.
WINDOW MAKER could not read your menu definition file.
You should check the output of wmaker for an error, it may be visible in the console or in the
.xsession-errors file.