source: BOOK/final-system/common/cloog-ppl.xml@ 2580945

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-cloog-ppl" role="wrap">
  <?dbhtml filename="cloog-ppl.html"?>

  <title>CLooG-PPL-&cloog-ppl-version;</title>

  <indexterm zone="ch-system-cloog-ppl">
    <primary sortas="a-CLooG-PPL">CLooG-PPL</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>CLooG-PPL is a library to generate code for scanning Z-polyhedra.
    In other words, it finds code that reaches each integral point of one or
    more parameterized polyhedra.  GCC links with this library in order to
    enable the new loop generation code known as Graphite.</para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of CLooG-PPL</title>

    <para os="p1">When this version of CLooG-PPL was packaged it was missing
    a few files related to Libtool. The following patch adds them back in and
    regenerted Automake and Autoconf.</para>

<screen os="p2"><userinput>patch -Np1 -i ../&cloog-ppl-autogen-patch;</userinput></screen>

    <para os="a">Prepare CLooG-PPL for compilation:</para>

<screen os="b"><userinput>CC="gcc -isystem /usr/include" LDFLAGS="-Wl,-rpath-link,/lib" \
    ./configure --prefix=/usr --enable-shared --with-gmp \
    --with-ppl</userinput></screen>

    <para os="c">Compile the package:</para>

<screen os="d"><userinput>make</userinput></screen>

    <important os="e">
      <para>The test suite for CLooG-PPL is considered
      critical. Do not skip it under any circumstance.</para>
    </important>

    <para os="f">Test the results:</para>

<screen os="g"><userinput>make check</userinput></screen>

    <para os="h">Install the package:</para>

<screen os="i"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 id="contents-cloog-ppl" role="content">
    <title>Contents of CLooG-PPL</title>

    <segmentedlist>
      <segtitle>Installed programs</segtitle>
      <segtitle>Installed libraries</segtitle>
      <segtitle>Installed directory</segtitle>

      <seglistitem>
        <seg>cloog</seg>
        <seg>libcloog.[a,so]</seg>
        <seg>/usr/include/cloog</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="cloog">
        <term><command>cloog</command></term>
        <listitem>
          <para>Loop generator for scanning Z-polyhedra</para>
          <indexterm zone="ch-system-cloog-ppl cloog">
            <primary sortas="b-cloog">cloog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libcloog">
        <term><filename class="libraryfile">libcloog</filename></term>
        <listitem>
          <para>The Chunky Loop Generator.</para>
          <indexterm zone="ch-system-cloog-ppl libcloog">
            <primary sortas="c-libcloog-ppl">libcloog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>