12287 errors in audio utility man pages

          --- old/usr/src/man/man1/audioplay.1
          +++ new/usr/src/man/man1/audioplay.1
   1    1  '\" te
   2    2  .\"  Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
   3    3  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4    4  .\"  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the
   5    5  .\" fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH AUDIOPLAY 1 "May 13, 2017"
        6 +.TH AUDIOPLAY 1 "Feb 8, 2020"
   7    7  .SH NAME
   8    8  audioplay \- play audio files
   9    9  .SH SYNOPSIS
  10      -.LP
  11   10  .nf
  12   11  \fBaudioplay\fR [\fB-iV\fR] [\fB-v\fR \fIvol\fR] [\fB-d\fR \fIdev\fR] [\fIfile\fR]...
  13   12  .fi
  14   13  
  15   14  .SH DESCRIPTION
  16      -.LP
  17   15  The \fBaudioplay\fR utility copies the named audio files (or the standard input
  18   16  if no filenames are present) to the audio device. If no input file is specified
  19   17  and standard input is a tty, the program exits with an error message.
  20   18  .sp
  21   19  .LP
  22   20  The input files must contain a valid audio file header. The encoding
  23   21  information in this header is matched against the capabilities of the audio
  24   22  device and, if the data formats are incompatible, an error message is printed
  25   23  and the file is skipped. Compressed \fBADPCM\fR (G.721) monaural audio data is
  26   24  automatically uncompressed before playing.
  27   25  .sp
  28   26  .LP
  29   27  Minor deviations in sampling frequency (that is, less than 1%) are ordinarily
  30   28  ignored. This allows, for instance, data sampled at 8012 Hz to be played on an
  31   29  audio device that only supports 8000 Hz. If the \fB-V\fR option is present,
  32   30  such deviations are flagged with warning messages.
  33   31  .SH OPTIONS
  34      -.LP
  35   32  The following options are supported:
  36   33  .sp
  37   34  .ne 2
  38   35  .na
  39   36  \fB\fB-d\fR \fIdev\fR\fR
  40   37  .ad
  41   38  .RS 11n
  42   39  \fIDevice\fR: The \fIdev\fR argument specifies an alternate audio device to
  43   40  which output should be directed. If the \fB-d\fR option is not specified, the
  44   41  \fBAUDIODEV\fR environment variable is consulted (see below). Otherwise,

  45   42  \fB/dev/audio\fR is used as the default audio device.
  46   43  .RE
  47   44  
  48   45  .sp
  49   46  .ne 2
  50   47  .na
  51   48  \fB\fB-i\fR\fR
  52   49  .ad
  53   50  .RS 11n
  54   51  \fIImmediate\fR: If the audio device is unavailable (that is, another process
  55   52  currently has write access), \fBaudioplay\fR ordinarily waits until it can
  56   53  obtain access to the device. When the \fB-i\fR option is present,
  57   54  \fBaudioplay\fR prints an error message and exits immediately if the device is
  58   55  busy.
  59   56  .RE
  60   57  
  61   58  .sp
  62   59  .ne 2
  63   60  .na
  64   61  \fB\fB-v\fR \fIvol\fR\fR
  65   62  .ad
  66   63  .RS 11n
  67   64  \fIVolume\fR: The output volume is set to the specified value before playing
  68   65  begins, and is reset to its previous level when \fBaudioplay\fR exits. The
  69   66  \fIvol\fR argument is an integer value between 0 and 100, inclusive. If this
  70   67  argument is not specified, the output volume remains at the level most recently
  71   68  set by any process.
  72   69  .RE
  73   70  
  74   71  .sp
  75   72  .ne 2
  76   73  .na

  77   74  \fB\fB-V\fR\fR
  78   75  .ad
  79   76  .RS 11n
  80   77  \fIVerbose\fR: Prints messages on the standard error when waiting for access to
  81   78  the audio device or when sample rate deviations are detected.
  82   79  .RE
  83   80  
  84   81  .sp
  85   82  .ne 2
  86   83  .na
  87      -\fB\fB\(mi\e?\fR\fR
       84 +\fB\fB-?\fR\fR
  88   85  .ad
  89   86  .RS 11n
  90   87  \fIHelp\fR: Prints a command line usage message.
  91   88  .RE
  92   89  
  93   90  .SH OPERANDS
  94   91  .ne 2
  95   92  .na
  96   93  \fB\fIfile\fR\fR
  97   94  .ad
  98   95  .RS 8n
  99   96  \fIFile Specification\fR: Audio files named on the command line are played
 100   97  sequentially. If no filenames are present, the standard input stream (if it is
 101   98  not a tty) is played (it, too, must contain an audio file header). The special
 102   99  filename \fB\(mi\fR can be used to read the standard input stream instead of a
 103  100  file. If a relative path name is supplied, the \fBAUDIOPATH\fR environment
 104  101  variable is consulted (see below).
 105  102  .RE
 106  103  
 107  104  .SH USAGE
 108      -.LP
 109  105  See \fBlargefile\fR(5) for the description of the behavior of \fBaudioplay\fR
 110      -when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
      106 +when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
 111  107  .SH ENVIRONMENT VARIABLES
 112  108  .ne 2
 113  109  .na
 114  110  \fB\fBAUDIODEV\fR\fR
 115  111  .ad
 116  112  .RS 13n
 117  113  The full path name of the audio device to write to, if no \fB-d\fR argument is
 118  114  supplied. If the \fBAUDIODEV\fR variable is not set, \fB/dev/audio\fR is used.
 119  115  .RE
 120  116  

 121  117  .sp
 122  118  .ne 2

 123  119  .na
 124  120  \fB\fBAUDIOPATH\fR\fR
 125  121  .ad
 126  122  .RS 13n
 127  123  A colon-separated list of directories in which to search for audio files whose
 128  124  names are given by relative pathnames. The current directory (\fB\&.\fR) can be
 129  125  specified explicitly in the search path. If the \fBAUDIOPATH\fR variable is not
 130  126  set, only the current directory is searched.
 131  127  .RE
 132  128  
 133      -.SH ATTRIBUTES
 134      -.LP
 135      -See \fBattributes\fR(5) for descriptions of the following attributes:
 136      -.sp
 137      -
 138      -.sp
 139      -.TS
 140      -box;
 141      -c | c
 142      -l | l .
 143      -ATTRIBUTE TYPE  ATTRIBUTE VALUE
 144      -_
 145      -Architecture    SPARC, x86
 146      -_
 147      -Interface Stability     Committed
 148      -.TE
 149      -
 150  129  .SH SEE ALSO
 151      -.LP
 152  130  \fBaudioconvert\fR(1), \fBaudiorecord\fR(1),
 153      -\fBattributes\fR(5), \fBlargefile\fR(5), \fBaudio\fR(7I)
      131 +\fBlargefile\fR(5), \fBaudio\fR(7I)
 154  132  .SH BUGS
 155      -.LP
 156  133  \fBaudioplay\fR currently supports a limited set of audio format conversions.
 157  134  If the audio file is not in a format supported by the audio device, it must
 158  135  first be converted. For example, to convert to voice format on the fly, use the
 159  136  command:
 160  137  .sp
 161  138  .in +2
 162  139  .nf
 163  140  example% \fBaudioconvert -f voice myfile | audioplay\fR
 164  141  .fi
 165  142  .in -2
 166  143  .sp
 167  144  
 168  145  .sp
 169  146  .LP
 170  147  The format conversion is not always be able to keep up with the audio output.
 171  148  If this is the case, you should convert to a temporary file before playing the
 172  149  data.
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX