big review ! (translators curse me:)

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@750 b3059339-0415-0410-9bf9-f77b7e298cf2

7 files changed, 61 insertions, 52 deletions

diff --git a/DOCS/AUTHORS b/DOCS/AUTHORS
index c46e99a5e4..aafa8f29d8 100644
--- a/DOCS/AUTHORS
+++ b/DOCS/AUTHORS
@@ -18,7 +18,7 @@
 
 Zoltán Ponekker (Pontscho/Fresh!):  <pontscho@makacs.poliod.hu> 
 - configure script and Makefiles for easy compile
-- GUI system (/still/ coming soon!)
+- GUI system (near complete!?)
 - 3DNow! support into mp3lib
 - 3DNow! support into fastmemcpy.h
 - various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)
@@ -29,11 +29,11 @@ Gábor Lénárt (LGB): <lgb@lgb.hu>
 - ./configure script improvements
 - Makefile improvements
 - prelimenary DVD support
-- another GUI code (coming soon or later :)
+- another GUI code (is that so..?)
 
 Gábor Bérczi (Gabucino):  <gabucino@k2.jozsef.kando.hu>
 - documentation maintainer, hun-eng translator
-- webpage maintaining
+- webpage maintainer
 - testing, codecs quality & speed comparsions
 - IRC channel #MPlayer operator
 
@@ -52,12 +52,13 @@ Gyula László (Chass, Tégla): <chass-@freemail.hu>
 
 Zoltán Márk Vicián (Se7en): <se7en@sch.bme.hu>
 - SVGAlib support in libvo
+- native AAlib driver (coming soon)
 
 Andreas Ackermann:  <asackerm@stud.informatik.uni-erlangen.de>
 - LIRC support (see DOCS/LIRC)
 - DGA support in libvo
 
-Felix Bünemann: <Felix.Buenemann@gmx.de>
+Felix Bünemann: <atmosfear@users.sourceforge.net>
 - SDL driver maintainer
 - Additional YUV formats fixes
 - New font (mp_font2.zip)
@@ -78,6 +79,8 @@ Jens Hoffmann: <hoffmajs@gmx.de>
 Nick Kurshev: <nickols_k@mail.ru>
 - memcpy optimizations for AMD K7 and Intel Pentium III  (fastmemcpy.h)
 - CDROM tune info
+- further 3DNow! optimizations into mp3lib
+- russian DOCS translation
 
 German Gomez Garcia: <german@piraos.com>
 - DVD .ifo parser and chapter selection [not yet in the main trunk]
diff --git a/DOCS/MPlayer-FAQ b/DOCS/MPlayer-FAQ
index 15e0a2a712..778537eb9e 100644
--- a/DOCS/MPlayer-FAQ
+++ b/DOCS/MPlayer-FAQ
@@ -14,7 +14,7 @@ Q: What about DVD playback?
 A: Read files 'DVD' and 'DVD-FAQ'.
 
 Q: SDL output doesn't work or compile. Problem is ....
-A: It is tested with SDL v1.2.0 (probably runs on 1.1.7+ too).
+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.
 
 Q: I am still having trouble compiling with SDL support. gcc says something
@@ -33,14 +33,16 @@ A: copy DOCS/inttypes.h to MPlayer directory (cp DOCS/inttypes.h .)
    try again... if fail, contact me
 
 Q: I have Pentium III but ./configure doesn't detect SSE
-A: Only kernel versions 2.4.x supports SSE (or try latest 2.2.19 or newer)
+A: Only kernel versions 2.4.x supports SSE (or try latest 2.2.19 or newer, but
+   be prepared for problems)
 
 Q: -xy option doesn't work with x11 driver (-vo x11)
 A: x11 driver doesn't support scaling, but XF86VidMode support is now
    used: you must specify the -vm and the -fs switch, and you're done.
    Make sure you have the right Modelines in your XF86Config file, and
    try if the DGA driver (and SDL's DGA driver, see VIDEOCARDS) works for you.
-   It's much faster. If even SDL's DGA works, it'll be EVEN more faster!
+   It's much faster. If SDL's DGA works too, use that, it'll be EVEN
+   faster!
 
 Q: audio goes out of sync playing .avi file
 A: try with -bps or -nobps option
@@ -65,7 +67,7 @@ A: It's not zero, but it's built in into codec, so can't be measured separated.
    You should try to play the file using -vo null and then -vo ... and check
    the difference to see video_out speed...
 
-Q: OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors)
+Q: OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors/...)
 A: your opengl driver doesn't support dynamic texture chanegs (glTexSubImage)
    it's known not to work with X 4.0.x DRI drivers and nVidia's binary shit.
    it's known to work with Utah-GLX and Matrox G400 card.
