From c18d59d269105016597b9516e5e00a2a3208716b Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Thu, 7 May 2020 15:46:08 -0400 Subject: man page tweaks --- miragextract.1 | 18 ++++++++++-------- miragextract.c | 3 ++- miragextract.rst | 17 ++++++++++++----- 3 files changed, 24 insertions(+), 14 deletions(-) diff --git a/miragextract.1 b/miragextract.1 index d154778..7bf0226 100644 --- a/miragextract.1 +++ b/miragextract.1 @@ -93,6 +93,8 @@ Quality setting for ogg and flac output files. Integer from 0 to 10. Default is 7. Has very little effect on flac, and no effect on wav or cdda output. .UNINDENT +.sp +Always include a space between an option and its argument (e.g. \fB\-b foo\fP, not \fB\-bfoo\fP). .SH NOTES .sp Image\-file is e.g. a .cue, .ccd, .nrg, .mds, or anything else supported @@ -140,14 +142,14 @@ play \-x \-t cdda track01.cdda . .\" =========== . -.\" EXIT STATUS -. -.\" =========== -. -.\" BUGS -. -.\" ==== -. +.SH EXIT STATUS +.sp +0 (success) if everything worked properly, or non\-zero (failure) if +there was an error. +.SH BUGS +.sp +There\(aqs not enough error checking. It\(aqs probably possible to make +miragextract segfault under some circumstances. .\" EXAMPLES . .\" ======== diff --git a/miragextract.c b/miragextract.c index 571f39a..fb6b3a3 100644 --- a/miragextract.c +++ b/miragextract.c @@ -253,7 +253,8 @@ void parse_args(int argc, char **argv) { autoname = 1; break; default: - die("unrecognized option"); + fprintf(stderr, "unrecognized option '%s', try --help\n", *argv); + exit(1); break; } } else if(imagefile) { diff --git a/miragextract.rst b/miragextract.rst index b85a430..2a477aa 100644 --- a/miragextract.rst +++ b/miragextract.rst @@ -37,7 +37,7 @@ OPTIONS ======= --help - Print short usage string. + Print short usage string. -l Lists the tracks in the image without extracting them. @@ -69,6 +69,8 @@ OPTIONS to 10. Default is 7. Has very little effect on flac, and no effect on wav or cdda output. +Always include a space between an option and its argument (e.g. **-b foo**, not **-bfoo**). + NOTES ===== @@ -108,11 +110,16 @@ them with the *play* command from *sox*. Try:: .. ENVIRONMENT .. =========== -.. EXIT STATUS -.. =========== +EXIT STATUS +=========== + +As usual, 0 for success, non-zero for failure. + +BUGS +==== -.. BUGS -.. ==== +There's not enough error checking. It's probably possible to make +miragextract segfault under some circumstances. .. EXAMPLES .. ======== -- cgit v1.2.3