Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Bug Reporting Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Chris@0: Chris@0:

Reporting Bugs in libsndfile

Chris@0: Chris@0:

Chris@0: Before even attempting to report a bug in libsndfile please make sure you have Chris@0: read the Chris@0: Frequently Asked Questions. Chris@0: If you are having a problem writing code using libsndfile make sure you read Chris@0: the Chris@0: Application Programming Interface Chris@0: documentation. Chris@0:

Chris@0:

Chris@0: That said, I am interested in finding and fixing all genuine bugs in libsndfile. Chris@0: Bugs I want to fix include any of the following problems (and probably others) : Chris@0:

Chris@0:

Compilation problems on new platforms. Chris@0:
Errors being detected during the `make check' process. Chris@0:
Segmentation faults occuring inside libsndfile. Chris@0:
libsndfile hanging when opening a file. Chris@0:
Supported sound file types being incorrectly read or written. Chris@0:
Omissions, errors or spelling mistakes in the documentation. Chris@0:

Chris@0: Chris@0:

Chris@0: When submitting a bug report you must include : Chris@0:

Chris@0:

Your system (CPU and memory size should be enough). Chris@0:
The operating system you are using. Chris@0:
Whether you are using a package provided by your distribution or you Chris@0: compiled it youself. Chris@0:
If you compiled it yourself, the compiler you are using. (Also make Chris@0: sure to run 'make check'.) Chris@0:
A description of the problem. Chris@0:
Information generated by the sndfile-info program (see next paragraph). Chris@0:
If you are having problems with sndfile-play and ALSA on Linux, I will Chris@0: need information about your kernel, ALSA version, compiler version, Chris@0: whether you compiled the kernel/ALSA your self or installed from a Chris@0: package etc. Chris@0:

Chris@0: Chris@0:

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

Chris@0:

Chris@0: Please do not send me a sound file which fails to open under libsndfile unless I Chris@0: specifically ask you to. The above information should usually suffice for most Chris@0: problems. Chris@0:

Chris@0:

Chris@0: Once you have the above information you should email it to one of the Chris@0: mailing lists Chris@0: (posting to these lists is limited to the list subscribers). Chris@0: Chris@0:

Chris@0: Chris@0: