mplayer.hg: DOCS/bugreports.html annotate

annotate DOCS/bugreports.html @ 9200:d8f8013a61b3

sync

author	nicolas
date	Sat, 01 Feb 2003 14:52:49 +0000
parents	636c1e894a27
children	bb210d621122

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
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
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
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
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
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	41 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	42 <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	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
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	72 <H2><A NAME="where">B.3 Where to report bugs</A></H2>
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
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	89 <H2><A NAME ="what">B.4 What to report</A></H2>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	90
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	91 <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	92 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	93 <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	94 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	95 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	96 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	97
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	98
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	99 <H3><A NAME="system">B.4.1 System Information</A></H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	100
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	101 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	102 <LI>Your Linux distribution or operating system and version e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	103 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	104 <LI>Red Hat 7.1</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	105 <LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	106 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	107 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	108 <LI>kernel version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	109 <CODE>uname -a</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	110 <LI>libc version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	111 <CODE>ls -l /lib/libc[.-]*</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	112 <LI>X version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	113 <CODE>X -version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	114 <LI>gcc and ld versions:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	115 <CODE>gcc -v<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	116 ld -v</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	117 <LI>binutils version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	118 <CODE>as --version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	119 <LI>If you have problems with fullscreen mode:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	120 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	121 <LI>Window manager type and version</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>
8844 3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	124 <LI>If you have problems with XVIDIX:
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	125 <UL>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	126 <LI>X colour depth:<BR>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	127 <CODE>xdpyinfo \| grep "depth of root"</CODE></LI>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	128 </UL>
3f32b0a251ab Report X color depth for XVIDIX problems. diego parents: 8838 diff changeset	129 </LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	130 <LI>If only the GUI is buggy:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	131 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	132 <LI>GTK version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	133 <LI>GLIB version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	134 <LI>libpng version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	135 <LI>GUI situation in which the bug occurs</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	136 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	137 </LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	138 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	139
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	140
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	141 <H3><A NAME="hardware">B.4.2 Hardware and drivers</A></H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	142
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	143 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	144 <LI>CPU info (this works on Linux only):<BR>
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	145 <CODE>cat /proc/cpuinfo</CODE></LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	146 <LI>Video card manufacturer and model, 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>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	149 <LI>Matrox G400 DH 32MB SGRAM</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>Video driver type & version, 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>X built-in driver</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	155 <LI>nVidia 0.9.623</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	156 <LI>Utah-GLX CVS 2001-02-17</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	157 <LI>DRI from X 4.0.3</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	158 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	159 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	160 <LI>Sound card type & driver, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	161 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	162 <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	163 <LI>Creative SB16 with kernel OSS drivers</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	164 <LI>GUS PnP with ALSA OSS emulation</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	165 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	166 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	167 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	168 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	169
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	170
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	171 <H3><A NAME="compilation">B.4.3 Compilation problems</A></H3>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	172
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	173 Please include these files:
a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	174
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	175 <UL>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	176 <LI><CODE>config.h</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	177 <LI><CODE>config.mak</CODE></LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	178 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	179
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	180 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	181
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	182 <UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	183 <LI><CODE>Gui/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	184 <LI><CODE>libvo/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	185 <LI><CODE>libao2/config.mak</CODE></LI>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	186 </UL>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	187
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	188
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	189 <H3><A NAME="configure">B.4.4 Configure problems</A></H3>
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	190
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	191 Include <CODE>configure.log</CODE>.
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	192
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	193
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	194 <H3><A NAME="playback">B.4.5 Playback problems</A></H3>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	195
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	196 <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	197 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	198 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	199 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	200
8641 8ceb8a8b7244 bashism diego parents: 7818 diff changeset	201 <P><CODE>    mplayer -v [options] [filename] > mplayer.log 2>&1</CODE></P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	202
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	203 <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	204 offender(s) to:</P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	205
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	206 <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	207
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	208 <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	209 with a .txt extension. Describe the problem you are having with the
ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	210 particular file there and include your email address as well as the output
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	211 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	212 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	213
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	214 <P><CODE>    dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	215
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	216 <P>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	217 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	218 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	219 <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	220 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	221 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	222 sufficient.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	223
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	224
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	225 <H3><A NAME="crash">B.4.6 Crashes</A></H3>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	226
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	227 <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	228 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	229 information from the <CODE>Core</CODE> file. Here's how:</P>
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
636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	232 <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	233
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	234 Recompile MPlayer with debugging code enabled:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	235
5347 0ba8c5086d11 Suggest --enable-debug=3 atmos4 parents: 5237 diff changeset	236 <P><CODE>    ./configure --enable-debug=3<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	237     make</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	238
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7700 diff changeset	239 and then run MPlayer within gdb using:
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	240
7640 427935644581 updates, fixes gabucino parents: 7365 diff changeset	241 <P><CODE>    gdb ./mplayer</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	242
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	243 You are now within gdb. Type:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	244
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	245 <P><CODE>    run -v [options-to-mplayer] filename</code></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	246
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	247 and reproduce your crash. As soon as you did it, gdb will
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	248 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	249
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	250 <P><CODE>    bt<BR>
8845 37fa18a88e76 10l to A'rpi diego parents: 8844 diff changeset	251     disass $pc-32 $pc+32<BR>
8838 246a4b986d44 100l to doxmaintainers arpi parents: 8758 diff changeset	252     info all-registers</CODE></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	253
8758 ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	254
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	255 <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	256
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	257 <P>Please create the following command file:</P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	258
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	259 <P><CODE>disass $pc-32 $pc+32<BR>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	260 info all-registers</CODE></P>
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	261
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	262 <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	263
ed6cf8b95138 More bug reporting HOWTO links, crash section reordered, compilation section diego parents: 8641 diff changeset	264 <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	265
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	266
8851 636c1e894a27 Appendix B and E numbered, encoding moved to a separate section. diego parents: 8845 diff changeset	267 <H2><A NAME="advusers">B.5 I know what I am doing...</A></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 @ 9200:d8f8013a61b3