
NOTE
====
If you have WindowMaker version 0.6.3 or older installed, take a look
at the NEWS file. 


If you have automake installed, be sure that it is at least 
version 1.2  or you'll get messages like:
make: *** No rule to make target `libPropList.a.c', needed by 
`libPropList.a.o'.  Stop.

Versions I have are:
autoconf 2.12
automake 1.2

You can get them from ftp://prep.ai.mit.edu or any mirror.

If you still get these errors even if your autoconf/automake versions
are up to date, you're probably using a broken installation from RedHat 4.2
You will need to get them (the original sources, not rpm) and reinstall.

If you do NOT have it installed, you don't need to worry about it
or install it at all.


SUPPORTED PLATFORMS 
===================
(eg: I've heard someone has compiled it on...)

- intel/Linux (primary platform)
- PowerPC/MkLinux
- FreeBSD
- Solaris 2.5.1, 2.5.2
- Solaris 2.6.0
- SCO Unix
- Irix
- OSF/1
- HP-UX
- AIX 4.1.4 / IBM PowerPC
Patches to make it work on other platforms are welcome.


REQUIREMENTS:
=============

The following software is required to run WindowMaker

- X11R6		
	WindowMaker can be compiled in older versions of X, like X11R5
	(Solaris) or X11R4 (OpenWindows) but it will not work 100% correctly.

- Tcl/Tk for the dialog window stuff


OPTIONAL:
=========

- libXPM 4.7 	
	Older versions may not work!!! 
	Available at ftp://sunsite.unc.edu/pub/Linux/libs/X/

- libpng 0.96 or newer and zlib     
	For PNG image support.

- libtiff 3.4 or newer
	For TIFF image support.
	You can get it at ftp://ftp.sgi.com/graphics/tiff

- libjpeg

Most of these can be get from ftp.uu.net/pub/graphics


CONFIGURE OPTIONS:
==================
--disable-xpm   disables use of the XPM library even if it is available on
	your system. 

--disable-png	disables use of PNG library

--disable-tiff 	disable use of TIFF library

--disable-jpeg 	disable use of JPEG library

--disable-shape  disables shaped windows (for oclock, xeyes etc.)

--enable-debug	adds extra debugging information. Do not use it
	unless you're debugging WindowMaker.
	
--enable-newstyle    uses a different style of buttons in titlebars.

--enable-kanji	support to display Kanji characters, Korean, Chinese 
		and other languagues

--enable-superfluous  adds some extra superfluous animations



PLATFORM SPECIFIC NOTES:
========================
- SCO Unix - run configure like
	CFLAGS="-belf -DANSICPP" ./configure 

- SunOS, Solaris 
	If you have gcc installed, after running configure, edit
	src/config.h and change the #define CPP_PATH line to
	#define CPP_PATH "gcc -E -x c"
	Sun's cpp lacks some features needed by WindowMaker and it can
	cause problems when parsing the config files.


INSTALLATION:
=============

If you have an older version of wrlib installed, manually remove the
wraster.h header file and libwraster.a from your system.

% gunzip -c libPropList.tar.gz | tar xf -
% cd libPropList
% ./configure
% make
% cd ..
% ./configure
% make
% su root
% make install
% exit
% wmaker.inst
add the script below in ~/.xinitrc or equivalent

# begin script
#
if [ -f ~/GNUstep/Library/WindowMaker/.workspace_state ]; then
	sh ~/GNUstep/Library/WindowMaker/.workspace_state &
fi
wmaker

# end script
#

After installing, each new user that wishes to use WindowMaker must run the 
wmaker.inst script and modify his/her ~/.xinitrc file.


LOCALES
=======
WindowMaker has national language support. 
To enable national language support, you must compile
WindowMaker with some additional parameters. 

0 - You must have the GNU gettext package installed. It can be
obtained at ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz

(Usually, you can skip the rest if you use the build script)

1 - You have to select the languages you want to support. Set the
LINGUAS to the list of locales you want. English is always
suported. Example:

setenv LINGUAS "pt ja de"
in csh

or

export LINGUAS;LINGUAS="pt ja de"
in sh

The list of supported locales is:

pt	Portuguese
jp	Japanese
de	German
es	Spanish
se	Swedish
ko	Korean
cz	Czech
nl	Dutch
fr	French
gl	Galician
it	Italian

Besides English, which is the default language.

Contact me if you'd wish to translate and maintain locale files 
for other languages.


2 - Additionally, if your language uses multi-byte characters, such
as Japanese or Korean, you must edit src/wconfig.h and define I18N_MB.


3 - Configure, build and install WindowMaker normally.


To select a particular locale at runtime you must set the LANG environment
variable to the locale you want. For example, if you want to
set the portuguese locale, you must run

setenv LANG pt

in csh or

export LANG; LANG=pt

in Bourne sh and similars

Note: If you have the LC_CTYPE environment variable set, you must
unset it before running wmaker.

For menu definition files, WindowMaker searches for them in the
following order (for brazilian portuguese, in this case):

menu.pt_BR
menu.pt
menu


TROUBLESHOOTING
===============

== Segmentation fault on startup

* Check if the version of libXPM you have is at least 4.7

== configure doesn't detect libXpm. 

* Check if you have a symbolic link from libXpm.so.4.9 to libXpm.so

== "...: your machine is misconfigured. gethostname() returned (none)"

* the hostname of your machine is set to something invalid, that starts
	with a parenthesis. Do a man hostname for info about how to set it.


== Multibyte I18N doesn't work

* Try to rebuild wmaker with the #define X_LOCALE in src/wconfig.h uncommented
or commented if it already was.

* Try other things noted in the FAQ

