apt-get install gcc libc-dev automake autoconf libtool libgtk2.0-dev \
libgc-dev libgcrypt-dev libpcre3-dev libvorbis-dev \
libao-dev libmad0-dev libasound2-dev libdb4.3-dev \
- libflac-dev
+ libflac-dev vorbis-tools wget
+
+ (Use the bzr from backports, the one in etch is obsolete.)
+
+ On lenny use libdb4.5-deb. libdb4.6 does not work (and configure will
+ refuse to use it).
* On FreeBSD you'll need at least these packages:
autotools
Building:
- * Compiled versions of configure and the makefiles are including in bzr, so
- if you didn't use a source tarball, you must start as follows:
+ * Compiled versions of configure and the makefiles are not included in bzr,
+ so if you didn't use a source tarball, you must start as follows:
bash ./prepare
./configure -C
* To support a new sound API:
1) Teach configure.ac how to detect any libraries required.
- 2) Define a new BACKEND_ value and update configuration.[ch] for it.
- 3) Create a suitable server/speaker-*.c along the pattern of the existing
- ones.
- 4) If possible create a suitable lib/mixer-*.c. This doesn't make sense
- for all APIs (e.g. network), but even for those it does, playback
- support without volume control support is likely to be acceptable (even
- if inferior to full support).
+ 2) Create lib/uaudio-<name>.c; see uaudio.h for the interface.
+ 3) Update the list in lib/uaudio-apis.c
+ 4) Add a new option to clients/playrtp.c and document it in
+ doc/disorder-playrtp.1.in (if appropriate).
5) Update doc/disorder_config.5.in.
- 6) If relevant, create a suitable clients/playrtp-*.c and update
- doc/disorder-playrtp.1.in.
* To support a new file format:
1) Teach configure.ac how to detect any libraries required.
Web Interface:
* The web interface does not use Javascript or Flash and I would like to
- keep it that way. Clever use of CSS is OK provided it works well on the
- mainstream browsers.
-
- * I know that the web template syntax is rather nasty. Perhaps it will be
- improved in a future version.
+ keep it that way; Javascript might be acceptable but it must degrade
+ gracefuly if disabled. Clever use of CSS is OK provided it works well on
+ the mainstream browsers.
- * Update templates/help.html for any changes you make.
+ * Update templates/help.tmpl for any changes you make.
Disobedience:
(But if your new feature only makes sense on a given platform then
obviously its new dependencies don't need to be available elsewhere.)
- * GCC is stated as a dependency. In fact the code is mostly standard C,
- with C99 initializers, long long and possibly the occasional // comment as
- the main departures from C89. Additional GCCisms will be accepted if it's
- impractical to avoid them. At least one active user is still using GCC
- 2.95, so extensions that only appear in later versions are to be avoided
- for the time being.
+ * GCCisms such as typeof and C99isms such as mixed declarations and named
+ structure initializers are used; the configure script asks for -std=gnu99
+ by default. Some supported platforms are still on GCC 4.0.
* Please submit patches either using 'diff -u', or by publishing a bzr
branch somewhere I can get at it.
* Please make it clear that your changes can be distributed under DisOrder's
- licence (which is "GPL v2 or later").
+ licence (which is "GPL v3 or later").
Local Variables:
mode:text
~mdw / disorder / blobdiff