xref: /freebsd/tools/tools/locale/README (revision b306c604df541dede4d0f3cc96188bbf5b6719fe)
1Files in this directory are used to generate locale source files
2from files in CLDR (Unicode Common Locale Data Repository).
3
4To generate the files, do the following:
5
6	cd /usr/src/tools/tools/locale
7	make obj	(mandatory)
8	make fetch	(download the CLDR source)
9	make extract	(and extract it)
10	make -j16	(-jN recommended)
11	make diff	(check if the changes are reasonable)
12	make install
13
14"make" downloads the necessary files, build them, and install the
15results into /usr/src/share/* as source files for locales.
16
17More details are as follows:
18
19Variables:
20	LOCALESRCDIR
21		Destination path for the generated locale files.
22		Default: ${SRCTOP}/share.
23	TMPDIR
24		Temporary directory.
25		Default: /tmp
26
27Targets:
28	make obj
29		Create a temporary directory for building.
30
31	make clean
32		Clean up the obj directories.  Note that this does not
33		clean up tools or posix locale source files generated
34		from the CLDR files because it takes a long time to generate
35		them and they are not changed as long as using the same
36		CLDR files.  "make clean && make build" will
37		regenerate the locale source files for src/share/*def.
38
39	make cleandir
40		Remove the obj directories completely.
41
42	make tools-test
43		Check if necessary tools are installed or not.
44		If something is missing, install them.
45
46	make fetch
47		Download necessary files from CLDR.
48
49	make build-tools
50		Build a tool to generate locale source files.
51
52	make posix
53		Build POSIX locale source files.
54
55	make build
56		Build locale files.
57
58	make diff
59		Run diff(1) the build results against $LOCALESRCDIR.
60
61	make install
62		Install the build results into $LOCALESRCDIR.
63
64	make widths
65		Generate widths.txt.  Requires pkgconf and utf8proc
66		packages to be installed.
67[EOF]
68