updated DVD documentation for libmpdvdkit

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

2 files changed, 57 insertions, 131 deletions

diff --git a/DOCS/Hungarian/cd-dvd.html b/DOCS/Hungarian/cd-dvd.html
index e77a27af96..27e0fd03a8 100644
--- a/DOCS/Hungarian/cd-dvd.html
+++ b/DOCS/Hungarian/cd-dvd.html
@@ -70,58 +70,40 @@ szimbolikus linket kell létrehozni, vagy megadni az eszközt a parancssorban!
 
 <P><B><A NAME=4.2>4.2.  DVD lejátszás</A></B></P>
 
-<P>Örüljetek népek, itt az igazi DVD támogatás. Már nem kell egyesével
-lejátszani a VOB file-okat a video_ts könyvtárból, nem kell aggódni amiatt
-hogy a lemez kódolt-e vagy se (régebben kellett ilyenkor a '-dvdauth /dev/dvd'
-opció is), és még csak fel se kell mountolni a lemezt (bár a mountolás
-azzal a tagadhatatlan előnnyel jár hogy a Linux a feltört CSS kulcsokat
-cache-be rakja, így a következő lejátszásnál már nem kell a törésre várni).</P>
-
-<P>FONTOS: NE kérj semmit a DVD lejátszással kapcsolatban. Most először van
-működő támogatás <B>MPlayer</B>-ben, és jelenleg a hibák kijavításán, és
-alapvető DVD funkciók beépítésén dolgozunk.</P>
-
-<P>Az <B>MPlayer</B> a libdvdread-et használja, ami tartalmaz beépített
-támogatást az IFO file-ok feldolgozásához, navi blokkok olvasásához, és
-autentikációhoz. Ezutóbbihoz a libdvdcss-t használja, így először
-azt kell lefordítani és installálni, majd ./configure, és az automatikusan
-felismeri.</P>
-
-<UL>
-<LI><P><B>Töltsd le a libdvdread és libdvdcss forrását.</B></P>
-  
-<P><I>Letöltheted őket a
-<A HREF="http://www.dtek.chalmers.se/groups/dvd">http://www.dtek.chalmers.se/groups/dvd</A>
-címről (klikkelj a 'download'-ra a bal oldali menűben).</I></P>
-
-<P><B><I>FONTOS !</I></B>
-<UL>
-  <LI>libdvdread 0.8-hoz libdvdcss helyett <B>libcss</B> kell</LI>
-  <LI>libdvdread 0.9-hez libdvdcss <B>0.0.3</B> kell! Az újabb libdvdcss
-    verziókkal nem fog működni!</LI>
-  <LI>libdvdcss <B>1.0</B>-t ne használj, mert használhatatlanul lassúvá teszi a
-    lejátszást.</LI>
-</UL>
-</P>
-</LI>
-
-<LI><P><B>Fordítsd le és installáld a libdvdcss-t és AZUTÁN a libdvdread-et.</B></P>
+<P>Az <B>MPlayer</B> a <CODE>libdvdread</CODE> és <CODE>libdvdcss</CODE>
+  néven ismert könyvtárakat használja a DVD dekódolásához és lejátszásához.
+  Ez a két program a <CODE>libmpdvdkit/</CODE> alkönyvtárban található, így
+  külön installálásuk szükségtelen és felesleges. Azért használjuk ezt a
+  módszert mert így lehetőségünk nyílt kijavítani egy <CODE>libdvdread</CODE>
+  bugot, és megpatchelni a <CODE>libdvdcss-t</CODE> olyan módon hogy a
+  feltört CSS kulcsokat mentse el a <CODE>$HOME/.mplayer/DVDKeys</CODE>
+  könyvtárba, így a következő lejátszásnál nem lesz szükség ezek újabb
+  feltörésére.</P>
 
-<P><I>Olvasd el ezen csomagok dokumentációját, ha segítségre van szükséged.</I></P></LI>
+<P>A <CODE>libdvdnav</CODE> támogatásának készítése folyamatban van, jelenleg
+  nem használható.</P>
 
