File: INSTALL

package info (click to toggle)
wmaker 0.14.1-7
  • links: PTS
  • area: main
  • in suites: hamm
  • size: 2,868 kB
  • ctags: 2,744
  • sloc: ansic: 30,785; sh: 2,619; makefile: 547
file content (314 lines) | stat: -rw-r--r-- 7,898 bytes parent folder | download
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