Mercurial > hg > sv-dependency-builds

diff src/libsndfile-1.0.27/doc/bugs.html @ 40:1df64224f5ac

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Current libsndfile source
author Chris Cannam
date Tue, 18 Oct 2016 13:22:47 +0100
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/libsndfile-1.0.27/doc/bugs.html	Tue Oct 18 13:22:47 2016 +0100
@@ -0,0 +1,76 @@
+<!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>