annotate DOCS/xml/en/bugreports.xml @ 11278:ff78d7ceecaa

Dead links updated or removed, Joe Barr section rewritten taking into account his latest article.
author diego
date Sun, 26 Oct 2003 23:08:16 +0000
parents 9da833258d9d
children d480f7e36b74
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
1 <?xml version="1.0" encoding="iso-8859-1"?>
10913
49b1a67e7381 Add revision keyword to english xml files, to ease translation synchronization
lumag
parents: 10111
diff changeset
2 <!-- $Revision$ -->
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
3 <appendix id="bugreports">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
4 <title>How to report bugs</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
5 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
6 Good bug reports are a very valuable contribution to the development of any
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
7 software project. But just like writing good software, good problem reports
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
8 involve some work. Please realize that most developers are extremely busy and
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
9 receive obscene amounts of email. So while your feedback is crucial in improving
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
10 MPlayer and very much appreciated, please understand that you have to provide
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
11 <emphasis role="bold">all</emphasis> of the information we request and follow
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
12 the instructions in this document closely.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
13 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
14 <sect1 id="bugreports_fix">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
15 <title>How to fix bugs</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
16 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
17 If you feel have the necessary skills you are invited to have a go at fixing the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
18 bug yourself. Or maybe you already did that? Please read
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
19 <ulink url="../../tech/patches.txt">this short document</ulink> to find out how to
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
20 get your code included in MPlayer. The people on the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
21 <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</ulink>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
22 mailing list will assist you if you have questions.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
23 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
24 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
25 <sect1 id="bugreports_report">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
26 <title>How to report bugs</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
27 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
28 First of all please try the latest CVS version of MPlayer as your bug might
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
29 already be fixed there. Development moves extremely fast, most problems in
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
30 official releases are reported within days or even hours, so please use
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
31 <emphasis role="bold">only CVS</emphasis> to report bugs. This includes
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
32 binary packages of MPlayer. CVS instructions can be found at the bottom of
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
33 <ulink url="http://www.mplayerhq.hu/homepage/dload.html">this page</ulink> or in
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
34 the README. If this did not help please refer to the list of
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
35 <link linkend="bugs">known bugs</link> and the rest of the documentation. If your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
36 problem is not known or not solvable by our instructions, then please report the bug.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
37 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
38
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
39 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
40 Please do not send bug reports privately to individual developers. This is
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
41 community work and thus there might be several people interested in it. Sometimes
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
42 other users already experienced your troubles and know how to circumvent a problem
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
43 even if it is a bug in MPlayer code.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
44 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
45
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
46 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
47 Please describe your problem in as much detail as possible. Do a little detective
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
48 work to narrow down the circumstances under which the problem occurs. Does the bug
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
49 only show up in certain situations? Is it specific to certain files or file types?
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
50 Does it occur with only one codec or is it codec independent? Can you reproduce it
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
51 with all output drivers? The more information you provide the better are our
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
52 chances at fixing your problem. Please do not forget to also include the valuable
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
53 information requested below, we will be unable to properly diagnose your problem
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
54 otherwise.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
55 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
56
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
57 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
58 An excellent and well written guide to asking questions in public forums is
9740
7412751211e0 link fixed
diego
parents: 9675
diff changeset
59 <ulink url="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask
7412751211e0 link fixed
diego
parents: 9675
diff changeset
60 Questions The Smart Way</ulink> by <ulink url="http://www.catb.org/~esr/">Eric S. Raymond</ulink>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
61 There is another called
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
62 <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
63 Bugs Effectively</ulink> by <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/">Simon Tatham</ulink>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
64 If you follow these guidelines you should be able to get help. But please
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
65 understand that we all follow the mailing lists voluntarily in our free time. We
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
66 are very busy and cannot guarantee that you will get a solution for your problem
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
67 or even an answer.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
68 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
69
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
70 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
71
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
72 <sect1 id="bugreports_where">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
73 <title>Where to report bugs</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
74 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
75 Subscribe to the mplayer-users mailing list:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
76 <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-users"/>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
77 and send your bug report to:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
78 <ulink url="mailto:mplayer-users@mplayerhq.hu"/>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
79 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
80 <para>
10111
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
81 The language of this list is <emphasis role="bold">English</emphasis>. Please follow the standard
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
82 <ulink url="http://www.ietf.org/rfc/rfc1855.txt">Netiquette Guidelines</ulink> and
10111
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
83 <emphasis role="bold">do not send HTML mail</emphasis> to any of our mailing lists. You will only get ignored or
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
84 banned. If you do not know what HTML mail is or why it is evil, read this
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
85 <ulink url="http://expita.com/nomime.html">fine document</ulink>. It explains all
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
86 the details and has instructions for turning HTML off. Also note that we will not
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
87 individually CC (carbon-copy) people so it is a good idea to subscribe to actually
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
88 receive your answer.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
89 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
90 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
91
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
92 <sect1 id="bugreports_what">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
93 <title>What to report</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
94 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
95 You may need to include log, configuration or sample files in your bug report.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
96 If some of them are quite big then it is better to upload them to our
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
97 <ulink url="ftp://mplayerhq.hu/MPlayer/incoming/">FTP server</ulink> in a
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
98 compressed format (gzip and bzip2 preferred) and include only the path and file
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
99 name in your bug report. Our mailing lists have a message size limit of 80k, if
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
100 you have something bigger you have to compress or upload it.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
101 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
102
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
103 <sect2 id="bugreports_system">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
104 <title>System Information</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
105 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
106 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
107 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
108 Your Linux distribution or operating system and version e.g.:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
109 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
110 <listitem><para>Red Hat 7.1</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
111 <listitem><para>Slackware 7.0 + devel packs from 7.1 ...</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
112 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
113 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
114 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
115 kernel version:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
116 <screen>uname -a</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
117 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
118 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
119 libc version:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
120 <screen>ls -l /lib/libc[.-]*</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
121 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
122 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
123 gcc and ld versions:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
124 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
125 gcc -v
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
126 ld -v
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
127 </screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
128 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
129 <listitem><para>
10111
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
130 binutils version:
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
131 <screen>
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
132 as --version
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
133 </screen>
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
134 </para></listitem>
a570a78537aa various fixes and updates
nicolas
parents: 9740
diff changeset
135 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
136 If you have problems with fullscreen mode:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
137 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
138 <listitem><para>Window manager type and version</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
139 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
140 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
141 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
142 If you have problems with XVIDIX:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
143 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
144 <listitem><para>X colour depth:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
145 <screen>xdpyinfo | grep &quot;depth of root&quot;</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
146 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
147 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
148 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
149 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
150 If only the GUI is buggy:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
151 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
152 <listitem><para>GTK version</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
153 <listitem><para>GLIB version</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
154 <listitem><para>libpng version</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
155 <listitem><para>GUI situation in which the bug occurs</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
156 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
157 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
158 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
159 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
160 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
161
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
162 <sect2 id="bugreports_hardware">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
163 <title>Hardware and drivers</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
164 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
165 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
166 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
167 CPU info (this works on Linux only):
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
168 <screen>cat /proc/cpuinfo</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
169 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
170 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
171 Video card manufacturer and model, e.g.:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
172 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
173 <listitem><para>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
174 <listitem><para>Matrox G400 DH 32MB SGRAM</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
175 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
176 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
177 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
178 Video driver type &amp; version, e.g.:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
179 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
180 <listitem><para>X built-in driver</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
181 <listitem><para>nVidia 0.9.623</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
182 <listitem><para>Utah-GLX CVS 2001-02-17</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
183 <listitem><para>DRI from X 4.0.3</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
184 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
185 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
186 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
187 Sound card type &amp; driver, e.g.:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
188 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
189 <listitem><para>Creative SBLive! Gold with OSS driver from oss.creative.com</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
190 <listitem><para>Creative SB16 with kernel OSS drivers</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
191 <listitem><para>GUS PnP with ALSA OSS emulation</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
192 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
193 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
194 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
195 If in doubt include <command>lspci -vv</command> output on Linux systems.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
196 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
197 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
198 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
199 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
200
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
201 <sect2 id="bugreports_configure">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
202 <title>Configure problems</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
203 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
204 If you get errors while running <command>./configure</command>, or autodetection
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
205 of something fails, read <filename>configure.log</filename>. You may find the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
206 answer there, for example multiple versions of the same library mixed on your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
207 system, or you forgot to install the development package (those with the -dev
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
208 suffix). If you think there is a bug, include <filename>configure.log</filename>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
209 in your bug report.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
210 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
211 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
212
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
213 <sect2 id="bugreports_conpilation">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
214 <title>Compilation problems</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
215 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
216 Please include these files:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
217 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
218 <listitem><para>config.h</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
219 <listitem><para>config.mak</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
220 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
221 Only if compilation fails below one of these directories, include these files:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
222 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
223 <listitem><para>Gui/config.mak</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
224 <listitem><para>libvo/config.mak</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
225 <listitem><para>libao2/config.mak</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
226 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
227 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
228 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
229
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
230 <sect2 id="bugreports_playback">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
231 <title>Playback problems</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
232 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
233 Please include the output of <application>MPlayer</application> at verbosity level
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
234 1, but remember to <emphasis role="bold">not truncate the output</emphasis> when
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
235 you paste it into your mail. The developers need all of the messages to properly
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
236 diagnose a problem. You can direct the output into a file like this:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
237 <screen>mplayer -v <replaceable>options</replaceable> <replaceable>filename</replaceable> &gt; mplayer.log 2&gt;&amp;1</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
238 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
239
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
240 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
241 If your problem is specific to one or more files, then please upload the offender(s) to:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
242 <ulink url="ftp://mplayerhq.hu/MPlayer/incoming/"/>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
243 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
244
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
245 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
246 Also upload a small text file having the same base name as your file with a .txt
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
247 extension. Describe the problem you are having with the particular file there and
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
248 include your email address as well as the output of MPlayer at verbosity level 1.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
249 Usually the first 1-5 MB of a file are enough to reproduce the problem, but to be
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
250 sure we ask you to:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
251 <screen>dd if=<replaceable>yourfile</replaceable> of=<replaceable>smallfile</replaceable> bs=1024k count=5</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
252 It will take the first five megabytes of '<emphasis role="bold">your-file</emphasis>'
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
253 and write it to '<emphasis role="bold">small-file</emphasis>'. Then try again on
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
254 this small file and if the bug still shows up your sample is sufficient for us.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
255 Please <emphasis role="bold">do not ever</emphasis> send such files via mail!
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
256 Upload it, and send only the path/filename of the file on the FTP-server. If the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
257 file is accessible on the net, then sending the <emphasis role="bold">exact</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
258 URL is sufficient.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
259 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
260 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
261
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
262 <sect2 id="bugreports_crash">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
263 <title>Crashes</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
264 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
265 You have to run <application>MPlayer</application> inside <command>gdb</command>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
266 and send us the complete output or if you have a <filename>core</filename> dump of
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
267 the crash you can extract useful information from the Core file. Here's how:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
268 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
269
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
270 <sect3 id="bugreports_debug">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
271 <title>How to conserve information about a reproducible crash</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
272 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
273 Recompile MPlayer with debugging code enabled:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
274 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
275 ./configure --enable-debug=3
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
276 make
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
277 </screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
278 and then run MPlayer within gdb using:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
279 <screen>gdb ./mplayer</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
280 You are now within gdb. Type:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
281 <screen>run -v <replaceable>options-to-mplayer</replaceable> <replaceable>filename</replaceable></screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
282 and reproduce your crash. As soon as you did it, gdb will return you to the command
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
283 line prompt where you have to enter
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
284 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
285 bt
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
286 disass $pc-32 $pc+32
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
287 info all-registers
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
288 </screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
289 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
290 </sect3>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
291
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
292 <sect3 id="bugreports_core">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
293 <title>How to extract meaningful information from a core dump</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
294 <para>
11049
9da833258d9d wording improvement
diego
parents: 10913
diff changeset
295 Create the following command file:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
296 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
297 bt
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
298 disass $pc-32 $pc+32
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
299 info all-registers
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
300 </screen>
11049
9da833258d9d wording improvement
diego
parents: 10913
diff changeset
301 Then simply execute this command:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
302 <screen>gdb mplayer --core=core -batch --command=<replaceable>command_file</replaceable> &gt; mplayer.bug</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
303 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
304 </sect3>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
305 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
306 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
307
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
308 <sect1 id="bugreports_advusers">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
309 <title>I know what I am doing...</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
310 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
311 If you created a proper bug report following the steps above and you are confident
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
312 it is a bug in MPlayer, not a compiler problem or broken file, you have already
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
313 read the documentation and you could not find a solution, your sound drivers are
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
314 OK, then you might want to subscribe to the mplayer-advusers list and send your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
315 bug report there to get a better and faster answer.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
316 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
317
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
318 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
319 Please be advised that if you post newbie questions or questions answered in the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
320 manual there, you will be ignored or flamed instead of getting an appropriate answer.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
321 So do not flame us and subscribe to -advusers only if you really know what you are
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
322 doing and feel like being an advanced MPlayer user or developer. If you meet these
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
323 criteria it should not be difficult to find out how to subscribe...
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
324 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
325
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
326 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
327
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
328 </appendix>