mplayer.hg: DOCS/bugreports.html annotate

annotate DOCS/bugreports.html @ 7102:a3eefdc6e640

Added proper heading tags and fixed the HTML structure.

author	diego
date	Tue, 27 Aug 2002 21:32:35 +0000
parents	ed54a7bba268
children	da10c0756649

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
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	13 <H1><A NAME=C>Appendix C - How to report bugs</A></H1>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	14
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	15
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	16 <H2>How to fix bugs</H2>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	17
6445 e676143308bf Added a short note on how to contribute fixes. diego parents: 6409 diff changeset	18 <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	19 the bug yourself. Or maybe you already did that? Please read
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	20 <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	21 your code included in <B>MPlayer</B>. The people on the
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	22 <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	23 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	24
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	25
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	26 <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	27
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	28 <P>First of all please try the latest CVS version of <B>MPlayer</B> as your bug
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	29 might already be fixed there. CVS instructions can be found at the bottom of
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	30 <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	31 README. If this did not help please refer to
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	32 <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	33 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	34 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	35
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	36 <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	37 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	38 Sometimes other users already experienced your troubles and know how to
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	39 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	40
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	41 <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	42 detective work to narrow down the circumstances under which the problem
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	43 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	44 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	45 independent? Can you reproduce it with all output drivers? The more
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	46 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	47 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	48 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	49
1a5858256659 The endless quest to force people into writing good bug reports part 2342: diego parents: 6783 diff changeset	50 <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	51 <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	52 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	53 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	54 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	55 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	56
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	57
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	58 <H3>Where to report bugs?</H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	59
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	60 <P>Subscribe to the mplayer-users mailing list:<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	61     <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	62 and send your bug report to:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	63     <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	64
7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>. diego parents: 6446 diff changeset	65 <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	66 <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	67 <B>do not send HTML mail</B> to any of our mailing lists. You will only get
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	68 ignored or banned. Also note that we will not individually CC (carbon-copy)
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	69 people so it is a good idea to subscribe to actually receive your answer.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	70
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	71
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	72 <H3>What to report?</H3>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	73
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	74 <H4>System Information:</H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	75
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	76 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	77 <LI>Your Linux distribution or operating system e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	78 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	79 <LI>Red Hat 7.1</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	80 <LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	81 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	82 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	83 <LI>kernel version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	84 <CODE>uname -a</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	85 <LI>libc version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	86 <CODE>ls -l /lib/libc[.-]*</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	87 <LI>X version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	88 <CODE>X -version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	89 <LI>gcc and ld versions:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	90 <CODE>gcc -v<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	91 ld -v</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	92 <LI>binutils version:<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	93 <CODE>as --version</CODE></LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	94 <LI>If you have problems with fullscreen mode:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	95 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	96 <LI>Window manager type and version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	97 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	98 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	99 <LI>If only the GUI is buggy:
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	100 <UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	101 <LI>GTK version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	102 <LI>GLIB version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	103 <LI>libpng version</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	104 <LI>GUI situation in which the bug occurs</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	105 </UL>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	106 </LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	107 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	108
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	109
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	110 <H4>Hardware & drivers:</H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	111
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	112 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	113 <LI>CPU info (this works on Linux only):<BR>
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	114 <CODE>cat /proc/cpuinfo</CODE></LI>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	115 <LI>Video card manufacturer and model, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	116 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	117 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	118 <LI>Matrox G400 DH 32MB SGRAM</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	119 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	120 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	121 <LI>Video driver type & version, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	122 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	123 <LI>X built-in driver</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	124 <LI>nVidia 0.9.623</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	125 <LI>Utah-GLX CVS 2001-02-17</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	126 <LI>DRI from X 4.0.3</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	127 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	128 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	129 <LI>Sound card type & driver, e.g.:
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	130 <UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	131 <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	132 <LI>Creative SB16 with kernel OSS drivers</LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	133 <LI>GUS PnP with ALSA OSS emulation</LI>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	134 </UL>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	135 </LI>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	136 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	137 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	138
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	139
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	140 <H4>For compilation problems/errors</H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	141
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	142 Please include these files:
a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	143
6055 3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	144 <UL>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	145 <LI>configure.log</LI>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	146 <LI>config.h</LI>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	147 <LI>config.mak</LI>
3ca1f8cf7bfc various updates by Diego Biurrun <diego@biurrun.de> arpi parents: 5705 diff changeset	148 <LI>libvo/config.mak</LI>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	149 </UL>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	150
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	151
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	152 <H4>For playback problems</H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	153
6470 7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>. diego parents: 6446 diff changeset	154 <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	155 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	156 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	157 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	158
26c35aa7e1d8 Remind people to NOT cut mplayer output, removed italics that make text diego parents: 6055 diff changeset	159 <P><CODE>    mplayer -v [options] [filename] &> mplayer.log</CODE></P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	160
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	161 <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	162 offender(s) to:</P>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	163
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	164 <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	165
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	166 <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	167 with a .txt extension. Describe the problem you are having with the
ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	168 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	169 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	170 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	171
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	172 <P><CODE>    dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	173
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	174 <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	175 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	176 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	177 <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	178 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	179 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	180 sufficient.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	181
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	182
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	183 <H4>For crashes</H4>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	184
6470 7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>. diego parents: 6446 diff changeset	185 <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	186 otherwise skip it.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	187
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	188
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	189 <H4>How to extract meaningful information from a core dump</H4>
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	190
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	191 <P>Please create following command file:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	192
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	193 <P><CODE>disass $eip-32 $eip+32<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	194 printf "eax=%08lX\n",$eax<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	195 printf "ebx=%08lX\n",$ebx<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	196 printf "ecx=%08lX\n",$ecx<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	197 printf "edx=%08lX\n",$edx<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	198 printf "esp=%08lX\n",$esp<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	199 printf "ebp=%08lX\n",$ebp<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	200 printf "edi=%08lX\n",$edi<BR>
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	201 printf "esi=%08lX\n",$esi</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	202
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	203 <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	204
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	205 <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	206
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	207
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	208 <H4>How to conserve information about a reproducible crash</H4>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	209
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	210 Recompile <B>MPlayer</B> with debugging code enabled:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	211
5347 0ba8c5086d11 Suggest --enable-debug=3 atmos4 parents: 5237 diff changeset	212 <P><CODE>    ./configure --enable-debug=3<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	213     make</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	214
6470 7051757b01df HTML mail not wanted, mplayer --> <B>MPlayer</B>. diego parents: 6446 diff changeset	215 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	216
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	217 <P><CODE>    gdb mplayer</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	218
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	219 You are now within gdb. Type:
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	220
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	221 <P><CODE>    run -v [options-to-mplayer] filename</code></P>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	222
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	223 and reproduce your crash. As soon as you did it, gdb will
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	224 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	225
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	226 <P><CODE>    bt<BR>
7100 9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	227     disass $eip-32 $eip+32</CODE></P>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	228
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	229 and send the complete output to us.
99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	230
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	231
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	232 <H3>General note</H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	233
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	234 <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	235 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	236 include only the path and filename in your bug report.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	237
7101 ed54a7bba268 Cosmetics: Some more indents and newlines. diego parents: 7100 diff changeset	238
7102 a3eefdc6e640 Added proper heading tags and fixed the HTML structure. diego parents: 7101 diff changeset	239 <H2>I know what I am doing...</H2>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	240
5237 99aee378e507 wording patch by Diego & Egger gabucino parents: 5108 diff changeset	241 <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	242 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	243 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	244 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	245 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	246 faster answer.<BR><BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	247 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	248 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	249 appropriate answer.<BR>
9e641d749832 Cosmetics: Indented code and inserted empty lines. diego parents: 6906 diff changeset	250 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	251 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	252 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	253 out how to subscribe...</P>
3228 fd1bbd90d87a secret :) arpi parents: 3011 diff changeset	254
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	255 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	256 </HTML>

Mercurial > mplayer.hg

annotate DOCS/bugreports.html @ 7102:a3eefdc6e640