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

Jean-Baptiste Kempf <[email protected]> Mon, 14 Jun 2021 16:29:21 +0200
Newsgroups gmane.comp.video.videolan.libdvdcss.devel
Message-ID <[email protected]>
--===============5935031066686072688==
Content-Type: multipart/alternative;
 boundary="--==_mimepart_60c767c1d097_93731d474bdc11914238";
 charset=UTF-8
Content-Transfer-Encoding: 7bit


----==_mimepart_60c767c1d097_93731d474bdc11914238
Content-Type: text/plain;
 charset=UTF-8
Content-Transfer-Encoding: quoted-printable



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
- =E2=88=92 README
- + README.md


Changes:

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
Makefile.am
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -3,7 +3,7 @@ AM_CPPFLAGS =3D -I$(top_srcdir)/src -I$(top_builddir)/src=
/dvdcss
 =

 EXTRA_DIST =3D msvc libdvdcss.spec INSTALL
 =

-dist_doc_DATA =3D AUTHORS COPYING NEWS README ChangeLog
+dist_doc_DATA =3D AUTHORS COPYING NEWS README.md ChangeLog
 =

 MAINTAINERCLEANFILES =3D ChangeLog
 =



=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
README deleted
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -1,62 +0,0 @@
-README for libdvdcss, a portable abstraction library for DVD decryption
-
-
-Introduction
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-
-libdvdcss is part of the VideoLAN project, which among other things prod=
uces
-VLC, a full video client/server streaming solution. VLC can  also be use=
d as
-a standalone program to play video streams from a hard disk or a DVD.
-
-
-Building and Installing libdvdcss
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D
-
-See the INSTALL file.
-
-
-Running libdvdcss
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-
-The behavior of the library can be changed by setting two environment va=
riables:
-
-  DVDCSS_METHOD=3D{title|disc|key}: method for key decryption
-    title: By default the decrypted title key is guessed from the encryp=
ted
-           sectors of the stream. Thus it should work with a file as wel=
l 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=3D{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
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-
-A mailing-list has been set up for support and discussion about
-libdvdcss. Its address is:
-
-   <[email protected]>
-
-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
-=3D=3D=3D=3D=3D=3D=3D=3D=3D
-
-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.


=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
README.md
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -0,0 +1,76 @@
+# Goals and feature
+
+**Libdvdcss** is a portable abstraction **lib**rary for **DVD** decrypti=
on.
+
+It is part of the **VideoLAN** project, which among other things produce=
s **VLC**, a full video client/server streaming solution. =

+
+**VLC** can  also be used as a standalone program to **play video stream=
s** 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/-/bl=
ob/master/INSTALL) for full instructions.
+
+
+## Running libdvdcss
+
+
+The behavior of the library can be changed by setting two environment va=
riables :
+
+`DVDCSS_METHOD=3D{title|disc|key}`: method for **key decryption** :
+
+- **title** : By default the decrypted title key is guessed from the enc=
rypted
+              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 mu=
ch time
+              or even fail. With the **title method**, the key is only c=
hecked at
+              the **beginning of each title**, so it will not work if th=
e key
+              changes in the middle of a title.
+
+- **disc** :  The disc key is **cracked first**. Afterwards all title ke=
ys can be
+              decrypted **instantly**, which allows checking them often.=

+
+- **key** :   The same as the "disc" method if you do not have a file wi=
th 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=3D{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:
+
+   <[email protected]>
+
+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.videola=
n.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.=




----==_mimepart_60c767c1d097_93731d474bdc11914238--

--===============5935031066686072688==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: base64
Content-Disposition: inline

X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KbGliZHZkY3Nz
LWRldmVsIG1haWxpbmcgbGlzdApsaWJkdmRjc3MtZGV2ZWxAdmlkZW9sYW4ub3JnCmh0dHBzOi8v
bWFpbG1hbi52aWRlb2xhbi5vcmcvbGlzdGluZm8vbGliZHZkY3NzLWRldmVsCg==

--===============5935031066686072688==--