From b3ecef214c5ae74ea71d1fbd568ae5b89d17bff4 Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Thu, 30 May 2002 07:34:10 +0000 Subject: [PATCH] mdoc(7) police: tidy up the markup. --- usr.sbin/cdcontrol/cdcontrol.1 | 136 +++++++++++++++++---------------- 1 file changed, 70 insertions(+), 66 deletions(-) diff --git a/usr.sbin/cdcontrol/cdcontrol.1 b/usr.sbin/cdcontrol/cdcontrol.1 index 272fc354ea4e..3f986fe4e6e7 100644 --- a/usr.sbin/cdcontrol/cdcontrol.1 +++ b/usr.sbin/cdcontrol/cdcontrol.1 @@ -1,6 +1,6 @@ .\" $FreeBSD$ .\" -.Dd July 3, 1995 +.Dd May 8, 2002 .Dt CDCONTROL 1 .Os .Sh NAME @@ -21,16 +21,20 @@ as or .Pa mcd0 . .Pp -If no command is given, then +If no +.Ar command +is given, then .Nm enters an interactive mode, reading commands from the standard input. .Pp The following options are available: .Bl -tag -width indent .It Fl s -Silent mode - do not print table headers and human readable comments. +Silent mode. +Do not print table headers and human readable comments. .It Fl v -Verbose mode - print as much information as possible. +Verbose mode. +Print as much information as possible. .It Fl f Ar device Specify a device, such as .Pa /dev/cd0c @@ -39,35 +43,38 @@ or Both absolute path and relative to .Pa /dev filename are possible. -Suffix `c' is added to the device name if needed. +Suffix +.Pa c +is added to the device name if needed. .El .Pp -The available commands are listed below. Only as many +The available commands are listed below. +Only as many characters as are required to uniquely identify a command need be specified. The word -.Cm play +.Ic play can be omitted or the characters -.Dq + +.Ic + and -.Dq - +.Ic - can be used in the place of -.Cm next +.Ic next and -.Cm prev . -.Bl -tag -width Cm -.It Cm play Ar first_track Op Ar last_track +.Ic prev . +.Bl -tag -width indent +.It Ic play Ar first_track Op Ar last_track Play from track .Ar first_track to track .Ar last_track . The first track has number 1. Can be omitted in all cases. -.It Cm play Xo +.It Xo +.Ic play .Ar start_m : Ns Ar start_s . Ns Ar start_f -.Oo Ar end_m : Ns Ar end_s . Ns -.Ar end_f Oc +.Op Ar end_m : Ns Ar end_s . Ns Ar end_f .Xc Play from the absolute address (MSF) defined by @@ -82,112 +89,109 @@ in minutes, .Ar end_s , in seconds and .Ar end_f -(frame number). Minutes are in the range 0-99. +(frame number). +Minutes are in the range 0-99. Seconds are in the range 0-59. Frame numbers are in the range 0-74. -.It Cm play Op Ar #start_block Op length +.It Ic play Op # Ns Ar start_block Op Ar length Play starting from the logical block .Ar start_block using .Ar length logical blocks. -.It Cm next Op Ar tracks +.It Ic next Op Ar tracks Skip forward a number of tracks (default 1). -.It Cm prev Op Ar tracks +.It Ic prev Op Ar tracks Skip backward a number of tracks (default 1). -.It Cm pause +.It Ic pause Stop playing. Do not stop the disc. -.It Cm resume +.It Ic resume Resume playing. Used after the -.Em pause +.Ic pause command. -.It Cm stop +.It Ic stop Stop the disc. -.It Cm eject +.It Ic eject Eject the disc. -.It Cm close +.It Ic close Inject the disc. -.It Cm volume Ar left_channel Ar right_channel +.It Ic volume Ar left_channel right_channel Set the volume of left channel to .Ar left_channel and the volume of right channel to .Ar right_channel . Allowed values are in the range 0-255. -.It Cm volume Ar mute +.It Ic volume Cm mute Turn the sound off. -.It Cm volume Ar mono +.It Ic volume Cm mono Set the mono mode. -.It Cm volume Ar stereo +.It Ic volume Cm stereo Set the stereo mode. -.It Cm volume Ar left +.It Ic volume Cm left Play the left subtrack on both left and right channels. -.It Cm volume Ar right +.It Ic volume Cm right Play the right subtrack on both left and right channels. -.It Cm info +.It Ic info Print the table of contents. -.It Cm status Xo -.Op Ar audio | media | volume -.Xc +.It Ic status Op Cm audio | media | volume Print the information about the disc: .Pp -.Bl -tag -width "volume" -compact -.It Ar audio +.Bl -tag -width ".Cm volume" -compact +.It Cm audio the current playing status and position -.It Ar media +.It Cm media the current media catalog status -.It Ar volume +.It Cm volume the current values of the volume for left and right channels. .El -.It Cm cdid -Display the serial number of the cd using the method used by the -cddb (http://www.cddb.org/) project. -.It Cm help +.It Ic cdid +Display the serial number of the CD using the method used by the +.Tn CDDB +project +.Pq Pa http://www.cddb.org/ . +.It Ic help Print the list of available commands. -.It Cm debug Ar on +.It Ic debug Cm on Enable the debugging mode of the CD device driver. -.It Cm debug Ar off +.It Ic debug Cm off Disable the driver debugging mode. -.It Cm reset +.It Ic reset Perform the hardware reset of the device. -.It Cm set Ar msf +.It Ic set Cm msf Set minute-second-frame ioctl mode (default). -.It Cm set Ar lba +.It Ic set Cm lba Set LBA ioctl mode. -.It Cm speed Ar s -Set the highest speed that the drive should use. The speed is a multiple of -the single speed. This command is currently only supported on ATAPI drives. -.It Cm quit +.It Ic speed Ar s +Set the highest speed that the drive should use. +The speed is a multiple of the single speed. +This command is currently only supported on ATAPI drives. +.It Ic quit Quit the program. .El .Sh ENVIRONMENT The following environment variables affect the execution of .Nm : -.Pp -.Bl -tag -width CD_DRIVE -compact +.Bl -tag -width ".Ev CD_DRIVE" .It Ev CDROM -The cd device to use if one isn't specified with the +The CD device to use, if one is not specified with the .Fl f -flag. -.Pp -.It Ev CDPLAY -.It Ev CD_DRIVE -.It Ev DISC -.It Ev MUSIC_CD +option. +.It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD These variables have been deprecated in favour of .Ev CDROM . .El .Sh FILES -.Bl -tag -width /dev/mcd0c -compact +.Bl -tag -width ".Pa /dev/mcd0c" -compact .It Pa /dev/cd0c .It Pa /dev/mcd0c .It Pa /dev/acd0c .El .Sh AUTHORS -.An Jean-Marc Zucconi , -.An Andrey A.\ Chernov , -.An Serge V.\ Vakulenko +.An Jean-Marc Zucconi +.An Andrey A. Chernov +.An Serge V. Vakulenko .Sh HISTORY The .Nm