xref: /freebsd/tools/tools/locale/README (revision 2c8d44449b25411a4dd62d073db51a312faf9b9c)
132810cf3SBaptiste Daroussin# $FreeBSD$
232810cf3SBaptiste Daroussin
384fa0ef9SHiroki SatoFiles in this directory are used to generate locale source files
484fa0ef9SHiroki Satofrom files in CLDR (Unicode Common Locale Data Repository).
532810cf3SBaptiste Daroussin
684fa0ef9SHiroki SatoTo generate the files, do the following:
732810cf3SBaptiste Daroussin
884fa0ef9SHiroki Sato	cd /usr/src/tools/tools/locale
984fa0ef9SHiroki Sato	make obj	(mandatory)
1084fa0ef9SHiroki Sato	make -j16	(-jN recommended)
1184fa0ef9SHiroki Sato	make diff	(check if the changes are reasonable)
1232810cf3SBaptiste Daroussin	make install
1384fa0ef9SHiroki Sato
1484fa0ef9SHiroki Sato"make" downloads the necessary files, build them, and install the
1584fa0ef9SHiroki Satoresults into /usr/src/share/* as source files for locales.
1684fa0ef9SHiroki Sato
1784fa0ef9SHiroki SatoMore details are as follows:
1884fa0ef9SHiroki Sato
1984fa0ef9SHiroki SatoVariables:
2084fa0ef9SHiroki Sato	LOCALESRCDIR
2184fa0ef9SHiroki Sato		Destination path for the generated locale files.
2284fa0ef9SHiroki Sato		Default: $DESTDIR/usr/src/share.
2384fa0ef9SHiroki Sato	TMPDIR
2484fa0ef9SHiroki Sato		Temporary directory.
2584fa0ef9SHiroki Sato		Default: /tmp
2684fa0ef9SHiroki Sato
2784fa0ef9SHiroki SatoTargets:
2884fa0ef9SHiroki Sato	make obj
2984fa0ef9SHiroki Sato		Create a temporary directory for building.
3084fa0ef9SHiroki Sato
3184fa0ef9SHiroki Sato	make clean
3284fa0ef9SHiroki Sato		Clean up the obj directories.
3384fa0ef9SHiroki Sato
3484fa0ef9SHiroki Sato	make cleandir
3584fa0ef9SHiroki Sato		Remove the obj directories completely.
3684fa0ef9SHiroki Sato
3784fa0ef9SHiroki Sato	make tools-test
3884fa0ef9SHiroki Sato		Check if necessary tools are installed or not.
3984fa0ef9SHiroki Sato		If something is missing, install them.
4084fa0ef9SHiroki Sato
4184fa0ef9SHiroki Sato	make fetch
4284fa0ef9SHiroki Sato		Download necessary files from CLDR.
4384fa0ef9SHiroki Sato
4484fa0ef9SHiroki Sato	make build-tools
4584fa0ef9SHiroki Sato		Build a tool to generate locale source files.
4684fa0ef9SHiroki Sato
4784fa0ef9SHiroki Sato	make posix
4884fa0ef9SHiroki Sato		Build POSIX locale source files.
4984fa0ef9SHiroki Sato
5084fa0ef9SHiroki Sato	make build
5184fa0ef9SHiroki Sato		Build locale files.
5284fa0ef9SHiroki Sato
5384fa0ef9SHiroki Sato	make diff
5484fa0ef9SHiroki Sato		Run diff(1) the build results against $LOCALESRCDIR.
5584fa0ef9SHiroki Sato
5684fa0ef9SHiroki Sato	make install
5784fa0ef9SHiroki Sato		Install the build results into $LOCALESRCDIR.
58*2c8d4444SYuri Pankov
59*2c8d4444SYuri Pankov	make widths
60*2c8d4444SYuri Pankov		Generate widths.txt.  Requires pkgconf and utf8proc
61*2c8d4444SYuri Pankov		packages to be installed.
6284fa0ef9SHiroki Sato[EOF]
63