source: gnome/applications/evince.xml@ 87adc73

<?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 evince-download-http 
     "&gnome-download-http;/evince/&gnome-minor-14;/evince-&evince-version;.tar.xz">
  <!ENTITY evince-download-ftp  
     "&gnome-download-ftp;/evince/&gnome-minor-14;/evince-&evince-version;.tar.xz">
  <!ENTITY evince-md5sum        "feaf7382d4829a8ea52bfbaae106b9da">
  <!ENTITY evince-size          "2.9 MB">
  <!ENTITY evince-buildsize     "80 MB">
  <!ENTITY evince-time          "1.3 SBU">
]>

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

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

  <title>Evince-&evince-version;</title>

  <indexterm zone="evince">
    <primary sortas="a-Evince">Evince</primary>
  </indexterm>

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

    <para>
      <application>Evince</application> is a document viewer for multiple
      document formats. It supports PDF, Postscript, DjVu, TIFF and DVI.
      It is useful for viewing documents of various types using one simple
      application instead of the multiple document viewers that once existed
      on the <application>GNOME</application> Desktop.
    </para>

    &lfs76_checked;

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="adwaita-icon-theme"/>,
      <xref linkend="gsettings-desktop-schemas"/>,
      <xref linkend="gtk3"/>, and
      <xref linkend="itstool"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="gobject-introspection"/>,
      <xref linkend="libsecret"/>,
      <xref linkend="nautilus"/>, and
      <xref linkend="poppler"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="gtk-doc"/>,
      <xref linkend="texlive"/>,
      <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
      <ulink url="https://wiki.gnome.org/action/show/Projects/libgxps">libgxps</ulink>,
      <ulink url="http://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>, and
      <ulink url="http://fossies.org/linux/misc/t1lib-5.1.2.tar.gz/">t1lib</ulink>
    </para>

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

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

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

<screen><userinput>./configure --prefix=/usr           \
            --enable-introspection  \
            --disable-static        &amp;&amp;
make</userinput></screen>

    <para>
      This package does not have a working testsuite.
    </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 Explanation</title>

    <para>
      <option>--enable-introspection</option>: By default, the
      <application>Gobject Introspection</application> support is
      turned off, even though that package is an expected component
      of the <application>GNOME</application> Desktop.
    </para>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/static-libraries.xml"/>

    <para>
      <option>--without-keyring</option>: This switch disables use of
      the <application>libsecret</application>. Use this switch
      if <application>libsecret</application> is not installed.
    </para>

    <para>
      <option>--disable-nautilus</option>: This switch disables building
      of the <application>Nautilus</application> Plugin. Use this switch
      if <application>Nautilus</application> is not installed.
    </para>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/gtk-doc-rebuild.xml"/>

    <para><option>--libexecdir=/usr/lib/evince</option>: This option
    puts the package's private program in an <filename
    class="directory">evince</filename> directory in <filename
    class="directory">/usr/lib</filename> instead of using
    <filename class="directory">/usr/libexec</filename> in accordance
    with the old version of the FHS used before LFS-7.5.</para>

  </sect2>

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

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

      <seglistitem>
        <seg>
          evince, evinced, evince-previewer, and evince-thumbnailer
        </seg>
        <seg>
          libevdocument3.so,
          libevview3.so,
          /usr/lib/mozilla/plugins/libevbrowserplugin.so, and
          /usr/lib/nautilus/extensions-3.0/libevince-properties-page.so
        </seg>
        <seg>
          /usr/include/evince,
          /usr/lib/evince,
          /usr/share/evince,
          /usr/share/gtk-doc/html/{evince,libevdocument-3.0,libevview-3.0}, and
          /usr/share/help/*/evince
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="evince-prog">
        <term><command>evince</command></term>
        <listitem>
          <para>
            is a multiple format document viewer.
          </para>
          <indexterm zone="evince evince-prog">
            <primary sortas="b-evince">evince</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="evince-previewer">
        <term><command>evince-previewer</command></term>
        <listitem>
          <para>
            is an applicaton that implements the printing preview.
          </para>
          <indexterm zone="evince evince-previewer">
            <primary sortas="b-evince-previewer">evince-previewer</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="evince-thumbnailer">
        <term><command>evince-thumbnailer</command></term>
        <listitem>
          <para>
            is a simple program used to create thumbnail images of
            supported documents.
          </para>
          <indexterm zone="evince evince-thumbnailer">
            <primary sortas="b-evince-thumbnailer">evince-thumbnailer</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>