diff DOCS/documentation.html @ 1500:526047bdda07

*** empty log message ***

--- a/DOCS/documentation.html	Sun Aug 12 22:36:05 2001 +0000
+++ b/DOCS/documentation.html	Mon Aug 13 10:38:01 2001 +0000
@@ -201,6 +201,9 @@
   _before_ compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be
   built.
 
+  If you plan to use the ProjectMayo's <B>OpenDivX</B> codec, check the
+  <A HREF="#2.1.2.1">2.1.2.1</A> section before compiling.
+
   Then build <B>MPlayer</B>:
 
 
@@ -260,7 +263,7 @@
 
   The most important video codecs:
   - MPEG1 (VCD) and MPEG2 (DVD) video
-  - DivX, OpenDivX and other MPEG4 variants
+  - DivX, FFmpeg, OpenDivX and other MPEG4 variants
   - Windows Media Video 7 (WMV1) used in .wmv files
   - Intel Indeo codecs (3.1,3.2,4.1,5.0)
   - MJPEG, ASV2 and other hardware formats
@@ -307,7 +310,8 @@
 
 
   <B>MPlayer</B> autodetects if OpenDivX is (properly) installed, just compile
-  as usual.
+  as usual. If it doesn't detect it, you didn't install it exactly as above,
+  and/or has fucked up config (see last question of 6.1 section).
 
   Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is
   very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX
@@ -345,16 +349,36 @@
   which is compatible with the traditional DivX. <B>MPlayer</B> contains this codec,
   and this makes it possible to <B>watch DivX movies on non-x86 platforms!</B>
   To get it compile, you'll need nasm, bison, and flex, above the other
-  devel tools. No manual hacking is needed to build it, ./configure detects
-  if it can be built. At the moment it doesn't support postprocessing, and
-  is under optimization (it's generally a bit faster than the DirectShow
-  DivX codec, now).
+  devel tools. It was removed from <B>MPlayer</B>'s cvs tree, you have
+  to download it manually directly from <B>FFmpeg</B>'s tree :
+
+
+  cvs -d:pserver:[e-mail]:/cvsroot/ffmpeg login
+  cvs -d:pserver:[e-mail]:/cvsroot/ffmpeg co ffmpeg
+
+
+  Note: if you copy with CVS subdirs, next time it's enough to do
+	'cvs update'.
+
+  Now, move the newly downloaded ffmpeg source's <B>libavcodec</B> directory,
+  (with all it's subdirectories) to <B>MPlayer</B>'s tree, so it will look
+  like this :
+
+
+		main/libavcodec
+
+
+  Symlinking is NOT enough, you have to copy it.
+
+  ./configure detects if it can be built. At the moment it doesn't support
+  postprocessing, and is under optimization (it's faster than the DS/VfW DivX
+  codec).
 
   In order to use it, refresh your codecs.conf file, and do as the manpage,
   or the example.conf says (the -vfm option).
 
   Note: libavcodec contains other codecs as well, but at the moment we mostly
-        focus on ffdivx.
+        focus on ffdivx, and it's unlikely that this will change.
 
   <A NAME=2.1.3>2.1.4.  Codec importing howto
 
@@ -388,7 +412,7 @@
   This is the MP3 codec.
   So, now we have all the info needed (fourcc, codec file, sample AVI), submit
   your codec support request in mail, and upload these files to the FTP:
-    ftp://mplayerhq.hu/MPlayer/incoming/<codecname>/
+    ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/
 
 
   <A NAME=2.1.4.2>2.1.4.2.  DirectShow codecs
@@ -421,7 +445,7 @@
 
   So, now we have all the info needed (fourcc, GUID, codec file, sample AVI),
   submit your codec support request in mail, and upload these files to the FTP:
-      ftp://mplayerhq.hu/MPlayer/incoming/<codecname>/
+      ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/
 
 
   <A NAME=2.2>2.2.  Video & Audio output devices
@@ -782,7 +806,7 @@
 		-vo sdl:name	specifies sdl video driver to use (ie. aalib,
 				dga, x11)
 		-ao sdl:name	specifies sdl audio driver to use (ie. dsp,
-				esd)
+				esd, arts)
 		-noxv		disables Xvideo hardware acceleration
 		-forcexv	tries to force Xvideo acceleration
 
@@ -821,6 +845,26 @@
   Doctor (formerly UniVBE) before booting Linux.  Use a DOS boot disk or
   whatever.  And don't forget to register your UniVBE ;))
 
