shithub: sox

Download patch

ref: b1d87fb89d426c759c71fe47ace9c025d6384a6c
parent: 5d2e7c1b1cbf1894cc440275bffdc78438cefb8f
author: robs <robs>
date: Thu Mar 6 14:55:44 EST 2008 

--help-format


--- a/ChangeLog
+++ b/ChangeLog
@@ -24,9 +24,10 @@
 
 File formats:
 
+  o New option --help-format shows info about supported formats.  (robs)
   o New htk format.  (robs)
   o Fix [1864216] comments mangled when writing ogg-vorbis.  (robs)
-  o Fix short noise at end of alsa playback.  (Morita Sho)
+  o Fix short noise at end of alsa playback.  (Morita Sho/Tim Munro/robs)
   o Fix wve seek accuracy.  (robs)
   o Fix lpc10 not working.  (robs)
   o For wav & au, fix [548256] size in header wrong when piping out.  (robs)
@@ -36,7 +37,7 @@
   o Au/snd: added support for 32-bit integer and 64-bit float PCM
     encoding/decoding; display name of unsupported encoding.  (robs)
   o Can now write .amb (.wav variant) files [FR 1902232].  (robs)
-  o Can now read 2,3,4 bit ADPCM .voc files [FR 1714991].  (robs)
+  o Can now read 2,3(2.6),4 bit ADPCM .voc files [FR 1714991].  (robs)
 
 Effects:
 
