Bug Reporting
Author: Erik de Castro Lopo (erikd AT mega-nerd DOT com)

# 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
- omissions, 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 should email it to one of the mailing lists (posting to these lists is limited to the list subscribers).