-<LI><P><B>Régi DVD támogatás - <I>OPCIONÁLIS</I></B></P>
+<LI><P><B>Régi tipusú DVD támogatás - <I>OPCIONÁLIS</I></B></P>
 
 <P><I>Ez akkor hasznos ha pl merevlemezről akarsz kódolt VOB-ot lejátszani.
   Fordítsd le és installáld a <B>libcss</B> 0.0.1-et (és ne újabbat).
   Ha az <B>MPlayer</B> nem találja, használd a <CODE>-csslib /útvonal/libcss.so</CODE>
   opciót.</P></LI>
 
-<LI><P><B>Fordítsd újra az MPlayer-t.</B></P>
+<LI><P><B>Fordítsd le az MPlayer-t.</B></P>
+
+<P><I>Futtasd a <CODE>./configure</CODE>-t. Ha nem törölted le a
+  <CODE>libmpdvdkit</CODE> könyvtárat, a ./configure valami ilyesmit fog
+  kiírni :</P>
+
+<P><CODE>Checking for DVD support (libmpdvdkit) ... yes</CODE></P>
 
-<P><I>Futtasd a <CODE>./configure</CODE>-t. Ha helyesen tetted fel a libdvdread-et,
-a ./configure valami ilyesmit fog kiírni :<BR><CODE>Checking for DVDread support ... yes</CODE><BR>
-Ezután a szokott módon <CODE>make</CODE> és <CODE>make install</CODE>.</I></P></LI>
-</UL>
+<P>Az <B>MPlayer</B> képes már installált <CODE>libdvdread</CODE> és
+  <CODE>libdvdcss</CODE> használatára, de ezen módszer használata NEM
+  AJÁNLOTT mivel használata különféle hibákhoz, inkompatibilitásokhoz, és
+  lassabb sebességhez vezet.</P>
+
+<P>Ezután a szokott módon <CODE>make</CODE> és <CODE>make install</CODE>.</P>
 
 <P>Természetesen miután felinstalláltad a libdvdcss-t és a libdvdread-et,
 nem kell újrafordítanod őket minden alkalommal mikor az <B>MPlayer</B>-t.</P>
@@ -194,7 +176,8 @@ DVD lejátszás előtt/helyett/közben ezt a hibaüzenetet kapom :<BR>
 <CODE>mplayer: ifo_read.c:1143: ifoRead_C_ADT_internal: Assertion     nfo_length /
 sizeof(cell_adr_t) >= c_adt->nr_of_vobs' failed.</CODE>
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-Ismert libdvdread 0.9.1 bug, a 0.9.2-ben már javítva van.
+Ismert libdvdread 0.9.1 bug, a 0.9.2-ben és a libmpdvdkit-ben már javítva van,
+miért nem ezutóbbi használod?
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>   
 
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
@@ -219,13 +202,6 @@ Igen, lásd fent, a DVD fejezetet.
      <A HREF="http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz">http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz</A>
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
-<TD>&nbsp;&nbsp;</TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
- Szóval az MPlayer tud DVD lejátszást? Akkor biztos DeCSS-t használ!
-     Bűnösek vagytok a következő vádpontokban : XYZ#$--
-</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-Anyád. Nincs DeCSS kód az MPlayer-ben. libdvdcss-hez linkeli magát.<BR>
-</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
-
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
 Muszáj rendszergazdai jogosultságokkal rendelkeznem hogy le tudjak
 játszani egy DVD-t?
@@ -235,13 +211,6 @@ jogosultságok a DVD egységhez (pl /dev/dvd).
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
-Hogy lehetne azt megcsinálni hogy ... ?
-</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-Mint fentebb is leírtuk, most a hibák javításán dolgozunk, a
-kívánságok majd később jöhetnek.
-</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
-
-<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
 Hol lehet letölteni a libdvdread-et és a libdvdcss-t?
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
 Innen:
@@ -257,9 +226,8 @@ Igen, lásd fent a <CODE>-chapter</CODE> opciót.
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
 Nagyon lassú a DVD lejátszás !
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-Próbáld a <CODE>-cache</CODE> opciót (lásd manpage!). Ha így se jó, bizonyosodj
-meg róla hogy megfelelő libdvdread+libdvdcss kombinációt használsz. Mindenképp
-próbáld meg bekapcsolni a DMA-t a DVD meghajtón.
+Próbáld a <CODE>-cache</CODE> opciót (lásd manpage!). Ha így se jó, próbáld meg
+bekapcsolni a DMA-t a DVD meghajtón.
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
 </TABLE>
diff --git a/DOCS/cd-dvd.html b/DOCS/cd-dvd.html
index 0feebce0a0..71fa9e8d1b 100644
--- a/DOCS/cd-dvd.html
+++ b/DOCS/cd-dvd.html
@@ -74,46 +74,16 @@ CDROM.</P>
 
 <P><B><A NAME=4.2>4.2. DVD playback</A></B></P>
   
-<P>Yes, the real DVD support has been arrived. You don't need to play VOB files
-manually from disk thinking of the purpose of a file in the video_ts
-directory, you don't need worry it it's an encrypted disk or not (in old
-<B>MPlayer</B> you had to put '-dvdauth /dev/dvd' into the command line in case
-of encrypted discs), and you don't need even mount your disk to be able to
-play (but mounting it makes Linux cache the cracked CSS keys, so the playing
-will initialize much faster second time).</P>
-
-<P>IMPORTANT NOTE: please _DO_NOT_ require further features for DVD playback.
-This is the first version of some real DVD support inside <B>MPlayer</B> and
-we're busy with hunting bugs and implementing basic DVD player features.</P>
-
-<P><B>MPlayer</B> uses libdvdread which has got built in support for IFO
-parsing, reading navi blocks and doing authentication/descrambling. libdvdread
-uses libdvdcss to the latter tasks. So you will need libdvdcss and libdvdread
-downloaded, compiled and installed BEFORE you run ./configure script of
-<B>MPlayer</B> which will autodetect libdvdread for you in this way.</P>
-
-<UL>  
-<LI><P><B>Download source of libdvdread and libdvdcss.</B></P>
-  
-<P><I>You can download them from
-<A HREF="http://www.dtek.chalmers.se/groups/dvd">http://www.dtek.chalmers.se/groups/dvd</A>
-(click 'download' in the menu at the left, and you can find libdvdcss and
-libdvdread in a table).</I></P>
-
-<P><B><I>IMPORTANT !</I></B><BR>
-For
-<UL>
-  <LI>libdvdread 0.8 - you'll need <B>libcss</B> instead of libdvdcss</LI>
-  <LI>libdvdread 0.9 - you'll need <B>libdvdcss 0.0.3</B> ! Don't use newer
-    versions, they won't work!</LI>
-  <LI>For example <B><U>never</U></B> use libdvdcss <B>1.0</B>, it will be unusably slow!</LI>
-</UL>
-</P>
-</LI>
-  
-<LI><P><B>Compile and install libdvdcss THEN libdvdread.</B></P>
-    
-<P><I>Read documentation of these packages to do this step easily.</I></P></LI>
+<P><B>MPlayer</B> uses <CODE>libdvdread</CODE> and <CODE>libdvdcss</CODE> for
+  DVD decryption and playing. These two libraries are contained in the
+  <CODE>libmpdvdkit/</CODE> subdirectory in the <B>MPlayer</B> tree, you
+  don't have to install them separately. We opt for this solution because
+  we had to fix a libdvdread bug, and apply a patch which adds
+  <B>cracked CSS keys caching support</B> for libdvdcss (results in large
+  speed increase before playing). These cracked keys are stored in
+  <CODE>$HOME/.mplayer/DVDKeys</CODE> directory.</P>
+
+<P>Support for <CODE>dvdnav</CODE> is being added (not usable now).</P>
 
 <LI><P><B>Old-style DVD support - <I>OPTIONAL</I></B></P>
 
@@ -121,18 +91,22 @@ For
   install <B>libcss</B> 0.0.1 (not newer) (if <B>MPlayer</B> can't detect
   it, use the <CODE>-csslib /path/to/libcss.so</CODE> option).</P></LI>
 
-<LI><P><B>Recompile MPlayer.</B></P>
-  
-<P><I>Run <CODE>./configure</CODE>. If you install libdvdread correctly, ./configure
-says something similar:<BR><CODE>Checking for DVDread support ... yes</CODE><BR>
-(Of course you can put your favourite configure options into the command
-line when you run ./configure). That's it! Say: <CODE>make</CODE>, then <CODE>make install</CODE>.</I></P></LI>
-</UL>
+<LI><P><B>Compile MPlayer.</B></P>
+
+<P>Run <CODE>./configure</CODE>. If you didn't delete
+  <CODE>libmpdvdkit</CODE> subdirectory from MPlayer tree, ./configure should
+  say the following:</P>
+
+<P><CODE>Checking for DVD support (libmpdvdkit) ... yes</CODE></P>
+
+<P>(of course you can put your favourite configure options into the command
+  line when you run ./configure)</P>
+
+<P><B>MPlayer</B> can use <CODE>libdvdread</CODE> and <CODE>libdvdcss</CODE>
+  libraries installed system-wide, but this solution is NOT RECOMMENDED, as
+  can result in bugs, library incompatibilities, and slower speed.</P>
 
-<P>Of course after installing libdvdcss and libdvdread you don't need recompile
-them at each time when you want to recompile <B>MPlayer</B> (from a new CVS version
-for example) since the needed packages have already been installed on your
-machine.</P>
+<P>Either way, say: <CODE>make</CODE>, then <CODE>make install</CODE>.</P>
 
 <P><B>Using MPlayer to play DVDs:</B></P>
 
@@ -204,7 +178,8 @@ Playing a DVD, I encountered this error :<BR>
 <CODE>mplayer: ifo_read.c:1143: ifoRead_C_ADT_internal: Assertion     nfo_length /
 sizeof(cell_adr_t) >= c_adt->nr_of_vobs' failed.</CODE>
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-This is a known libdvdread 0.9.1 bug, it should be already fixed in 0.9.2.
+This is a known libdvdread 0.9.1 bug, it should be already fixed in 0.9.2 and
+libmpdvdkit, use the later.
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
@@ -229,14 +204,6 @@ Use the 'regionset' tool:
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
-So MPlayer can play DVDs? Then it must use DeCSS! You are under arrest
-under the XYZ#$ paragraph of the--
-</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-Get back asshole, there is no DeCSS code in <B>MPlayer</B>. <B>MPlayer</B> uses libdvdread
-by linking against it, and libdvdread uses libdvdcss by dynamic loading it.<BR>
-</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
-
-<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
 Do I need to be (setuid) root/setuid fibmap_mplayer to be able to play DVD?
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
 No, you don't. Only for old-style DVD support. However of course you must have
@@ -244,14 +211,6 @@ the proper rights to the DVD device driver entry (in /dev).
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
 <TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
-How can I ... (insert some expectable DVD player feature here)?
-</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
-The current implementation is the first implementation of some real DVD
-player functionality. First, we would like to target existing bugs and
-basic features before implementing new features.
-</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
-
-<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
 Where can I get libdvdread and libdvdcss packages from?
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
 From the site of Ogle:
@@ -268,8 +227,7 @@ Yes, see the <CODE>-chapter</CODE> option.
 My DVD playing is sluggish !
 </B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
 Use the <CODE>-cache</CODE> option (see the manpage!). If it still doesn't
-work, check the beginning of this documentaion for proper
-libdvdread+libdvdcss combinations. Also try enabling DMA for the DVD drive.
+work, try enabling DMA for the DVD drive.
 </TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
 
 </TABLE>