source: general/graphlib/libexif.xml@ 0602a99

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

  <!ENTITY libexif-download-http "http://prdownloads.sourceforge.net/libexif/libexif-&libexif-version;.tar.bz2">
  <!ENTITY libexif-download-ftp  " ">
  <!ENTITY libexif-md5sum        "1b1e2b495c5aa20c08725f30545a110b">
  <!ENTITY libexif-size          "519 KB">
  <!ENTITY libexif-buildsize     "18.1 MB">
  <!ENTITY libexif-time          "0.3 SBU">
]>

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

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
    <keywordset>
      <keyword role="package">libexif-&libexif-version;.tar</keyword>
      <keyword role="ftpdir">libexif</keyword>
    </keywordset>
  </sect1info>

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

  <indexterm zone="libexif">
    <primary sortas="a-Libexif">Libexif</primary>
  </indexterm>

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

    <para>The <application>libexif</application> package contains a library
    for parsing, editing, and saving EXIF data. Most digital cameras produce
    EXIF files, which are JPEG files with extra tags that contain information
    about the image. All EXIF tags described in EXIF standard 2.1 are
    supported.</para>

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

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

    <bridgehead renderas="sect4">Optional (to Build Documentation)</bridgehead>
    <para role="optional"><xref linkend="doxygen"/> and
    <ulink url="http://www.graphviz.org/">GraphViz</ulink></para>

  </sect2>

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

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

<screen><userinput>sed -i 's/^install-data-local/@HAVE_DOXYGEN_TRUE@&amp;/' \
            doc/Makefile.in &amp;&amp;
./configure --prefix=/usr \
            --with-doc-dir=/usr/share/doc/libexif-&libexif-version; &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue: <command>make check</command>.</para>

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

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

    <para>Documentation was built and installed if you have the dependencies
    shown above installed. If you don't have the dependencies installed, there
    is a compressed tarball in the source tree
    <filename class='directory'>doc</filename> directory that can be unpacked
    into /usr/share/doc/libexif-&libexif-version;.</para>

  </sect2>

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

    <para><command>sed -i ... doc/Makefile.in</command>:
    Installation of <application>libexif</application> will fail if
    <application>Doxygen</application> is not present on the system due to
    a packaging bug.  The command does not affect the situation where
    <application>Doxygen</application> is installed.</para>

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>libexif.[so,a]</seg>
        <seg>/usr/include/libexif and
        /usr/share/doc/libexif-&libexif-version;</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="libexif-lib">
        <term><filename class='libraryfile'>libexif.[so,a]</filename></term>
        <listitem>
          <para>contains functions used for parsing, editing, and saving
          EXIF data.</para>
          <indexterm zone="libexif libexif-lib">
            <primary sortas="c-libexif">libexif.[so,a]</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect2>

</sect1>