Update libsndfile to 1.0.29pre2+git

This pulls in MANY (over 890) changes compared to our
from our current 1.0.24 version.

lib-src/libsndfile/man/sndfile-interleave.1

@@ -1,23 +1,62 @@
-.TH SNDFILE-INTERLEAVE 1 "December 14, 2009"
-.SH NAME
-sndfile-interleave \- convert multiple single channel files into a multi-channel file
-.br
-sndfile-deinterleave \- split a multi-channel into multiple single channel files
-.SH SYNOPSIS
-.B sndfile-interleave
-.RI "<input 1> <input 2> ... -o <output file>"
-.br
-.B sndfile-deinterleave
-.RI "filename"
-
-.SH DESCRIPTION
-sndfile-interleave and sndfile-deinterleave use libsndfile
-(http://www.mega-nerd.com/libsndfile/) to convert back and forth between multiple
-single channel files and a single multi-channel sound file.
-
-Run "sndfile\-interleave \-\-help" or "sndfile\-deinterleave \-\-help" for
-more information
-
-.SH AUTHOR
-This manual page was written by Erik de Castro Lopo <erikd@mega-nerd.com>.
-
+.Dd November 2, 2014
+.Dt SNDFILE-INTERLEAVE 1
+.Os
+.Sh NAME
+.Nm sndfile-interleave ,
+.Nm sndfile-deinterleave
+.Nd convert mono files into a multi-channel file and vice versa
+.Sh SYNOPSIS
+.Nm sndfile-interleave
+.Ar input1
+.Ar input2
+.Ar ...
+.Fl o Ar output
+.Nm sndfile-deinterleave
+.Ar file
+.Sh DESCRIPTION
+.Nm sndfile-interleave
+creates a multi-channel file taking audio data
+from two or more mono files as individual channels.
+The format of the output file is determined by its filename suffix.
+The audio parameters of the output file will be made so that
+the format can accommodate each of the mono inputs;
+for example, the samplerate will be the maximal samplerate
+occurring in the inputs.
+The output file will be overwritten if it already exists.
+.Pp
+.Nm sndfile-deinterleave
+creates two or more mono files from a multi-channel audio file,
+containing data from the individual channels. The names of the
+resulting mono files are of the form
+.Dq name_XY.suf
+where
+.Em name
+and
+.Em suf
+are the basename and suffix of the original file.
+If any file of such name already exists, it will be overwritten.
+Apart from the number of channels,
+the audio format of the resulting mono files
+is the same as that of the original file.
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+Merge a mono OGG file and a mono FLAC file into a stereo WAV file:
+.Bd -literal -offset indent
+$ sndfile-interleave left.ogg right.flac -o stereo.wav
+.Ed
+.Pp
+Split a multi-channel into individual mono files:
+.Bd -literal -offset indent
+$ sndfile-deinterleave multi.wav
+Input file : multi
+Output files :
+    multi_00.wav
+    multi_01.wav
+    multi_02.wav
+    multi_03.wav
+.Ed
+.Sh SEE ALSO
+.Lk http://www.mega-nerd.com/libsndfile/
+.Sh AUTHORS
+.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com