@@ -54,7 +55,7 @@
   o Basic VU meter.  (robs)
   o Simple heuristic to detect when playing an album and set
     the default replay-gain mode to `album'.  (robs)
-  o More intelligent choice of output file format parameters when
+  o Better auto-choice of output file format parameters when
     type is different to that of input file.  (robs)
   o SoX now treats (and displays) encoding size & signal precision
     separately.  (robs)
--- a/sox.1
+++ b/sox.1
@@ -488,6 +488,10 @@
 Show usage information on the specified effect.  The name
 \fBall\fR can be used to show usage on all effects.
 .TP
+\fB\-\-help\-format=\fINAME\fR
+Show information about the specified file format.  The name
+\fBall\fR can be used to show information on all formats.
+.TP
 \fB\-\-interactive\fR
 Prompt before overwriting an existing file with the same name as that
 given for the output file.
--- a/src/8svx.c
+++ b/src/8svx.c
@@ -364,6 +364,7 @@
   static char const * const names[] = {"8svx", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_SIGN2, 8, 0, 0};
   static sox_format_handler_t const handler = {
+    "Amiga audio format (a subformat of the Interchange File Format)",
     names, SOX_FILE_BIG_END|SOX_FILE_MONO|SOX_FILE_STEREO|SOX_FILE_QUAD,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/aifc-fmt.c
+++ b/src/aifc-fmt.c
@@ -25,6 +25,7 @@
   static unsigned const write_encodings[] = {
     SOX_ENCODING_SIGN2, 32, 24, 16, 8, 0, 0};
   static sox_format_handler_t const sox_aifc_format = {
+    "AIFF-C (not compressed, linear), defined in DAVIC 1.4 Part 9 Annex B",
     names, SOX_FILE_LOOPS | SOX_FILE_BIG_END,
     sox_aiffstartread, sox_aiffread, sox_aiffstopread,
     sox_aifcstartwrite, sox_aiffwrite, sox_aifcstopwrite,
--- a/src/aiff-fmt.c
+++ b/src/aiff-fmt.c
@@ -25,6 +25,7 @@
   static unsigned const write_encodings[] = {
     SOX_ENCODING_SIGN2, 32, 24, 16, 8, 0, 0};
   static sox_format_handler_t const sox_aiff_format = {
+    "AIFF files used on Apple IIc/IIgs and SGI",
     names, SOX_FILE_LOOPS | SOX_FILE_BIG_END,
     sox_aiffstartread, sox_aiffread, sox_aiffstopread,
     sox_aiffstartwrite, sox_aiffwrite, sox_aiffstopwrite,
--- a/src/alsa.c
+++ b/src/alsa.c
@@ -666,6 +666,7 @@
     SOX_ENCODING_UNSIGNED, 16, 8, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Advanced Linux Sound Architecture device driver",
     names, SOX_FILE_DEVICE | SOX_FILE_NOSTDIO,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/amr.h
+++ b/src/amr.h
@@ -157,6 +157,7 @@
   static sox_rate_t   const write_rates[] = {AMR_RATE, 0};
   static unsigned const write_encodings[] = {AMR_ENCODING, 0, 0};
   static sox_format_handler_t handler = {
+    "3GPP Adaptive Multi Rate lossy speech compressor",
     names, SOX_FILE_MONO,
     startread, read, stopread,
     startwrite, write, stopwrite,
--- a/src/ao.c
+++ b/src/ao.c
@@ -127,6 +127,7 @@
   static char const * const names[] = {"ao", NULL};
   static unsigned const encodings[] = {SOX_ENCODING_SIGN2, 16, 0, 0};
   static sox_format_handler_t const handler = {
+    "Xiph's libao device driver",
     names, SOX_FILE_DEVICE | SOX_FILE_NOSTDIO,
     NULL, NULL, NULL,
     startwrite, write_samples, stopwrite,
--- a/src/au.c
+++ b/src/au.c
@@ -235,6 +235,7 @@
     SOX_ENCODING_FLOAT, 32, 64, 0,
     0};
   static sox_format_handler_t const handler = {
+    "PCM file format used widely on Sun systems",
     names, SOX_FILE_BIG_END | SOX_FILE_REWIND,
     startread, sox_rawread, NULL,
     write_header, sox_rawwrite, NULL,
--- a/src/auto.c
+++ b/src/auto.c
@@ -165,6 +165,7 @@
 {
   static const char *autonames[] = {"magic", NULL};
   static sox_format_handler_t sox_auto_format = {
+    NULL,
     autonames, SOX_FILE_DEVICE | SOX_FILE_PHONY,
     sox_autostartread, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL
   };
--- a/src/avr.c
+++ b/src/avr.c
@@ -280,6 +280,7 @@
     SOX_ENCODING_UNSIGNED, 16, 8, 0,
     0};
   static sox_format_handler_t handler = {
+    "Audio Visual Research format; used on the Mac",
     names,
     SOX_FILE_BIG_END|SOX_FILE_MONO|SOX_FILE_STEREO,
     startread, sox_rawread, NULL,
--- a/src/cdr.c
+++ b/src/cdr.c
@@ -40,6 +40,7 @@
   static unsigned const write_encodings[] = {SOX_ENCODING_SIGN2, 16, 0, 0};
   static sox_rate_t const write_rates[] = {44100, 0};
   static sox_format_handler_t handler = {
+    "Red Book Compact Disc Digital Audio",
     names, SOX_FILE_BIG_END|SOX_FILE_STEREO,
     start, sox_rawread, NULL,
     NULL, sox_rawwrite, stopwrite,
--- a/src/cvsd-fmt.c
+++ b/src/cvsd-fmt.c
@@ -23,6 +23,7 @@
   static char const * const names[] = {"cvsd", "cvs", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_CVSD, 1, 0, 0};
   static sox_format_handler_t const handler = {
+    "Headerless Continuously Variable Slope Delta modulation",
     names, SOX_FILE_MONO,
     sox_cvsdstartread, sox_cvsdread, sox_cvsdstopread,
     sox_cvsdstartwrite, sox_cvsdwrite, sox_cvsdstopwrite,
--- a/src/dat.c
+++ b/src/dat.c
@@ -153,6 +153,7 @@
   static char const * const names[] = {"dat", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_FLOAT_TEXT, 0, 0};
   static sox_format_handler_t const handler = {
+    "Textual representation of the sampled audio",
     names, 0,
     sox_datstartread, sox_datread, NULL,
     sox_datstartwrite, sox_datwrite, NULL,
--- a/src/dvms-fmt.c
+++ b/src/dvms-fmt.c
@@ -23,6 +23,7 @@
   static char const * const names[] = {"dvms", "vms", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_CVSD, 1, 0, 0};
   static sox_format_handler_t const handler = {
+    "Continuously Variable Slope Delta modulation with header",
     names, SOX_FILE_MONO,
     sox_dvmsstartread, sox_cvsdread, sox_cvsdstopread,
     sox_dvmsstartwrite, sox_cvsdwrite, sox_dvmsstopwrite,
--- a/src/ffmpeg.c
+++ b/src/ffmpeg.c
@@ -489,6 +489,7 @@
   static unsigned const write_encodings[] = {SOX_ENCODING_SIGN2, 16, 0, 0};
 
   static sox_format_handler_t handler = {
+    "Pseudo format to use libffmpeg",
     names,
     SOX_FILE_NOSTDIO,
     startread, read_samples, stopread,
--- a/src/flac.c
+++ b/src/flac.c
@@ -519,6 +519,7 @@
   static char const * const names[] = {"flac", NULL};
   static unsigned const encodings[] = {SOX_ENCODING_FLAC, 8, 16, 24, 0, 0};
   static sox_format_handler_t const handler = {
+    "Free Lossless Audio CODEC compressed audio",
     names, 0,
     start_read, read_samples, stop_read,
     start_write, write_samples, stop_write,
--- a/src/gsm.c
+++ b/src/gsm.c
@@ -239,6 +239,7 @@
   static char const * const names[] = {"gsm", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_GSM, 0, 0};
   static sox_format_handler_t handler = {
+    "GSM 06.10 (full-rate) lossy speech compression",
     names, 0,
     sox_gsmstartread, sox_gsmread, sox_gsmstopread,
     sox_gsmstartwrite, sox_gsmwrite, sox_gsmstopwrite,
--- a/src/hcom.c
+++ b/src/hcom.c
@@ -451,10 +451,11 @@
 SOX_FORMAT_HANDLER(hcom)
 {
   static char const * const names[]       = {"hcom", NULL};
-  static sox_rate_t   const write_rates[] = {22050,22050/2,22050/3,22050/4, 0};
+  static sox_rate_t   const write_rates[] = {22050,22050/2,22050/3,22050/4.,0};
   static unsigned     const write_encodings[] = {
     SOX_ENCODING_HCOM, 8, 0, 0};
   static sox_format_handler_t handler   = {
+    "Mac FSSD files with Huffman compression",
     names, SOX_FILE_BIG_END|SOX_FILE_MONO,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/htk.c
+++ b/src/htk.c
@@ -65,6 +65,7 @@
   static char const * const names[] = {"htk", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_SIGN2, 16, 0, 0};
   static sox_format_handler_t handler = {
+    "PCM format used for Hidden Markov Model speech processing",
     names, SOX_FILE_BIG_END | SOX_FILE_MONO | SOX_FILE_REWIND,
     start_read, sox_rawread, NULL,
     write_header, sox_rawwrite, NULL,
--- a/src/ima-fmt.c
+++ b/src/ima-fmt.c
@@ -24,6 +24,7 @@
   static char const * const names[] = {"ima", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_IMA_ADPCM, 4, 0, 0};
   static sox_format_handler_t handler = {
+    "Raw IMA ADPCM",
     names, SOX_FILE_MONO,
     sox_ima_start, sox_vox_read, sox_vox_stopread,
     sox_ima_start, sox_vox_write, sox_vox_stopwrite,
--- a/src/lpc10.c
+++ b/src/lpc10.c
@@ -214,6 +214,7 @@
   static sox_rate_t   const write_rates[] = {8000, 0};
   static unsigned     const write_encodings[] = {SOX_ENCODING_LPC10, 0, 0};
   static sox_format_handler_t handler = {
+    "Low bandwidth, robotic sounding speech compression",
     names, SOX_FILE_MONO,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/maud.c
+++ b/src/maud.c
@@ -326,6 +326,7 @@
     SOX_ENCODING_ALAW, 8, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Used with the ‘Toccata’ sound-card on the Amiga",
     names, SOX_FILE_BIG_END | SOX_FILE_MONO | SOX_FILE_STEREO,
     startread, sox_rawread, sox_rawstopread,
     startwrite, write_samples, stopwrite,
--- a/src/mp3.c
+++ b/src/mp3.c
@@ -534,6 +534,7 @@
   static unsigned const write_encodings[] = {
     SOX_ENCODING_GSM, 0, 0};
   static sox_format_handler_t const handler = {
+    "MPEG Layer 3 lossy audio compression",
     names, 0,
     startread, sox_mp3read, stopread,
     startwrite, sox_mp3write, stopwrite,
--- a/src/nulfile.c
+++ b/src/nulfile.c
@@ -52,6 +52,7 @@
 {
   static const char * const names[] = {"null", NULL};
   static sox_format_handler_t const handler = {
+    NULL,
     names, SOX_FILE_DEVICE | SOX_FILE_PHONY | SOX_FILE_NOSTDIO,
     startread, read_samples, NULL, NULL, write_samples, NULL, NULL, NULL, NULL
   };
--- a/src/oss.c
+++ b/src/oss.c
@@ -214,6 +214,7 @@
     SOX_ENCODING_UNSIGNED, 8, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Open Sound Sytem device driver for unix-like systems",
     names, SOX_FILE_DEVICE,
     ossinit, sox_rawread, sox_rawstopread,
     ossinit, sox_rawwrite, sox_rawstopwrite,
--- a/src/prc.c
+++ b/src/prc.c
@@ -390,6 +390,7 @@
     SOX_ENCODING_IMA_ADPCM, 4, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Psion Record; used in EPOC devices (Series 5, Revo and similar)",
     names, SOX_FILE_LIT_END | SOX_FILE_MONO,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/raw-fmt.c
+++ b/src/raw-fmt.c
@@ -33,6 +33,7 @@
     SOX_ENCODING_FLOAT, 64, 32, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Raw PCM, mu-law, or A-law",
     names, 0,
     raw_start, sox_rawread , NULL,
     raw_start, sox_rawwrite, NULL,
--- a/src/raw.h
+++ b/src/raw.h
@@ -25,6 +25,7 @@
   static unsigned const write_encodings[] = { \
     SOX_ENCODING_ ## encoding, size, 0, 0}; \
   static sox_format_handler_t handler = { \
+    "Raw audio", \
     names, flags, \
     id ## _start, sox_rawread , NULL, \
     id ## _start, sox_rawwrite, NULL, \
--- a/src/sf.c
+++ b/src/sf.c
@@ -222,6 +222,7 @@
     SOX_ENCODING_FLOAT, 32, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Institut de Recherche et Coordination Acoustique/Musique Sound Description Interchange Format",
     names, 0,
     startread, sox_rawread, sox_rawstopread,
     startwrite, sox_rawwrite, sox_rawstopwrite,
--- a/src/skelform.c
+++ b/src/skelform.c
@@ -213,6 +213,7 @@
    * and NULL used in place of the its name below.
    */
   static sox_format_handler_t handler = {
+    "My first SoX format!",
     names, 0,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/smp.c
+++ b/src/smp.c
@@ -401,6 +401,7 @@
   static char const * const names[] = {"smp", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_SIGN2, 16, 0, 0};
   static sox_format_handler_t handler = {
+    "Turtle Beach SampleVision",
     names, SOX_FILE_LOOPS | SOX_FILE_LIT_END | SOX_FILE_MONO,
     sox_smpstartread, sox_smpread, NULL,
     sox_smpstartwrite, sox_smpwrite, sox_smpstopwrite,
--- a/src/sndfile.c
+++ b/src/sndfile.c
@@ -459,6 +459,7 @@
     0};
 
   static sox_format_handler_t const format = {
+    "Pseudo format to use libsndfile",
     names, SOX_FILE_NOSTDIO,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/sndrtool.c
+++ b/src/sndrtool.c
@@ -167,6 +167,7 @@
   static char const * const names[] = {"sndt", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_UNSIGNED, 8, 0, 0};
   static sox_format_handler_t const handler = {
+    "Handles Sndtool and Sounder files",
     names, SOX_FILE_LIT_END | SOX_FILE_MONO,
     startread, sox_rawread, sox_rawstopread,
     startwrite, write_samples, stopwrite,
--- a/src/sox.c
+++ b/src/sox.c
@@ -933,6 +933,7 @@
 "--combine sequence  sequence multiple input files (default for play)",
 "-h, --help      display version number and usage information",
 "--help-effect NAME  display usage of specified effect; use `all' to display all",
