11622 clean up rarer mandoc lint warnings

          --- old/usr/src/man/man1/audioctl.1
          +++ new/usr/src/man/man1/audioctl.1

   1    1  '\" t
   2    2  .\"
   3    3  .\" This file and its contents are supplied under the terms of the
   4    4  .\" Common Development and Distribution License ("CDDL"), version 1.0.
   5    5  .\" You may only use this file in accordance with the terms of version
   6    6  .\" 1.0 of the CDDL.
   7    7  .\"
   8    8  .\" A full copy of the text of the CDDL should have accompanied this

   9    9  .\" source.  A copy of the CDDL is also available via the Internet at
  10   10  .\" http://www.illumos.org/license/CDDL.
  11   11  .\"
  12   12  .\"
  13   13  .\" Copyright 2011 Nexenta Systems, Inc.  All rights reserved.
  14   14  .\"
  15   15  .TH AUDIOCTL 1 "Mar 18, 2011"
  16   16  .SH NAME
  17   17  audioctl - audio device control command line interface
  18   18  .SH SYNOPSIS
  19      -.LP
  20   19  .nf
  21   20  \fBaudioctl\fR \fBlist-devices\fR
  22   21  .fi
  23   22  
  24   23  .LP
  25   24  .nf
  26   25  \fBaudioctl\fR \fBshow-device\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR]
  27   26  .fi
  28   27  
  29   28  .LP

  30   29  .nf
  31   30  \fBaudioctl\fR \fBshow-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fB] [\fIcontrol\fR ...]
  32   31  .fi
  33   32  
  34   33  .LP
  35   34  .nf
  36   35  \fBaudioctl\fR \fBset-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fB] \fIcontrol\fR \fIvalue\fR
  37   36  .fi
  38   37  
  39   38  .LP
  40   39  .nf
  41   40  \fBaudioctl\fR \fBsave-controls\fR [\fB-d\fR \fIdevice\fB] [\fB-f\fR] \fIfile\fR
  42   41  .fi

  43   42  
  44   43  .LP
  45   44  .nf
  46   45  \fBaudioctl\fR \fBload-controls\fR [\fB-d\fR \fIdevice\fB] \fIfile\fR
  47   46  .fi
  48   47  
  49   48  .SH DESCRIPTION
  50   49  The \fBaudioctl\fP command is used to control various settings and features
  51   50  of audio devices, including mixer settings such as playback volume and
  52   51  record gain.
  53      -.LP
  54      -
  55   52  .SH SUBCOMMANDS
  56   53  The \fBaudioctl\fR command supports the following subcommands.
  57   54  .sp
  58   55  .ne 2
  59   56  .na
  60   57  \fBlist-devices\fR
  61   58  .ad
  62   59  .sp .6
  63   60  .RS 4n
  64   61  List all the audio devices on the system.

  65   62  .RE
  66   63  
  67   64  .sp
  68   65  .ne 2
  69   66  .na
  70   67  \fBshow-device\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] [\fBcontrol\fR ... ]
  71   68  .ad
  72   69  .sp .6
  73   70  .RS 4n
  74   71  Display an informational overview of \fIdevice\fR (or the default device if
  75   72  not specified).  If the \fB-v\fR option is specified, then more detail
  76   73  will be displayed.
  77   74  .RE
  78   75  
  79   76  .sp
  80   77  .ne 2
  81   78  .na
  82   79  \fBshow-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR]
  83   80  .ad
  84   81  .sp .6
  85   82  .RS 4n
  86   83  Display the control settings for one or more \fIcontrols\fR of a
  87   84  \fIdevice\fR (or the default device if not specified).  If no \fIcontrol\fR is
  88   85  specified, then the settings for all controls will be displayed. If
  89   86  the \fB-v\fR option is specified, then more detail will be displayed.
  90   87  .RE
  91   88  
  92   89  .sp
  93   90  .ne 2
  94   91  .na
  95   92  \fBset-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fB] \fIcontrol\fR \fIvalue\fR
  96   93  .ad
  97   94  .sp .6
  98   95  .RS 4n
  99   96  Set the control settings for a \fIcontrol\fR of a \fIdevice\fR (or the
 100   97  default device if not specified) to \fIvalue\fR.  If the \fB-v\fR
 101   98  option is specified, then more verbose output be displayed.
 102   99  .RE
 103  100  
 104  101  .sp
 105  102  .ne 2
 106  103  .na
 107  104  \fBsave-controls\fR [\fB-f\fR] [\fB-d\fR \fIdevice\fB] \fIfile\fR
 108  105  .ad
 109  106  .sp .6
 110  107  .RS 4n
 111  108  Save all control settings of the \fIdevice\fR (or the default device if not
 112  109  specified) to the named \fIfile\fR.  This subcommand will not replace
 113  110  or modify an existing file unless \fB-f\fR (force) is specified.
 114  111  .RE
 115  112  
 116  113  .sp
 117  114  .ne 2
 118  115  .na
 119  116  \fBload-controls\fR [\fB-d\fR \fIdevice\fB] \fIfile\fR
 120  117  .ad
 121  118  .sp .6
 122  119  .RS 4n
 123  120  Load previously saved control settings from a \fIfile\fR
 124  121  into a \fIdevice\fR (or all audio devices if not
 125  122  specified).
 126  123  .RE
 127  124  
 128  125  .SH ENVIRONMENT VARIABLES
 129  126  .ne 2
 130  127  .na

 131  128  \fB\fBAUDIODEV\fR\fR
 132  129  .ad
 133  130  .RS 12n
 134  131  The full path name of the default audio device to use if one
 135  132  is not specified on the command line.  If this variable is not set,
 136  133  \fB/dev/audio\fR is used.
 137  134  .RE
 138  135  
 139  136  
 140  137  .SH ATTRIBUTES
 141      -.LP
 142  138  See \fBattributes\fR(5) for descriptions of the following attributes:
 143  139  .sp
 144  140  
 145  141  .sp
 146  142  .TS
 147  143  box;
 148  144  c | c
 149  145  l | l .
 150  146  ATTRIBUTE TYPE  ATTRIBUTE VALUE
 151  147  _
 152  148  Interface Stability     See below.
 153  149  .TE
 154  150  .LP
 155  151  The \fBaudioctl\fR command and its subcommands are Committed.  The
 156  152  names of controls, their values, and device names are Uncommitted.
 157  153  The display output is intended for human consumption, and is Not An
 158  154  Interface.  The format of the state files used by the
 159  155  \fBsave-controls\fR and \fBload-controls\fR subcommands is Committed
 160  156  Private.
 161      -.LP
 162      -
 163  157  .SH SEE ALSO
 164  158  \fBaudioplay\fR(1), \fBaudiorecord\fR(1), \fBdsp\fR(7I),
 165  159  \fBmixer\fR(7I), \fBattributes\fR(5)
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX