~ubuntu-branches/ubuntu/lucid/mpg123/lucid

« back to all changes in this revision

Viewing changes to INSTALL

Tags: upstream-0.60
ImportĀ upstreamĀ versionĀ 0.60

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
 
2
 
(1)  Read the README file.
3
 
     (also read the JUKEBOX file if you wanna compile a player
4
 
     for the sajber jukebox)
5
 
 
6
 
(2)  Type "make" to see a list of supported hardware platforms
7
 
     and operating systems, then type the make command that
8
 
     best fits your system.
9
 
 
10
 
(3)  If compilation was successful, type "make install" to
11
 
     install the binary and the manual page in /usr/local.
12
 
 
13
 
Have fun!
14
 
 
15
 
Some additional remarks:
 
1
There are now two basic ways to get your mpg123 installation consisting of
 
2
 
 
3
        a) the mpg123 binary file
 
4
        b) a man page
 
5
 
 
6
(you may want to copy some of the documentation - README, etc - to /usr/share/doc/mpg123 or the like, too)
 
7
 
 
8
 
 
9
0. Prerequesites
 
10
 
 
11
You really need:
 
12
 
 
13
- a C compiler; we try to keep the code ANSI C89 compatible
 
14
  gcc from 2.95 on should work, others, too - please report any issues
 
15
 
 
16
You want:
 
17
 
 
18
- working assembler (recent GNU binutils) if using certain CPU optimizations
 
19
 
 
20
- headers and lib for certain audio output drivers (libasound for alsa, sdl for sdl...)
 
21
 
 
22
 
 
23
1. New installation via GNU autotools
 
24
 
 
25
The GNU 3-step procedure:
 
26
 
 
27
        ./configure
 
28
        make
 
29
        make install
 
30
 
 
31
Run
 
32
 
 
33
        ./configure --help
 
34
 
 
35
for a list of possible parameters you can specify. The obvious are --prefix and the normal GNU autotool bunch, but others include what audio subsystem to use and what CPU optimizations to build in.
 
36
In future we may have a merged build for the i386 platform including MMX, SSE, 3DNow!, etc. optimizations and choosing at runtime, but for now that's a build time decision.
 
37
 
 
38
Other important choices include --enable-gapless for enabling mpg123 to skip encoder/decoder padding for seamless transition between tracks and --with-seektable=<number> for setting the size for the table of stored frame addresses to make seeking faster. When you want a minimal memory footprint, you can set number to 0. Seeking will always start from the beginning, then - being accurate, but rather slow, what doesn't matter if you don't use interactive seeking forth and back.
 
39
 
 
40
2. The classic way via the provided Makefile
 
41
 
 
42
This is basically the known mpg123 Makefile with some mods and additions.
 
43
for coexistence with the autotools setup, a wrapper script for generating a fake config.h is needed.
 
44
You may want to edit that one in src/config.h and run make -f src/Makefile.legacy yourself, but normally run
 
45
 
 
46
        ./MakeLegacy.sh
 
47
 
 
48
to get a list of targets and simply
 
49
 
 
50
        ./MakeLegacy.sh <target>
 
51
 
 
52
to build. You may want to have some CFLAGS defined; these are used now in the Makefile.
 
53
 
 
54
        ./MakeLegacy.sh install
 
55
 
 
56
will install the binary and man page to the dirs specified by these make variables (with default values):
 
57
 
 
58
PREFIX=/usr/local
 
59
BINDIR=$(PREFIX)/bin
 
60
MANDIR=$(PREFIX)/man
 
61
 
 
62
So, if you want it in /usr; just run
 
63
 
 
64
        ./MakeLegacy.sh PREFIX=/usr install
 
65
 
 
66
 
 
67
Please note that the Makefile does not contain any CFLAGS or explicit `strip` calls anymore; mpg123 will be built and installed with debugging symbols - so if you want to conserve some space, please specify the -s in CFLAGS or strip the binary yourself.
 
68
 
 
69
 
 
70
3. Have fun!
 
71
 
 
72
 
 
73
These are some remarks from Michael that are likely to be still valid in essence:
16
74
 
17
75
 - There is currently no direct audio hardware support for the
18
76
   "dec" and "generic" targets.  That means that you have to use
38
96
 
39
97
 - IRIX: some people reported compile problems on IRIX 5.x (5.3)
40
98
         but 6.x seems to compile without problems
41
 
 
42
 
 
43
 
***