annotate DOCS/xml/en/bugs.xml @ 27990:a5755165051a

Use doxygen-style comments in file header. Remove tabs usage.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<appendix id="bugs">
<title>Known bugs</title>

<sect1 id="bugs-special">
<title>Special system/CPU-specific bugs/problems</title>

<itemizedlist>
<listitem>
  <para>General SIGILL (signal 4):</para>
  <para>
  Problem: you compiled and run <application>MPlayer</application> on
  different machines (for example compiled on P3 and running on Celeron)
  </para>
  <para>
  Solution: compile <application>MPlayer</application> on the same machine
  where you will use it!
  </para>
  <para>
  Workaround: You can forget all this by configuring with the
  <option>--enable-runtime-cpudetection</option> option or you can
  disable particular CPU instruction sets with more specific options (like
  <option>--disable-mmx</option>, <option>--disable-3dnow</option>, etc).
  </para>
</listitem>

<listitem>
  <para>Crashes when dumping streams:</para>
  <para>Problem: core dump</para>
  <para>Solution: Don't panic. Make sure you know where your towel is.</para>
</listitem>
</itemizedlist>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugs-audio">
<title>Various A-V sync and other audio problems</title>

<sect2 id="bugs-delay-all">
<title>General audio delay or jerky sound
  (exists with all or many files)</title>

<itemizedlist>
<listitem><para>
  most common: buggy audio driver! - try to use different drivers, try ALSA OSS
  emulation with <option>-ao oss</option>, also try <option>-ao sdl</option>,
  sometimes it helps. If your file plays fine with <option>-nosound</option>,
  then you can be sure it's sound card (driver) problem.
</para></listitem>

<listitem>
  <para>audio buffer problems (buffer size badly detected)</para>
  <para>
  Workaround: <application>MPlayer</application>'s <option>-abs</option> option
  </para>
</listitem>

<listitem><para>
  samplerate problems - maybe your card doesn't support the samplerate used in
  your files - try the resampling filter (<option>-af resample=...</option>)
</para></listitem>

<listitem>
  <para>slow machine (CPU or VGA)</para>
  <para>
  try with <option>-vo null</option>, if it plays well, then you have slow
  VGA card/driver
  </para>
  <para>
  Workaround: buy a faster card or read this documentation about how to speed up
  </para>
  <para>Also try <option>-framedrop</option></para>
</listitem>
</itemizedlist>
</sect2>

<!-- ********** -->

<sect2 id="bugs-delay-specific">
<title>Audio delay/desync specific to one or a few files</title>

<itemizedlist>
<listitem>
  <para>bad file</para>
  <para>
  Workaround:
  <itemizedlist>
  <listitem>
    <para>
	<option>-ni</option> or <option>-nobps</option> option
	(for non-interleaved or bad files)
	</para>
    <para>and/or</para>
  </listitem>
  <listitem>
    <para>
	<option>-mc 0</option>
	(required for files with badly interleaved VBR audio)
	</para>
    <para>and/or</para>
  </listitem>
  <listitem>
    <para>
	<option>-delay</option> or <keycap>+</keycap>/<keycap>-</keycap>
        keys at runtime to adjust delay
	</para>
  </listitem>
  </itemizedlist>
  If none of these help, please upload the file, we'll check (and fix).
  </para>
</listitem>

<listitem>
  <para>your sound card doesn't support 48kHz playback</para>
  <para>
  Workaround: buy a better sound card... or try to decrease fps by 10%
  (use <option>-fps 27</option> for a 30fps movie) or use the resample filter
  </para>
</listitem>

<listitem>
  <para>
  slow machine (if A-V is not around 0,
  and the last number in the status line increasing)
  </para>
  <para>Workaround: <option>-framedrop</option></para>
</listitem>
</itemizedlist>
</sect2>

</sect1>

</appendix>