mplayer.hg: DOCS/en/bugreports.html annotate

annotate DOCS/en/bugreports.html @ 9959:c35fd30aab72

10l, noted by Mark Szabo <mw3@daisy.chains.ch>

author	alex
date	Mon, 21 Apr 2003 17:16:49 +0000
parents	7412751211e0
children	9da833258d9d

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>
9506 6c6ea2b4cfdb default.css path fixed (it needs to be moved on CVS server!!) gabucino parents: 9475 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
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	13 <H1><A NAME="appendix_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
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	24 <H2><A NAME="fix">B.1 How to fix bugs</A></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
9387 72c0458c854a update of links regarding tech/ dir nicolas parents: 9382 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
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	34 <H2><A NAME="report">B.2 How to report bugs</A></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
9475 6d4d66421b29 binary packages not supported diego parents: 9387 diff changeset	39 <B>only CVS</B> to report bugs. This includes binary packages of MPlayer.
6d4d66421b29 binary packages not supported diego parents: 9387 diff changeset	40 Please do not report bugs in one of the various RPM or Debian packages of
6d4d66421b29 binary packages not supported diego parents: 9387 diff changeset	41 MPlayer. CVS instructions can be found at the bottom of
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	42 <A HREF="http://www.mplayerhq.hu/homepage/dload.html">this page</A> or in the
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	43 README. If this did not help please refer to the
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	44 <A HREF="documentation.html#known_bugs">list of known bugs</A> and the
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	45 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	46 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	47
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	48 <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	49 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	50 Sometimes other users already experienced your troubles and know how to
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	51 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	52
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	53 <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	54 detective work to narrow down the circumstances under which the problem
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	55 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	56 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	57 independent? Can you reproduce it with all output drivers? The more
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	58 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	59 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	60 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	61
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	62 <P>An excellent and well written guide to asking questions in public forums is
9740 7412751211e0 link fixed diego parents: 9506 diff changeset	63 <A HREF="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</A>
7412751211e0 link fixed diego parents: 9506 diff changeset	64 by <A HREF="http://www.catb.org/~esr/">Eric S. Raymond</A>. There is another
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	65 called
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	66 <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	67 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	68 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	69 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	70 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	71 problem or even an answer.</P>
6445 e676143308bf Added a short note on how to contribute fixes. diego parents: 6409 diff changeset	72
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	73
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	74 <H2><A NAME="where">B.3 Where to report bugs</A></H2>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	75
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	76 <P>Subscribe to the mplayer-users mailing list:<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	77     <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	78 and send your bug report to:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	79     <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	80
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>. diego parents: 6446 diff changeset	81 <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	82 <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	83 <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	84 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	85 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	86 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	87 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	88 subscribe to actually receive your answer.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	89
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	90
9282 513e02e2e553 fixing others' 10/100liters gabucino parents: 9232 diff changeset	91 <H2><A NAME="what">B.4 What to report</A></H2>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	92
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	93 <P>You may need to include log, configuration or sample files in your bug
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	94 report. If some of them are quite big then it is better to upload them to our
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	95 <A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">FTP server</A> in a compressed
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	96 format (gzip and bzip2 preferred) and include only the path and file name in
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	97 your bug report. Our mailing lists have a message size limit of 80k, if you
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	98 have something bigger you have to compress or upload it.</P>
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	99
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	100
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	101 <H3><A NAME="system">B.4.1 System Information</A></H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	102
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	103 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	104 <LI>Your Linux distribution or operating system and version e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	105 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	106 <LI>Red Hat 7.1</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	107 <LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	108 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	109 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	110 <LI>kernel version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	111 <CODE>uname -a</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	112 <LI>libc version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	113 <CODE>ls -l /lib/libc[.-]*</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	114 <LI>X version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	115 <CODE>X -version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	116 <LI>gcc and ld versions:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	117 <CODE>gcc -v<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	118 ld -v</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	119 <LI>binutils version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	120 <CODE>as --version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	121 <LI>If you have problems with fullscreen mode:
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>Window manager type and version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	124 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	125 </LI>
8844 3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	126 <LI>If you have problems with XVIDIX:
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	127 <UL>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	128 <LI>X colour depth:<BR>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	129 <CODE>xdpyinfo \| grep "depth of root"</CODE></LI>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	130 </UL>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	131 </LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	132 <LI>If only the GUI is buggy:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	133 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	134 <LI>GTK version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	135 <LI>GLIB version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	136 <LI>libpng version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	137 <LI>GUI situation in which the bug occurs</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	138 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	139 </LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	140 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	141
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	142
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	143 <H3><A NAME="hardware">B.4.2 Hardware and drivers</A></H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	144
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	145 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	146 <LI>CPU info (this works on Linux only):<BR>
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	147 <CODE>cat /proc/cpuinfo</CODE></LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	148 <LI>Video card manufacturer and model, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	149 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	150 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	151 <LI>Matrox G400 DH 32MB SGRAM</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	152 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	153 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	154 <LI>Video driver type & version, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	155 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	156 <LI>X built-in driver</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	157 <LI>nVidia 0.9.623</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	158 <LI>Utah-GLX CVS 2001-02-17</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	159 <LI>DRI from X 4.0.3</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	160 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	161 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	162 <LI>Sound card type & driver, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	163 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	164 <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	165 <LI>Creative SB16 with kernel OSS drivers</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	166 <LI>GUS PnP with ALSA OSS emulation</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	167 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	168 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	169 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	170 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	171
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	172
9225 bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	173 <H3><A NAME="configure">B.4.3 Configure problems</A></H3>
bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	174
9232 1399facc01d7 small updates and style improvements diego parents: 9225 diff changeset	175 <P>If you get errors while running <CODE>./configure</CODE>, or autodetection
1399facc01d7 small updates and style improvements diego parents: 9225 diff changeset	176 of something fails, read <CODE>configure.log</CODE>. You may find the answer
1399facc01d7 small updates and style improvements diego parents: 9225 diff changeset	177 there, for example multiple versions of the same library mixed on your system,
1399facc01d7 small updates and style improvements diego parents: 9225 diff changeset	178 or you forgot to install the development package (those with the -dev suffix). If you think there is a bug, include <CODE>configure.log</CODE> in your bug
1399facc01d7 small updates and style improvements diego parents: 9225 diff changeset	179 report.</P>
9225 bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	180
bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	181
bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	182 <H3><A NAME="compilation">B.4.4 Compilation problems</A></H3>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	183
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	184 Please include these files:
a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	185
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	186 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	187 <LI><CODE>config.h</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	188 <LI><CODE>config.mak</CODE></LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	189 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	190
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	191 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	192
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	193 <UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	194 <LI><CODE>Gui/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	195 <LI><CODE>libvo/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	196 <LI><CODE>libao2/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	197 </UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	198
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	199
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	200 <H3><A NAME="playback">B.4.5 Playback problems</A></H3>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	201
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	202 <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	203 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	204 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	205 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	206
8641 8ceb8a8b7244 bashism diego parents: 7818 diff changeset	207 <P><CODE>    mplayer -v [options] [filename] > mplayer.log 2>&1</CODE></P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	208
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	209 <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	210 offender(s) to:</P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	211
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	212 <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	213
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	214 <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	215 with a .txt extension. Describe the problem you are having with the
ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	216 particular file there and include your email address as well as the output
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	217 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	218 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	219
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	220 <P><CODE>    dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	221
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	222 <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	223 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	224 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	225 <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	226 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	227 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	228 sufficient.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	229
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	230
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	231 <H3><A NAME="crash">B.4.6 Crashes</A></H3>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	232
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	233 <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	234 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	235 information from the <CODE>Core</CODE> file. Here's how:</P>
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	236
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	237
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	238 <H4><A NAME="debug">B.4.6.1 How to conserve information about a reproducible crash</A></H4>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	239
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	240 Recompile MPlayer with debugging code enabled:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	241
5347 0ba8c5086d11 Suggest --enable-debug=3 atmos4 parents: 5237 diff changeset	242 <P><CODE>    ./configure --enable-debug=3<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	243     make</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	244
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	245 and then run MPlayer within gdb using:
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	246
7640 427935644581 updates, fixes gabucino parents: 7365 diff changeset	247 <P><CODE>    gdb ./mplayer</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	248
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	249 You are now within gdb. Type:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	250
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	251 <P><CODE>    run -v [options-to-mplayer] filename</code></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	252
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	253 and reproduce your crash. As soon as you did it, gdb will
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	254 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	255
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	256 <P><CODE>    bt<BR>
8845 37fa18a88e76 10l to A'rpi diego parents: 8844 diff changeset	257     disass $pc-32 $pc+32<BR>
8838 246a4b986d44 100l to doxmaintainers arpi parents: 8758 diff changeset	258     info all-registers</CODE></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	259
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	260
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	261 <H4><A NAME="core">B.4.6.2 How to extract meaningful information from a core dump</A></H4>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	262
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	263 <P>Please create the following command file:</P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	264
9225 bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	265 <P><CODE>bt<BR>
bb210d621122 swapped configure & compile errors, configure section extended, 'bt' added arpi parents: 8851 diff changeset	266 disass $pc-32 $pc+32<BR>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	267 info all-registers</CODE></P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	268
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	269 <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	270
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	271 <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	272
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	273
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	274 <H2><A NAME="advusers">B.5 I know what I am doing...</A></H2>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	275
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	276 <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	277 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	278 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	279 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	280 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	281 faster answer.<BR><BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	282 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	283 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	284 appropriate answer.<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	285 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	286 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	287 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	288 out how to subscribe...</P>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	289
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	290 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	291 </HTML>

Mercurial > mplayer.hg

annotate DOCS/en/bugreports.html @ 9959:c35fd30aab72