[libdvdcss-devel] [PATCH 1/3] misc small wording and spelling fixes for the documentation

[Diego Biurrun]

---
AUTHORS | 14 +++++++-------
INSTALL | 21 +++++++++++----------
NEWS | 8 ++++----
README | 16 ++++++++--------
4 files changed, 30 insertions(+), 29 deletions(-)

diff --git a/AUTHORS b/AUTHORS
index bec3772..7d3920a 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1,11 +1,11 @@
# The format of this file was inspired by the Linux kernel CREDITS file.
-#
+#
# Authors and contributors are listed alphabetically.
-#
-# The fields are: name (N), email (E), web-address (W),
+#
+# The fields are: name (N), email (E), web address (W),
# PGP key ID and fingerprint (P), description (D)

-N: Billy Biggs
+N: Billy Biggs
E: ***@dumbterm.net
D: libdvdcss enhancements

@@ -57,7 +57,7 @@ D: QNX port

N: Steve Lhomme
E: ***@free.fr
-D: win32 improvements
+D: Windows improvements

N: Christophe Massiot
E: ***@via.ecp.fr
@@ -81,8 +81,8 @@ D: OS/2 port

N: German Tischler
E: ***@gaspode.franken.de
-D: FreeBSD DVD input patch
+D: FreeBSD DVD input

N: Gildas Bazin
E: ***@netcourrier.com
-D: various fixes to the Win32 port
+D: various fixes to the Windows port
diff --git a/INSTALL b/INSTALL
index 7dd6cef..d45489c 100644
--- a/INSTALL
+++ b/INSTALL
@@ -6,14 +6,14 @@ Configuring libdvdcss

A typical way to configure libdvdcss is:

- ./configure --prefix=/usr
+ ./configure --prefix=/usr

See `./configure --help' for more information.


If you got libdvdcss from its version control system, please bootstrap first:

- autoreconf -i
+ autoreconf -i


Building libdvdcss
@@ -30,15 +30,15 @@ Installing libdvdcss

You can install libdvdcss by typing:

- make install
+ make install


-Building libdvdcss for Win32
-============================
+Building libdvdcss for Windows
+==============================

-You have two alternatives to build libdvdcss for Win32:
+There are two alternative ways to build libdvdcss for Windows.

-- on Linux, using the mingw.org or mingw-w64 cross-compilers.
+- on a Linux host with the mingw.org or mingw-w64 cross-compilers:

If you are running Debian, there are mingw32 packages you can use.

@@ -50,15 +50,16 @@ You have two alternatives to build libdvdcss for Win32:

make

-- natively on Windows, using MSYS + MinGW (www.mingw.org):
+- natively on Windows with MSYS + MinGW (www.mingw.org):

(MSYS is a minimal build environment to compile Unixish projects under
Windows. It provides all the common Unix tools like sh, GNU Make...)

- You will need to download and install the latest MSYS and MINGW.
+ You will need to download and install the latest MSYS and MinGW.

To build libdvdcss you just have to run the following commands:
+
./configure
make

- More on MSys on our wiki: http://wiki.videolan.org/Win32CompileMSYS
+ More about MSYS on our wiki: http://wiki.videolan.org/Win32CompileMSYS
diff --git a/NEWS b/NEWS
index 4fbdb1d..54ce859 100644
--- a/NEWS
+++ b/NEWS
@@ -1,10 +1,10 @@
Changes between 1.2.12 and 1.2.13:
----------------------------------

- * Drop BSD/OS and Windows 95 support.
- * Rewrite most of the buildsystem, and simplify it
- * System dependant code cleanup
- * Move to git and rewrite of the history to get proper authorship
+ * Drop BSD/OS and Windows 95 support
+ * Rewrite most of the build system and simplify it
+ * System-dependant code cleanup
+ * Move to Git and rewrite of the history to get proper authorship
* Drop LaTeX documentation
* Fix build on various systems
* Fix compilation on MSVC
diff --git a/README b/README
index 2de3069..cb77e60 100644
--- a/README
+++ b/README
@@ -4,21 +4,21 @@ README for libdvdcss, a portable abstraction library for DVD decryption
Introduction
============

-libdvdcss is part of the VideoLAN project, a full video client/server
-streaming solution. VLC can also be used as a standalone program
-to play video streams from a hard disk or a DVD.
+libdvdcss is part of the VideoLAN project, which among other things produces
+VLC, a full video client/server streaming solution. VLC can also be used as
+a standalone program to play video streams from a hard disk or a DVD.


Building and Installing libdvdcss
=================================

-See the INSTALL or INSTALL.libdvdcss file for this.
+See the INSTALL file.

Running libdvdcss
=================

-The behavior of the library can be affected by changing two environment
-variables:
+The behavior of the library can be changed by setting two environment variables:
+
DVDCSS_METHOD={title|disc|key}: method for key decryption
title: decrypted title key is guessed from the encrypted sectors of
the stream. Thus it should work with a file as well as the
@@ -58,6 +58,6 @@ Resources
=========

The VideoLAN web site at http://www.videolan.org/ is a good start for
-information about MPEG and DVD playing. Have a look at the documentation
-section, as well as the bookmarks.
+information about MPEG and DVD playback. Have a look at the support
+section to look for answers.

[Diego Biurrun]

---
INSTALL | 10 +++-------
1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/INSTALL b/INSTALL
index d45489c..d9e85b8 100644
--- a/INSTALL
+++ b/INSTALL
@@ -40,14 +40,10 @@ There are two alternative ways to build libdvdcss for Windows.

- on a Linux host with the mingw.org or mingw-w64 cross-compilers:

- If you are running Debian, there are mingw32 packages you can use.
-
- If you are cross-compiling from the Debian package, you can use the following
- commands, for example:
-
- ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \
- --build=i386-linux
+ Tell configure about the compiler to use. If you run, for example, Debian or
+ Ubuntu with the mingw32 packages installed, it would be:

+ ./configure --host=i586-mingw32msvc
make

- natively on Windows with MSYS + MinGW (www.mingw.org):

[Diego Biurrun]

---
README | 21 ++++++++++-----------
1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/README b/README
index cb77e60..c450b88 100644
--- a/README
+++ b/README
@@ -20,18 +20,17 @@ Running libdvdcss
The behavior of the library can be changed by setting two environment variables:

DVDCSS_METHOD={title|disc|key}: method for key decryption
- title: decrypted title key is guessed from the encrypted sectors of
- the stream. Thus it should work with a file as well as the
- DVD device. But it sometimes takes too much time to decrypt a title
- key and may even fail. With this method, the key is only checked
- at the beginning of each title, so it won't work if the key
+ title: By default the decrypted title key is guessed from the encrypted
+ sectors of the stream. Thus it should work with a file as well as
+ the DVD device. But decrypting a title key may take too much time
+ or even fail. With the title method, the key is only checked at
+ the beginning of each title, so it will not work if the key
changes in the middle of a title.
- disc: the disc key is first cracked ; then all title keys can be
- decrypted instantly, which allows us to check them often,
- key: the same as "disc" if you don't have a file with player keys at
- compilation time. If you do, the decryption of the disc key will
- be faster with this method. It is the one that was used by libcss.
- This is the default method.
+ disc: The disc key is cracked first. Afterwards all title keys can be
+ decrypted instantly, which allows checking them often.
+ key: The same as the "disc" method if you do not have a file with player
+ keys at compile time. If you do, disc key decryption will be faster.
+ This is the default method also employed by libcss.
DVDCSS_VERBOSE={0|1|2}: libdvdcss verbosity
0: no error messages, no debug messages (this is the default)
1: only error messages