-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-
-<HEAD>
- <TITLE>
- Bug Reporting
- </TITLE>
- <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">
- <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">
- <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">
-</HEAD>
-
-<BODY>
-
-<CENTER>
- <H1><B>Reporting Bugs in libsndfile</B></H1>
-</CENTER>
-<P>
- Before even attempting to report a bug in libsndfile please make sure you have
- read the
- <A HREF="FAQ.html">Frequently Asked Questions</A>.
- If you are having a problem writing code using libsndfile make sure you read
- the
- <A HREF="api.html">Application Programming Interface</A>
- documentation.
-</P>
-<P>
- That said, I am interested in finding and fixing all genuine bugs in libsndfile.
- Bugs I want to fix include any of the following problems (and probably others) :
-</P>
- <UL>
- <LI> Compilation problems on new platforms.
- <LI> Errors being detected during the `make check' process.
- <LI> Segmentation faults occuring inside libsndfile.
- <LI> libsndfile hanging when opening a file.
- <LI> Supported sound file types being incorrectly read or written.
- <LI> Omissions, errors or spelling mistakes in the documentation.
- </UL>
-
-<P>
- When submitting a bug report you must include :
-</P>
- <UL>
- <LI> Your system (CPU and memory size should be enough).
- <LI> The operating system you are using.
- <LI> Whether you are using a package provided by your distribution or you
- compiled it youself.
- <LI> If you compiled it yourself, the compiler you are using. (Also make
- sure to run 'make check'.)
- <LI> A description of the problem.
- <LI> Information generated by the sndfile-info program (see next paragraph).
- <LI> If you are having problems with sndfile-play and ALSA on Linux, I will
- need information about your kernel, ALSA version, compiler version,
- whether you compiled the kernel/ALSA your self or installed from a
- package etc.
- </UL>
-
-<P>
- If libsndfile compiles and installs correctly but has difficulty reading a particular
- file or type of file you should run the <B>sndfile-info</B> program (from the examples
- directory of the libsndfile distribution) on the file. See
- <A HREF="sndfile_info.html">here</A>
- for an example of the use of the <B>sndfile-info</B> program.
-</P>
-<P>
- Please do not send me a sound file which fails to open under libsndfile unless I
- specifically ask you to. The above information should usually suffice for most
- problems.
-</P>
-<P>
- Once you have the above information you should email it to one of the
- <A HREF="lists.html">mailing lists</a>
- (posting to these lists is limited to the list subscribers).
-
-</P>
-</BODY>
-</HTML>