Chapter 3. Compiling Pekwm

Table of Contents
3.1. Unpacking the Archive
3.2. Configuration Options
3.3. Building and installing

This chapter will help you get pekwm compiled.

3.1. Unpacking the Archive

The first step to compiling pekwm is to unpack the archive. Unpacking it depends on which version you downloaded:

tar -zxvf pekwm-0.1.12.tar.gz
tar -jxvf pekwm-0.1.12.tar.bz2

The '-j' option works normally on most linux systems, and as of the current GNU tar development version, is part of GNU tar. If your system does not support the -j option, you can use two things: bzip2 -dc pekwm-0.1.12.tar.bz2 | tar -xvf - or bzip2 -d pekwm-0.1.12.tar.bz2 followed by tar -xvf pekwm-0.1.12.tar. This also works for the .tar.gz version using gzip -dc or gzip -d.

The 'v' options are optional, they show you the filenames as they're being extracted. at this point, you should have a pekwm-0.1.12 directory. Use cd pekwm-0.1.12 to get there.

3.2. Configuration Options

The first thing to do is to run the configure script. This configures compile options for pekwm. Here are some of the more used options and what their default values are.

Important ./configure options:

--enable-shape

Enables the use of the Xshape extension for non-rectangular windows.

By default, Enabled

--enable-xinerama

Enables Xinerama multi screen support

By default, Enabled

--enable-xrandr

Enables RandR multi screen support

By default, Enabled

--enable-xft

Enables Xft font support in pekwm (themes).

By default, Enabled

--enable-image-xpm

XPM image support using libXpm.

By default, Enabled

--enable-image-jpeg

JPEG image support using libjpeg.

By default, Enabled

--enable-image-png

PNG image support using libpng.

By default, Enabled

--enable-debug

Enables debugging output

By default, Disabled

--enable-pedantic

Enables pedantic compile flags when using GCC

By default, Disabled

--enable-menus

Enables menu support (It's useful to turn this off if you rely completely on a desktop environment using the root window)

By default, Enabled

--enable-harbour

Enables the use of the harbour which is used to swallow Window Maker dockapps.

By default, Enabled

--prefix=PREFIX

It may be useful to use a custom prefix to install the files.

By default, /usr/local

3.3. Building and installing

After running ./configure with any options you need, run make. This should only take a few minutes. After that, become root (unless you used a prefix in your home directory, such as --prefix=/home/you/pkg) and type make install

Adding exec pekwm to ~/.xinitrc if you start X running startx or ~/.xsession if you use a display manager should usually be enough to get pekwm running.

That's it! pekwm is installed on your computer now. Next you should read the Getting Started chapter.