source: general/genutils/iso-codes.xml@ 63a2d8d0

<?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 iso-codes-download-http "https://ftp.debian.org/debian/pool/main/i/iso-codes/iso-codes_&iso-codes-version;.orig.tar.xz">
  <!ENTITY iso-codes-download-ftp  " ">
  <!ENTITY iso-codes-md5sum        "6ab41fd20ad0be8c5585b573993e36fb">
  <!ENTITY iso-codes-size          "4.1 MB">
  <!ENTITY iso-codes-buildsize     "97 MB">
  <!ENTITY iso-codes-time          "0.1 SBU (with tests)">
]>

<sect1 id="iso-codes" xreflabel="ISO Codes-&iso-codes-version;">
  <?dbhtml filename="iso-codes.html"?>


  <title>ISO Codes-&iso-codes-version;</title>

  <indexterm zone="iso-codes">
    <primary sortas="a-ISO-Codes">ISO Codes</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to ISO Codes</title>

    <para>
      The <application>ISO Codes</application> package contains a list of
      country, language and currency names and it is used as a central
      database for accessing this data.
    </para>

    &lfs122_checked;

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

  </sect2>

  <sect2 role="installation">
    <title>Installation of ISO Codes</title>

    <para>
      The directory is called iso-codes-&iso-codes-version;.
    </para>

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

<screen><userinput>./configure --prefix=/usr &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 LN_S='ln -sfn'</userinput></screen>

  </sect2>

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

    <para>
      <parameter>LN_S='ln -sfn'</parameter>: This override ensures the
      installed symlinks correctly recreated in case we are upgrading or
      reinstalling the package.  It's unneeded but harmless when installing
      the package onto the system for the first time.
    </para>
  </sect2>

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

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

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/share/iso-codes, /usr/share/xml/iso-codes
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>