annotate FAQ @ 0:cb178e5ad177 trunk

[svn] Import audacious source.
author nenolod
date Mon, 24 Oct 2005 03:06:47 -0700
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
1 Beep Media Player FAQ
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
2
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
3 NOTE: This document is no longer maintained. Please check the FAQ on
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
4 the BMP website (http://beepmp.sf.net)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
5
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
6 Contents
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
7 ========
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
8
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
9 Compilation:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
10
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
11 c1: The CVS version won't compile, but the tarball does
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
12
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
13 Running:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
14
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
15 r1: Why do I keep getting "Gdk-ERROR **: an x io error occurred" when I try
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
16 to use BMP?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
17 r2: My X server crashes when I try to change skin, what can I do?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
18 r3: When using GNOME / Enlightenment the playlist window got lost somewhere
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
19 in my virtual desktops what should I do? I'm all out of breadcrumbs.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
20 r4: Why do I keep getting "Gdk-WARNING **: shmat failed!" in Solaris?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
21 r5: Why do BMP windows behave differently than my other windows?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
22 r6: Why does BMP have 5-6 running instances which each takes x% of my memory,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
23 isn't 5-6*x% memory A REAL WASTE?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
24
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
25 General:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
26
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
27 g1: Is there a mailing list for BMP?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
28 g2: How do I unsubscribe from the mailing list?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
29 g3: Can I use XMMS plugins with BMP?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
30
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
31
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
32 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
33
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
34
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
35 Compilation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
36 ===========
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
37
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
38 c1: The CVS version won't compile, but the tarball does
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
39
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
40 This can happen for various reasons:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
41
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
42 1. You do not have a sufficiently new version of autoconf and/or automake
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
43 installed. BMP requires at least autoconf 2.5 and automake 1.7 in order
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
44 to compile directly from CVS.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
45
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
46 2. If your version of autoconf/automake is recent enough, you may have
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
47 multiple copies of them installed. To check, you can run this command:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
48
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
49 autoconf --version ; automake --version
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
50
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
51 Normally the commands "autoconf" and "automake" will run their latest
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
52 versions. If they do not, you can specify the correct versions to use
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
53 like this:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
54
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
55 AUTOCONF=autoconf-xx AUTOMAKE=automake-yy ACLOCAL=aclocal-yy ./autogen.sh
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
56
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
57 (where xx, yy are the versions of autoconf/automake respectively)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
58
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
59 For Gentoo users, use this instead:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
60
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
61 WANT_AUTOCONF=xx WANT_AUTOMAKE=yy ./autogen.sh
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
62
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
63
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
64 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
65
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
66 Running:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
67
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
68 r1: Why do I keep getting "Gdk-ERROR **: an x io error occurred" when I
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
69 try to use BMP?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
70
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
71 This is because you're running an older system with libc5 and you don't
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
72 have Thread Safe X libs. You might want to download these thread aware
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
73 X libs and install them, just untar them into /usr/X11R6/lib (or appropriate
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
74 path) NOTE: do NOT do this while X is running.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
75 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
76
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
77 r2: My X server crashes when I try to change skin, what can I do?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
78
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
79 This is because of your window manager, if you browse the configure file
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
80 for your window manager you'll find an option called SaveUnder somewhere.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
81 In Window Maker change "UseSaveUnders = YES;" to "UseSaveUnders = NO;"
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
82 This will fix it for you.. (don't forget to restart your window manager)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
83 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
84
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
85 r3: When using GNOME / Enlightenment the playlist window got lost somewhere
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
86 in my virtual desktops what should I do? I'm all out of breadcrumbs.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
87
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
88 Edit the ~/.bmp/config file and change the playlist_x= and playlist_y=
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
89 to sane values.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
90 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
91
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
92 r4: Why do I keep getting "Gdk-WARNING **: shmat failed!" in Solaris?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
93
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
94 Solaris (2.5, 2.6, 2.7) has insufficient IPC settings by default for some
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
95 products that use shared memory.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
96 You need to place this in /etc/system:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
97 set shmsys:shminfo_shmmax = 8388608
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
98 set shmsys:shminfo_shmmni = 0x1000
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
99 set shmsys:shminfo_shmseg = 0x100
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
100 Thanks to Yuri Kulaghin and Jeff Johnson
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
101 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
102
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
103 r5: Why do BMP windows behave differently than my other windows?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
104
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
105 Since BMP disables the window managers title bars, the window manager is
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
106 unable to raise/lower/move BMP as it's configured to do.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
107 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
108
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
109 r6: Why does BMP have 5-6 running instances which each takes x% of my
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
110 memory, isn't 5-6*x% memory A REAL WASTE?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
111
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
112 BMP is not using that memory for each instance, it shares the memory
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
113 between the instances. If you have 6 entries in your process list, each
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
114 claiming to take 5 MB, BMP is using 5 MB, and not 30 MB (5x6).
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
115 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
116
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
117
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
118 General
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
119 =======
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
120
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
121 g1: Is there a mailing list for BMP?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
122
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
123 Yes there is. In fact there are 3, namely:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
124
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
125 a) beepmp-users
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
126 b) beepmp-devel
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
127 c) beepmp-cvs
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
128
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
129 You can subscribe each of them at:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
130 http://sourceforge.net/mail/?group_id=95272
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
131
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
132 Please keep any messages sent to this list STRICTLY about BMP. Or we will
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
133 have to moderate it.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
134 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
135
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
136 g2: How do I unsubscribe from the mailing lists?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
137
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
138 You can use the page:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
139 http://sourceforge.net/mail/?group_id=95272
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
140
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
141 ______________________________________________________________________________
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
142
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
143 g3: Can I use XMMS plugins with BMP?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
144
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
145 Generally no in their binary form i.e. '.so' files [1]. You can however
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
146 attempt to compile them from source using GTK 2.4.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
147
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
148 GTK 1.2 programs are usually compiled with a 'gtk-config --xx'
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
149 parameter passed to the compiler. You can try replacing that with
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
150 'pkg-config gtk+-2.0 -xx'. For example, if the compile command is:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
151
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
152 gcc -Wall -ansi -c `gtk-config --cflags --libs` plugin.c
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
153
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
154 Modify it to:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
155
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
156 gcc -Wall -ansi -c `pkg-config gtk+-2.0 --cflags --libs` plugin.c
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
157
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
158 If this fails, you will need to modify the source code to use GTK 2.4. Refer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
159 to the official guide on migrating the code:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
160
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
161 http://developer.gnome.org/doc/API/2.2/gtk/migrating.html
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
162
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
163
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
164 [1] Bear in mind that BMP uses GTK 2.4 while XMMS uses GTK 1.2. Consequently,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
165 XMMS plugins are compiled against 1.2 and will not work properly with BMP.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
166
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
167 The technical reason for this is that GTK 1.2 and GTK 2.4 share the same
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
168 symbol names for the most part and there is no easy way to get the dynamic
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
169 linker to resolve to the right one.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
170
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
171
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
172
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
173 ______________________________________________________________________________