Bug#309846: locales: new localedef.1 manual page
On Fri, May 20, 2005 at 02:03:59AM +0300, Lars Wirzenius wrote:
> Package: locales
> Version: 2.3.5-2
>
> Attached is a new version of the localedef.1 manual page
> (debian/local/manpages/localedef.1) and a diff against the previous
> version (the former is there so that people who want to review it can
> more easily get a complete version).
>
> I have added descriptions of options that were missing (presumably added
> since the manual page was originally written years ago), and clarified
> the behavior in general. I hope it is complete and correct, but it might
> not be. I had to read through the source and experiment, and I may have
> overlooked or misinterpreted something. Should be better than the
> current version, however.
>
> Hopefully this is useful. Happy hacking.
Hi Lars,
this is definitely useful, thanks a lot for your time.
Here are points which could be modified:
* When the output directory does not exist, localedef aborts and
its error message is not very helpful, so this could be mentioned
in this man page. This is for instance annoying when testing
the --prefix flag.
* I18NPATH is a colon separated list of directories.
Patch against your page attached, but you may change its wording if
you prefer.
Denis
--- localedef.1.orig 2005-08-31 00:02:59.000000000 +0200
+++ localedef.1 2005-08-31 00:06:04.000000000 +0200
@@ -59,6 +59,11 @@
archive file
.BR /usr/lib/locale/locale-archive .
.PP
+In any case,
+.B localedef
+aborts if the directory in which it tries to write locale files has
+not already been created.
+.PP
If no
.I charmapfile
is given, the value
@@ -120,14 +125,14 @@
.I inputfile
is not absolute,
.B localedef
-will also look in the directory specified by the environment variable
+will also look in the directories specified by the environment variable
.B I18NPATH
and in the default directory for locale definition files. This default
directory is printed by
.BR "localedef \-\-help" .
.TP
.BI \-u " repertoirefile" ", \-\-repertoire-map=" repertoirefile
-Read mappings from sybolic names to Unicode UCS4 value from
+Read mappings from symbolic names to Unicode UCS4 values from
.IR repertoirefile .
.TP
.BI \-A " aliasfile" ", \-\-alias\-file=" aliasfile
@@ -142,7 +147,7 @@
Setting the prefix to
.IR foo ,
the archive would be placed in
-.BR foo/usr/lib/locale/locale/locale-archive .
+.BR foo/usr/lib/locale/locale-archive .
.TP
.B "\-c, \-\-force"
Write the output files even if warnings were generated about the input
@@ -194,7 +199,7 @@
flag is assumed if this environment variable is set.
.TP
.B I18NPATH
-The default directory for locale definition files.
+A colon separated list of default directories for locale definition files.
.SH FILES
.TP
.B /usr/share/i18n/charmaps
@@ -266,7 +271,7 @@
last argument must then contain a slash):
.PP
.RS
-localedef \-f UTF\-8 \-i fi_FI ./.
+localedef \-f UTF\-8 \-i fi_FI ./
.RE
.SH "SEE ALSO"
.BR locale "(5), " locale "(7), " locale (1)
Reply to: