commit: c6e22b17d4174ac35179993052c2f230fcb1bf2c Author: Kerin Millar <kfm <AT> plushkava <DOT> net> AuthorDate: Mon Jan 12 06:35:40 2026 +0000 Commit: Kerin Millar <kfm <AT> plushkava <DOT> net> CommitDate: Mon Jan 12 07:02:00 2026 +0000 URL: https://gitweb.gentoo.org/proj/locale-gen.git/commit/?id=c6e22b17
locale-gen.8: replace MINUS sequences with HYPHEN-MINUS Presently, the locale-gen(8) groff text contains many "\-" sequences. Depending on the output medium, troff(1) may render these as "MINUS" (U+2212) characters which is inappropriate. It is a character that depicts a mathematical operator, after all. Change all of them to "-" so that they are rendered as "HYPHEN-MINUS" (U+002D) characters instead. Signed-off-by: Kerin Millar <kfm <AT> plushkava.net> locale-gen.8 | 48 ++++++++++++++++++++++++------------------------ 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/locale-gen.8 b/locale-gen.8 index 4371d92..25d368d 100644 --- a/locale-gen.8 +++ b/locale-gen.8 @@ -1,52 +1,52 @@ .TH "locale-gen" "8" "Aug 2025" "Gentoo" .SH "NAME" -locale\-gen - safely compile and install a glibc locale archive +locale-gen - safely compile and install a glibc locale archive .SH "SYNOPSIS" .SY locale-gen -.RB [ \-A ] -.RB [ \-q ] -.RB [ \-u ] -.RB [ \-c\~\c +.RB [ -A ] +.RB [ -q ] +.RB [ -u ] +.RB [ -c\~\c .IR config ] -.RB [ \-j\~\c +.RB [ -j\~\c .IR jobs ] -.RB [ \-p\~\c +.RB [ -p\~\c .IR prefix ] .YS .SY locale-gen -.B \-h +.B -h .YS .SY locale-gen -.B \-V +.B -V .YS .SH "DESCRIPTION" -The locale\-gen utility provides a means by which a system administrator may conveniently manage the set of locales that are made available to the GNU C Library. It accomplishes this by acting as a user-friendly frontend for the \fBlocaledef\fR(1) utility, which is used to compile locales and integrate them into a central archive. +The locale-gen utility provides a means by which a system administrator may conveniently manage the set of locales that are made available to the GNU C Library. It accomplishes this by acting as a user-friendly frontend for the \fBlocaledef\fR(1) utility, which is used to compile locales and integrate them into a central archive. .P -By default, locale\-gen generates an archive containing a full complement of supported locales, numbering 500 or more. However, it is typical for an administrator to require only a few of them. In that case, the \fIconfig\fR file may be populated with a list of the required locales. Consequently, locale\-gen shall compile only those, saving both time and space in the longer term. +By default, locale-gen generates an archive containing a full complement of supported locales, numbering 500 or more. However, it is typical for an administrator to require only a few of them. In that case, the \fIconfig\fR file may be populated with a list of the required locales. Consequently, locale-gen shall compile only those, saving both time and space in the longer term. .SH "OPTIONS" .TP -\fB\-A\fR, \fB\-\-all\fR +\fB-A\fR, \fB--all\fR Compile all locales that are officially supported by glibc. Cannot be combined with the \fB-c\fR option. .TP -\fB\-c\fR, \fB\-\-config\fR \fIconfig\fR -Read the given \fIconfig\fR file (defaults to \fIprefix\fR/etc/locale.gen). If specified as a \%<hyphen-minus>, the configuration shall be read from standard input. If the file contains no locales or is missing, locale\-gen shall act as if the \fB-A\fR option had been specified. +\fB-c\fR, \fB--config\fR \fIconfig\fR +Read the given \fIconfig\fR file (defaults to \fIprefix\fR/etc/locale.gen). If specified as a \%<hyphen-minus>, the configuration shall be read from standard input. If the file contains no locales or is missing, locale-gen shall act as if the \fB-A\fR option had been specified. .TP -\fB\-h\fR, \fB\-\-help\fR +\fB-h\fR, \fB--help\fR Write out a synopsis and summary of the supported options then exit. .TP -\fB\-j\fR, \fB\-\-jobs\fR \fIjobs\fR +\fB-j\fR, \fB--jobs\fR \fIjobs\fR Spawn up to the specified number of \fIjobs\fR to compile locales in parallel (defaults to the number of logical processors). .TP -\fB\-p\fR, \fB\-\-prefix\fR \fIprefix\fR +\fB-p\fR, \fB--prefix\fR \fIprefix\fR Treat FILES as being relative to the specified \fIprefix\fR (defaults to / if not a Gentoo Prefix system). Where explicitly specified, the \fIconfig\fR file shall be exempted from this behaviour. .TP -\fB\-q\fR, \fB\-\-quiet\fR +\fB-q\fR, \fB--quiet\fR Suppress the writing of informational messages to standard output. .TP -\fB\-u\fR, \fB\-\-update\fR +\fB-u\fR, \fB--update\fR Suppress the compilation of locales that are already installed (not recommended). .TP -\fB\-V\fR, \fB\-\-version\fR +\fB-V\fR, \fB--version\fR Write out some details regarding the program then exit. .SH "FILES" .TP @@ -56,7 +56,7 @@ The default location of the \fIconfig\fR file. It specifies the locales to be co .I /usr/share/i18n/SUPPORTED A complete list of valid locale declarations, as provided by glibc. .TP -.I /usr/lib/locale/locale\-archive +.I /usr/lib/locale/locale-archive Contains the currently installed locales. .TP .I /usr/share/i18n/locales @@ -67,7 +67,7 @@ Contains character map files that serve as inputs to \fBlocaledef\fR(1). .SH "ENVIRONMENT" .TP LOCALEGEN\_ALLOW\_UNSUPPORTED -If set as a non-empty string, locale\-gen shall convey validation errors as warnings. Validation is performed by comparing the entries of the \fIconfig\fR file against the \fI/usr/share/i18n/SUPPORTED\fR file. +If set as a non-empty string, locale-gen shall convey validation errors as warnings. Validation is performed by comparing the entries of the \fIconfig\fR file against the \fI/usr/share/i18n/SUPPORTED\fR file. .TP LOCALEGEN\_CONFIG Defines the path of the \fIconfig\fR file in the absence of the \fB-A\fR and \fB-c\fR options. @@ -77,9 +77,9 @@ If set as a non-empty string, coloured output shall be disabled. .SH "EXIT STATUS" The exit status shall be 0 under any of these conditions: .IP \[bu] 2 -the \fB\-h\fR and/or \fB\-V\fR options were specified +the \fB-h\fR and/or \fB-V\fR options were specified .IP \[bu] 2 -the \fB\-u\fR option was specified but no locales need compiling +the \fB-u\fR option was specified but no locales need compiling .IP \[bu] 2 the options and \fIconfig\fR were validated, the specified locales compiled and the resulting archive installed, without error .P
