ref: 812aacbf7d77c3074a4ed16353812cf4ca328b49
parent: 23d8e2097648708708ef6e413fc892405461549a
author: Mathias Couder <mathias.couder.20@gmail.com>
date: Mon Jun 14 10:29:17 EDT 2021
Move README to README.md
--- a/Makefile.am
+++ b/Makefile.am
@@ -3,7 +3,7 @@
EXTRA_DIST = msvc libdvdcss.spec INSTALL
-dist_doc_DATA = AUTHORS COPYING NEWS README ChangeLog
+dist_doc_DATA = AUTHORS COPYING NEWS README.md ChangeLog
MAINTAINERCLEANFILES = ChangeLog
--- a/README
+++ /dev/null
@@ -1,62 +1,0 @@
-README for libdvdcss, a portable abstraction library for DVD decryption
-
-
-Introduction
-============
-
-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 file.
-
-
-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: 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 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
- 2: error and debug messages
-
-
-Troubleshooting
-===============
-
-A mailing-list has been set up for support and discussion about
-libdvdcss. Its address is:
-
- <libdvdcss-devel@videolan.org>
-
-To subscribe or unsubscribe, go to:
-
- http://mailman.videolan.org/
-
-When reporting bugs, try to be as precise as possible (which OS, which
-distribution, what plugins you were trying, and so on).
-
-
-Resources
-=========
-
-The VideoLAN web site at http://www.videolan.org/ is a good start for
-information about MPEG and DVD playback. Have a look at the support
-section to look for answers.
--- /dev/null
+++ b/README.md
@@ -1,0 +1,76 @@
+# Goals and feature
+
+**Libdvdcss** is a portable abstraction **lib**rary for **DVD** decryption.
+
+It 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.
+
+
+**Libdvdcss** 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.
+
+## Building and installing instructions for Libdvdcss
+
+See the [INSTALL file](https://code.videolan.org/videolan/libdvdcss/-/blob/master/INSTALL) for full instructions.
+
+
+## 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** : 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 **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
+- **2**: error and debug messages
+
+
+## Troubleshooting
+
+
+A **mailing-list** has been set up for support and discussion about
+libdvdcss. Its address is:
+
+ <libdvdcss-devel@videolan.org>
+
+To subscribe or unsubscribe, go [here](http://mailman.videolan.org/).
+
+
+When reporting **bugs**, try to be as **precise** as possible (which OS, which
+distribution, what plugins you were trying, and so on).
+
+## CoC
+
+The [VideoLAN Code of Conduct](https://wiki.videolan.org/CoC) applies to this project.
+
+## Licence
+
+**Libdvdcss** is released under the **General Public License**, ensuring it will stay free, and used only for free software products.
+
+## Resources
+
+
+The [VideoLAN web site](http://www.videolan.org/) is a good start for
+information about MPEG and DVD playback.
+
+Have a look at the [support section](https://www.videolan.org/support/) to look for answers.
+
+You can also have a look to [the documentation](https://videolan.videolan.me/libdvdcss/).