@node Installation, Usage, Introduction, Top
@comment  node-name,  next,  previous,  up
@chapter Installation

@menu
* Supported Platforms::         
* System Requirements::         
* configure Options::           
* Invokation::                  
@end menu

@node Supported Platforms, System Requirements, Installation, Installation
@comment  node-name,  next,  previous,  up
@section Supported Platforms

@itemize @minus
@item Linux (Intel)
@item FreeBSD
@item SunOS 4.1
@end itemize

Patches to make it work on other platforms are welcome.

@node System Requirements, configure Options, Supported Platforms, Installation
@comment  node-name,  next,  previous,  up
@section System Requirements

@itemize @minus
@item libXPM 4.7 (or greater)
@item X server capable of displaying in 8bpp or better
@item @TeX{} and DviPS (if you want to produce a printed manual) [optional]
@item TeXi2HTML (for documentation in HTML format) [optional] 
@item MakeInfo (GNU Info Hypertext Document) [optional] 
@end itemize

@node configure Options, Invokation, System Requirements, Installation
@comment  node-name,  next,  previous,  up
@section Configure Options

@table @samp
@item --enable-xpm   
enables the use of the XPM library (if it is available) on your system
@item --enable-shape  
enables shaped windows (for oclock, xeyes etc.)
@item --enable-debug	
adds extra debugging information. Do not use it unless you intend to debug WindowMaker
@end table

@node Invokation,  , configure Options, Installation
@comment  node-name,  next,  previous,  up
@section Invokation

Usually you invoke the window manager during the startup of your X
session.  This is done by placing a call to @file{wmaker} in your
@file{.xinitrc} or @file{.xsession} file.

@noindent For example

@example
xterm &
wmaker
@end example
@sp 1
or
@sp 1
@example
wmaker &
xterm
@end example


The first example makes @file{wmaker} the "magic" client for the
session, which means that when you exit WindowMaker, your X session
will be closed.  The second example makes @file{xterm} the "magic"
client. This is preferable, at least until WindowMaker get's
sufficiently stable.  This will have the benefit that should your
Window Manager crash, your X window session will not be closed and you
are more likely not to loose any work.

The following command-line options are supported:
@sp 1
@table @asis
@item @t{-nocpp}
disables use of cpp to preprocess configuration files (menu and
preferences). If you use this option, you must make sure that the
configuration files do not use any feature of the preprocessor, like
@file{#include} statements.
@sp 1
@item @t{-nodock}
disables the dock and docking operations.
@sp 1
@item @t{-display <display>}
specifies the display where WindowMaker should be opened.
@sp 1
@item @t{-version}
prints version number and exits 
@end table


@c ********************************
@c *** end installation section ***
@c ********************************

