xref: /freebsd/tools/tools/locale/README (revision 84fa0ef97db9dd72693f10a1fa72c766f2b0838f)
132810cf3SBaptiste Daroussin# $FreeBSD$
232810cf3SBaptiste Daroussin
3*84fa0ef9SHiroki SatoFiles in this directory are used to generate locale source files
4*84fa0ef9SHiroki Satofrom files in CLDR (Unicode Common Locale Data Repository).
532810cf3SBaptiste Daroussin
6*84fa0ef9SHiroki SatoTo generate the files, do the following:
732810cf3SBaptiste Daroussin
8*84fa0ef9SHiroki Sato	cd /usr/src/tools/tools/locale
9*84fa0ef9SHiroki Sato	make obj	(mandatory)
10*84fa0ef9SHiroki Sato	make -j16	(-jN recommended)
11*84fa0ef9SHiroki Sato	make diff	(check if the changes are reasonable)
1232810cf3SBaptiste Daroussin	make install
13*84fa0ef9SHiroki Sato
14*84fa0ef9SHiroki Sato"make" downloads the necessary files, build them, and install the
15*84fa0ef9SHiroki Satoresults into /usr/src/share/* as source files for locales.
16*84fa0ef9SHiroki Sato
17*84fa0ef9SHiroki SatoMore details are as follows:
18*84fa0ef9SHiroki Sato
19*84fa0ef9SHiroki SatoVariables:
20*84fa0ef9SHiroki Sato	LOCALESRCDIR
21*84fa0ef9SHiroki Sato		Destination path for the generated locale files.
22*84fa0ef9SHiroki Sato		Default: $DESTDIR/usr/src/share.
23*84fa0ef9SHiroki Sato	TMPDIR
24*84fa0ef9SHiroki Sato		Temporary directory.
25*84fa0ef9SHiroki Sato		Default: /tmp
26*84fa0ef9SHiroki Sato
27*84fa0ef9SHiroki SatoTargets:
28*84fa0ef9SHiroki Sato	make obj
29*84fa0ef9SHiroki Sato		Create a temporary directory for building.
30*84fa0ef9SHiroki Sato
31*84fa0ef9SHiroki Sato	make clean
32*84fa0ef9SHiroki Sato		Clean up the obj directories.
33*84fa0ef9SHiroki Sato
34*84fa0ef9SHiroki Sato	make cleandir
35*84fa0ef9SHiroki Sato		Remove the obj directories completely.
36*84fa0ef9SHiroki Sato
37*84fa0ef9SHiroki Sato	make tools-test
38*84fa0ef9SHiroki Sato		Check if necessary tools are installed or not.
39*84fa0ef9SHiroki Sato		If something is missing, install them.
40*84fa0ef9SHiroki Sato
41*84fa0ef9SHiroki Sato	make fetch
42*84fa0ef9SHiroki Sato		Download necessary files from CLDR.
43*84fa0ef9SHiroki Sato
44*84fa0ef9SHiroki Sato	make build-tools
45*84fa0ef9SHiroki Sato		Build a tool to generate locale source files.
46*84fa0ef9SHiroki Sato
47*84fa0ef9SHiroki Sato	make posix
48*84fa0ef9SHiroki Sato		Build POSIX locale source files.
49*84fa0ef9SHiroki Sato
50*84fa0ef9SHiroki Sato	make build
51*84fa0ef9SHiroki Sato		Build locale files.
52*84fa0ef9SHiroki Sato
53*84fa0ef9SHiroki Sato	make diff
54*84fa0ef9SHiroki Sato		Run diff(1) the build results against $LOCALESRCDIR.
55*84fa0ef9SHiroki Sato
56*84fa0ef9SHiroki Sato	make install
57*84fa0ef9SHiroki Sato		Install the build results into $LOCALESRCDIR.
58*84fa0ef9SHiroki Sato[EOF]
59