1
0
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:
dan
1998-10-21 14:43:47 +00:00
parent 9d2e6ef9f1
commit 9af1c6c415
222 changed files with 9132 additions and 4322 deletions

151
INSTALL
View File

@@ -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)