annotate DOCS/BUGS @ 1331:b4457de47804

ds->type removed - using id-based audio format detection in mplayer.c

Known bugs:
~~~~~~~~~~~

Special system/cpu-specific bugs/problems:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. SIGILL (signal 4) in draw_frame, on P3 (mostly with 2.2.x kernels):
  Problem: movups is crashing in libvo/fastmemcpy.h
  Workaround:  ./configure --disable-fastmemcpy
  SOLVED: disabled SSE code in fastmemcpy.h ;(

2. No image (black image) in RGB 15/16bpp (x11,dga,fbdev,svga) playing
  MPEG or OpenDivX files:
  Problem: gcc 2.96 bug
  Workaround: ./configure --disable-mmx, or use gcc 2.95.x
  SOLVED: code fixed

3. SIGILL (signal 4) or other fault at loading l3codeca.acm:
  Problem: shared libs are loaded to 0x00xxxxxx instead of 0x40xxxxxx
  Workaround: mplayer -afm 1 ...
  SOLVED: you are using some security kernel patch, like OpenWall etc.

4. SIGILL (signal 4) on P3 using 2.2.x kernels:
  Problem: kernel 2.2.x doesn't have proper (working) SSE support
  Solution: upgrade kernel to 2.4.x
  Workaround: ./configure --disable-sse

5. General SIGILL (signal 4):
  Problem: you compiled and run mplayer in different machines
    (for example compiled on P3 and running on celeron)
  Solution: compile MPlayer on the same machine where you will use it!
  Workaround: ./configure --disable-sse etc. options

Various A-V sync and other audio problems:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
General audio delay or jerky sound (exists with all or many files):
- audio buffer problems (buffer size badly detected)
  Workaround:  mplayer -abs option
- slow machine (cpu or vga)
  try with -vo null, if it plays well, then you have slow VGA card/driver:
  Workaround: buy a faster card or read DOCS/VIDEOCARDS about how to speed up
  SOLVED: try -framedrop

Audio delay/de-sync specific to one or a few files:
- bad file (please upload the file, so we can check & fix)
  Workaround: -ni or -bps option   (for non-interlaved or bad files)
              -mc 0   (required for files with VBR audio)
              -delay option or +/- keys at runtime to adjust delay
- your soundcard doesn't support 48Khz playback
  Workaround: buy a better soundcard... 
              or try to decrease fps by 10% (use -fps 27 for a 30fps movie)
- slow machine
  (if A-V is not around 0, and teh last number in the status line increasing)
  Workaround: -framedrop

After many > or ^ (fast forward) audio vs. video is going out of sync (ASF/AVI)
- bug in mplayer code (a-v sync probs after seek... not really bug but
  my avi/asf seeking code is not perfect yet)
  Workaround: -bps
  SOLVED: code fixed (but -bps still can help)

Signal 11 in decode_audio:
- mp3lib doesn't handle (yet) well bad/broken audio streams
  Workaround: -afm 4
  SOLVED: fixed mp3lib, it must be rock solid now!
- if it's still bad, try with -nosound  [and report the bug, see BUGREPORTS]

No sound at all:
- your file uses an unsupported codec
  Workaround: read DOCS/CODECS, and help us adding support for it

Video-out problems:
~~~~~~~~~~~~~~~~~~~
First note: options -fs -vm and -zoom are just recommendations, not (yet)
supported by all drivers. So it isn't a bug if it doesn't work.
Only a few driver supports scaling/zooming, don't expect this from x11 or dga.

OSD/sub flickering:
- x11 driver: sorry, it can't be fixed now
- xv driver: increase number of buffers in libvo/vo_xv.c, and recompile all


A'rpi / Astral & ESP-team