mirror of
https://github.com/gryf/wmaker.git
synced 2026-02-08 09:25:49 +01:00
Updating to version 0.20.2
Many bug fixes.
This commit is contained in:
151
INSTALL
151
INSTALL
@@ -1,5 +1,5 @@
|
||||
|
||||
Installation Instructions for WindowMaker
|
||||
Installation Instructions for Window Maker
|
||||
|
||||
|
||||
|
||||
@@ -21,8 +21,10 @@ SUPPORTED PLATFORMS
|
||||
- OSF/1
|
||||
- HP-UX
|
||||
- AIX 4.1.4 / IBM PowerPC
|
||||
- AIX 5.3
|
||||
- DEC Alpha/Digital UNIX 4.x
|
||||
- XFree86 / OS/2
|
||||
- Corel Netwinder
|
||||
|
||||
Patches to make it work on other platforms are welcome.
|
||||
|
||||
@@ -30,32 +32,33 @@ Patches to make it work on other platforms are welcome.
|
||||
REQUIREMENTS:
|
||||
=============
|
||||
|
||||
The following software is required to use WindowMaker
|
||||
The following software is required to use Window Maker
|
||||
|
||||
- X11R6.x
|
||||
WindowMaker can be compiled in older versions of X, like X11R5
|
||||
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.
|
||||
trouble using the dock. Upgrading the client libraries (Xlib, Xt etc)
|
||||
will help if you can't upgrade the server.
|
||||
|
||||
|
||||
If you will build WindowMaker, make sure you have gcc and the X header files
|
||||
If you will build Window Maker, make sure you have gcc and the X header files
|
||||
installed. Specially for newbie Linux users: you must install all X development
|
||||
packages and the gcc suite. Otherwise you won't be able to build any X program,
|
||||
including WindowMaker.
|
||||
including Window Maker.
|
||||
|
||||
|
||||
OPTIONAL:
|
||||
=========
|
||||
|
||||
These libraries are not required to make WindowMaker work, but they
|
||||
These libraries are not required to make Window Maker work, but they
|
||||
are supported in case you want to use them. Version numbers are those
|
||||
that I have (and therefore, guraranteed to work), but other versions
|
||||
might work too. Tell me if you made wmaker work with some library
|
||||
with a version older than the stated here.
|
||||
|
||||
|
||||
- libXPM 4.7
|
||||
- libXPM 4.7 or newer
|
||||
Older versions may not work!!!
|
||||
Available at ftp://sunsite.unc.edu/pub/Linux/libs/X/
|
||||
|
||||
@@ -69,7 +72,7 @@ with a version older than the stated here.
|
||||
For TIFF image support.
|
||||
You can get it at ftp://ftp.sgi.com/graphics/tiff
|
||||
|
||||
- libjpeg 6.0.1
|
||||
- libjpeg 6.0.1 or newer
|
||||
For JPEG image support
|
||||
|
||||
- libgif 2.2 or libungif
|
||||
@@ -87,13 +90,18 @@ CONFIGURE OPTIONS:
|
||||
==================
|
||||
|
||||
These options can be passed to the configure script to enable/disable
|
||||
some WindowMaker features. Example:
|
||||
some Window Maker features. Example:
|
||||
|
||||
./configure --enable-kanji
|
||||
|
||||
will configure WindowMaker with kanji characters support compiled in.
|
||||
will configure Window Maker with kanji (and other multi-byte) characters
|
||||
support compiled in.
|
||||
|
||||
|
||||
To get a list of other options, run ./configure --help
|
||||
|
||||
--enable-sound enable support of sound effects module
|
||||
|
||||
--disable-xpm disables use of the XPM library even if it is available on
|
||||
your system.
|
||||
|
||||
@@ -108,7 +116,7 @@ will configure WindowMaker with kanji characters support compiled in.
|
||||
--disable-shape disables shaped windows (for oclock, xeyes etc.)
|
||||
|
||||
--enable-debug adds extra debugging information. Do not use it
|
||||
unless you're debugging WindowMaker.
|
||||
unless you're debugging Window Maker.
|
||||
|
||||
--enable-kanji support to display Kanji characters, Korean, Chinese
|
||||
and other languagues that require special characters.
|
||||
@@ -118,6 +126,9 @@ will configure WindowMaker with kanji characters support compiled in.
|
||||
supported at all by the developers. If you have some trouble with it,
|
||||
contact it's author: Christopher Seawood <cls@seawood.org>
|
||||
|
||||
--disable-shm disable use of the MIT shared memory extension. This will
|
||||
slow down texture generation.
|
||||
|
||||
|
||||
PLATFORM SPECIFIC NOTES:
|
||||
========================
|
||||
@@ -128,8 +139,10 @@ PLATFORM SPECIFIC NOTES:
|
||||
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
|
||||
Sun's cpp lacks some features needed by Window Maker and it can
|
||||
cause problems when parsing the config files.
|
||||
You also might need to use the --with-gfx-libs and --with-gfx-incs
|
||||
to supply the directory where libtiff is located.
|
||||
|
||||
- RedHat Linux
|
||||
Make sure you don't have the LANG and LINGUAS environment variables
|
||||
@@ -159,8 +172,8 @@ INSTALLATION:
|
||||
Unpack WindowMaker-data.tar.gz and move the pixmaps directory in it
|
||||
to /usr/local/share/pixmaps
|
||||
|
||||
You can get the file at ftp://ftp.windowmaker.org. This file is not strictly
|
||||
necessary, but contains some additional nice icons and other things.
|
||||
You can get the file at ftp://ftp.windowmaker.org. This file is optional
|
||||
and only have a few icons.
|
||||
|
||||
|
||||
autoconf and automake
|
||||
@@ -172,34 +185,9 @@ an older version, disable them by temporarily renaming them to something
|
||||
else or uninstalling them from your system.
|
||||
|
||||
|
||||
Build libPropList
|
||||
-----------------
|
||||
|
||||
Note: You only need to build libPropList if you don't have it installed
|
||||
in your system.
|
||||
|
||||
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
|
||||
|
||||
then, login as root and type:
|
||||
|
||||
make install
|
||||
|
||||
|
||||
Build WindowMaker
|
||||
-----------------
|
||||
If this is the first time you're building WindowMaker, you can
|
||||
simply type:
|
||||
Build Window Maker
|
||||
------------------
|
||||
For a quick start, type the following in your shell prompt:
|
||||
|
||||
./configure
|
||||
make
|
||||
@@ -208,12 +196,12 @@ then, login as root and type:
|
||||
|
||||
make install
|
||||
|
||||
or if you want to strip the binaries from debugging symbols and make them
|
||||
or if you want to strip the debugging symbols from the binaries and make them
|
||||
smaller, you can instead type:
|
||||
|
||||
make install-strip
|
||||
|
||||
This will build and install WindowMaker with default parameters.
|
||||
This will build and install Window Maker with default parameters.
|
||||
|
||||
If you want to customize some compile-time options, you can do the
|
||||
following.
|
||||
@@ -225,9 +213,6 @@ following.
|
||||
|
||||
to get a complete listing of other options that are available.
|
||||
|
||||
Note that the WPrefs.app installation path is configured
|
||||
in a different way. Look at WPrefs/README for information.
|
||||
|
||||
2. Run configure with the options you want. For example, if you
|
||||
want to use the --enable-kanji option, type:
|
||||
|
||||
@@ -236,44 +221,38 @@ following.
|
||||
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 WindowMaker. Just type:
|
||||
4. Compile. Just type:
|
||||
|
||||
make
|
||||
|
||||
5. Login as root (if you can't do that, read the "I don't have the
|
||||
root password :-(" section) and install WindowMaker in your system.
|
||||
Again, type:
|
||||
root password :-(" section) and install Window Maker in your system:
|
||||
su root
|
||||
make install
|
||||
|
||||
|
||||
User specific configuration
|
||||
---------------------------
|
||||
|
||||
These instructions do not need to be followed when upgrading WindowMaker
|
||||
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 WindowMaker must do the
|
||||
Every user on your system that wishes to run Window Maker must do the
|
||||
following:
|
||||
|
||||
1. Install WindowMaker configuration files in your home directory.
|
||||
1. Install Window Maker 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.
|
||||
wmaker.inst will install Window Maker configuration files and will
|
||||
setup X to automatically launch Window Maker at startup.
|
||||
|
||||
That's it! The configuration file where you can edit your preferences
|
||||
is $HOME/GNUstep/Defaults/WindowMaker.
|
||||
The $HOME/GNUstep/Defaults/WMWindowAttributes file is where you assign
|
||||
icons to applications and edit some other attributes for windows. This can
|
||||
be also edited from the "Attributes Panel". To access it, click the titlebar
|
||||
of the window with the Right mouse button and select "Attributes...".
|
||||
That's it!
|
||||
|
||||
You can type "man wmaker" to get some general help for configuration
|
||||
and other stuff.
|
||||
|
||||
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
|
||||
Read the User Guide for a more in-depth explanation of Window Maker.
|
||||
|
||||
You might want to take a look at the FAQ too.
|
||||
|
||||
@@ -283,14 +262,17 @@ I don't have the root password :(
|
||||
|
||||
If you can't get superuser privileges (can't be root) you can install
|
||||
wmaker in your own home directory. For that, supply the --prefix option
|
||||
when running configure in step 2 of building WindowMaker . Example:
|
||||
when running configure in step 2 of building Window Maker. You will
|
||||
also need to supply the --with-appspath option, to specify the path for
|
||||
WPrefs.app Example:
|
||||
|
||||
./configure --prefix=/home/jshmoe
|
||||
./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps
|
||||
|
||||
If you use national language support, you must also supply the --with-nlsdir
|
||||
option, as:
|
||||
|
||||
./configure --prefix=/home/jshmoe --with-nlsdir=/home/jshmoe/lib/locale
|
||||
./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps \
|
||||
--with-nlsdir=/home/jshmoe/lib/locale
|
||||
|
||||
Then make /home/jshmoe/bin be included in your search path and run
|
||||
bin/wmaker.inst
|
||||
@@ -299,10 +281,10 @@ bin/wmaker.inst
|
||||
UPGRADING
|
||||
=========
|
||||
|
||||
If you are upgrading from an older version of WindowMaker:
|
||||
If you are upgrading from an older version of Window Maker:
|
||||
|
||||
1. Configure and build WindowMaker as always
|
||||
2. Install WindowMaker (but do not run wmaker.inst)
|
||||
1. Configure and build Window Maker as always
|
||||
2. Install Window Maker (but do not run wmaker.inst)
|
||||
3. Read the NEWS file and update your configuration files,
|
||||
if necessary.
|
||||
|
||||
@@ -314,12 +296,6 @@ 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.
|
||||
|
||||
|
||||
== When I try to start X after installing wmaker, I get this:
|
||||
exec: wmaker: not found
|
||||
|
||||
You probably are using a brain-damaged distribution. Add /usr/local/bin
|
||||
into your path environment variable (editing .cshrc or .profile)
|
||||
|
||||
== Error during build of libPropList
|
||||
|
||||
make: *** No rule to make target `libPropList.a.c', needed by
|
||||
@@ -332,8 +308,7 @@ automake 1.3
|
||||
|
||||
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.
|
||||
ftp://prep.ai.mit.edu or any mirror.
|
||||
|
||||
== configure doesn't detect libtiff, or other graphic libraries.
|
||||
|
||||
@@ -367,17 +342,18 @@ If you're not sure, try renaming ~/GNUstep to ~/GNUtmp and then run wmaker.inst
|
||||
|
||||
== The root menu contains only 2 entries. ("XTerm" and "Exit...")
|
||||
|
||||
* WindowMaker is not finding cpp (the C preprocessor). If your cpp is
|
||||
* Window Maker is not finding cpp (the C preprocessor). If your cpp is
|
||||
not located in /lib/cpp, edit src/config.h and correct the path in
|
||||
CPP_PATH.
|
||||
|
||||
|
||||
|
||||
LOCALES/INTERNATIONALIZATION
|
||||
============================
|
||||
|
||||
WindowMaker has national language support.
|
||||
Window Maker has national language support.
|
||||
To enable national language support, you must compile
|
||||
WindowMaker with some additional parameters.
|
||||
Window Maker 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
|
||||
@@ -405,7 +381,7 @@ for other languages.
|
||||
2 - Additionally, if your language uses multi-byte characters, such
|
||||
as Japanese or Korean, you must supply the --enable-kanji flag to configure.
|
||||
|
||||
3 - Configure, build and install WindowMaker normally.
|
||||
3 - Configure, build and install Window Maker normally.
|
||||
|
||||
4 - 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
|
||||
@@ -422,7 +398,7 @@ 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
|
||||
For menu definition files, Window Maker searches for them in the
|
||||
following order (for brazilian portuguese, in this case):
|
||||
|
||||
menu.pt_BR
|
||||
@@ -452,4 +428,5 @@ and in ~/G/D/WMGLOBAL:
|
||||
SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
|
||||
BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
|
||||
|
||||
|
||||
The above 2 fonts are only used by applications that use WINGs (WindowMaker
|
||||
and WPrefs.app)
|
||||
|
||||
Reference in New Issue
Block a user