@@ -100,20 +102,14 @@ A: It's a known bug (really it's a bug/limitation of the DLL codec)
 
 Q: I've got 'MPlayer interrupted by signal 11' in module audio_setup or
    decode_audio.
-A: It's a damaged file with bad mp3 audio stream. Try it with  -afm 4
+A: This is highly unlikely, since the mp3lib rewrite. Contact us, it may be
+   a bug. Possibly it's a damaged file, try with -afm 4 .
 
 Q: Are there rpm/deb/... packages of MPlayer?
 A: You can make a .deb package for yourself, check DOCS/DEBIAN .
-   There are .rpm packages at
-	ftp://ftp.pld.org.pl/test/i386/
-	ftp://ftp.pld.org.pl/test/i586/
-	ftp://ftp.pld.org.pl/test/i686/
-
-   NOTE : it's _STRONGLY_ discouraged to make and distribute binary packages
-	of MPlayer, since it (currently) _highly_ depends on compile-time
-	options and optimizations!
-
-   NOTE: MANUAL COMPILATION _ALWAYS_ GIVES BETTER PERFORMANCE AND SPEED !
+   It's _STRONGLY_ discouraged to use binary packages
+   of MPlayer, since it (currently) _highly_ depends on compile-time
+   options and optimizations!
 
 Q: Are there any mailing lists on MPlayer?
 A: Yes! See README on how to subscribe them!
@@ -121,7 +117,7 @@ A: Yes! See README on how to subscribe them!
 Q: I've found a nasty bug when I tried to play my favourite video!!
    Who should I inform?
 A: Inform the MPlayer-users mailing list about your problem. *ALWAYS*
-   read the README about what information we NEED to identify your problem.
+   read the BUGREPORTS file about what information we NEED to identify your problem.
    Use the developers addresses (specified in AUTHORS) only if you want to
    flame, or want to ask for a date. ;)
 
@@ -138,12 +134,14 @@ A: ...but you don't have the X development package installed. Or not
 
 Q: I have problems playing files with ... codec. Can I use'em?
 A: Check http://mplayer.sourceforge.net/DOCS/codecs.html,
-   if it doesn't contain your codec, contact us.
+   if it doesn't contain your codec, read
+   http://mplayer.sourceforge.net/DOCS/CODECS, and contact us.
 
 Q: What about DGA driver? I can't find it!!!
 A: ./configure autodetects your DGA driver. If -vo help doesn't show
    DGA, then there's a problem with your X installation.
    Try ./configure --enable-dga (and read VIDEOCARDS)
+   Alternatively, try SDL's DGA driver with '-vo sdl -sdl dga' options.
 
 Q: Ok, -vo help shows DGA driver, but it is babbling about permissions!
    Help me!
@@ -211,5 +209,5 @@ A: Check 'ldd /usr/local/bin/mplayer' output. If it contains
 
 Q: My computer plays M$ DivX AVIs with resolutions ~ 640x300 and stereo mp3
    sound too slow. When I use -nosound switch, everything is ok (but quiet).
-A: Those files probably have 48Khz audio, and your soundcard can't play
+A: Those files probably have 48Khz audio, and your soundcard/driver can't play
    it correctly. Audio downsampling isn't implemented in MPlayer (yet).
diff --git a/DOCS/OpenDivX b/DOCS/OpenDivX
index 02dbc84fce..91dfa4bb8e 100644
--- a/DOCS/OpenDivX
+++ b/DOCS/OpenDivX
@@ -2,10 +2,10 @@
 OpenDivX support in MPlayer
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-See http://www.projectmayo.com for details on the OpenDivX codec.
-It's the opensource successor of the DivX codec, already available
-on most platforms. We use an MMX-optimized Decore.
-OpenDivX version supported in MPlayer : 4.0alpha48
+See http://www.projectmayo.com for details on the OpenDivX codec. It's the
+opensource successor of the DivX codec (really it's a somewhat enhanced version
+of the MPEG-4 standard), already available on most platforms. We use an
+MMX-optimized Decore. OpenDivX version supported in MPlayer : 4.0alpha48
 
 Decoder:
 ~~~~~~~~
diff --git a/DOCS/README b/DOCS/README
index 32078577bc..69b630cc3e 100644
--- a/DOCS/README
+++ b/DOCS/README
@@ -8,7 +8,7 @@ MPlayer is a movie player for LINUX. It plays most mpeg, avi and asf files,
 supported by many native and win32 DLL codecs. You can watch VCD, DVD and
 even DivX movies too. The another big feature of mplayer is the wide range
 of supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
