mplayer.hg: DOCS/bugreports.html annotate

annotate DOCS/bugreports.html @ 8758:ed6cf8b95138

More bug reporting HOWTO links, crash section reordered, compilation section extended, configure section added.

author	diego
date	Sat, 04 Jan 2003 02:33:09 +0000
parents	8ceb8a8b7244
children	246a4b986d44

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
7365 822923446b66 Removed authors and maintainers section, now in txt format. diego parents: 7103 diff changeset	13 <H1><A NAME="B">Appendix B - 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
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	19 improving MPlayer and very much appreciated, please understand that you
7103 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
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	29 your code included in MPlayer. The people on the
7100 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
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	36 <P>First of all please try the latest CVS version of MPlayer 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
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	49 circumvent a problem even if it is a bug in MPlayer 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
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	61 <A HREF="http://www.tuxedo.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</A>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	62 by <A HREF="http://www.tuxedo.org/~esr/">Eric S. Raymond</A>. There is another
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	63 called
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	64 <A HREF="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report Bugs Effectively</A>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	65 by <A HREF="http://www.chiark.greenend.org.uk/~sgtatham/">Simon Tatham</A>. If
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	66 you follow these guidelines you should be able to get help. But please
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	67 understand that we all follow the mailing lists voluntarily in our free time.
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	68 We are very busy and cannot guarantee that you will get a solution for your
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	69 problem or even an answer.</P>
6445 e676143308bf Added a short note on how to contribute fixes. diego parents: 6409 diff changeset	70
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	71
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	72 <H3>Where to report bugs?</H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	73
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	74 <P>Subscribe to the mplayer-users mailing list:<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	75     <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	76 and send your bug report to:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	77     <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	78
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>. diego parents: 6446 diff changeset	79 <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	80 <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	81 <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	82 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	83 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	84 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	85 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	86 subscribe to actually receive your answer.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	87
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	88
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	89 <H3>What to report?</H3>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	90
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	91 <H4>System Information:</H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	92
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	93 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	94 <LI>Your Linux distribution or operating system and version e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	95 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	96 <LI>Red Hat 7.1</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	97 <LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	98 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	99 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	100 <LI>kernel version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	101 <CODE>uname -a</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	102 <LI>libc version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	103 <CODE>ls -l /lib/libc[.-]*</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	104 <LI>X version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	105 <CODE>X -version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	106 <LI>gcc and ld versions:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	107 <CODE>gcc -v<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	108 ld -v</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	109 <LI>binutils version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	110 <CODE>as --version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	111 <LI>If you have problems with fullscreen mode:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	112 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	113 <LI>Window manager type and version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	114 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	115 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	116 <LI>If only the GUI is buggy:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	117 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	118 <LI>GTK version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	119 <LI>GLIB version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	120 <LI>libpng version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	121 <LI>GUI situation in which the bug occurs</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	122 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	123 </LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	124 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	125
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	126
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	127 <H4>Hardware & drivers:</H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	128
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	129 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	130 <LI>CPU info (this works on Linux only):<BR>
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	131 <CODE>cat /proc/cpuinfo</CODE></LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	132 <LI>Video card manufacturer and model, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	133 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	134 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	135 <LI>Matrox G400 DH 32MB SGRAM</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	136 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	137 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	138 <LI>Video driver type & version, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	139 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	140 <LI>X built-in driver</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	141 <LI>nVidia 0.9.623</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	142 <LI>Utah-GLX CVS 2001-02-17</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	143 <LI>DRI from X 4.0.3</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	144 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	145 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	146 <LI>Sound card type & driver, e.g.:
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>Creative SBLive! Gold with OSS driver from oss.creative.com</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	149 <LI>Creative SB16 with kernel OSS drivers</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	150 <LI>GUS PnP with ALSA OSS emulation</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	151 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	152 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	153 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	154 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	155
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	156
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	157 <H4>For compilation problems/errors</H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	158
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	159 Please include these files:
a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	160
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	161 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	162 <LI><CODE>config.h</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	163 <LI><CODE>config.mak</CODE></LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	164 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	165
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	166 Only if compilation fails below one of these directories, include these files:
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	167
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	168 <UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	169 <LI><CODE>Gui/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	170 <LI><CODE>libvo/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	171 <LI><CODE>libao2/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	172 </UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	173
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	174
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	175 <H4>For configure problems</H4>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	176
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	177 Include <CODE>configure.log</CODE>.
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	178
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	179
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	180 <H4>For playback problems</H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	181
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	182 <P>Please include the output of MPlayer at verbosity level 1, but
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	183 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	184 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	185 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	186
8641 8ceb8a8b7244 bashism diego parents: 7818 diff changeset	187 <P><CODE>    mplayer -v [options] [filename] > mplayer.log 2>&1</CODE></P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	188
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	189 <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	190 offender(s) to:</P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	191
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	192 <P>    <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	193
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	194 <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	195 with a .txt extension. Describe the problem you are having with the
ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	196 particular file there and include your email address as well as the output
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	197 of MPlayer at verbosity level 1. Usually the first 1-5 MB of a file are
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	198 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	199
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	200 <P><CODE>    dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	201
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	202 <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	203 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	204 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	205 <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	206 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	207 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	208 sufficient.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	209
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	210
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	211 <H4>For crashes</H4>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	212
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	213 <P>You have to run MPlayer inside <CODE>gdb</CODE> and send us the complete
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	214 output or if you have a core dump of the crash you can extract useful
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	215 information from the <CODE>Core</CODE> file. Here's how:</P>
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	216
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	217 <H4>How to conserve information about a reproducible crash</H4>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	218
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	219 Recompile MPlayer with debugging code enabled:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	220
5347 0ba8c5086d11 Suggest --enable-debug=3 atmos4 parents: 5237 diff changeset	221 <P><CODE>    ./configure --enable-debug=3<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	222     make</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	223
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	224 and then run MPlayer within gdb using:
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	225
7640 427935644581 updates, fixes gabucino parents: 7365 diff changeset	226 <P><CODE>    gdb ./mplayer</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	227
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	228 You are now within gdb. Type:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	229
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	230 <P><CODE>    run -v [options-to-mplayer] filename</code></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	231
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	232 and reproduce your crash. As soon as you did it, gdb will
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	233 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	234
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	235 <P><CODE>    bt<BR>
7818 be462f075d52 Obtain gdb information from non i386 machines. diego parents: 7814 diff changeset	236     disass $pc-32 $pc+32</CODE></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	237
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	238
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	239 <H4>How to extract meaningful information from a core dump</H4>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	240
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	241 <P>Please create the following command file:</P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	242
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	243 <P><CODE>disass $pc-32 $pc+32<BR>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	244 info all-registers</CODE></P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	245
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	246 <P>Then simply execute the following on your command line:</P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	247
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	248 <P>    <CODE>gdb mplayer --core=core -batch --command=command_file > mplayer.bug</CODE></P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	249
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	250
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	251 <H3>General note</H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	252
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	253 <P>If something is quite big (logs for instance) then it is better to upload
7640 427935644581 updates, fixes gabucino parents: 7365 diff changeset	254 it to the FTP server in a compressed format (gzip and bzip2 preferred) and
7700 4a39a8bac5de Mailing list section reworded and updated. This should at some point be diego parents: 7640 diff changeset	255 include only the path and filename in your bug report. Our mailing lists
4a39a8bac5de Mailing list section reworded and updated. This should at some point be diego parents: 7640 diff changeset	256 have a message size limit of 80k, if you have something bigger you have to
4a39a8bac5de Mailing list section reworded and updated. This should at some point be diego parents: 7640 diff changeset	257 compress or upload it.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	258
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	259
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	260 <H2>I know what I am doing...</H2>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	261
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	262 <P>If you created a proper bug report following the steps above and you are
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	263 confident it is a bug in MPlayer, not a compiler problem or broken
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	264 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	265 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	266 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	267 faster answer.<BR><BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	268 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	269 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	270 appropriate answer.<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	271 So do not flame us and subscribe to -advusers only if you really know
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	272 what you are doing and feel like being an advanced MPlayer user or
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	273 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	274 out how to subscribe...</P>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	275
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	276 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	277 </HTML>

Mercurial > mplayer.hg

annotate DOCS/bugreports.html @ 8758:ed6cf8b95138