@@@ dvdrip-upload: change settings while i'm stealing someone else's internet

[dvdrip] / lib.h

diff --git a/lib.h b/lib.h
index b982286..7c4a0cb 100644 (file)
--- a/lib.h
+++ b/lib.h
@@ -301,19 +301,19 @@ extern void hide_banner(void);
 
 /*----- DVD utilities -----------------------------------------------------*/
 
-extern void open_dvd(const char *device, int mode,
-                    int *fd_out, dvd_reader_t **dvd_out);
+extern int open_dvd(const char *device, int mode,
+                   int *fd_out, dvd_reader_t **dvd_out);
        /* Open the DEVICE.  If FD_OUT is not null, then open a file
         * descriptor onto the device, with the given open(2)-style MODE,
         * storing the descriptor in *FD_OUT; if DVD_OUT is not null, then
         * open a `libdvdread' handle onto the devie and store it in
         * *DVD_OUT.  If both are null, then why are you calling this
-        * function?
+        * function?  Returns 0 on success or -1 on failure.
         *
         * If DEVICE refers to an actual block device, and no medium is
         * currently inserted, then put up a banner prompting the user and
-        * wait for a medium to be inserted.  Other problems are reported as
-        * fatal errors.
+        * wait for a medium to be inserted.  Other problems are reported to
+        * stderr.
         */
 
 enum { RAW, IFO, VOB, BUP };