--- a/localedef.1.debian
+++ b/localedef.1
@@ -1,4 +1,30 @@
-.TH LOCALEDEF 1 "May 20, 2005"
+.\" Copyright (C) 2001 Richard Braakman
+.\" Copyright (C) 2004 Alastair McKinstry
+.\" Copyright (C) 2005 Lars Wirzenius
+.\" Copyright (C) 2014 Marko Myllynen
+.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
+.\" This is free documentation; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of
+.\" the License, or (at your option) any later version.
+.\"
+.\" The GNU General Public License's references to "object code"
+.\" and "executables" are to be interpreted as the output of any
+.\" document formatting or typesetting system, including
+.\" intermediate and printed output.
+.\"
+.\" This manual is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, see
+.\" .
+.\" %%%LICENSE_END
+.\"
+.TH LOCALEDEF 1 2014-05-26 "Linux" "Linux Programmer's Manual"
.SH NAME
localedef \- compile locale definition files
.SH SYNOPSIS
@@ -58,6 +84,11 @@
is the name of a locale and the compiled locale data is added to the
archive file
.BR /usr/lib/locale/locale-archive .
+Locale archive is a memory mapped file which contains all the system
+provided locales and it is used by all localized programs when the
+environment variable
+.B LOCPATH
+is not set.
.PP
In any case,
.B localedef
@@ -67,8 +98,8 @@
If no
.I charmapfile
is given, the value
-.I POSIX
-is used by default.
+.I ANSI_X3.4-1968
+(for ASCII) is used by default.
If no
.I inputfile
is given, or if it is given as a dash
@@ -111,29 +142,54 @@
using
.BR \-\-no\-archive .
.SS "Other options"
-Some of the following options are only sensible for some operations; hopefully it is self-evident which ones.
+Some of the following options are only sensible for some operations;
+hopefully it is self-evident which ones.
.TP
.BI \-f " charmapfile" ", \-\-charmap=" charmapfile
Specify the file that defines the symbolic character names that are
-used by the input file. If the file is in the default directory for
-character maps, it is not necessary to specify the full pathname.
-This default directory is printed by
+used by the input file. If
+.I charmapfile
+contains a slash character ('/'), it is directly the name of the
+character map. Otherwise, the file is searched from the local directory
+and the default directory. If the environment variable
+.B I18NPATH
+is set,
+.B I18NPATH/charmaps/
+and
+.B I18NPATH/
+are also searched after the local directory. This default directory is
+printed by
.BR "localedef \-\-help" .
.TP
.BI \-i " inputfile" ", \-\-inputfile=" inputfile
-Specify the locale definition file to compile. If
-.I inputfile
-is not absolute,
-.B localedef
-will also look in the directories specified by the environment variable
+Specify the locale definition file to compile. The file is searched
+from the local directory and the default directory. If the environment
+variable
+.B I18NPATH
+is set,
+.B I18NPATH/locales/
+and
.B I18NPATH
-and in the default directory for locale definition files. This default
-directory is printed by
+are also searched after the local directory. This default directory is
+printed by
.BR "localedef \-\-help" .
.TP
.BI \-u " repertoirefile" ", \-\-repertoire-map=" repertoirefile
Read mappings from symbolic names to Unicode UCS4 values from
.IR repertoirefile .
+If
+.I repertoirefile
+contains a slash character ('/'), it is directly the name of the
+repertoire map. Otherwise, the file is searched from the local
+directory and the default directory. If the environment variable
+.B I18NPATH
+is set,
+.B I18NPATH/repertoiremaps/
+and
+.B I18NPATH
+are also searched after the local directory. This default directory is
+printed by
+.BR "localedef \-\-help" .
.TP
.BI \-A " aliasfile" ", \-\-alias\-file=" aliasfile
Use
@@ -154,7 +210,7 @@
file.
.TP
.B \-\-old\-style
-Create old-style tables.
+Create old-style hash tables instead of 3-level access tables.
.TP
.B "\-v, \-\-verbose"
Generate extra warnings about errors that are normally ignored.
@@ -165,7 +221,7 @@
.B \-\-posix
Conform strictly to POSIX. Implies
.BR \-\-verbose .
-This option currently has no other effect. Posix conformance is
+This option currently has no other effect. POSIX conformance is
assumed if the environment variable
.B POSIXLY_CORRECT
is set.
@@ -199,7 +255,7 @@
flag is assumed if this environment variable is set.
.TP
.B I18NPATH
-A colon separated list of default directories for locale definition files.
+A colon separated list of search directories for files.
.SH FILES
.TP
.B /usr/share/i18n/charmaps
@@ -214,67 +270,72 @@
.B /usr/lib/locale/locale-archive
Usual default locale archive location.
.TP
+.IB outputpath/ LC_ADDRESS
+One of the output files. It contains information about formatting
+of addresses and geography-related items.
+.TP
.IB outputpath/ LC_COLLATE
-One of the output files. It describes the rules for comparing strings
-in the locale's alphabet.
+One of the output files. It contains information about the rules
+for comparing strings.
.TP
.IB outputpath/ LC_CTYPE
One of the output files. It contains information about character
-cases and case conversions for the locale.
+classes.
.TP
-.IB outputpath/ LC_MONETARY
-One of the output files. It describes the way monetary values should
-be formatted in the locale.
+.IB outputpath/ LC_IDENTIFICATION
+One of the output files. It contains metadata about the locale.
+.TP
+.IB outputpath/ LC_MEASUREMENT
+One of the output files. It contains information about locale
+measurements (metric versus US customary).
.TP
.IB outputpath/ LC_MESSAGES/SYS_LC_MESSAGES
One of the output files. It contains information about the language
messages should be printed in, and what an affirmative or negative
answer looks like.
.TP
-.IB outputpath/ LC_NUMERIC
-One of the output files. It describes the rules for formatting
-numbers in the locale.
-.TP
-.IB outputpath/ LC_TIME
-One of the output files. It describes the rules for formatting
-times and dates in the locale.
-.TP
-.IB outputpath/ LC_PAPER
-One of the output files. It describes the default paper size
-in the locale.
+.IB outputpath/ LC_MONETARY
+One of the output files. It contains information about formatting
+of monetary values.
.TP
.IB outputpath/ LC_NAME
-One of the output files. It describes the rules for formatting
-names in the locale.
+One of the output files. It contains information about salutations
+for persons.
.TP
-.IB outputpath/ LC_ADDRESS
-One of the output files. It describes the rules for formatting
-addresses, and other location information in the locale.
+.IB outputpath/ LC_NUMERIC
+One of the output files. It contains information about formatting
+of nonmonetary numeric values.
.TP
-.IB outputpath/ LC_TELEPHONE
-One of the output files. It describes the rules for formatting
-telephone numbers in the locale.
+.IB outputpath/ LC_PAPER
+One of the output files. It contains information about settings
+related to standard paper size.
.TP
-.IB outputpath/ LC_MEASUREMENT
-One of the output files. It describes the rules for measurement in the
-locale, e.g. Metric or other units.
+.IB outputpath/ LC_TELEPHONE
+One of the output files. It contains information about formats
+to be used with telephone services.
.TP
-.IB outputpath/ LC_IDENTIFICATION
-One of the output files. It identifies the elements within the locale.
+.IB outputpath/ LC_TIME
+One of the output files. It contains information about formatting
+of data and time values.
.SH EXAMPLES
-Compile the locale files for Finnish in the UTF-8 character set
+Compile the locale files for Finnish in the UTF\-8 character set
and add it to the default locale archive with the name
-.BR fi_FI.UTF-8 :
+.BR fi_FI.UTF\-8 :
.PP
.RS
localedef \-f UTF\-8 \-i fi_FI fi_FI.UTF\-8
.RE
.PP
-The same, but generate files into the current directory (note that the
-last argument must then contain a slash):
+The same, but generate files into the
+.B fi_FI.UTF\-8
+directory which can then be used by programs when the environment
+variable
+.B LOCPATH
+is set to the current directory (note that the last argument must
+contain a slash):
.PP
.RS
-localedef \-f UTF\-8 \-i fi_FI ./
+localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8
.RE
.SH "SEE ALSO"
.BR locale "(5), " locale "(7), " locale (1)
@@ -287,7 +348,6 @@
explain new ISO 14652 elements,
and amended further by Lars Wirzenius to document new
functionality (as of GNU C library 2.3.5).
-The manpage is not supported by the GNU libc maintainers and may be
-out of date.
+The manpage is not supported by the GNU libc maintainers.
.SH STANDARDS
-This program conforms to the POSIX standard P1003.2
+This program conforms to the POSIX standard P1003.2.