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
|
Installation Instructions for WSoundServer
SUPPORTED PLATFORMS
===================
(ie: I've heard someone has compiled it on...)
- Intel FreeBSD-3.2-STABLE (primary platform)
- Intel FreeBSD-4.0-CURRENY (primary platform)
- Intel Linux/Mandrake 6.0
- Intel Linux/Redhat 6.0
- Intel Linux/Debian 2.1
Patches to make it work on other platforms are welcome.
There is "support" already for HPUX, Solaris and ESD though this has not been
(thoroughly) tested, so if you think you could improve the support for an
already supported platform, Please feel free to do so.
REQUIREMENTS:
=============
The following software is required to use WSoundServer:
- Anything that can properly run the Window Maker Window Manager.
- Window Maker (I think any version will do that has support for a soundserver
included)
The following is required to build WSoundServer:
- Basic obvious stuff
If you will build WSoundServer, make sure you have gcc (or some
other ANSI C compiler) 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 WSoundServer.
- libPropList
This library can be found in ftp://ftp.windowmaker.org/pub/libs
Install it before building WSoundServer.
(Should already be installed if you have Window Maker installed)
- libdockapp
This library is normally included in your Window Maker source tree
by default.
Install it before building WSoundServer.
- libaudiofile-0.1.9
This library can be found in ftp://ftp.68k.org/pub/michael/ as well as
on my own system ftp://shadowmere.student.utwente.nl/pub/WindowMaker
For more information about libaudiofile check out
http://www.68k.org/~michael/audiofile/
- autoconf, automake and libtool
These tools are NOT needed, but IF you have one or
more of them installed, make sure you have ALL of the following;
autoconf 2.13
automake 1.4
libtool 1.3.3
If you have a different version, they might work but are not
guaranteed, disable them by temporarily renaming them to something else
or uninstalling them from your system. If you don't develop software
you don't need them, so you can safely uninstall.
OPTIONAL:
=========
These libraries are not required to make WSoundServer 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.
- ESound 2.8 or newer
To have WSoundServer use ESD to play the sounds instead of
locking the audiodevice itself.
ESD support is very basic (i think) and might be broken
if you can fix /improve it ... please do so.
CONFIGURE OPTIONS:
==================
These options can be passed to the configure script to enable/disable
some WSoundServer features. Example:
./configure --enable-esd
will configure WSoundServer with support for the ESound Daemon.
To get a list of other options, run ./configure --help
--with-libs-from
specify additional paths for libraries to be searched.
The -L flag must precede each path, like:
--with-libs-from="-L/opt/libs -L/usr/local/lib"
--with-incs-from
specify additional paths for header files to be searched.
The -I flag must precede each paths, like:
--with-incs-from="-I/opt/headers -I/usr/local/include"
--enable-esd
configure the soundserver to use the esound daemon
--enable-debug
Do not use it unless you know what you're doing.
INSTALLATION:
=============
Build WSoundServer
------------------
For a quick start, type the following in your shell prompt:
./configure
make
then, login as root and type:
make install
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 WSoundServer with default parameters.
(on some platforms you may need to run ldconfig with proper paramters
check man ldconfig in those cases. On FreeBSD this is not necesarry
as libtool already takes care of this for you during install phase)
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
want to use the --enable-esd option, type:
./configure --enable-esd
3. Compile. Just type:
make
4. Become root (if you can't do that, read the "I don't have the
root password :-(" section) and install WSoundServer in your system:
su root
make install
I don't have the root password :(
---------------------------------
If you can't get superuser privileges (can't be root) you can install
wsoundserver in your own home directory. For that, supply the --prefix option
when running configure in step 2 of building WSoundServer.
./configure --prefix=/home/jshmoe
Then make /home/jshmoe/bin be included in your search PATH, add
/home/jshmoe/lib to your LD_LIBRARY_PATH environment variable and run
bin/wmaker.inst
Of course, /home/jshmoe is supposed to be replaced with your actual home
directory path.
TROUBLESHOOTING
===============
When you have some trouble during configuration (while running configure),
look at the config.log file for clues of the problem.
== Error when configuring
ltconfig: unrecognized option `--no-reexec'
Try `ltconfig --help' for more information.
configure: error: libtool configure failed
remove the --no-reexec option from aclocal.m4 and libPropList/aclocal.m4
and reconfigure
Also make sure the autoconf and automake versions you have installed are:
autoconf 2.13
automake 1.4
libtool 1.3.3
Note that it must not be libtool 1.2b, it must be libtool 1.3.3,
from the GNU sites. (libtool 1.3 might also work)
== Cant find proplist.h or libPropList.something
Download and install libPropList from the places pointed to
somewhere else in this file.
== Cant find dockapp.h or libdockapp.something
Download and install libdockapp from the places pointed to
somewhere else in this file.
|