-fbdev, but you can use SDL (and this way all drivers of SDL) and some 
+fbdev, AAlib, but you can use SDL (and this way all drivers of SDL) and some 
 lowlevel card-specific drivers (for Matrox/3dfx/SiS) too! Most of them
 supports software or hardware scaling, so you can enjoy movies in fullscreen.
 And what about the nice big antialiased shaded subtitles (.sub files) with
@@ -47,12 +47,13 @@ or speed problems too. So I've decided to write/modify one...
   Try it, and be amazed! Thousands of new features added... and of course
   old code was improved too, bugs removed etc.
 
-As you see, I didn't write any codecs, just some players. But I spent
+As you see, I didn't write any codecs, just some players. Instead I spent
 a lot of time finding the best way to parse bad damaged input files
 (both mpg and avi) and to do perfect A-V sync with seeking ability.
 My player is rock solid playing damaged mpeg files (useful for some VCDs),
 and it plays bad AVI files which are unplayable with the famous
-windows media player. Even AVI files without index chunk are playable!
+windows media player. Even AVI files without index chunk are playable, and
+you can rebuild their indexes with the -idx option, thus enabling seeking!
 As you see, stability and quality are the most important things for me,
 speed has lower priority, but is still very important.
 
@@ -61,7 +62,7 @@ What about the GUI?
 I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
 So the player has only keyboard control from the controlling console/xterm now.
 But there is a GUI development for the player, coordinated by Pontscho/Fresh!
-It's still under development, but it will be merged and released soon.
+It's still under development, but it will be merged and released real soon.
 BTW he needs some nice skins, if you are a good graphician, contact him!!!
 
 Supported input formats:
@@ -92,8 +93,8 @@ The most important audio codecs:
 - alaw, msgsm, pcm and other simple old audio formats
 
 If you have a codec not listed here, and not supported yet, just
-read DOCS/CODECS to get info about its status or about
-how to help us adding support for it!
+read http://mplayer.sourceforge.net/DOCS/codecs.html and DOCS/CODECS
+to get info about its status and about how to help us adding support for it!
 
 Supported video output devices:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -107,6 +108,7 @@ General:
 - svga: Output to SVGAlib
 - sdl:	SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8
         even support Xvideo (thus hardware rendering) and with >=1.2.0 aalib)
+- aalib:Textmode rendering (through SDL, native driver is coming soon!)
 
 Card specific:
 - mga:	Matrox G200/G400 hardware YUV overlay via the mga_vid device
@@ -134,7 +136,7 @@ NOTE: check DOCS/SOUNDCARDS for details!
 
 Speed:
 ~~~~~~
-Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!.
+Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!/3Dnow!Ex.
 You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
 Some *old* benchmark results can be found in the doc file SPEED.
 
@@ -229,23 +231,26 @@ Mailing lists:
 There are some public mailing lists on MPlayer. Subscribing can be achieved on
 the following addresses:
 
+- MPlayer core/hungarian developers list:  (HUNGARIAN language ONLY!)
+	http://lists.sourceforge.net/lists/listinfo/mplayer-devel
+
+- MPlayer developers list:  (send your patches here)
+	http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng
+
 - MPlayer users list:  (send your ideas, bugreports, feature requests here)
 	http://lists.sourceforge.net/lists/listinfo/mplayer-users
 
 - MPlayer & Matrox G200/G400/G450 users: (about TV-out, mga_vid, syncfb, Xv)
 	http://lists.sourceforge.net/lists/listinfo/mplayer-matrox
 
-- MPlayer developers list:  (send your patches here)
-	http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng
-
 - MPlayer announce:    (information about new releases or big changes in CVS)
 	http://lists.sourceforge.net/lists/listinfo/mplayer-announce
 
 - MPlayer CVS-log:     (announce about _every_ CVS commit)
 	http://lists.sourceforge.net/lists/listinfo/mplayer-cvslog
 
-NOTE: language of above lists are ENGLISH. Please do not send there
-      messages using other language!
+NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise.
+      Please do not send messages using other language!
 
 License:                                                                     
 ~~~~~~~~
diff --git a/DOCS/SOUNDCARDS b/DOCS/SOUNDCARDS
index 031848f7e3..e93d28a39b 100644
--- a/DOCS/SOUNDCARDS
+++ b/DOCS/SOUNDCARDS
@@ -25,26 +25,23 @@ Gravis UltraSound MAX:
 			ALSA    : OK (?)
 			Max kHz : 48
 
