1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
|
<?xml version='1.0' ?>
<sect1 id="installation" xreflabel="Installation">
<title>Installation</title>
<sect2>
<title>Requirements</title>
<para>
For installing &prog; you need the following:
</para>
<para> <itemizedlist>
<listitem>
<para>The Gimp, of course. This plug-in should work with versions > 1.2.
</para>
</listitem>
<listitem>
<para>Gtk+-2 plus <command moreinfo="none">pkg-config</command>.</para>
</listitem>
<listitem>
<para>Optional: ATLAS, see <xref linkend="atlas"/>
</para> </listitem>
</itemizedlist></para>
<para>Installation should be simple. Untar the distribution.
If you want to use ATLAS install it in lib-atlas (see <xref linkend="atlas"/>).
</para>
<para>
Then run <command moreinfo="none">./configure</command> in the top-level directory.</para>
<para>Then run <command moreinfo="none">make install-bin</command> if you
want to install the plug-in under your home directory or
<command moreinfo="none">make install-admin-bin</command> if you
want to install the plug-in under your Gimp's system directory.</para>
<para>If you have gtk-doc installed you can build the system documentation
in the <filename>gtk-doc</filename> directory.
In this case you must invoke <command>configure</command> with the <computeroutput>--enable-gtk-doc</computeroutput> option.
When you <command>make</command> it for the first time <command>make</command> will fail with the message
<computeroutput>No rule to make target `tmpl/*.sgml'</computeroutput>.
Running <command>make</command> again will fix this problem.</para>
</sect2>
<sect2 id="atlas" xreflabel="Using ATLAS">
<title>Using ATLAS</title>
<sect3>
<title>What is ATLAS</title>
<para>ATLAS (see <ulink url="http://math-atlas.sourceforge.net"></ulink>) is
a system for generating high-performance mathematical libraries.
It generates a library that is specifically tuned to your processor and compiler.
&prog; needs some routines for solving a linear system of equations.
By default &prog; uses an unoptimized version from the CLAPACK distribution
(see <ulink url="http://www.netlib.org/clapack/"></ulink>).
</para>
</sect3>
<sect3>
<title>How to use ATLAS</title>
<itemizedlist mark="disc">
<listitem>
<para>
Make ATLAS generate its libraries.
For instructions see the ATLAS documentation.
Depending on your system, this may take a long time.
During the installation you have to select a name to identify your configuration.
In the following examples we will use Linux_PII as the chosen name.</para></listitem>
<listitem>
<para>
Go to the subdirectory lib/Linux_PII and run <command>make</command>.</para>
<programlisting format="linespecific">cd lib/Linux_PII
make</programlisting>
<para>
This will generate a gzipped tar file that contains the generated libraries
and include files.
</para>
</listitem>
<listitem>
<para>
Copy the gzipped tar file to the &prog; directory and unpack it.</para>
<programlisting format="linespecific">cp ~/ATLAS/lib/atlas3.4.1_Linux_PII.tgz ~/&prog;
cd ~/&prog;
zcat atlas3.4.1_Linux_PII.tgz |tar xvf -
mv Linux_PII lib-atlas
</programlisting>
</listitem>
<listitem>
<para>
If you have already run <command>configure</command>
, you must delete the file <filename>config.cache</filename>.</para> </listitem>
<listitem><para>Then run <command>configure</command>.
If everything is OK you should see a message like
<computeroutput>using atlas in lib-atlas/lib</computeroutput>.</para></listitem>
<listitem>
<para>
Now run <command>make</command>.</para></listitem>
</itemizedlist>
<para> </para>
</sect3>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("doc.xml" "sect1")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
|