annotate DOCS/bugreports.html @ 7156:3e5e0e7c6e5e

sync
author nexus
date Fri, 30 Aug 2002 08:16:52 +0000
parents da10c0756649
children 822923446b66
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6387
26c35aa7e1d8 Remind people to NOT cut mplayer output, removed italics that make text
diego
parents: 6055
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
2 <HTML>
4982
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4058
diff changeset
3
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4058
diff changeset
4 <HEAD>
6882
f3f87f6bf5cf Added a uniform title: something - MPlayer - The Movie Player for Linux.
diego
parents: 6866
diff changeset
5 <TITLE>Bug reporting - MPlayer - The Movie Player for Linux</TITLE>
6391
4e5c236ade69 small updates
gabucino
parents: 6387
diff changeset
6 <LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
6409
8d9c6decdfd6 Background now uses CSS, added charset.
diego
parents: 6393
diff changeset
7 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4982
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4058
diff changeset
8 </HEAD>
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4058
diff changeset
9
6409
8d9c6decdfd6 Background now uses CSS, added charset.
diego
parents: 6393
diff changeset
10 <BODY>
1704
a2e1432f7ac3 Arial font
gabucino
parents: 1685
diff changeset
11
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
12
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
13 <H1><A NAME=C>Appendix C - How to report bugs</A></H1>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
14
7103
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
15 <P>Good bug reports are a very valuable contribution to the development of any
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
16 software project. But just like writing good software, good problem reports
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
17 involve some work. Please realize that most developers are extremely busy and
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
18 receive obscene amounts of email. So while your feedback is crucial in
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
19 improving <B>MPlayer</B> and very much appreciated, please understand that you
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
20 have to provide <B>all</B> of the information we request and follow the
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
21 instructions in this document closely.</P>
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
22
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
23
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
24 <H2>How to fix bugs</H2>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
25
6445
e676143308bf Added a short note on how to contribute fixes.
diego
parents: 6409
diff changeset
26 <P>If you feel have the necessary skills you are invited to have a go at fixing
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
27 the bug yourself. Or maybe you already did that? Please read
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
28 <A HREF="tech/patches.txt">this short document</A> to find out how to get
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
29 your code included in <B>MPlayer</B>. The people on the
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
30 <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</A>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
31 mailing list will assist you if you have questions.</P>
6866
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
32
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
33
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
34 <H2>How to report bugs</H2>
6866
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
35
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
36 <P>First of all please try the latest CVS version of <B>MPlayer</B> as your bug
7103
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
37 might already be fixed there. Development moves extremely fast, most problems
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
38 in official releases are reported within days or even hours, so please use
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
39 <B>only CVS</B> to report bugs. CVS instructions can be found at the bottom of
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
40 <A HREF="http://www.mplayerhq.hu/homepage/dload.html">this page</A> or in the
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
41 README. If this did not help please refer to
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
42 <A HREF="documentation.html#known_bugs">the list of known bugs</A> and the
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
43 rest of the documentation. If your problem is not known or not solvable by our
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
44 instructions, then please report the bug.</P>
6866
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
45
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
46 <P>Please do not send bug reports privately to individual developers. This is
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
47 community work and thus there might be several people interested in it.
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
48 Sometimes other users already experienced your troubles and know how to
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
49 circumvent a problem even if it is a bug in <B>MPlayer</B> code.</P>
6866
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
50
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
51 <P>Please describe your problem in as much detail as possible. Do a little
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
52 detective work to narrow down the circumstances under which the problem
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
53 occurs. Does the bug only show up in certain situations? Is it specific to
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
54 certain files or file types? Does it occur with only one codec or is it codec
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
55 independent? Can you reproduce it with all output drivers? The more
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
56 information you provide the better are our chances at fixing your problem.
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
57 Please do not forget to also include the valuable information requested below,
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
58 we will be unable to properly diagnose your problem otherwise.</P>
6866
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
59
1a5858256659 The endless quest to force people into writing good bug reports part 2342:
diego
parents: 6783
diff changeset
60 <P>An excellent and well written guide to asking questions in public forums is
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
61 <A HREF="http://www.tuxedo.org/~esr/faqs/smart-questions.html">How To Ask
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
62 Questions The Smart Way</A> by Eric S. Raymond. If you follow these guidelines
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
63 you should be safe. But please understand that we all follow the mailing lists
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
64 voluntarily in our free time. We are very busy and cannot guarantee that you
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
65 will get a solution for your problem or even an answer.</P>
6445
e676143308bf Added a short note on how to contribute fixes.
diego
parents: 6409
diff changeset
66
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
67
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
68 <H3>Where to report bugs?</H3>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
69
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
70 <P>Subscribe to the mplayer-users mailing list:<BR>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
71 &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
72 and send your bug report to:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
73 &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="mailto:mplayer-users@mplayerhq.hu">mplayer-users@mplayerhq.hu</A></P>
6470
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>.
diego
parents: 6446
diff changeset
74
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>.
diego
parents: 6446
diff changeset
75 <P>The language of this list is <B>English</B>. Please follow the standard
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
76 <A HREF="http://www.ietf.org/rfc/rfc1855.txt">Netiquette Guidelines</A> and
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
77 <B>do not send HTML mail</B> to any of our mailing lists. You will only get
7103
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
78 ignored or banned. If you do not know what HTML mail is or why it is evil,
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
79 read this <A HREF="http://expita.com/nomime.html">fine document</A>. It
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
80 explains all the details and has instructions for turning HTML off. Also note
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
81 that we will not individually CC (carbon-copy) people so it is a good idea to
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
82 subscribe to actually receive your answer.</P>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
83
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
84
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
85 <H3>What to report?</H3>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
86
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
87 <H4>System Information:</H4>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
88
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
89 <UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
90 <LI>Your Linux distribution or operating system e.g.:
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
91 <UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
92 <LI>Red Hat 7.1</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
93 <LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
94 </UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
95 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
96 <LI>kernel version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
97 <CODE>uname -a</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
98 <LI>libc version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
99 <CODE>ls -l /lib/libc[.-]*</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
100 <LI>X version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
101 <CODE>X -version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
102 <LI>gcc and ld versions:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
103 <CODE>gcc -v<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
104 ld -v</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
105 <LI>binutils version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
106 <CODE>as --version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
107 <LI>If you have problems with fullscreen mode:
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
108 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
109 <LI>Window manager type and version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
110 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
111 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
112 <LI>If only the GUI is buggy:
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
113 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
114 <LI>GTK version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
115 <LI>GLIB version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
116 <LI>libpng version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
117 <LI>GUI situation in which the bug occurs</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
118 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
119 </LI>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
120 </UL>
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
121
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
122
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
123 <H4>Hardware &amp; drivers:</H4>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
124
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
125 <UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
126 <LI>CPU info (this works on Linux only):<BR>
6055
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de>
arpi
parents: 5705
diff changeset
127 <CODE>cat /proc/cpuinfo</CODE></LI>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
128 <LI>Video card manufacturer and model, e.g.:
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
129 <UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
130 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
131 <LI>Matrox G400 DH 32MB SGRAM</LI>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
132 </UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
133 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
134 <LI>Video driver type &amp; version, e.g.:
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
135 <UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
136 <LI>X built-in driver</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
137 <LI>nVidia 0.9.623</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
138 <LI>Utah-GLX CVS 2001-02-17</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
139 <LI>DRI from X 4.0.3</LI>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
140 </UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
141 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
142 <LI>Sound card type &amp; driver, e.g.:
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
143 <UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
144 <LI>Creative SBLive! Gold with OSS driver from oss.creative.com</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
145 <LI>Creative SB16 with kernel OSS drivers</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
146 <LI>GUS PnP with ALSA OSS emulation</LI>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
147 </UL>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
148 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
149 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
150 </UL>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
151
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
152
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
153 <H4>For compilation problems/errors</H4>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
154
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
155 Please include these files:
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
156
6055
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de>
arpi
parents: 5705
diff changeset
157 <UL>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de>
arpi
parents: 5705
diff changeset
158 <LI>configure.log</LI>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de>
arpi
parents: 5705
diff changeset
159 <LI>config.h</LI>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de>
arpi
parents: 5705
diff changeset
160 <LI>config.mak</LI>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de>
arpi
parents: 5705
diff changeset
161 <LI>libvo/config.mak</LI>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
162 </UL>
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
163
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
164
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
165 <H4>For playback problems</H4>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
166
6470
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>.
diego
parents: 6446
diff changeset
167 <P>Please include the output of <B>MPlayer</B> at verbosity level 1, but
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
168 remember to <B>not truncate the output</B> when you paste it into your mail.
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
169 The developers need all of the messages to properly diagnose a problem. You
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
170 can direct the output into a file like this:</P>
6387
26c35aa7e1d8 Remind people to NOT cut mplayer output, removed italics that make text
diego
parents: 6055
diff changeset
171
26c35aa7e1d8 Remind people to NOT cut mplayer output, removed italics that make text
diego
parents: 6055
diff changeset
172 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -v [options] [filename] &amp;&gt; mplayer.log</CODE></P>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
173
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
174 <P>If your problem is specific to one or more files, then please upload the
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
175 offender(s) to:</P>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
176
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
177 <P>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">ftp://mplayerhq.hu/MPlayer/incoming/</A></P>
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
178
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
179 <P>Also upload a small text file having the same base name as your file
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
180 with a .txt extension. Describe the problem you are having with the
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
181 particular file there and include your email address as well as the output
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
182 of <B>MPlayer</B> at verbosity level 1. Usually the first 1-5 MB of a file are
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
183 enough to reproduce the problem, but to be sure we ask you to:</P>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
184
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
185 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
186
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
187 <P>It will take the first five megabytes of <STRONG>'your-file'</STRONG> and
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
188 write it to <STRONG>'small-file'</STRONG>. Then try again on this small file
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
189 and if the bug still shows up your sample is sufficient for us. Please
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
190 <STRONG>do not ever</STRONG> send such files via mail! Upload it, and send
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
191 only the path/filename of the file on the FTP-server. If the file is
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
192 accessible on the net, then sending the <STRONG>exact</STRONG> URL is
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
193 sufficient.</P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
194
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
195
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
196 <H4>For crashes</H4>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
197
6470
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>.
diego
parents: 6446
diff changeset
198 <P>If you have a core dump of the crash continue reading the next paragraph,
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
199 otherwise skip it.</P>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
200
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
201
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
202 <H4>How to extract meaningful information from a core dump</H4>
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
203
7103
da10c0756649 Added some introductory words, request only CVS for bug reports and further
diego
parents: 7102
diff changeset
204 <P>Please create the following command file:</P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
205
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
206 <P><CODE>disass $eip-32 $eip+32<BR>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
207 printf "eax=%08lX\n",$eax<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
208 printf "ebx=%08lX\n",$ebx<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
209 printf "ecx=%08lX\n",$ecx<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
210 printf "edx=%08lX\n",$edx<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
211 printf "esp=%08lX\n",$esp<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
212 printf "ebp=%08lX\n",$ebp<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
213 printf "edi=%08lX\n",$edi<BR>
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
214 printf "esi=%08lX\n",$esi</CODE></P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
215
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
216 <P>Then simply execute the following on your command line:</P>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
217
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
218 <P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=command_file &gt; mplayer.bug</CODE></P>
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
219
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
220
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
221 <H4>How to conserve information about a reproducible crash</H4>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
222
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
223 Recompile <B>MPlayer</B> with debugging code enabled:
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
224
5347
0ba8c5086d11 Suggest --enable-debug=3
atmos4
parents: 5237
diff changeset
225 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;./configure --enable-debug=3<BR>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
226 &nbsp;&nbsp;&nbsp;&nbsp;make</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
227
6470
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>.
diego
parents: 6446
diff changeset
228 and then run <B>MPlayer</B> within gdb using:
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
229
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
230 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;gdb mplayer</CODE></P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
231
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
232 You are now within gdb. Type:
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
233
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
234 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;run -v [options-to-mplayer] filename</code></P>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
235
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
236 and reproduce your crash. As soon as you did it, gdb will
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
237 return you to the command line prompt where you have to enter
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
238
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
239 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;bt<BR>
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
240 &nbsp;&nbsp;&nbsp;&nbsp;disass $eip-32 $eip+32</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
241
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
242 and send the complete output to us.
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
243
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
244
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
245 <H3>General note</H3>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
246
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
247 <P>If something is quite big (logs for instance) then it is better to upload
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
248 it to the FTP server in a compressed format (gzip and bzip preferred) and
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
249 include only the path and filename in your bug report.</P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
250
7101
ed54a7bba268 Cosmetics: Some more indents and newlines.
diego
parents: 7100
diff changeset
251
7102
a3eefdc6e640 Added proper heading tags and fixed the HTML structure.
diego
parents: 7101
diff changeset
252 <H2>I know what I am doing...</H2>
3228
fd1bbd90d87a secret :)
arpi
parents: 3011
diff changeset
253
5237
99aee378e507 wording patch by Diego & Egger
gabucino
parents: 5108
diff changeset
254 <P>If you created a proper bug report following the steps above and you are
7100
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
255 confident it is a bug in <B>MPlayer</B>, not a compiler problem or broken
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
256 file, you have already read the documentation and you could not find a
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
257 solution, your sound drivers are OK, then you might want to subscribe to the
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
258 mplayer-advusers list and send your bug report there to get a better and
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
259 faster answer.<BR><BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
260 Please be advised that if you post newbie questions or questions answered
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
261 in the manual there, you will be ignored or flamed instead of getting an
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
262 appropriate answer.<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
263 So do not flame us and subscribe to -advusers only if you really know
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
264 what you are doing and feel like being an advanced <B>MPlayer</B> user or
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
265 developer. If you meet these criteria it should not be difficult to find
9e641d749832 Cosmetics: Indented code and inserted empty lines.
diego
parents: 6906
diff changeset
266 out how to subscribe...</P>
3228
fd1bbd90d87a secret :)
arpi
parents: 3011
diff changeset
267
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
268 </BODY>
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
269 </HTML>