mplayer.hg: DOCS/bugreports.html annotate

annotate DOCS/bugreports.html @ 8844:3f32b0a251ab

Report X color depth for XVIDIX problems. Patch by James Stembridge <jstembridge@gmx.net>.

author	diego
date	Wed, 08 Jan 2003 19:59:46 +0000
parents	246a4b986d44
children	37fa18a88e76

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>
8844 3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	116 <LI>If you have problems with XVIDIX:
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	117 <UL>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	118 <LI>X colour depth:<BR>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	119 <CODE>xdpyinfo \| grep "depth of root"</CODE></LI>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	120 </UL>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	121 </LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	122 <LI>If only the GUI is buggy:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	123 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	124 <LI>GTK version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	125 <LI>GLIB version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	126 <LI>libpng version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	127 <LI>GUI situation in which the bug occurs</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	128 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	129 </LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	130 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	131
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	132
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	133 <H4>Hardware & drivers:</H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	134
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	135 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	136 <LI>CPU info (this works on Linux only):<BR>
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	137 <CODE>cat /proc/cpuinfo</CODE></LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	138 <LI>Video card manufacturer and model, 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>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	141 <LI>Matrox G400 DH 32MB SGRAM</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	142 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	143 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	144 <LI>Video driver type & version, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	145 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	146 <LI>X built-in driver</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	147 <LI>nVidia 0.9.623</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	148 <LI>Utah-GLX CVS 2001-02-17</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	149 <LI>DRI from X 4.0.3</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	150 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	151 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	152 <LI>Sound card type & driver, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	153 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	154 <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	155 <LI>Creative SB16 with kernel OSS drivers</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	156 <LI>GUS PnP with ALSA OSS emulation</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	157 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	158 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	159 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	160 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	161
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	162
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	163 <H4>For compilation problems/errors</H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	164
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	165 Please include these files:
a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	166
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	167 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	168 <LI><CODE>config.h</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	169 <LI><CODE>config.mak</CODE></LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	170 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	171
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	172 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	173
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	174 <UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	175 <LI><CODE>Gui/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	176 <LI><CODE>libvo/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	177 <LI><CODE>libao2/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	178 </UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	179
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	180
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	181 <H4>For configure problems</H4>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	182
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	183 Include <CODE>configure.log</CODE>.
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	184
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	185
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	186 <H4>For playback problems</H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	187
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	188 <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	189 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	190 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	191 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	192
8641 8ceb8a8b7244 bashism diego parents: 7818 diff changeset	193 <P><CODE>    mplayer -v [options] [filename] > mplayer.log 2>&1</CODE></P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	194
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	195 <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	196 offender(s) to:</P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	197
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	198 <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	199
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	200 <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	201 with a .txt extension. Describe the problem you are having with the
ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	202 particular file there and include your email address as well as the output
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	203 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	204 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	205
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	206 <P><CODE>    dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	207
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	208 <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	209 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	210 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	211 <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	212 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	213 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	214 sufficient.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	215
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>For crashes</H4>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	218
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	219 <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	220 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	221 information from the <CODE>Core</CODE> file. Here's how:</P>
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	222
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	223 <H4>How to conserve information about a reproducible crash</H4>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	224
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	225 Recompile MPlayer with debugging code enabled:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	226
5347 0ba8c5086d11 Suggest --enable-debug=3 atmos4 parents: 5237 diff changeset	227 <P><CODE>    ./configure --enable-debug=3<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	228     make</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	229
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	230 and then run MPlayer within gdb using:
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	231
7640 427935644581 updates, fixes gabucino parents: 7365 diff changeset	232 <P><CODE>    gdb ./mplayer</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	233
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	234 You are now within gdb. Type:
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 <P><CODE>    run -v [options-to-mplayer] filename</code></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	237
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	238 and reproduce your crash. As soon as you did it, gdb will
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	239 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	240
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	241 <P><CODE>    bt<BR>
7818 be462f075d52 Obtain gdb information from non i386 machines. diego parents: 7814 diff changeset	242     disass $pc-32 $pc+32</CODE></P>
8838 246a4b986d44 100l to doxmaintainers arpi parents: 8758 diff changeset	243     info all-registers</CODE></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	244
8758 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 <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	247
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	248 <P>Please create the following command file:</P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	249
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	250 <P><CODE>disass $pc-32 $pc+32<BR>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	251 info all-registers</CODE></P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	252
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	253 <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	254
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	255 <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	256
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	257
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	258 <H3>General note</H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	259
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	260 <P>If something is quite big (logs for instance) then it is better to upload
7640 427935644581 updates, fixes gabucino parents: 7365 diff changeset	261 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	262 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	263 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	264 compress or upload it.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	265
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	266
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	267 <H2>I know what I am doing...</H2>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	268
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	269 <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	270 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	271 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	272 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	273 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	274 faster answer.<BR><BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	275 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	276 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	277 appropriate answer.<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	278 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	279 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	280 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	281 out how to subscribe...</P>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	282
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	283 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	284 </HTML>

Mercurial > mplayer.hg

annotate DOCS/bugreports.html @ 8844:3f32b0a251ab