[libdvdcss-devel] [Git][videolan/libdvdcss][master] Move README to README.md

Jean-Baptiste Kempf gitlab at videolan.org
Mon Jun 14 14:29:21 UTC 2021



Jean-Baptiste Kempf pushed to branch master at VideoLAN / libdvdcss


Commits:
812aacbf by Mathias Couder at 2021-06-14T14:29:17+00:00
Move README to README.md

- - - - -


3 changed files:

- Makefile.am
- − README
- + README.md


Changes:

=====================================
Makefile.am
=====================================
@@ -3,7 +3,7 @@ AM_CPPFLAGS = -I$(top_srcdir)/src -I$(top_builddir)/src/dvdcss
 
 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
 


=====================================
README deleted
=====================================
@@ -1,62 +0,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 at 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.


=====================================
README.md
=====================================
@@ -0,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 at 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/).



View it on GitLab: https://code.videolan.org/videolan/libdvdcss/-/commit/812aacbf7d77c3074a4ed16353812cf4ca328b49

-- 
View it on GitLab: https://code.videolan.org/videolan/libdvdcss/-/commit/812aacbf7d77c3074a4ed16353812cf4ca328b49
You're receiving this email because of your account on code.videolan.org.




More information about the libdvdcss-devel mailing list