xref: /freebsd/tools/tools/locale/README (revision 2ed3236082a4473c1da8f72c1ebc071a7b54321f)
1# $FreeBSD$
2
3Files in this directory are used to generate locale source files
4from files in CLDR (Unicode Common Locale Data Repository).
5
6To generate the files, do the following:
7
8	cd /usr/src/tools/tools/locale
9	make obj	(mandatory)
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: $DESTDIR/usr/src/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.
33
34	make cleandir
35		Remove the obj directories completely.
36
37	make tools-test
38		Check if necessary tools are installed or not.
39		If something is missing, install them.
40
41	make fetch
42		Download necessary files from CLDR.
43
44	make build-tools
45		Build a tool to generate locale source files.
46
47	make posix
48		Build POSIX locale source files.
49
50	make build
51		Build locale files.
52
53	make diff
54		Run diff(1) the build results against $LOCALESRCDIR.
55
56	make install
57		Install the build results into $LOCALESRCDIR.
58[EOF]
59