77 lines
2.6 KiB
HTML
77 lines
2.6 KiB
HTML
<!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 submit a ticket on the libsnfile
|
|
<A HREF="https://github.com/erikd/libsndfile/issues">github issue tracker</A>.
|
|
|
|
</P>
|
|
</BODY>
|
|
</HTML>
|