mplayer.hg: DOCS/bugreports.html annotate

annotate DOCS/bugreports.html @ 7365:822923446b66

Removed authors and maintainers section, now in txt format.

author	diego
date	Tue, 10 Sep 2002 21:56:05 +0000
parents	da10c0756649
children	427935644581

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

Mercurial > mplayer.hg

annotate DOCS/bugreports.html @ 7365:822923446b66