-ESS 688 and probably all old SB's (without buffers):
-			OSS     : OK (48Khz, somehow...)
-			ALSA    : OK
-			Max kHz : 44.1
+ESS 688:
+			OSS     : OK
+			ALSA    : OK (?)
+			Max kHz : 48
 
 PC Speaker or DAC:
 			OSS     : only with the new HQ timing code
-			          (maybe won't work at all in the future)
 			ALSA    : no driver
 			Max kHz : 6 ;) (the driver emulates 44.1 maybe more)
 			Driver  : ftp://ftp.infradead.org/pub/pcsp
 
- - MPlayer is mostly intended for OSS
+ - MPlayer is mostly intended for OSS, until we change to libxmm
  - use at least 2.4 if possible, 2.2 isn't tested
- - In case of any problems, first try recompiling with
-   ./configure --disable-select , then make distclean ; make .
-   Your soundcard may not support querying of its buffer.
  - if sound clicks when playing from CD-ROM, turn on IRQ unmasking !
    for example "hdparm -u1 /dev/cdrom" (see "man hdparm" !!!)
    This is recommended anyways... (for XMMS, etc...)
+   Read DOCS/CDROM .
  - don't use your soundcard by other application ( for ex. XMMS ) !
    if you use ESD, start MPlayer with the esddsp utility !
  - Please tell us how MPlayer and your soundcard(s) worked together!
diff --git a/DOCS/TODO b/DOCS/TODO
index 149c84bd04..778699e14a 100644
--- a/DOCS/TODO
+++ b/DOCS/TODO
@@ -11,10 +11,10 @@ They Have Been Around For A Long Time:
 High Priority:
 - finish ASF seeking (find next keyframe)
 - asterix.avi audio delays after 5-10 mins (bps mode only)
-- fix mp3lib to avoid segfault with some damaged .avi files
+- fix mp3lib to avoid segfault with some damaged .avi files (DONE!?)
 
 Medium Priority:
-- seeking support for broken avi files without index chunk
+- seeking support for broken avi files without index chunk (DONE!)
 - fix x11 driver to work without SHM (for remote playing etc)
 - show current frame number [Gabucino]
 - seek_to_frame and seek_to_index options
diff --git a/DOCS/VIDEOCARDS b/DOCS/VIDEOCARDS
index c8bc1d423b..947e313298 100644
--- a/DOCS/VIDEOCARDS
+++ b/DOCS/VIDEOCARDS
@@ -78,7 +78,7 @@ II. OpenGL drivers with *working* *fast* glTexSubImage() support.
    Currently only the old Utah-GLX drivers (for X 3.3.6) have it.
    See http://utah-glx.sourceforge.net for details about how to install it.
 
-   The new X4/DRI and nVidia's binary drivers has no usable glTexSubImage :(
+   The new X4/DRI and nVidia's binary drivers have no usable glTexSubImage :(
 
 III. Native card-specific drivers
 
@@ -88,10 +88,15 @@ There is 3 native drivers for Linux:
   with triple buffering. It works on both framebuffer console and under X.
   
   To use, simply compile the mga_vid.o in the drivers/ subdir (type: make)
-  and load it with insmod mga_vid.o. You should verify the memory size
+  create /dev/mga_vid device :
+	mknod /dev/mga_vid c 178 0
+  and load the driver with insmod mga_vid.o. You should verify the memory size
   detection using the 'dmesg' command. If it's bad, use the mga_ram_size
   option (rmmod mga_vid first), specify card's memory size in MB:
     insmod mga_vid.o mga_ram_size=16
+  To make it load/unload automatically when needed, insert the following line
+  at the end of /etc/modules.conf :
+	alias char-major-178 mga_vid
 
   Using it from MPlayer:  (you should re-compile it with mga_vid support...)
   
@@ -158,6 +163,7 @@ a, If you don't have X...
   forced), and don't forget to edit /etc/vga/libvga.config to suit your
   card & monitor.
 
+  Try the aalib target ('-vo sdl -sdl aalib'), it's great! :)
 
 b, You want to use framebuffer...
   ... Whether to build the FBdev target is autodetected during ./configure .
@@ -165,7 +171,7 @@ b, You want to use framebuffer...
   (Documentation/fb/*) for info on how to enable it, etc.. !
 
   ... but your card doesn't support VBE 2.0 standard (older ISA/PCI
-  cards, such as S3 Trio64) :
+  cards, such as S3 Trio64), only VBE 1.2 (or older?) :
   Well, VESAfb is still available, but you'll have to load SciTech Display
   Doctor (formerly UniVBE) before booting Linux.  Use a DOS boot disk or
   whatever.  And don't forget to register your UniVBE ;))