1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314
|
SUPPORTED PLATFORMS
===================
(eg: I've heard someone has compiled it on...)
- intel/Linux (primary platform)
- PowerPC/MkLinux (have problems with dialog windows)
- 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 use WindowMaker
- X11R6
WindowMaker can be compiled in older versions of X, like X11R5
(Solaris) or X11R4 (OpenWindows) but it will not work 100% correctly.
OPTIONAL:
=========
These libraries are not required to make WindowMaker work, but they
are supported in case you want to use them.
- 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:
==================
These options can be passed to the configure script to enable/disable
some WindowMaker features. Example:
./configure --enable-newstyle
will configure WindowMaker with the newstyle option compiled in.
--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
--with-x-locale uses X locale emulation instead of OS locale.
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.
- DEC Alpha - Digital Unix
DEC's lex and yacc doesnt seem to work with libproplist.
You might need to get GNU's flex and bison to compile it.
INSTALLATION:
=============
Unpack WindowMaker-data.tar.gz and move the pixmaps directory in it
to /usr/local/share/pixmaps
You can get the file at http://windowmaker.org
Build libPropList
-----------------
libPropList is included with the distribution, so you don't
need to download it anywhere (some people have asked me this...)
But if you already have libPropList installed on you system you
can skip this step, since configure will detect that and use the
installed version first if available.
To build libPropList, simply type the following at the shell prompt:
gunzip -c libPropList.tar.gz | tar xf -
cd libPropList
./configure
make
make install (eventually)
cd ..
Build WindowMaker
-----------------
If this is the first time you're building WindowMaker, you can
simply type:
./configure
make
then, login as root and type:
make install
This will build and install WindowMaker with default parameters.
If you want to customize some compile-time options, you can do the
following.
1. (optional) Look at the CONFIGURE OPTIONS section above for the
options available. Also run:
./configure --help
to get a complete listing of other options that are available.
2. Run configure with the options you want. For example, if you
to use the --enable-superfluous option, type:
./configure --enable-superfluous
3. (optional) Edit src/wconfig.h with your favorite text editor
and browse through it for some options you might want to change.
4. Compile WindoMaker. Just type:
make
5. Login as root and install WindowMaker in your system. Again, type:
su root
make install
User specific configuration
---------------------------
Every user on your system that wishes to run WindowMaker must do the
following:
1. Install WindowMaker configuration files in your home directory.
Type:
wmaker.inst
wmaker.inst will install WindowMaker configuration files and will
setup X to automatically launch WindowMaker at startup. It also does
the necessary steps to make the "Save Workspace" command work.
That's it! The configuration file where you can edit your preferences
if $HOME/GNUstep/Defaults/WindowMaker.
The $HOME/GNUstep/Defaults/WMWindowAttributes file is where you assign
icons to applications and edit some other attributes for windows.
The $HOME/GNUstep/Library/WindowMaker/menu file is the definition of the
root menu. Edit it according to the applications you have installed.
Read the User Guide for a more in depth explanation of WindowMaker.
The User Guide is avaiable at http://windowmaker.org
You might want to take a look at the FAQ too.
TROUBLESHOOTING
===============
== Error during build of libPropList
make: *** No rule to make target `libPropList.a.c', needed by
`libPropList.a.o'. Stop.
Make sure the autoconf and automake versions you have installed are at
least:
autoconf 2.12
automake 1.2
If you are using the RPM's that come with RedHat 4.x, don't use them.
It is broken. Uninstall the RPM and reinstall a fresh package from
You can get them from ftp://prep.ai.mit.edu or any mirror.
== Segmentation fault on startup
* Check if the version of libXPM you have is at least 4.7
* Check if you have an updated version of ~/GNUstep/Defaults/WindowMaker
If you're not sure, try renaming ~/GNUstep to ~/GNUtmp and then run wmaker.inst
== 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 adding configure option, "--with-x-locale".
See FAQ for more information.
* Try other things noted in the FAQ
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
cs 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
|