doc/LOCALIZATION

   1 LOCALIZATION
   2 ============
   3
   4 See chapter 'Customization Localizattion and UTF-8' in the
   5 Users Manual and the usage of 'set-locale' function in the
   6 Function Reference.
   7
   8 The 'set-locale' function will not influence the behaviour of
   9 PCRE (Perl Compatible Regular Expressions) in newLISP, but a
  10 special option flag number  can be set to support UTF-8 in all
  11 functions supporting regular expressions like: regex, find,
  12 replace, parse and search.
  13
  14 To further localize the behaviour of regular expressions in newLISP
  15 the file 'pcre-chartables.c' must be replaced with a localized
  16 version. To obtain this file for your locale, follow these steps:
  17
  18 (1) get the pcre source distribution from http://www.pcre.org
  19
  20 (2) follow the instruction in it's README file to 'configure'
  21     and  'make' it. An installation is not necessary. Just using
  22     the 'configure' and 'make' steps will create a file called
  23     'chartables.c' suitable for the locale on your computer
  24     system. Rename this file to 'pcre-chartables.c', which it
  25     replaces in the newLISP source distribution.
  26
  27 (3) recompile newLISP
  28
  29 newLISP will now show regular expression behaviour in functions
  30 like 'regex', 'find', 'replace' and 'parse' appropiate to your
  31 locale. The function 'set-locale' should still be used to change
  32 all other aspects of newLISP to your locale.
  33
  34 newLISP can be used with multi-byte character languages when
  35 compiled with UTF-8 options. For some OS flavors UTF-8 enabled
  36 makefile are shipped in the source distribution.
  37
  38 When compiled with UTF-8 character handling some newLISP functions
  39 will work on multibyte characters instead of single bytes. See
  40 the manual for details.
  41                                +++