/*----- 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 };