| <!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> |