source: general/prog/perl-deps/perl-mime-charset.xml@ 1bbf621

<?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 my-download-http "&metacpan_authors;/N/NE/NEZUMI/MIME-Charset-&MIME-Charset-version;.tar.gz">
  <!ENTITY my-md5sum "71440416376248c31aa3bef753fae28d">

]>

  <!-- Begin MIME::Charset -->
  <sect2 id="perl-mime-charset" xreflabel="MIME-Charset-&MIME-Charset-version;">

    <title>MIME::Charset-&MIME-Charset-version;</title>

    <indexterm zone="perl-mime-charset">
      <primary sortas="a-MIME-Charset">MIME::Charset</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to MIME::Charset</title>

      <para>
        MIME::Charset provides information about character sets used for MIME
        messages o nthe internet, such as their encodings.
      </para>

      &lfs83_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">MIME::Charset Dependencies</bridgehead>

      <bridgehead renderas="sect5">Recommended</bridgehead>
      <para role="recommended">
        <xref linkend="new-perl-encode-eucjpascii"/>,
        <xref linkend="new-perl-encode-hanextra"/> and
        <xref linkend="new-perl-encode-jis2k"/> (because all are required
        by <xref role="nodep" linkend="biber"/>)
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of MIME::Charset</title>

      <para>
        This module uses a variant of the standard build and installation
        instructions:

<screen><userinput>yes '' | perl Makefile.PL &amp;&amp;
make             &amp;&amp;
make test</userinput></screen>

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

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

    </para>

    </sect3>

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

      <para>
        <command>yes |</command>: Perl will ask if you wish to install
        a further module for handling legacy Japanese encodings, and another
        which it would use for translating documentation to Japanese. The
        default option is 'n', using 'yes' allows you to script the build.
      </para>

    </sect3>

  </sect2>