Bug Reporting
Author: Erik de Castro Lopo (erikd AT zip DOT com DOT au)

# Reporting Bugs in libsndfile

Before even attempting to report a bug in libsndfile please make sure you have read all the documentation, especially the Application Programming Interface docs and the Frequently Asked Questions.

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) :

- compilation problems on new platforms
- errors being detected during the `make check' process
- segmentation faults occuring inside libsndfile
- libsndfile hanging when opening a file
- supported sound file types being incorrectly read or written
- ommissions, errors or spelling mistakes in the documentation

When submitting a bug report you must include :

- the operating system you are using
- the compiler you are using
- a description of the problem
- information generated by the sndfile-info program (see next paragraph)

If libsndfile compiles and installs correctly but has difficulty reading a particular file or type of file you should run the sndfile-info program (from the examples directory of the libsndfile distribution) on the file. See here for an example of the use of the sndfile-info program.

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.

Once you have the above information you may mail it to me at erikd@zip.com.au.