.gitlab-ci.yml

@@ -20,7 +20,7 @@ build-debian:
 build-macos:
     stage: build
     tags:
-        - catalina
+        - mojave
         - amd64
     script:
         - autoreconf -fisv

README.md

 # Goals and features
 
-**libdvdread** is a library for simpler navigation (DVDs without menus)
+**libdvdread** is a library for simple navigation of DVD (DVDs without menus).
+
+Written in C, cross-platform, it gives low-level access to DVD structures.
+
+It works well in conjunction with ***libdvdnav*** *(menus)* and ***libdvdcss*** *(cipher)*.
 
 ## Where does it come from?
 
@@ -18,7 +22,9 @@ libdvdnav and libdvdread were merged, and then split again.
 
 ## Where is it now?
 
-Libdvdread is hosted [here](https://code.videolan.org/videolan/libdvdread)
+Libdvdread is hosted [here](https://code.videolan.org/videolan/libdvdread).
+
+Libdvdnav is hosted [here](https://code.videolan.org/videolan/libdvdnav).
 
 You can find more information [here](https://www.videolan.org/developers/libdvdnav.html)
 
@@ -27,7 +33,7 @@ Please report bugs to the developers mailinglist at
 
 ## License
 
-**Libdvdread** is completely licensed under GPL. You may use it at wish within the
+**Libdvdread** is completely licensed under GPLv2/v3. You may use it at wish within the
 bounds of this license. See the file [COPYING](https://code.videolan.org/videolan/libdvdread/-/blob/master/COPYING) for a copy of the GPL.
 
 ## Using libdvdread
@@ -36,6 +42,15 @@ A detailed description of DVD structures is available [here](http://www.mpucoder
 
 All documentation is also accessible [here](http://dvdnav.mplayerhq.hu/#docs)
 
+## Deciphering disks
+
+**Libdvdread** does not do any decryption of the CSS algorithm. This task can be delegated to **libdvdcss**.
+
+Install *libdvdcss* from source or from your distribution (*libdvd-pkg*) to play full DVDs,
+if your country allows this to work legally.
+
+Note that *libdvdnav* is useful for interactive DVD menus.
+
 ## CoC
 
 The [VideoLAN Code of Conduct](https://wiki.videolan.org/Code_of_Conduct/) applies to this project.

src/dvdread/dvd_reader.h

@@ -37,7 +37,7 @@
 /**
  * The DVD access interface.
  *
- * This file contains the functions that form the interface to to
+ * This file contains the functions that form the interface for
  * reading files located on a DVD.
  */
 
@@ -128,10 +128,10 @@ typedef struct {
  *   path/VTS_01_1.VOB
  *   path/vts_01_1.vob
  *
- * @param path Specifies the the device, file or directory to be used.
+ * @param path Specifies the device, file or directory to be used.
  * @param stream is a private handle used by stream_cb
  * @param stream_cb is a struct containing seek and read functions
- * @return If successful a a read handle is returned. Otherwise 0 is returned.
+ * @return If successful a read handle is returned. Otherwise 0 is returned.
  *
  * dvd = DVDOpen(path);
  * dvd = DVDOpenStream(stream, &stream_cb);
@@ -142,11 +142,11 @@ dvd_reader_t *DVDOpenStream( void *, dvd_reader_stream_cb * );
 /**
  * Same as DVDOpen, but with private handle to be passed back on callbacks
  *
- * @param path Specifies the the device, file or directory to be used.
+ * @param path Specifies the device, file or directory to be used.
  * @param priv is a private handle
  * @param logcb is a custom logger callback struct, or NULL if none needed
  * @param stream_cb is a struct containing seek and read functions
- * @return If successful a a read handle is returned. Otherwise 0 is returned.
+ * @return If successful a read handle is returned. Otherwise 0 is returned.
  *
  * dvd = DVDOpen2(priv, logcb, path);
  * dvd = DVDOpenStream2(priv, logcb, &stream_cb);
@@ -324,7 +324,7 @@ int DVDFileSeekForce( dvd_file_t *, int offset, int force_size);
 /**
  * Get the ISO9660 VolumeIdentifier and VolumeSetIdentifier
  *
- * * Only use this function as fallback if DVDUDFVolumeInfo returns 0   *
+ * * Only use this function as fallback if DVDUDFVolumeInfo returns -1  *
  * * this will happen on a disc mastered only with a iso9660 filesystem *
  * * All video DVD discs have UDF filesystem                            *
  *