<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

<!-- Process this file with docbook-to-man to generate an nroff manual
     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
     less'.  A typical entry in a Makefile or Makefile.am is:

manpage.1: manpage.sgml
	docbook-to-man $< > $@
  -->

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Eduard</firstname>">
  <!ENTITY dhsurname   "<surname>Bloch</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>March 10, 2005</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>8</manvolnum>">
  <!ENTITY dhemail     "<email>blade@debian.org</email>">
  <!ENTITY dhusername  "Eduard Bloch">
  <!ENTITY dhucpackage "<refentrytitle>LOCALE-GEN</refentrytitle>">
  <!ENTITY dhpackage   "locale-gen">

  <!ENTITY debian      "<productname>Debian GNU/Linux</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2001</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>generates localisation files from templates</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;</command>
      <arg><option>--keep-existing</option></arg>

    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para>This manual page documents briefly the
      <command>&dhpackage;</command> command.</para>

    <para>By default, the locale package which provides the base support for
    localisation of libc-based programs does not contain usable localisation
    files for every supported language. This limitation has became necessary
    because of the substantial size of such files and the large number of
    languages supported by libc. As a result, Debian uses a special
    mechanism where we prepare the actual localisation files on the target
    host and distribute only the templates for them.</para>
    <para>
    <command>&dhpackage;</command> is a program that reads the file
    <filename>/etc/locale.gen</filename> and invokes
    <command>localedef</command> for the chosen localisation profiles.
    Run <command>&dhpackage;</command> after you have modified the <filename>/etc/locale.gen</filename> file.
    
	  </para>

  </refsect1>
  <refsect1>
    <title>OPTIONS</title>

    <variablelist>
      <varlistentry>
        <term><option>--keep-existing</option></term>
        <listitem>
          <para>By default, <command>&dhpackage;</command> removes all
          existing locales and generates new ones afresh. The
          <option>--keep-existing</option> option prevents this, so that
          only locales which do not already exist are generated. This is
          useful if calling locale-gen a number of times in
          succession.</para>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>
  <refsect1>
    <title>FILES</title>

    <para><filename>/etc/locale.gen</filename></para>
    <para>The main configuration file, which has a simple format: every
    line that is not empty and does not begin with a # is treated as a
    locale definition that is to be built.
    </para>

  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>

    <para>localedef(1), locale(1), locale.alias(5), locale.gen(5).</para>

  </refsect1>

  <refsect1>
    <title>AUTHOR</title>

    <para>This manual page was written by &dhusername; &lt;&dhemail;&gt; for
      the &debian; system (but may be used by others).  Permission is
      granted to copy, distribute and/or modify this document under
      the terms of the <acronym>GNU</acronym> Free Documentation
      License, Version 1.1 or any later version published by the Free
      Software Foundation; with no Invariant Sections, no Front-Cover
      Texts and no Back-Cover Texts.</para>

  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
