source: multimedia/libdriv/gavl.xml@ 0005499

<?xml version="1.0" encoding="UTF-8"?>
<!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;

  <!ENTITY gavl-download-http "&sourceforge-dl;/gmerlin/gavl-&gavl-version;.tar.gz">
  <!ENTITY gavl-download-ftp  " ">
  <!ENTITY gavl-md5sum        "2752013a817fbc43ddf13552215ec2c0">
  <!ENTITY gavl-size          "4.4 MB">
  <!ENTITY gavl-buildsize     "50 MB">
  <!ENTITY gavl-time          "0.8 SBU">
]>

<sect1 id="gavl" xreflabel="gavl-&gavl-version;">
  <?dbhtml filename="gavl.html"?>


  <title>gavl-&gavl-version;</title>

  <indexterm zone="gavl">
    <primary sortas="a-gavl">Gavl</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Gavl</title>

    <para>
      <application>Gavl</application> is short for Gmerlin Audio Video
      Library.  It is a low level library that handles the details of audio and
      video formats like colorspaces, samplerates, multichannel configurations
      etc. It provides standardized definitions for those formats as well as
      container structures for carrying audio samples or video images inside an
      application.
    </para>

    &lfs121_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&gavl-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&gavl-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &gavl-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &gavl-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &gavl-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &gavl-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Gavl Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para>
      <xref linkend='libpng'/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para>
      <xref linkend='doxygen'/>
    </para>


  </sect2>

  <sect2 role="installation">
    <title>Installation of Gavl</title>

    <para>
      First, fix an issue with gcc-14 and later:
    </para>

<screen><userinput>sed -i "/stdio/a #include &lt;string.h&gt;" src/fill_test.c</userinput></screen>

    <para>
      Now, install <application>Gavl</application> by running the
      following commands:
    </para>

<screen><userinput>LIBS=-lm                         \
./configure --prefix=/usr        \
            --without-doxygen    \
            --with-cpuflags=none \
            --docdir=/usr/share/doc/gavl-&gavl-version; &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <envar>LIBS=-lm</envar>: This variable ensures the math library is
      searched when linking.
    </para>

    <para>
      <parameter>--without-doxygen</parameter>: This switch disables use of
      Doxygen. Omit if Doxygen is installed and you wish to build the API
      documentation.
    </para>

    <para>
      <parameter>--with-cpuflags=none</parameter>: This switch fixes a problem
      identifying capabilities of the system architecture.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>libgavl.so</seg>
        <seg>/usr/include/gavl and
             /usr/share/doc/gavl-&gavl-version;
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="libgavl.so">
        <term><filename class="libraryfile">libgavl.so</filename></term>
        <listitem>
          <para>
            is the Gmerlin Audio Video Library
          </para>
          <indexterm zone="gavl libgavl.so">
            <primary sortas="c-libgavl.so">libgavl.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>