initial commit
[glibc.git] / debian / local / manpages / locale-gen.8
1 .\" SPDX-License-Identifier: 0BSD
2 .\"
3 .Dd May 5, 2022
4 .Dt LOCALE-GEN 8
5 .Os
6 .
7 .Sh NAME
8 .Nm locale-gen
9 .Nd generate localisation files from templates
10 .Sh SYNOPSIS
11 .Nm
12 .Op Fl -keep-existing
13 .
14 .Sh DESCRIPTION
15 As compiled locales are large, only templates are distributed in the default
16 .Sy locales
17 package, and only the desired locales are compiled on the target system.
18 .Pp
19 After selecting the locales into
20 .Pa /etc/locale.gen
21 .Pq via Nm dpkg No package configuration, for example ,
22 .Nm
23 is run to compile them via
24 .Xr localedef 1 .
25 .
26 .Sh OPTIONS
27 .Bl -tag -compact -width ".Fl -keep-existing"
28 .It Fl -keep-existing
29 Do not remove
30 .Pa /usr/lib/locale/locale-archive ,
31 only compiling new locales.
32 .El
33 .
34 .Sh FILES
35 .Bl -tag -compact -width ".Pa /etc/locale.gen"
36 .It Pa /etc/locale.gen
37 Whitespace-separated newline-delimited
38 .Ar locale charset
39 list of locales to build with
40 .Li #
41 start-of-line comments.
42 .El
43 .
44 .Sh SEE ALSO
45 .Xr locale 1 ,
46 .Xr localedef 1 ,
47 .Xr locale.gen 5
48 .Pp
49 .Pa /usr/share/i18n/SUPPORTED
50 .Pq Pa /usr/local/share/i18n/SUPPORTED
51 \(em list of all supported locales on the current system.
52 .Pp
53 The
54 .Sy locales-all
55 package, which contains all supported locales in compiled form.