localedef.1: describe recently added options

Describe few recently added options (present in glibc-2.29).

Sort the options a bit more logically and alphabetically.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Marko Myllynen 2019-08-26 10:23:25 +03:00 committed by Michael Kerrisk
parent 15f2303db3
commit c27b4907fe
1 changed files with 56 additions and 33 deletions

View File

@ -41,22 +41,22 @@ localedef \- compile locale definition files
.RI [ options ]
.I outputpath
.br
.B "localedef \-\-list\-archive"
.B "localedef \-\-add\-to\-archive"
.RI [ options ]
.I compiledpath
.br
.B "localedef \-\-delete\-from\-archive"
.RI [ options ]
.IR localename " ..."
.br
.B "localedef \-\-add\-to\-archive"
.B "localedef \-\-list\-archive"
.RI [ options ]
.I compiledpath
.br
.B "localedef \-\-version"
.br
.B "localedef \-\-help"
.br
.B "localedef \-\-usage"
.br
.B "localedef \-\-version"
.ad b
.hy
.SH DESCRIPTION
@ -128,12 +128,6 @@ A few options direct
to do something other than compile locale definitions.
Only one of these options should be used at a time.
.TP
.B \-\-delete\-from\-archive
Delete the named locales from the locale archive file.
.TP
.B \-\-list\-archive
List the locales contained in the locale archive file.
.TP
.B \-\-add\-to\-archive
Add the
.I compiledpath
@ -142,6 +136,12 @@ The directories should have been created by previous runs of
.BR localedef ,
using
.BR \-\-no\-archive .
.TP
.B \-\-delete\-from\-archive
Delete the named locales from the locale archive file.
.TP
.B \-\-list\-archive
List the locales contained in the locale archive file.
.SS Other options
Some of the following options are sensible only for certain operations;
generally, it should be self-evident which ones.
@ -212,14 +212,6 @@ Use
to look up aliases for locale names.
There is no default aliases file.
.TP
.BI \-\-prefix= pathname
Set the prefix to be prepended to the full archive pathname.
By default, the prefix is empty.
Setting the prefix to
.IR foo ,
the archive would be placed in
.IR foo/usr/lib/locale/locale-archive .
.TP
.BR \-c ", " \-\-force
Write the output files even if warnings were generated about the input
file.
@ -227,21 +219,11 @@ file.
.BR \-v ", " \-\-verbose
Generate extra warnings about errors that are normally ignored.
.TP
.B \-\-quiet
Suppress all notifications and warnings, and report only fatal errors.
.B \-\-big\-endian
Generate big-ending output.
.TP
.B \-\-posix
Conform strictly to POSIX. Implies
.BR \-\-verbose .
This option currently has no other effect.
POSIX conformance is assumed if the environment variable
.B POSIXLY_CORRECT
is set.
.TP
.B \-\-replace
Replace a locale in the locale archive file.
Without this option, if the locale is in the archive file already,
an error occurs.
.B \-\-little\-endian
Generate little-ending output.
.TP
.B \-\-no\-archive
Do not use the locale archive file, instead create
@ -252,6 +234,47 @@ This is helpful to prevent system locale archive updates from overwriting
custom locales created with
.BR localedef .
.TP
.B \-\-no\-hard\-links
Do not create hard links between installed locales.
.TP
.BI \-\-no\-warnings= warnings
Comma-separated list of warnings to disable.
Supported warnings are
.I ascii
and
.IR intcurrsym .
.TP
.B \-\-posix
Conform strictly to POSIX. Implies
.BR \-\-verbose .
This option currently has no other effect.
POSIX conformance is assumed if the environment variable
.B POSIXLY_CORRECT
is set.
.TP
.BI \-\-prefix= pathname
Set the prefix to be prepended to the full archive pathname.
By default, the prefix is empty.
Setting the prefix to
.IR foo ,
the archive would be placed in
.IR foo/usr/lib/locale/locale-archive .
.TP
.B \-\-quiet
Suppress all notifications and warnings, and report only fatal errors.
.TP
.B \-\-replace
Replace a locale in the locale archive file.
Without this option, if the locale is in the archive file already,
an error occurs.
.TP
.BI \-\-warnings= warnings
Comma-separated list of warnings to enable.
Supported warnings are
.I ascii
and
.IR intcurrsym .
.TP
.BR \-? ", " \-\-help
Print a usage summary and exit.
Also prints the default paths used by