Description: Fix cdtool.1 Author: Bjarni Ingi Gislason Bug-Debian: https://bugs.debian.org/897208 * Spelling: give -> given * Remove space characters at the end of lines. * Separate the roman part from the only argument of the macro "IR". * Use macros instead of the escapes "\fX". * Change '-' to '\-' for options. * Shorten lines longer than 80 characters. * Begin sentences on a new line when only one space character is in front of them. * Add space in front of a tab to get the formatting correct (troff). --- a/cdtool.1 +++ b/cdtool.1 @@ -6,51 +6,52 @@ cdtool \- play and catalog audio CDROMs on CDROM drive(s) .SH SYNOPSIS .nf -\fBcdeject\fR [-[0..9]|-d device] [-V|-?|-h] -\fBcdclose\fR [-[0..9]|-d device] [-V|-?|-h] -\fBcdir\fR -n [-[0..9]|-d device] [-r|-s|-t|-V|-?|-h] -\fBcdinfo\fR [-[0..9]|-d device] [-a|-r|-s|-t|-v|-V|-?|-h] -\fBcdpause\fR [-[0..9]|-d device] [-V|-?|-h] -\fBcdplay\fR [-[0..9]|-d device] [\fIstart\fR [\fIstop\fR] -\fBcdplay\fR [-[0..9]|-d device] [\fI+|-\fR \fInumber\fR] -\fBcdplay\fR [-[0..9]|-d device] [start|stop|resume|eject|close|info|dir] -\fBcdplay\fR [-[0..9]|-d device] [-V|-?|-h] -\fBcdstop\fR [-[0..9]|-d device] [-V|-?|-h] -\fBcdvolume\fR [-[0..9]|-d device] [-V|-?|-h|\fIlevel\fR] -\fBcdshuffle\fR [-[0..9]|-d device] [-V|-?|-h] +\fBcdeject\fR [\-[0..9]|\-d device] [\-V|\-?|\-h] +\fBcdclose\fR [\-[0..9]|\-d device] [\-V|\-?|\-h] +\fBcdir\fR \-n [\-[0..9]|\-d device] [\-r|\-s|\-t|\-V|\-?|\-h] +\fBcdinfo\fR [\-[0..9]|\-d device] [\-a|\-r|\-s|\-t|\-v|\-V|\-?|\-h] +\fBcdpause\fR [\-[0..9]|\-d device] [\-V|\-?|\-h] +\fBcdplay\fR [\-[0..9]|\-d device] [\,\fIstart\/\fR [\,\fIstop\/\fR] +\fBcdplay\fR [\-[0..9]|\-d device] [\,\fI+|\-\/\fR \,\fInumber\/\fR] +\fBcdplay\fR [\-[0..9]|\-d device] [start|stop|resume|eject|close|info|dir] +\fBcdplay\fR [\-[0..9]|\-d device] [\-V|\-?|\-h] +\fBcdstop\fR [\-[0..9]|\-d device] [\-V|\-?|\-h] +\fBcdvolume\fR [\-[0..9]|\-d device] [\-V|\-?|\-h|\,\fIlevel\/\fR] +\fBcdshuffle\fR [\-[0..9]|\-d device] [\-V|\-?|\-h] .fi .SH DESCRIPTION -The +The .I cdeject command ejects the current compact disc. .PP -The +The .I cdclose command closes the CDROM tray. .PP The .I cdir command lists information about the currently loaded audio compact disc. -In particular, it lists the lengths of all tracks. +In particular, it lists the lengths of all tracks. It also references the database files specified in the .B CDTOOLPATHDB environment variable and the .B ~/.cdtooldb file, which use a simplified version of the format used by -.IR workman(1). -If one of these files contains an entry for the current compact disc, -.I cdir +.IR workman (1). +If one of these files contains an entry for the current compact disc, +.I cdir will print title, artist, and track name information. .RS -.IP \fB-n\fR +.IP \fB\-n\fR Do not lookup any information in the database files. -.IP \fB-s\fR +.IP \fB\-s\fR Print information in a short format: only author, title, and current track, all on one line. -.IP \fB-t\fR +.IP \fB\-t\fR Print a template for the current cd, including title, artist, and track name -information if available. If blank lines are filled in, this can be appended to the +information if available. +If blank lines are filled in, this can be appended to the .B ~/.cdtooldb file. .RE @@ -59,19 +60,19 @@ .I cdinfo command, with no option used, will print out the audiostatus (playing, etc.). .RS -.IP \fB-a\fR +.IP \fB\-a\fR Print out the absolute disc time. -.IP \fB-r\fR +.IP \fB\-r\fR Print out the relative track time. -.IP \fB-s\fR +.IP \fB\-s\fR Print out the audiostatus. -.IP \fB-t\fR +.IP \fB\-t\fR Print out the current track. -.IP \fB-v\fR +.IP \fB\-v\fR All info: \fBstatus track absolute relative\fR. .RE .PP -The +The .I cdpause command pauses the currently playing compact disc. Resume by using .I cdplay @@ -81,12 +82,15 @@ .I cdplay command plays the compact disc. If called with one argument, this is the starting track number. If called with two arguments, these are the -starting and stopping track numbers. If the first argument is a +starting and stopping track numbers. +If the first argument is a .B + or -.B - -then skip the number of tracks given by the second argument forward or -backward. If no second argument is give, skip one. A +.B \- +then skip the number of tracks given by the second argument forward or +backward. +If no second argument is given, skip one. +A .B 0 as first argument or no argument replays current track. .PP @@ -96,39 +100,41 @@ .PP The .I cdvolume -command sets the output volume level of the CD player. The level is an +command sets the output volume level of the CD player. The level is an integer from 0 to 255. .PP -The +The .I cdshuffle command plays the audio tracks on the disc in random order. .PP The default device opened is \fB/dev/cdrom\fR. This default and others -may be changed in \fIconfig.h\fR. Options supported by all programs are: +may be changed in +.IR config.h . +Options supported by all programs are: .RS -.IP "\fB-[0..7]\fR" +.IP "\fB\-[0..7]\fR" Multiple cdrom support to open \fB/dev/scd0../dev/scd7\fR [by default]. -.IP "\fB-d device\fR" +.IP "\fB\-d device\fR" Multiple cdrom support to open \fBdevice\fR by name. -.IP "\fB[-h|-?]\fR" +.IP "\fB[\-h|\-?]\fR" Print out help for the command. -.IP "\fB-V\fR" +.IP "\fB\-V\fR" Print out version information and build information. -.IP "\fB-D\fR" +.IP "\fB\-D\fR" Enable runtime debugging. .RE .SH FILES -.B ~/.cdtooldb -- default database file. +.B ~/.cdtooldb +\(en default database file. .SH ENVIRONMENT -.B CDTOOLDBPATH -- colon delimited path of database files to search. It is not necessary to -specify -.BR ~/.cdtooldb , +.B CDTOOLDBPATH +\(en colon delimited path of database files to search. It is not necessary to +specify +.BR ~/.cdtooldb , as this is automatically added to the end of the search path. .PP -.B CDTOOLDEV -- device file for cd-rom, overrides compile-time defaults. +.B CDTOOLDEV +\(en device file for cd-rom, overrides compile-time defaults. .SH SEE ALSO cdctrl(1), cdadd(1), cdown(1) .SH AUTHORS @@ -142,8 +148,8 @@ Byron Ellacott Wade Hampton Lin Zhe Min -Sven Oliver Moll -Daniel R. Risacher +Sven Oliver Moll +Daniel R.\& Risacher Max Vozeler .RE .fi