cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: Bug Reporting cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: cannam@85: cannam@85:

Reporting Bugs in libsndfile

cannam@85: cannam@85:

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

cannam@85:

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

cannam@85:

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

cannam@85: cannam@85:

cannam@85: When submitting a bug report you must include : cannam@85:

cannam@85:

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

cannam@85: cannam@85:

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

cannam@85:

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

cannam@85:

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

cannam@85: cannam@85: