Initial commit of audiofilesubmit/1.0/20121129.024832submit/1.0/20121129.024342

17 files changed, 843 insertions, 0 deletions

diff --git a/docs/Makefile.am b/docs/Makefile.am
new file mode 100644
index 0000000..3bb2e48
--- /dev/null
+++ b/docs/Makefile.am
@@ -0,0 +1,16 @@
+EXTRA_DIST = \
+	afCloseFile \
+	afGetFrameSize \
+	afGetTrackBytes \
+	afIntro \
+	afNewFileSetup \
+	afOpenFile \
+	afQuery \
+	afReadFrames \
+	afReadMisc \
+	afSeekFrame \
+	afSetErrorHandler \
+	afSetVirtualByteOrder \
+	afWriteFrames \
+	sfconvert \
+	sfinfo
diff --git a/docs/Makefile.in b/docs/Makefile.in
new file mode 100644
index 0000000..50e3143
--- /dev/null
+++ b/docs/Makefile.in
@@ -0,0 +1,232 @@
+# Makefile.in generated automatically by automake 1.5 from Makefile.am.
+
+# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001
+# Free Software Foundation, Inc.
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+@SET_MAKE@
+
+SHELL = @SHELL@
+
+srcdir = @srcdir@
+top_srcdir = @top_srcdir@
+VPATH = @srcdir@
+prefix = @prefix@
+exec_prefix = @exec_prefix@
+
+bindir = @bindir@
+sbindir = @sbindir@
+libexecdir = @libexecdir@
+datadir = @datadir@
+sysconfdir = @sysconfdir@
+sharedstatedir = @sharedstatedir@
+localstatedir = @localstatedir@
+libdir = @libdir@
+infodir = @infodir@
+mandir = @mandir@
+includedir = @includedir@
+oldincludedir = /usr/include
+pkgdatadir = $(datadir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+top_builddir = ..
+
+ACLOCAL = @ACLOCAL@
+AUTOCONF = @AUTOCONF@
+AUTOMAKE = @AUTOMAKE@
+AUTOHEADER = @AUTOHEADER@
+
+INSTALL = @INSTALL@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_HEADER = $(INSTALL_DATA)
+transform = @program_transform_name@
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+host_alias = @host_alias@
+host_triplet = @host@
+AMTAR = @AMTAR@
+AS = @AS@
+AUDIOFILE_MAJOR_VERSION = @AUDIOFILE_MAJOR_VERSION@
+AUDIOFILE_MICRO_VERSION = @AUDIOFILE_MICRO_VERSION@
+AUDIOFILE_MINOR_VERSION = @AUDIOFILE_MINOR_VERSION@
+AUDIOFILE_VERSION = @AUDIOFILE_VERSION@
+AUDIOFILE_VERSION_INFO = @AUDIOFILE_VERSION_INFO@
+AUDIO_LIB = @AUDIO_LIB@
+AWK = @AWK@
+CC = @CC@
+DEPDIR = @DEPDIR@
+DLLTOOL = @DLLTOOL@
+ECHO = @ECHO@
+EXEEXT = @EXEEXT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+LIBTOOL = @LIBTOOL@
+LN_S = @LN_S@
+OBJDUMP = @OBJDUMP@
+OBJEXT = @OBJEXT@
+PACKAGE = @PACKAGE@
+RANLIB = @RANLIB@
+STRIP = @STRIP@
+TEST_BIN = @TEST_BIN@
+VERSION = @VERSION@
+am__include = @am__include@
+am__quote = @am__quote@
+install_sh = @install_sh@
+
+EXTRA_DIST = \
+	afCloseFile \
+	afGetFrameSize \
+	afGetTrackBytes \
+	afIntro \
+	afNewFileSetup \
+	afOpenFile \
+	afQuery \
+	afReadFrames \
+	afReadMisc \
+	afSeekFrame \
+	afSetErrorHandler \
+	afSetVirtualByteOrder \
+	afWriteFrames \
+	sfconvert \
+	sfinfo
+
+subdir = docs
+mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES =
+DIST_SOURCES =
+DIST_COMMON = Makefile.am Makefile.in
+all: all-am
+
+.SUFFIXES:
+
+mostlyclean-libtool:
+	-rm -f *.lo
+
+clean-libtool:
+	-rm -rf .libs _libs
+
+distclean-libtool:
+	-rm -f libtool
+$(srcdir)/Makefile.in:  Makefile.am  $(top_srcdir)/configure.in $(ACLOCAL_M4)
+	cd $(top_srcdir) && \
+	  $(AUTOMAKE) --gnu  docs/Makefile
+Makefile:  $(srcdir)/Makefile.in  $(top_builddir)/config.status
+	cd $(top_builddir) && \
+	  CONFIG_HEADERS= CONFIG_LINKS= \
+	  CONFIG_FILES=$(subdir)/$@ $(SHELL) ./config.status
+uninstall-info-am:
+tags: TAGS
+TAGS:
+
+
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+
+top_distdir = ..
+distdir = $(top_distdir)/$(PACKAGE)-$(VERSION)
+
+distdir: $(DISTFILES)
+	@for file in $(DISTFILES); do \
+	  if test -f $$file; then d=.; else d=$(srcdir); fi; \
+	  dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
+	  if test "$$dir" != "$$file" && test "$$dir" != "."; then \
+	    $(mkinstalldirs) "$(distdir)/$$dir"; \
+	  fi; \
+	  if test -d $$d/$$file; then \
+	    cp -pR $$d/$$file $(distdir) \
+	    || exit 1; \
+	  else \
+	    test -f $(distdir)/$$file \
+	    || cp -p $$d/$$file $(distdir)/$$file \
+	    || exit 1; \
+	  fi; \
+	done
+check-am: all-am
+check: check-am
+all-am: Makefile
+
+installdirs:
+
+install: install-am
+install-exec: install-exec-am
+install-data: install-data-am
+uninstall: uninstall-am
+
+install-am: all-am
+	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+
+installcheck: installcheck-am
+install-strip:
+	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+	  `test -z '$(STRIP)' || \
+	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
+mostlyclean-generic:
+
+clean-generic:
+
+distclean-generic:
+	-rm -f Makefile $(CONFIG_CLEAN_FILES) stamp-h stamp-h[0-9]*
+
+maintainer-clean-generic:
+	@echo "This command is intended for maintainers to use"
+	@echo "it deletes files that may require special tools to rebuild."
+clean: clean-am
+
+clean-am: clean-generic clean-libtool mostlyclean-am
+
+distclean: distclean-am
+
+distclean-am: clean-am distclean-generic distclean-libtool
+
+dvi: dvi-am
+
+dvi-am:
+
+info: info-am
+
+info-am:
+
+install-data-am:
+
+install-exec-am:
+
+install-info: install-info-am
+
+install-man:
+
+installcheck-am:
+
+maintainer-clean: maintainer-clean-am
+
+maintainer-clean-am: distclean-am maintainer-clean-generic
+
+mostlyclean: mostlyclean-am
+
+mostlyclean-am: mostlyclean-generic mostlyclean-libtool
+
+uninstall-am: uninstall-info-am
+
+.PHONY: all all-am check check-am clean clean-generic clean-libtool \
+	distclean distclean-generic distclean-libtool distdir dvi \
+	dvi-am info info-am install install-am install-data \
+	install-data-am install-exec install-exec-am install-info \
+	install-info-am install-man install-strip installcheck \
+	installcheck-am installdirs maintainer-clean \
+	maintainer-clean-generic mostlyclean mostlyclean-generic \
+	mostlyclean-libtool uninstall uninstall-am uninstall-info-am
+
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/docs/afCloseFile b/docs/afCloseFile
new file mode 100644
index 0000000..c1f67ba
--- /dev/null
+++ b/docs/afCloseFile
@@ -0,0 +1,17 @@
+afCloseFile closes an open audio file, updating the file if it was
+opened for writing.
+
+SYNOPSIS
+#include <audiofile.h>
+
+int afCloseFile (AFfilehandle file);
+
+RETURN VALUE
+afCloseFile returns 0 if the file was closed properly and -1 if an
+error occurred while closing the file.
+
+ERRORS
+afCloseFile can generate these possible errors:
+AF_BAD_FILEHANDLE
+AF_BAD_LSEEK
+AF_BAD_WRITE
diff --git a/docs/afGetFrameSize b/docs/afGetFrameSize
new file mode 100644
index 0000000..781d04c
--- /dev/null
+++ b/docs/afGetFrameSize
@@ -0,0 +1,34 @@
+afGetFrameSize returns the frame size in bytes for a specified audio
+track.
+
+SYNOPSIS
+#include <audiofile.h>
+
+float afGetFrameSize (AFfilehandle file, int track, int expand3to4);
+
+PARAMETERS
+file is a valid AFfilehandle.
+
+track is an integer which refers to a specific audio track in the
+file.  At present no supported audio file format allows for more than
+one audio track within a file, so track should always be
+AF_DEFAULT_TRACK.
+
+If expand3to4 is a non-zero value, then 3-byte frames will be treated
+as taking up 4 bytes in memory.  This is useful for calculating how
+much memory will be needed to store audio data suitable for playback
+since 24-bit audio data is typically aligned on 32-bit boundaries.  (At
+least that's how it's done on SGI systems; I know of no other computer
+system that has support for 24-bit audio.)
+
+DESCRIPTION
+afGetFrameSize returns the number of bytes in a frame in the given
+track of the specified file.
+
+A sample frame consists of one or more samples.  For a monaural track,
+a sample frame will always contain one sample.  For a stereophonic
+track, a sample frame will always contain two samples, one for the left
+channel and one for the right channel.
+
+The parameter expand3to4 is ignored unless the specified audio track
+contains 24-bit sampled audio data.
diff --git a/docs/afGetTrackBytes b/docs/afGetTrackBytes
new file mode 100644
index 0000000..3109dba
--- /dev/null
+++ b/docs/afGetTrackBytes
@@ -0,0 +1,55 @@
+NAME
+
+afGetFrameCount, afGetTrackBytes, afGetDataOffset - get the total sample
+frame count, length of audio track in bytes, offset of the audio track for a
+specified audio track in a specified AFfilehandle structure
+
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+AFframecount afGetFrameCount (AFfilehandle file, int track);
+
+AFfileoffset afGetTrackBytes (AFfilehandle file, int track);
+
+AFfileoffset afGetDataOffset (AFfilehandle file, int track);
+
+
+PARAMETERS
+
+file is an AFfilehandle that has been created by a previous call to
+afOpenFile.
+
+track is an integer which specifies an audio track within file.  All
+supported file formats contain exactly one audio track per file, so the
+constant AF_DEFAULT_TRACK should always be used.
+
+
+DESCRIPTION
+
+afGetFrameCount returns the total number of sample frames contained
+within the specified track of the specified file.
+
+Each sample frame of audio consists of a fixed number of samples (equal to
+the number of audio channels in the file, equal to the value returned by
+afGetChannels for the particular track and file).  For monaural data, a
+sample frame consists of one audio sample.  For stereophonic data, a sample
+frame consists of a stereo pair.
+
+afGetTrackBytes returns the total number of bytes of raw audio data
+(i.e., prior to decompression) in track.  This is useful for determining
+raw file seek points, etc.
+
+afGetDataOffset returns the offset in bytes of the start of the audio
+data contained within the specified track of the specified file.
+
+
+RETURN VALUE
+
+afGetFrameCount returns the total number of sample frames in track.
+afGetTrackBytes() returns the total number of bytes of audio data in
+track.  afGetDataOffset() returns the offset in bytes to the beginning
+of the audio data in track.
+
+If an error occurs, -1 is returned by all of these routines.
diff --git a/docs/afIntro b/docs/afIntro
new file mode 100644
index 0000000..1a07204
--- /dev/null
+++ b/docs/afIntro
@@ -0,0 +1,92 @@
+The purpose of the Audio File Library is to provide transparency to
+the programmer of file formats and data formats.
+
+BASICS
+
+Audio files contain a sequence of amplitudes sampled at a particular
+rate, called the sampling frequency.  The method by which sounds can
+be acquired or generated in this manner is referred to as pulse-code
+modulation (PCM).  The representation of these amplitudes varies from
+one file format to another.  Common representations for these data are
+two's complement integers, unsigned integers, and floating-point
+numbers.
+
+For uncompressed audio, a track within an audio file consists of a
+sequence of frames, each of which contains a number of samples equal to
+the number of channels in the track.  For example, in a stereo track,
+every frame contains two samples.
+
+To read from a file containing audio data, the following sequence of
+function calls are typically used:
+
+afOpenFile
+afReadFrames
+afCloseFile
+
+To write to a file, a similar sequence of commands is typically
+employed:
+
+afNewFileSetup
+afOpenFile
+afWriteFrames
+afCloseFile
+
+Data format transparency is achieved in the Audio File Library by
+providing the data in a virtual format.  The virtual format consists of
+a virtual byte order and a virtual sample format.  Virtual byte order
+is by default set to the host byte order and does not depend on the
+native byte order of the file format being used.  Virtual sample format
+is by default in an uncompressed format.
+
+The current Audio File Library does not support the concept of a virtual
+sampling rate, but this may be supported in the future.
+
+At the present, the Audio File Library supports only CCITT G.711
+mu-law/A-law compression.
+
+PROGRAMMING PARADIGM
+
+An audio file is manipulated through the AFfilehandle opaque data
+type.  Calls to the library are made with this file handle as an
+argument.  When opening a file for writing, another opaque data
+structure called AFfilsetup is used.  This structure is then passed to
+calls which set various file parameters which are set at the time the
+file is created, such as its file type and data format; such
+properties cannot be modified for an existing file.
+
+FUNCTIONS
+
+Calls available through the library include the following:
+
+afNewFileSetup - create a file setup structure
+afFreeFileSetup - free a file setup structure
+afOpenFile - create a file handle structure given a file name and
+	optionally a file setup
+afCloseFile - close an open audio file
+afSyncFile - update an audio file which has been opened for writing
+afSetVirtual{ByteOrder,Channels,PCMMapping,SampleFormat} - set virtual
+	format for audio data within a specified track
+afInit{ByteOrder,Channels,Rate,SampleFormat} - set parameters of an
+	AFfilesetup structure which will be used to open an audio file for
+	writing
+
+afQuery - query regarding the capabilities of the Audio File Library
+afQueryLong
+afQueryPointer
+afQueryDouble
+
+afSetLoop* - set loop parameters
+afGetLoop* - get loop parameters
+
+afSetMark* - set mark parameters
+afGetMark* - get mark parameters
+
+afSetInst* - set instrument parameters
+afGetInst* - get instrument parameters
+
+afGetAESChannelData - get AES channel data for a given audio file
+afSetAESChannelData - set AES channel data for a given audio file
+afInitAESChannelData - specify that storage space is to be allocated
+	for AES channel status data in a given audio file
+afInitAESChannelDataTo - specify whether storage space is to be allocated
+	for AES channel status data in a given audio file
diff --git a/docs/afNewFileSetup b/docs/afNewFileSetup
new file mode 100644
index 0000000..1985755
--- /dev/null
+++ b/docs/afNewFileSetup
@@ -0,0 +1,25 @@
+afNewFileSetup creates and initializes a new AFfilesetup structure.
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+AFfilesetup afNewFileSetup(void);
+
+RETURN VALUE
+
+afNewFileSetup returns, upon success, a valid AFfilesetup structure.
+
+Upon failure, afNewFileSetup returns a null AFfilesetup
+(AF_NULL_FILESETUP).  This case should only occur when no memory is
+available.
+
+DESCRIPTION
+
+The opaque AFfilesetup structure returned by afNewFileSetup can be
+used to specify parameters for a file to be opened for writing by
+afOpenFile.
+
+SEE ALSO
+
+afOpenFile
diff --git a/docs/afOpenFile b/docs/afOpenFile
new file mode 100644
index 0000000..f8d2a47
--- /dev/null
+++ b/docs/afOpenFile
@@ -0,0 +1,42 @@
+afOpenFile opens a specified audio file and creates a file handle
+structure which is used for subsequent calls to the Audio File
+Library.
+
+SYNOPSIS
+#include <audiofile.h>
+
+AFfilehandle afOpenFile(const char *path, const char *mode,
+	const AFfilesetup seutp);
+
+PARAMETERS
+path is the path to the file to be opened.
+
+mode specifies a mode for opening the file (typically "r" or "w").
+
+setup is ignored unless the mode specifies writing.
+
+RETURN VALUE
+afOpenFile returns, upon success, a valid AFfilehandle which can be
+used in subsequent calls to the Audio File Library for reading or
+writing.
+
+Upon failure, afOpenFile returns a null file handle
+(AF_NULL_FILEHANDLE).
+
+afCloseFile is used to close the file when it is no longer needed.
+
+ERRORS
+afOpenFile can produce the following errors:
+AF_BAD_OPEN (open failed)
+AF_BAD_READ (read failed)
+AF_BAD_WRITE (write failed)
+AF_BAD_LSEEK (lseek failed)
+AF_BAD_MALLOC (memory allocation failed)
+AF_BAD_FILEFMT (unrecognized file format)
+
+SEE ALSO
+afCloseFile
+afNewFileSetup
+afInitFileFormat
+afReadFrames
+afWriteFrames
diff --git a/docs/afQuery b/docs/afQuery
new file mode 100644
index 0000000..0129261
--- /dev/null
+++ b/docs/afQuery
@@ -0,0 +1,57 @@
+afQuery queries the capabilities of the Audio File Library.
+
+SYNOPSIS
+#include <audiofile.h>
+
+AUpvlist afQuery (int querytype, int arg1, int arg2, int arg3, int arg4);
+long afQueryLong (int querytype, int arg1, int arg2, int arg3, int arg4);
+double afQueryDouble (int querytype, int arg1, int arg2, int arg3, int arg4);
+void *afQueryPointer (int querytype, int arg1, int arg2, int arg3, int arg4);
+
+PARAMETERS
+querytype can be one of the following:
+AF_QUERYTYPE_FILEFMT
+AF_QUERYTYPE_INST
+AF_QUERYTYPE_INSTPARAM
+AF_QUERYTYPE_COMPRESSION
+AF_QUERYTYPE_COMPRESSIONPARAM
+AF_QUERYTYPE_MISC
+AF_QUERYTYPE_MARK
+AF_QUERYTYPE_LOOP
+
+For AF_QUERYTYPE_FILEFMT, the following selectors are valid values for arg1:
+
+AF_QUERY_LABEL - Request a short label string for the format (e.g., "aiff").
+
+AF_QUERY_NAME - Request a short name for the format (e.g., "MS RIFF WAVE").
+
+AF_QUERY_DESC - Request a descriptive name for the format (e.g., "Audio
+Interchange File Format").
+
+AF_QUERY_IMPLEMENTED - Request a boolean value indicating whether the
+format is implemented for reading and writing in the Audio File Library.
+
+AF_QUERY_ID_COUNT - Request the total number of formats implemented.
+
+AF_QUERY_IDS - Request an integer array of the id token values of all
+implemented file formats.
+
+AF_QUERY_COMPRESSION_TYPES - Used with the selector AF_QUERY_VALUE_COUNT
+in arg2, this will return a long integer containing the number of
+compression schemes available for use within the format specified in arg3.
+Used with selector AF_QUERY_VALUES, it returns a pointer to an integer
+array containing the compression id values of the compression schemes
+supported by the format specified in arg3.
+
+AF_QUERY_SAMPLE_FORMATS - Used with the selector AF_QUERY_DEFAULT in arg2,
+this will return the default sample format for the file format specified in
+arg3.
+
+AF_QUERY_SAMPLE_SIZES - Used with selector AF_QUERY_DEFAULT in arg2, this
+will return the default sample width for the file format specified in arg3.
+
+
+ERRORS
+afQuery can produce the following errors:
+* AF_BAD_QUERYTYPE - The query type is unsupported.
+* AF_BAD_QUERY - The arguments to the query are bad.
diff --git a/docs/afReadFrames b/docs/afReadFrames
new file mode 100644
index 0000000..5119840
--- /dev/null
+++ b/docs/afReadFrames
@@ -0,0 +1,46 @@
+afReadFrames reads sample frames from a given audio track in an audio file.
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+int afReadFrames (const AFfilehandle file, int track, void *samples,
+	const int count)
+
+PARAMETERS
+
+file is the AFfilehandle structure for the audio file from which audio
+sample data will be read.
+
+track is the track number within the audio file referred to by file.
+track should be set to the default value of AF_DEFAULT_TRACK at the
+present time.
+
+samples is a pointer to a buffer capable of storing count frames read
+from the file referred to by file.
+
+count is the number of sample frames to be read from the track
+specified by track within the file specified by file.
+
+RETURN VALUE
+
+afReadFrames returns the number of frames successfully read from file into the
+array referred to by samples.
+
+ERRORS
+
+Possible errors include
+(old school)
+AF_BAD_READ
+AF_BAD_FILEHANDLE
+AF_BAD_LSEEK
+AF_BAD_TRACKID (the track parameter differs from AF_DEFAULT_TRACK)
+AF_BAD_AIFF_SSND
+
+(new school--unsupported)
+AF_ERR_BAD_READ
+AF_ERR_BAD_LSEEK
+
+SEE ALSO
+
+afWriteFrames
diff --git a/docs/afReadMisc b/docs/afReadMisc
new file mode 100644
index 0000000..b7fcdf7
--- /dev/null
+++ b/docs/afReadMisc
@@ -0,0 +1,33 @@
+afReadMisc, afWriteMisc, afSeekMisc
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+int afReadMisc (const AFfilehandle file, int miscid, void *buffer, int nbytes);
+
+int afWriteMisc (const AFfilehandle file, int miscid, void *buffer, int nbytes);
+
+int afSeekMisc (const AFfilehandle file, int chunkid, int offbytes);
+
+RETURN VALUE
+
+afReadMisc returns the number of bytes read from the specified
+miscellaneous chunk into the buffer referred to by buffer.
+
+afWriteMisc returns the number of bytes written to the specified
+miscellaneous chunk from the buffer referred to by buffer.
+
+afSeekMisc returns the new location of the logical file pointer as
+measured as an offset in bytes from the beginning of the miscellaneous
+chunk's data area.
+
+ERROR VALUES
+afReadMisc, afWriteMisc, and afSeekMisc can return the following error
+codes:
+AF_BAD_READ
+AF_BAD_WRITE
+AF_BAD_MISCSEEK
+AF_BAD_MISCID
+AF_BAD_TRACKID
+AF_BAD_FILEHANDLE
diff --git a/docs/afSeekFrame b/docs/afSeekFrame
new file mode 100644
index 0000000..eb7315f
--- /dev/null
+++ b/docs/afSeekFrame
@@ -0,0 +1,39 @@
+afSeekFrame moves the logical file pointer for a specified audio track
+to a desired sample frame location.
+
+afTellFrame retrieves current value of a file read or write pointer.
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+AFframecount afSeekFrame (const AFfilehandle file, int track,
+	AFframecount frameoffset);
+
+AFframecount afTellFrame (const AFfilehandle file, int track);
+
+PARAMETERS
+
+file is an AFfilehandle structure which has been created by
+afOpenFile.
+
+track is an integer which refers to an audio track within a file.  The
+constant AF_DEFAULT_TRACK should always be used for this parameter
+since no currently supported file formats support more than one track
+per file.
+
+frameoffset is an offset measured in sample frames.  This value must be
+greater than or equal to zero and strictly less than the number of
+sample frames contained within the specified audio track.  If
+frameoffset is -1, afSeekFrame() will return the current frame.
+
+RETURN VALUE
+
+On successful completion, the value returned from afSeekFrame and
+afTellFrame is the current file pointer location as measured in sample
+frames from the start of the audio track.
+
+ERROR VALUES
+
+The following errors could be generated by afSeekFrame or afTellFrame:
+AF_BAD_LSEEK
diff --git a/docs/afSetErrorHandler b/docs/afSetErrorHandler
new file mode 100644
index 0000000..0ff5eb5
--- /dev/null
+++ b/docs/afSetErrorHandler
@@ -0,0 +1,28 @@
+afSetErrorHandler allows an alternate error handling routine to be
+specified.
+
+SYNOPSIS
+
+	#include <audiofile.h>
+
+	AFerrfunc afSetErrorHandler (AFerrfunc errorFunction);
+
+PARAMETERS
+
+errorFunction is a pointer to an error handling function which has the
+following prototype:
+	void error (long, char *, ...);
+
+RETURN VALUE
+
+The value returned from afSetErrorHandler is a pointer to the previous
+error handling function.
+
+DESCRIPTION
+
+The afSetErrorHandler() library function allows the user to override
+the default error handling function.
+
+The arguments are a long indicating an error code and a string (which
+may have printf-style formatting) followed by a variable argument list
+which contains any arguments for the format string.
diff --git a/docs/afSetVirtualByteOrder b/docs/afSetVirtualByteOrder
new file mode 100644
index 0000000..e756c1b
--- /dev/null
+++ b/docs/afSetVirtualByteOrder
@@ -0,0 +1,62 @@
+The functions afSetVirtualSampleFormat, afSetVirtualByteOrder,
+afSetVirtualChannels, afSetVirtualPCMMapping set the virtual data
+format for a particular track of an audio file.
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+int afSetVirtualSampleFormat (AFfilehandle file, int track,
+	int sampleFormat, int sampleWidth);
+
+int afSetVirtualByteOrder (AFfilehandle file, int track,
+	int byteOrder);
+
+int afSetVirtualChannels (AFfilehandle file, int track, int channels);
+
+int afSetVirtualRate (AFfilehandle file, int track, double rate);
+
+int afSetVirtualPCMMapping (AFfilehandle file, int track,
+	double slope, double intercept, double minclip, double maxclip);
+
+PARAMETERS
+
+* file is an AFfilehandle which refers to an open audio file and is
+  usually created by afOpenFile.
+
+* track is an integer which identifies a particular track in an open
+  audio file.  The only valid track is AF_DEFAULT_TRACK for all
+  currently supported file formats.
+
+* sampleFormat is an integer which denotes a virtual sample format.
+  Valid values are AF_SAMPFMT_TWOSCOMP, AF_SAMPFMT_UNSIGNED,
+  AF_SAMPFMT_FLOAT, and AF_SAMPFMT_DOUBLE.  Note that this
+  implementation of the Audio File Library only supports the two's
+  complement sample format at present.
+
+* sampleWidth is a positive integer which specifies the number of bits in a
+  virtual sample.
+
+* channels is a positive integer which specifies the number of
+  interleaved audio channels in the given audio track.
+
+* byteOrder is an integer which specifies the virtual byte order of
+  samples in the given audio track.  byteOrder can be either
+  AF_BYTEORDER_BIGENDIAN or AF_BYTEORDER_LITTLEENDIAN.
+
+* slope and intercept are double-precision floating point values which
+  indicate the audio data sample slope and zero-crossing value,
+  respectively, for the given sample format.
+
+* minclip and maxclip are double-precision floating point values
+  which indicates the minimum or maximum sample values to be returned.
+  Any values less than minclip will be set to minclip, and any values
+  greater than maxclip will be set to maxclip.
+
+RETURN VALUE
+
+These functions return 0 for success and -1 for failure.
+
+BUGS
+
+At present, afSetVirtualRate is not implemented.
diff --git a/docs/afWriteFrames b/docs/afWriteFrames
new file mode 100644
index 0000000..e5501b6
--- /dev/null
+++ b/docs/afWriteFrames
@@ -0,0 +1,29 @@
+afWriteFrames writes the sample frames pointed to by samples to the
+audio file represented by file.
+
+SYNOPSIS
+
+#include <audiofile.h>
+
+int afWriteFrames(AFfilehandle file, int track, void *samples,
+	AFframecount frameCount);
+
+PARAMETERS
+
+file is a valid file handle.
+
+track is always use AF_DEFAULT_TRACK for now.
+
+samples is a pointer to the array of sample frames to be written to the file.
+frameCount is the number of frames from samples to be written.
+
+ERRORS
+
+afWriteFrames can return these possible errors:
+AF_BAD_WRITE
+AF_BAD_LSEEK
+AF_BAD_TRACKID
+
+SEE ALSO
+
+afReadFrames
diff --git a/docs/sfconvert b/docs/sfconvert
new file mode 100644
index 0000000..6a6b3be
--- /dev/null
+++ b/docs/sfconvert
@@ -0,0 +1,27 @@
+NAME
+
+sfconvert
+
+SYNOPSIS
+
+sfconvert infile outfile [ options ... ] [ output keywords ... ]
+
+DESCRIPTION
+
+The following keywords specify the format of the output sound file:
+
+    byteorder e    endian (e is big or little)
+    channels n     n-channel file (typically 1 or 2)
+    format f       file format f (see below)
+    integer n s    n-bit integer file, where s is:
+                       2scomp: 2's complement signed data
+                       unsigned: unsigned data
+    float m        floating point file, maxamp m (usually 1.0)
+
+Currently supported file formats are the following:
+
+    aiff    Audio Interchange File Format           
+    aifc    AIFF-C File Format                      
+    next    NeXT/Sun Format                         
+    wave    MS RIFF WAVE Format                     
+    bics    Berkeley/IRCAM/CARL Sound File Format
diff --git a/docs/sfinfo b/docs/sfinfo
new file mode 100644
index 0000000..13a9359
--- /dev/null
+++ b/docs/sfinfo
@@ -0,0 +1,9 @@
+sfinfo [options] file1 file2...
+
+options can be any combination of -reporterror and -short.
+
+sfinfo prints information regarding the file in question.
+
+-short prints one-line information.
+
+-reporterror prints errors if files are not valid audio files.