source: multimedia/libdriv/gavl.xml@ d47ad20c

<?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;

  <!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"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <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>

    &lfs83_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>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/gavl"/></para>

  </sect2>

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

    <para>Install <application>Gavl</application> by running the
    following commands:</para>

<screen><userinput>LIBS=-lm                      \
./configure --prefix=/usr     \
            --without-doxygen \
            --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>

  </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>libgavl.so</term>
        <listitem>
          <para>???</para>
          <indexterm zone="gavl libgavl.so">
            <primary sortas="c-libgavl.so">libgavl.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
-->
  </sect2>

</sect1>