tools/tools/locale/README

   1 # $FreeBSD$
   2
   3 Files in this directory are used to generate locale source files
   4 from files in CLDR (Unicode Common Locale Data Repository).
   5
   6 To 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
  15 results into /usr/src/share/* as source files for locales.
  16
  17 More details are as follows:
  18
  19 Variables:
  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
  27 Targets:
  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]