source: general/prog/perl-modules/perl-http-daemon.xml@ 695bc22

<?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 my-download-http "&perl_authors;/id/O/OA/OALDERS/HTTP-Daemon-&HTTP-Daemon-version;.tar.gz">
  <!ENTITY my-md5sum "51425462790165aeafc2819a7359706f">
]>

  <!-- Begin HTTP::Daemon -->
  <sect2 id="perl-http-daemon" xreflabel="HTTP-Daemon-&HTTP-Daemon-version;">

    <title>HTTP::Daemon-&HTTP-Daemon-version;</title>

    <indexterm zone="perl-http-daemon">
      <primary sortas="a-HTTP-Daemon">HTTP::Daemon</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to HTTP::Daemon</title>

      <para>
        Instances of the HTTP::Daemon class are HTTP/1.1 servers that listen on
        a socket for incoming requests. The HTTP::Daemon is a subclass of
        IO::Socket::INET, so you can perform socket operations directly on it too.
      </para>

      &lfs120_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&my-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &my-md5sum;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">HTTP::Daemon Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="perl-http-message"/>
        <!-- the listed deps are HTTP::Request, HTTP::Response, HTTP::Status
         which are all submodules from perl-http-message, and also
         HTTP::Date (perl-http-date) and LWP::MediaTypes (perl-lwp-mediatypes)
         which are dependencies of perl-http-message, as well as URI (perl-uri)
         in a test - that too is a dependency of perl-http-message. It claims
         to want Module::Build::Tiny but that is only for the old ./Build.PL -->
      </para>

      <note>
        <para>
          Makefile.PL and running the tests will complain that Module::Build::Tiny
          is missing, but that is only needed for <filename>Build.PL</filename>
          which is used if the system lacks a C compiler.
        </para>
      </note>

    </sect3>

    <sect3 role="installation">
      <title>Installation of HTTP::Daemon</title>

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

    </sect3>

  </sect2>