+  The FBdev output takes some additional parameters above the others:
+
+	-fb		specify the framebuffer device to use (/dev/fd0)
+	-fbmode		mode name to use (according to /etc/fb.modes)
+	-fbmodeconfig	config file of modes (default /etc/fb.modes)
+	monitor_hfreq
+	monitor_vfreq		IMPORTANT values, see example.conf
+	monitor_dotclock
+
+  If you want to change to a specific mode, then use
+
+	mplayer -vm -fbmode (NameOfMode) filename
+
+  -vm alone will choose the most suitable mode from /etc/fb.modes . Can be
+  used together with -x and -y options too. The -flip option is supported only
+  if the movie's pixel format matches the video mode's pixel format.
+  Pay attention to the bpp value, fbdev driver tries to use the current,
+  or if you specify the -bpp option, then that.
+  -zoom option isn't supported (software scaling is slow). -fs option
+  isn't supported. You can't use 8bpp (or less) modes.
 
   NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer,
 	and don't ask for it, since it's not an <B>MPlayer</B> limitation.
@@ -1057,7 +1101,7 @@
   end
 
   If you don't like the standard location for the lirc-config file (~/.lircrc) 
-  use the -lircconf <filename> switch to specify another file.
+  use the -lircconf [filename] switch to specify another file.
 
 
   <A NAME=3.3>3.3.  Streaming from network or pipes
@@ -1184,7 +1228,7 @@
   It's recommended that you tuneup your CDROM drive also with hdparm :
 
 
-		hdparm -d1 -a8 -u1 <cdrom device>
+		hdparm -d1 -a8 -u1 (cdrom device)
 
 
   to enable using DMA access, readahead, and IRQ unmasking.
@@ -1351,11 +1395,19 @@
   <B>Q: What's the problem with gcc 2.96 ?
   </B>A: gcc 2.96 is RedHat's UNOFFICIAL (it can be found only on RedHat sites, or
      RedHat distributions) and BUGGY gcc release. gcc 2.96 is TOTALLY
-     unsupported by <B>MPlayer</B>, because it simply SKIPS MMX codes, it just does not
-     compile it. Important: this is NOT an <B>MPlayer</B>-specific problem, numerous
-     other projects (DRI, avifile, etc..) have problems with this shit too.
+     unsupported by <B>MPlayer</B>, because it simply SKIPS MMX codes, it just does
+     not compile it. Important: this is NOT an <B>MPlayer</B>-specific problem,
+     numerous other projects (DRI, avifile, etc..) have problems with this shit
+     too.
      ** DO NOT USE gcc 2.96 !!! **
 
+  <B>Q: Great, I have gcc 3.0.1 from RedHat/Mandrake, then I'm fine--!
+  </B>A: No :) Their gcc 3.0.1 was compiled with gcc 2.96, so they are
+     buggy shit too.
+
+  <B>Q: Now then. What should I use?
+  </B>A: Any of gcc 2.95 series.
+
   <B>Q: SDL output doesn't work or compile. Problem is ....
   </B>A: It is tested with newest SDL (probably runs on 1.1.7+).
      It does NOT work with 1.1.6, 1.1.5 1.1.4 1.1.3 1.0.4 etc, don't ask.
@@ -1404,14 +1456,16 @@
   <B>Q: I can't compile SVGAlib.. I'm using 2.3/2.4 kernel.
   </B>A: You have to edit SVGAlib's Makefile.cfg and comment "BACKGROUND = y" out.
 
-  <B>Q: I compiled <B>MPlayer</B> with libcss support, but when I try to start
-        it, it says :
+  <B>Q: I compiled <B>MPlayer</B> with libcss/libdivxdecore support, but when
+	I try to start it, it says :
 	  > error while loading shared libraries: libcss.so.0: cannot load
 	  > shared object file: No such file or directory
 	I checked up on the file and it IS there in /usr/local/lib.
   </B>A: What are you doing on Linux? Can't you install a library? Why do
     we get these questions? It's not <B>MPlayer</B> specific at all! Add
     /usr/local/lib to <B>/etc/ld.so.conf</B> and run <B>ldconfig</B> .
+    Or install it to /usr/lib , because if you can't solve the /usr/local
+    problem, you are careless enough to do such things.
 
   <A NAME=6.2>6.2.  General questions
 
@@ -1714,7 +1768,7 @@
   "options USER_LDT" (unless you are running -CURRENT, where this is default).
 
   If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a 
-  symbolic link : ln -s /dev/<your_cdrom_device> /dev/cdrom 
+  symbolic link : ln -s /dev/(your_cdrom_device) /dev/cdrom 
 
   There's no DVD support for FreeBSD yet. 
   Feel free to add it :-)
@@ -1770,8 +1824,8 @@
    gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math 
 	-fomit-frame-pointer  -I/usr/local/include   -o mplayer.o mplayer.c
    Assembler: mplayer.c
-   "<stdin>", line 3567 : Illegal mnemonic
-   "<stdin>", line 3567 : Syntax error
+   "(stdin)", line 3567 : Illegal mnemonic
+   "(stdin)", line 3567 : Syntax error
    ... more "Illegal mnemonic" and "Syntax error" errors ...