                         AUXILIARY PROGRAM(S)
                         --------------------

     This directory contains the source and binary images for those utility programs which are needed to build additional binary files for use when a Sather program using this library is running.

Builder
--------
     Cultural dependencies during program execution have been separated out from the source code of the Sather library and facilities are available in that library to handle message files, culture dependencies, etc during program execution.
     The culture-dependencies are specified in ISO/IEC 14651 and 14652, in addition to the character code standard in use on the executing machine.

     The builder program is designed to read textual definitions of the appropriate cultural dependencies and create binary files which will be read as needed and as appropriate during program execution.   The program takes two command line arguments :--

     -code followed by a code kind name as given in the culture-dependent [for
           builder execution!] message file for the library class CODE_KINDS.
           This ensures that the binary files are generated with the character
           codes to be used by the target culture.

     -config followed by a file name containing 'configuration' file/directory
          names [See class BUILDER comment documentation.]

     The program reads, after the configuration file, three files which it finds named there -- a repertoire map file, a Sather special character name file [distributed as SATHER_HOME/Resources/Resources/Default/sather] and a culture definition file (in that order).   It produces the following output files in the directory which was specified in the configuration file :--

For moving to SATHER_HOME/Resources/Resources culture directory (eg fr_FR)
--------------------------------------------------------------------------
     culture      -- the binary  file for initialising the CULTURE class.

     order        -- the binary file for initialising the REPERTOIRE class.

     rep_map      -- the binary  file for initialising the REP_MAP class.

     LIBCHARS     -- the binary file for initialising the LIBCHARS class.

For moving to SATHER_HOME/Resources/DateTime culture directory (eg en_GB)
-------------------------------------------------------------------------
     weekdays    -- the message file for the class WEEKDAYS

     months      -- the message file for the class MONTHS

For moving to SATHER_HOME/Resources/Cultural culture directory (eg jp_JP)
---------------------------------
     suffices  -- the message file for the class TIME_SUFFIX


     There is a default version of each of these binary files provided with the initial distribution -- as specified in the relevant standards for a default culture.   Additional cultures may be set up and should be passed to ICSI for inclusion in future distributions, thus enabling a set of definitions and binary files to be made available for all users.