Mercurial > mplayer.hg
comparison DOCS/xml/en/bugreports.xml @ 11540:d480f7e36b74
<application> attack
author | wight |
---|---|
date | Sun, 30 Nov 2003 13:07:40 +0000 |
parents | 9da833258d9d |
children | 3860159f1591 |
comparison
equal
deleted
inserted
replaced
11539:2364dda5fe7e | 11540:d480f7e36b74 |
---|---|
5 <para> | 5 <para> |
6 Good bug reports are a very valuable contribution to the development of any | 6 Good bug reports are a very valuable contribution to the development of any |
7 software project. But just like writing good software, good problem reports | 7 software project. But just like writing good software, good problem reports |
8 involve some work. Please realize that most developers are extremely busy and | 8 involve some work. Please realize that most developers are extremely busy and |
9 receive obscene amounts of email. So while your feedback is crucial in improving | 9 receive obscene amounts of email. So while your feedback is crucial in improving |
10 MPlayer and very much appreciated, please understand that you have to provide | 10 <application>MPlayer</application> and very much appreciated, please understand |
11 <emphasis role="bold">all</emphasis> of the information we request and follow | 11 that you have to provide <emphasis role="bold">all</emphasis> of the information |
12 the instructions in this document closely. | 12 we request and follow the instructions in this document closely. |
13 </para> | 13 </para> |
14 <sect1 id="bugreports_fix"> | 14 <sect1 id="bugreports_fix"> |
15 <title>How to fix bugs</title> | 15 <title>How to fix bugs</title> |
16 <para> | 16 <para> |
17 If you feel have the necessary skills you are invited to have a go at fixing the | 17 If you feel have the necessary skills you are invited to have a go at fixing the |
18 bug yourself. Or maybe you already did that? Please read | 18 bug yourself. Or maybe you already did that? Please read |
19 <ulink url="../../tech/patches.txt">this short document</ulink> to find out how to | 19 <ulink url="../../tech/patches.txt">this short document</ulink> to find out how to |
20 get your code included in MPlayer. The people on the | 20 get your code included in <application>MPlayer</application>. The people on the |
21 <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</ulink> | 21 <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</ulink> |
22 mailing list will assist you if you have questions. | 22 mailing list will assist you if you have questions. |
23 </para> | 23 </para> |
24 </sect1> | 24 </sect1> |
25 <sect1 id="bugreports_report"> | 25 <sect1 id="bugreports_report"> |
26 <title>How to report bugs</title> | 26 <title>How to report bugs</title> |
27 <para> | 27 <para> |
28 First of all please try the latest CVS version of MPlayer as your bug might | 28 First of all please try the latest CVS version of <application>MPlayer</application> |
29 already be fixed there. Development moves extremely fast, most problems in | 29 as your bug might already be fixed there. Development moves extremely fast, |
30 official releases are reported within days or even hours, so please use | 30 most problems in official releases are reported within days or even hours, so |
31 <emphasis role="bold">only CVS</emphasis> to report bugs. This includes | 31 please use <emphasis role="bold">only CVS</emphasis> to report bugs. This |
32 binary packages of MPlayer. CVS instructions can be found at the bottom of | 32 includes binary packages of <application>MPlayer</application>. CVS |
33 instructions can be found at the bottom of | |
33 <ulink url="http://www.mplayerhq.hu/homepage/dload.html">this page</ulink> or in | 34 <ulink url="http://www.mplayerhq.hu/homepage/dload.html">this page</ulink> or in |
34 the README. If this did not help please refer to the list of | 35 the README. If this did not help please refer to the list of |
35 <link linkend="bugs">known bugs</link> and the rest of the documentation. If your | 36 <link linkend="bugs">known bugs</link> and the rest of the documentation. If your |
36 problem is not known or not solvable by our instructions, then please report the bug. | 37 problem is not known or not solvable by our instructions, then please report the bug. |
37 </para> | 38 </para> |
38 | 39 |
39 <para> | 40 <para> |
40 Please do not send bug reports privately to individual developers. This is | 41 Please do not send bug reports privately to individual developers. This is |
41 community work and thus there might be several people interested in it. Sometimes | 42 community work and thus there might be several people interested in it. Sometimes |
42 other users already experienced your troubles and know how to circumvent a problem | 43 other users already experienced your troubles and know how to circumvent a problem |
43 even if it is a bug in MPlayer code. | 44 even if it is a bug in <application>MPlayer</application> code. |
44 </para> | 45 </para> |
45 | 46 |
46 <para> | 47 <para> |
47 Please describe your problem in as much detail as possible. Do a little detective | 48 Please describe your problem in as much detail as possible. Do a little detective |
48 work to narrow down the circumstances under which the problem occurs. Does the bug | 49 work to narrow down the circumstances under which the problem occurs. Does the bug |
243 </para> | 244 </para> |
244 | 245 |
245 <para> | 246 <para> |
246 Also upload a small text file having the same base name as your file with a .txt | 247 Also upload a small text file having the same base name as your file with a .txt |
247 extension. Describe the problem you are having with the particular file there and | 248 extension. Describe the problem you are having with the particular file there and |
248 include your email address as well as the output of MPlayer at verbosity level 1. | 249 include your email address as well as the output of <application>MPlayer</application> |
249 Usually the first 1-5 MB of a file are enough to reproduce the problem, but to be | 250 at verbosity level 1. Usually the first 1-5 MB of a file are enough to reproduce |
250 sure we ask you to: | 251 the problem, but to be sure we ask you to: |
251 <screen>dd if=<replaceable>yourfile</replaceable> of=<replaceable>smallfile</replaceable> bs=1024k count=5</screen> | 252 <screen>dd if=<replaceable>yourfile</replaceable> of=<replaceable>smallfile</replaceable> bs=1024k count=5</screen> |
252 It will take the first five megabytes of '<emphasis role="bold">your-file</emphasis>' | 253 It will take the first five megabytes of '<emphasis role="bold">your-file</emphasis>' |
253 and write it to '<emphasis role="bold">small-file</emphasis>'. Then try again on | 254 and write it to '<emphasis role="bold">small-file</emphasis>'. Then try again on |
254 this small file and if the bug still shows up your sample is sufficient for us. | 255 this small file and if the bug still shows up your sample is sufficient for us. |
255 Please <emphasis role="bold">do not ever</emphasis> send such files via mail! | 256 Please <emphasis role="bold">do not ever</emphasis> send such files via mail! |
268 </para> | 269 </para> |
269 | 270 |
270 <sect3 id="bugreports_debug"> | 271 <sect3 id="bugreports_debug"> |
271 <title>How to conserve information about a reproducible crash</title> | 272 <title>How to conserve information about a reproducible crash</title> |
272 <para> | 273 <para> |
273 Recompile MPlayer with debugging code enabled: | 274 Recompile <application>MPlayer</application> with debugging code enabled: |
274 <screen> | 275 <screen> |
275 ./configure --enable-debug=3 | 276 ./configure --enable-debug=3 |
276 make | 277 make |
277 </screen> | 278 </screen> |
278 and then run MPlayer within gdb using: | 279 and then run <application>MPlayer</application> within gdb using: |
279 <screen>gdb ./mplayer</screen> | 280 <screen>gdb ./mplayer</screen> |
280 You are now within gdb. Type: | 281 You are now within gdb. Type: |
281 <screen>run -v <replaceable>options-to-mplayer</replaceable> <replaceable>filename</replaceable></screen> | 282 <screen>run -v <replaceable>options-to-mplayer</replaceable> <replaceable>filename</replaceable></screen> |
282 and reproduce your crash. As soon as you did it, gdb will return you to the command | 283 and reproduce your crash. As soon as you did it, gdb will return you to the command |
283 line prompt where you have to enter | 284 line prompt where you have to enter |
307 | 308 |
308 <sect1 id="bugreports_advusers"> | 309 <sect1 id="bugreports_advusers"> |
309 <title>I know what I am doing...</title> | 310 <title>I know what I am doing...</title> |
310 <para> | 311 <para> |
311 If you created a proper bug report following the steps above and you are confident | 312 If you created a proper bug report following the steps above and you are confident |
312 it is a bug in MPlayer, not a compiler problem or broken file, you have already | 313 it is a bug in <application>MPlayer</application>, not a compiler problem or broken |
313 read the documentation and you could not find a solution, your sound drivers are | 314 file, you have already read the documentation and you could not find a solution, |
314 OK, then you might want to subscribe to the mplayer-advusers list and send your | 315 your sound drivers are OK, then you might want to subscribe to the mplayer-advusers |
315 bug report there to get a better and faster answer. | 316 list and send your bug report there to get a better and faster answer. |
316 </para> | 317 </para> |
317 | 318 |
318 <para> | 319 <para> |
319 Please be advised that if you post newbie questions or questions answered in the | 320 Please be advised that if you post newbie questions or questions answered in the |
320 manual there, you will be ignored or flamed instead of getting an appropriate answer. | 321 manual there, you will be ignored or flamed instead of getting an appropriate answer. |
321 So do not flame us and subscribe to -advusers only if you really know what you are | 322 So do not flame us and subscribe to -advusers only if you really know what you are |
322 doing and feel like being an advanced MPlayer user or developer. If you meet these | 323 doing and feel like being an advanced <application>MPlayer</application> user or |
323 criteria it should not be difficult to find out how to subscribe... | 324 developer. If you meet these criteria it should not be difficult to find out how to subscribe... |
324 </para> | 325 </para> |
325 | 326 |
326 </sect1> | 327 </sect1> |
327 | 328 |
328 </appendix> | 329 </appendix> |