+"--help-format NAME  display info on specified format; use `all' to display all",
 "--interactive   prompt to overwrite output file",
 "-m, --combine mix  mix multiple input files (instead of concatenating)",
 "-M, --combine merge  merge multiple input files (instead of concatenating)",
@@ -995,7 +996,7 @@
   putchar('\n');
 
   if (strcmp("all", name) && !sox_find_effect(name)) {
-    printf("Cannot find an effect called `%s'.", name);
+    printf("Cannot find an effect called `%s'.\n", name);
     display_supported_effects();
   }
   else {
@@ -1010,6 +1011,80 @@
   exit(1);
 }
 
+static void usage_format1(sox_format_handler_t const * f)
+{
+  char const * const * names;
+
+  printf("\nFormat: %s\n", f->names[0]);
+  printf("Description: %s\n", f->description);
+  if (f->names[1]) {
+    printf("Also handles:");
+    for (names = f->names + 1; *names; ++names)
+      printf(" %s", *names);
+    putchar('\n');
+  }
+  if (f->flags & SOX_FILE_CHANS) {
+    printf("Channels restricted to:");
+    if (f->flags & SOX_FILE_MONO) printf(" mono");
+    if (f->flags & SOX_FILE_STEREO) printf(" stereo");
+    if (f->flags & SOX_FILE_QUAD) printf(" quad");
+    putchar('\n');
+  }
+  if (f->write_rates) {
+    sox_rate_t const * p = f->write_rates;
+    printf("Sample-rate restricted to:");
+    while (*p)
+      printf(" %g", *p++);
+    putchar('\n');
+  }
+  printf("Reads: %s\n", f->startread || f->read? "yes" : "no");
+  if (f->startwrite || f->write) {
+    if (f->write_formats) {
+      sox_encoding_t e;
+      unsigned i, s;
+#define enc_arg(T) (T)f->write_formats[i++]
+      i = 0;
+      puts("Writes:");
+      while ((e = enc_arg(sox_encoding_t)))
+        do {
+          s = enc_arg(unsigned);
+          if (sox_precision(e, s)) {
+            printf("  ");
+            if (s)
+              printf("%2u-bit ", s);
+            printf("%s (%u-bit precision)\n", sox_encodings_str[e], sox_precision(e, s));
+          }
+        } while (s);
+      }
+      else puts("Writes: yes");
+    }
+  else puts("Writes: no");
+}
+
+static void usage_format(char const * name)
+{
+  sox_format_handler_t const * f;
+  unsigned i;
+
+  display_SoX_version(stdout);
+
+  if (strcmp("all", name)) {
+    if (!(f = sox_find_format(name, sox_false))) {
+      printf("Cannot find a format called `%s'.\n", name);
+      display_supported_formats();
+    }
+    else usage_format1(f);
+  }
+  else {
+    for (i = 0; i < sox_formats; ++i) {
+      sox_format_handler_t const * f = sox_format_fns[i].fn();
+      if (!(f->flags & SOX_FILE_PHONY))
+        usage_format1(f);
+    }
+  }
+  exit(1);
+}
+
 static void read_comment_file(comments_t * comments, char const * const filename)
 {
   int c;
@@ -1055,6 +1130,7 @@
     {"endian"          , required_argument, NULL, 0},
     {"interactive"     ,       no_argument, NULL, 0},
     {"help-effect"     , required_argument, NULL, 0},
+    {"help-format"     , required_argument, NULL, 0},
     {"plot"            , required_argument, NULL, 0},
     {"replay-gain"     , required_argument, NULL, 0},
     {"version"         ,       no_argument, NULL, 0},
@@ -1171,14 +1247,18 @@
         break;
 
       case 8:
-        sox_effects_globals.plot = enum_option(option_index, plot_methods);
+        usage_format(optarg);
         break;
 
       case 9:
-        replay_gain_mode = enum_option(option_index, rg_modes);
+        sox_effects_globals.plot = enum_option(option_index, plot_methods);
         break;
 
       case 10:
+        replay_gain_mode = enum_option(option_index, rg_modes);
+        break;
+
+      case 11:
         display_SoX_version(stdout);
         exit(0);
         break;
--- a/src/sox.h
+++ b/src/sox.h
@@ -291,7 +291,8 @@
 typedef struct sox_format sox_format_t;
 
 typedef struct {
-    const char   * const *names;
+    char         const * description;
+    char         const * const * names;
     unsigned int flags;
     int          (*startread)(sox_format_t * ft);
     sox_size_t   (*read)(sox_format_t * ft, sox_sample_t *buf, sox_size_t len);
--- a/src/sphere.c
+++ b/src/sphere.c
@@ -249,6 +249,7 @@
     SOX_ENCODING_ULAW, 8, 0,
     0};
   static sox_format_handler_t const handler = {
+    "SPeech HEader Resources; defined by NIST",
     names, 0,
     startread, sox_rawread, sox_rawstopread,
     startwrite, write_samples, stopwrite,
--- a/src/sunaudio.c
+++ b/src/sunaudio.c
@@ -316,6 +316,7 @@
     SOX_ENCODING_SIGN2, 8, 16, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Sun audio device driver",
     names, SOX_FILE_DEVICE,
     sox_sunstartread, sox_rawread, sox_rawstopread,
     sox_sunstartwrite, sox_rawwrite, sox_rawstopwrite,
--- a/src/tx16w.c
+++ b/src/tx16w.c
@@ -366,6 +366,7 @@
   static char const * const names[] = {"txw", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_SIGN2, 16, 0, 0};
   static sox_format_handler_t const handler = {
+    "Yamaha TX-16W sampler",
     names, 0,
     startread, read_samples, NULL,
     startwrite, write_samples, stopwrite,
--- a/src/voc.c
+++ b/src/voc.c
@@ -789,6 +789,7 @@
     0
   };
   static sox_format_handler_t const handler = {
+    "Creative Technology Sound Blaster format",
     names, SOX_FILE_LIT_END | SOX_FILE_MONO | SOX_FILE_STEREO,
     startread, read_samples, NULL,
     startwrite, write_samples, stopwrite,
--- a/src/vorbis.c
+++ b/src/vorbis.c
@@ -397,6 +397,7 @@
   static const char *names[] = {"vorbis", "ogg", NULL};
   static unsigned encodings[] = {SOX_ENCODING_VORBIS, 0, 0};
   static sox_format_handler_t handler = {
+    "Xiph's ogg-vorbis lossy compression",
     names, 0,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/vox-fmt.c
+++ b/src/vox-fmt.c
@@ -24,6 +24,7 @@
   static char const * const names[] = {"vox", NULL};
   static unsigned const write_encodings[] = {SOX_ENCODING_OKI_ADPCM, 4, 0, 0};
   static sox_format_handler_t handler = {
+    "Raw OKI/Dialogic ADPCM",
     names, SOX_FILE_MONO,
     sox_vox_start, sox_vox_read, sox_vox_stopread,
     sox_vox_start, sox_vox_write, sox_vox_stopwrite,
--- a/src/wav.c
+++ b/src/wav.c
@@ -1613,6 +1613,7 @@
     SOX_ENCODING_FLOAT, 32, 0,
     0};
   static sox_format_handler_t const handler = {
+    "Microsoft audio format",
     names, SOX_FILE_LIT_END,
     startread, read_samples, stopread,
     startwrite, write_samples, stopwrite,
--- a/src/wve.c
+++ b/src/wve.c
@@ -52,6 +52,7 @@
   static sox_rate_t   const write_rates[] = {8000, 0};
   static unsigned     const write_encodings[] = {SOX_ENCODING_ALAW, 8, 0, 0};
   static sox_format_handler_t const handler = {
+    "Psion 3 audio format",
     names, SOX_FILE_BIG_END | SOX_FILE_MONO | SOX_FILE_REWIND,
     start_read, sox_rawread, NULL,
     write_header, sox_rawwrite, NULL,
--- a/src/xa.c
+++ b/src/xa.c
@@ -284,6 +284,7 @@
 {
   static char const * const names[] = {"xa", NULL };
   static sox_format_handler_t const handler = {
+    "16-bit ADPCM audio files used by Maxis games",
     names, SOX_FILE_LIT_END,
     startread, read_samples, stopread,
     NULL, NULL, NULL,