[libdvdcss-devel] [PATCH] Update libdvdcss information pages.

[Diego Biurrun]

---

First homepage patch; dunno if I can commit this directly or not...

 developers/libdvdcss.php | 24 ++++++++++++------------
 developers/libdvdcss.txt | 14 ++++++--------
 2 files changed, 18 insertions(+), 20 deletions(-)

diff --git a/developers/libdvdcss.php b/developers/libdvdcss.php
index 3a25dfc..b206396 100644
--- a/developers/libdvdcss.php
+++ b/developers/libdvdcss.php
@@ -11,34 +11,34 @@ DVDs like a block device without having to bother about the decryption. </p>
 <h2> Features </h2>
 
 <ul class="bullets">
-  <li><b>Portability</b>. Currently supported platforms are GNU/Linux,
-  FreeBSD, NetBSD, OpenBSD, BSD/OS, BeOS, Windows 95/98, Windows NT/2000,
-  MacOS X, Solaris, and HP-UX. </li>
-  <li><b> Simplicity</b>. There are currently 7 functions in the API, and we intend
-  to keep this number low. </li>
+  <li><b>Portability</b>. Currently supported platforms are GNU/Linux, FreeBSD,
+  NetBSD, OpenBSD, Haiku, Mac OS X, Solaris, QNX, OS/2, and Windows NT 4.0 SP4
+  (with IE 5.0) or later.</li>
+  <li><b> Simplicity</b>. A DVD player can be built around the
+  <code>libdvdcss</code> API using no more than 4 or 5 library calls.</li>
   <li> <b>Freedom</b>. <code>libdvdcss</code> is released under the General Public
   License, ensuring it will stay free, and used only for free software
   products. </li>
   <li> <b>Just better</b>. Unlike most similar projects, <code>libdvdcss</code>
-  doesn't require the region of your drive to be set. </li>
+  does not require the region of your drive to be set. </li>
 </ul>
 
 <h2>Get libdvdcss</h2>
 
-<p> Last version of <code>libdvdcss</code> is <b>1.3.0</b>. </p>
+<p> The latest version of <code>libdvdcss</code> is <b>1.3.0</b>. </p>
 
-<p> Our Debian/Ubuntu repository can be accessed by adding the following content to /etc/apt/sources.list<p>
+<p> Our Debian/Ubuntu repository can be accessed by adding the following lines to /etc/apt/sources.list<p>
 <p><code>deb http://download.videolan.org/pub/debian/stable/ /</code></p>
 <p><code>deb-src http://download.videolan.org/pub/debian/stable/ /</code></p>
 <p>And by running<p>
-<p><code>wget -O - http://download.videolan.org/pub/debian/videolan-apt.asc|sudo apt-key add -</code></p>
+<p><code>wget -O - http://download.videolan.org/pub/debian/videolan-apt.asc | sudo apt-key add -</code></p>
 
 <p> <code>libdvdcss</code> is available through <a href="http://wiki.videolan.org/Git">Git</a> or
 by browsing the <a href="http://www.videolan.org/pub/libdvdcss/">releases</a>.
 </p>
 
 <h3>Git checkout</h3>
-<p><code># git clone git://git.videolan.org/libdvdcss</code></p>
+<p><code>$ git clone git://git.videolan.org/libdvdcss</code></p>
 
 <p>You can also access the code <a href="http://git.videolan.org/?p=libdvdcss.git">online</a>.</p>
 
@@ -68,11 +68,11 @@ by browsing the <a href="http://www.videolan.org/pub/libdvdcss/">releases</a>.
 </tr>
 </table>
 
-<h2>additional information</h2>
+<h2>Additional Information</h2>
 
 <p>If you want to read more on this subject, we publish a <a
 href="libdvdcss.txt">non-technical description of libdvdcss</a>.</p>
 
-<h3>For legal documentation, see our <a href="/legal.html">legal page</a></h3>
+<h3>For legal information, see our <a href="/legal.html">legal page</a></h3>.
 
 <?php footer('$Id$'); ?>
diff --git a/developers/libdvdcss.txt b/developers/libdvdcss.txt
index 9704381..7de7210 100644
--- a/developers/libdvdcss.txt
+++ b/developers/libdvdcss.txt
@@ -9,8 +9,8 @@ contents of a DVD.
 
    All DVDs and commercially distributed readers include some information
 about their zone. When a DVD is put into a DVD reader, the information is
-compared, in order to limit the number of countries where they can be used.
-The DVD zone and the reader's zone should match.
+compared, in order to limit the number of countries where the DVD can be
+used. The DVD zone and the reader's zone should match.
 
 
     2/ CSS
@@ -20,7 +20,7 @@ of DVD reader programs obtain keys by purchasing them from the DVD CCA (DVD
 Copy Control Association) which will permit them to decrypt CSS-protected
 DVDs. They also get instructions on how to use CSS, which are kept secret
 under a confidentiality agreement.  When a program reads a DVD, it
-communicates with the DVD reader all the while, in order to get the
+communicates with the DVD reader all the time, in order to get the
 decryption information with the help of the key.
 
 
@@ -37,9 +37,9 @@ accessible while it is being viewed - whatever the equipment used.
     4/ Weaknesses of CSS
 
    CSS has been the subject of academic studies which have, through reverse
-engineering, uncovered how it works and the encryption algorithm it uses.
+engineering, uncovered how it works and what encryption algorithm it uses.
 These studies also show that the keys used by CSS are extremely weak from a
-cryptographic (code-breaking) approach, which has led to more effective
+cryptographic (code-breaking) perspective, which has led to more effective
 decryption algorithms and the discovery of keys.  It is possible to obtain
 a complete list of keys in a few minutes on an ordinary desktop computer.
 
@@ -49,7 +49,7 @@ a complete list of keys in a few minutes on an ordinary desktop computer.
    The list of CSS keys is therefore perfectly well known, and a sample of
 these keys is distributed with libdvdcss.  The libdvdcss library operates
 in a similar manner to a DVD reader program, by using a key to decode the
-contents, except that libdvdcss uses a key from the sample. If all of the
+content, except that libdvdcss uses a key from the sample.  If all of the
 sample keys fail, then libdvdcss computes the rest of the key set and tries
 each of them.
 
@@ -57,5 +57,3 @@ each of them.
 not from the same zone. As a last resort, libdvdcss will step outside of
 the whole DVD/reader system and will decrypt the encoded stream directly,
 exploiting weaknesses in the CSS encryption.
-
-
-- 
1.9.1