<?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 dillo-download-http "http://www.dillo.org/download/dillo-&dillo-version;.tar.bz2">
  <!ENTITY dillo-download-ftp  "&gentoo-ftp-repo;/dillo-&dillo-version;.tar.bz2">
  <!ENTITY dillo-md5sum        "d0ab7fa1d40b310deb891388604188f8">
  <!ENTITY dillo-size          "415 KB">
  <!ENTITY dillo-buildsize     "9.5 MB">
  <!ENTITY dillo-time          "0.2 SBU">
]>

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

  <sect1info>
    <othername>$LastChangedBy: bdubbs $</othername>
    <date>$Date: 2012-05-12 18:40:21 -0400 (Sat, 12 May 2012) $</date>
  </sect1info>

  <title>Dillo-&dillo-version;</title>

  <indexterm zone="dillo">
    <primary sortas="a-Dillo">Dillo</primary>
  </indexterm>

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

    <para><application>Dillo</application> is a fast, small footprint
    graphical browser. Version &dillo-version; is now considered a very
    stable beta. <application>Dillo</application> does not support
    <application>Java</application>, JavaScript or CSS, and the current
    version does not support FTP, HTTPS or frames. It is, however, very
    fast and so is useful on older, slower machines. It supports downloads
    and can support cookies.</para>

    <caution>
      <para><application>Dillo</application> always interprets web pages
      as if they had the ISO-8859-1 encoding. Thus, it is useless
      for reading non-English web pages.</para>
    </caution>

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="GTK"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="openssl"/> and
    <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink></para>

    <bridgehead renderas="sect4">Optional (Run-Time Requirement for FTP
    Downloading)</bridgehead>
    <para role="optional"><xref linkend="wget"/></para>

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

  </sect2>

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


    <para>Support for secure connections is considered experimental by
    <application>Dillo</application>'s author. If you want the optional HTTPS
    support for <application>Dillo</application> and have
    <xref linkend="openssl"/> installed, run the following command:</para>

<screen><userinput>sed -i -e "/#undef ENABLE_SSL/d" dpi/https.c</userinput></screen>

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

<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc/dillo &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 &amp;&amp;
install -d -v -m755 /usr/share/doc/dillo-&dillo-version; &amp;&amp;
install -v -m644 doc/{README,*.txt} /usr/share/doc/dillo-&dillo-version;</userinput></screen>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring Dillo</title>

    <sect3 id="dillo-config">
      <title>Config Files</title>

      <para><filename>/etc/dillo/dillorc</filename>,
      <filename>/etc/dillo/dpidrc</filename>, and
      <filename>~/.dillo/*</filename></para>

      <indexterm zone="dillo dillo-config">
        <primary sortas="e-AA.dillo-star">~/.dillo/*</primary>
      </indexterm>

      <indexterm zone="dillo dillo-config">
        <primary sortas="e-etc-dillo-dillorc">/etc/dillo/dillorc</primary>
      </indexterm>

      <indexterm zone="dillo dillo-config">
        <primary sortas="e-etc-dillo-dpidrc">/etc/dillo/dpidrc</primary>
      </indexterm>

    </sect3>

    <sect3>
      <title>Configuration Information</title>

      <para><application>Dillo</application> stores its configuration in
      the system wide <filename>/etc/dillo/dillorc</filename> file and the
      <filename class="directory">~/.dillo</filename> directory which is
      created automatically when <command>dillo</command> is run for the
      first time. Note that cookies are turned off by default. To enable
      cookies, edit the <filename>~/.dillo/cookiesrc</filename> file.</para>

    </sect3>

  </sect2>

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

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

      <seglistitem>
        <seg>dillo, dpid, and dpidc</seg>
        <seg>None</seg>
        <seg>~/.dillo, /etc/dillo, /usr/share/doc/dillo-&dillo-version;,
        and /usr/lib/dillo</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="dillo-prog">
        <term><command>dillo</command></term>
        <listitem>
          <para>is a GTK+ graphical WWW browser with limited facilities,
          but a small footprint and runs fast on slower machines.</para>
          <indexterm zone="dillo dillo-prog">
            <primary sortas="b-dillo">dillo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="dpid">
        <term><command>dpid</command></term>
        <listitem>
          <para>is a <application>Dillo</application> plugin daemon.</para>
          <indexterm zone="dillo dpid">
            <primary sortas="b-dpid">dpid</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="dpidc">
        <term><command>dpidc</command></term>
        <listitem>
          <para>is a control program for <command>dpid</command>.</para>
          <indexterm zone="dillo dpidc">
            <primary sortas="b-dpidc">dpidc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>
