Restructured gcc instructions in README.html

This commit is contained in:
oparviai 2009-12-28 20:51:18 +00:00
parent 4c885873df
commit cfce1434f4

View File

@ -110,18 +110,40 @@ binaries to the destination locations.</p>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<p><b>NOTE:</b> At the release time the SoundTouch package has been <h4><b>2.2.1 Required GNU tools</b>&nbsp;</h4>
tested <p> Bash shell, GNU C++ compiler, libtool, autoconf and automake tools are required
to compile in GNU/Linux platform. However, in past it's happened that for compiling
new the SoundTouch library. These are usually included with the GNU/Linux distribution, but if
gcc versions aren't necessarily compatible with the assembler setttings not, install these packages first. For example, in Ubuntu Linux these can be acquired and
used in the optimized routines. <b>If you have problems getting the installed with the following command:</p>
SoundTouch library compiled, try the workaround of disabling the optimizations</b> by editing the file <pre><b>sudo apt-get install <font SIZE="2">automake autoconf libtool build-essential</font></b></pre>
&quot;include/STTypes.h&quot; and removing <h4><b>2.2.2 Problems with GCC compiler compatibility</b></h4>
the following definition there:</p> <p>At the release time the SoundTouch package has been tested to compile in
GNU/Linux platform. However, in past it's happened that new gcc versions aren't
necessarily compatible with the assembler settings used in the optimized
routines. <b>If you have problems getting the
SoundTouch library compiled, try the workaround of disabling the optimizations</b>
by editing the file &quot;include/STTypes.h&quot; and removing the following
definition there:</p>
<blockquote> <blockquote>
<pre>#define ALLOW_OPTIMIZATIONS 1</pre> <pre>#define ALLOW_OPTIMIZATIONS 1</pre>
</blockquote> </blockquote>
<h4><b>2.2.3 Problems with configure script or build process</b>&nbsp;</h4>
<p>Incompatibilities between various GNU toolchain versions may cause errors when running the &quot;configure&quot; script or building the source
codes, if your GNU tool versions are not compatible with the versions used for
preparing the SoundTouch kit.&nbsp;</p>
<p>To resolve the issue, regenerate the configure scripts with your local tool
set by running
the &quot;<b>./bootstrap</b>&quot; script included in the SoundTouch source code
kit. After that, run the <b>configure</b> script and <b>make</b> as usually.</p>
<h4><b>2.2.4 Compiler issues with non-x86 processors</b></h4>
<p>SoundTouch library works also on non-x86 processors.</p>
<p>However, in case that you get compiler errors when trying to compile for non-Intel processor, edit the file
&quot;<b>source\SoundTouch\Makefile.am</b>&quot; and remove the &quot;<b>-msse2</b>&quot;
flag on the <b>AM_CXXFLAGS </b>line:</p>
<pre><b>AM_CXXFLAGS=-O3 -fcheck-new -I../../include&nbsp;&nbsp;&nbsp; # Note: -msse2 flag removed!</b></pre>
<p>After that, run &quot;<b>./bootstrap</b>&quot; script, and then run <b>configure</b>
and <b>make</b> again.</p>
<hr> <hr>
<h2>3. About implementation &amp; Usage tips</h2> <h2>3. About implementation &amp; Usage tips</h2>
<h3>3.1. Supported sample data formats</h3> <h3>3.1. Supported sample data formats</h3>
@ -224,11 +246,11 @@ processing, but in applications processing different kind of
sound the default parameter set may result into a sub-optimal sound the default parameter set may result into a sub-optimal
result.</p> result.</p>
<p>The time-stretch algorithm default <p>The time-stretch algorithm default
parameter values are set by these #defines in file &quot;TDStretch.h&quot;:</p> parameter values are set by the following #defines in file &quot;TDStretch.h&quot;:</p>
<blockquote> <blockquote>
<pre>#define DEFAULT_SEQUENCE_MS AUTOMATIC <pre>#define DEFAULT_SEQUENCE_MS AUTOMATIC
#define DEFAULT_SEEKWINDOW_MS AUTOMATIC #define DEFAULT_SEEKWINDOW_MS AUTOMATIC
#define DEFAULT_OVERLAP_MS 12</pre> #define DEFAULT_OVERLAP_MS 8</pre>
</blockquote> </blockquote>
<p>These parameters affect to the time-stretch <p>These parameters affect to the time-stretch
algorithm as follows:</p> algorithm as follows:</p>
@ -355,30 +377,6 @@ implemented for Win32 platform only. These optimizations are used in
AMD K6-2 and Athlon (classic) CPU's; better performing SSE routines are AMD K6-2 and Athlon (classic) CPU's; better performing SSE routines are
used with AMD processor starting from Athlon XP. </li> used with AMD processor starting from Athlon XP. </li>
</ul> </ul>
<h3>3.6 GNU compilation issues </h3>
<h4><b>3.6.1 Required GNU tools</b>&nbsp;</h4>
<p> Bash shell, GNU C++ compiler, libtool, autoconf and automake tools are required
for compiling
the SoundTouch library. These are usually included with the GNU/Linux distribution, but if
not, install these packages first. For example, in Ubuntu Linux these can be acquired and
installed with the following command:</p>
<pre><b>sudo apt-get install <font SIZE="2">automake autoconf libtool build-essential</font></b></pre>
<h4><b>3.6.2 Problems with configure script or build process</b>&nbsp;</h4>
<p>Incompatibilities between various GNU toolchain versions may cause errors when running the &quot;configure&quot; script or building the source
codes, if your GNU tool versions are not compatible with the versions used for
preparing the SoundTouch kit.&nbsp;</p>
<p>To resolve the issue, regenerate the configure scripts with your local tool
set by running
the &quot;<b>./bootstrap</b>&quot; script included in the SoundTouch source code
kit. After that, run the <b>configure</b> script and <b>make</b> as usually.</p>
<h4><b>3.6.3 Compiler issues with non-x86 processors</b></h4>
<p>SoundTouch library works also on non-x86 processors.</p>
<p>However, in case that you get compiler errors when trying to compile for non-Intel processor, edit the file
&quot;<b>source\SoundTouch\Makefile.am</b>&quot; and remove the &quot;<b>-msse2</b>&quot;
flag on the <b>AM_CXXFLAGS </b>line:</p>
<pre><b>AM_CXXFLAGS=-O3 -fcheck-new -I../../include&nbsp;&nbsp;&nbsp; # Note: -msse2 flag removed!</b></pre>
<p>After that, run &quot;<b>./bootstrap</b>&quot; script, and then run <b>configure</b>
and <b>make</b> again.</p>
<hr> <hr>
<h2><a name="SoundStretch"></a>4. SoundStretch audio processing utility <h2><a name="SoundStretch"></a>4. SoundStretch audio processing utility
</h2> </h2>