                        Notes on Standard source documents
                        ----------------------------------

The sub-directories within this directory contain source documents for the cultural (and Sather) specifications needed by the cultural compiler when producing the binary culture files for use by Sather programs written using the Required Library.

Default
-------
     This directory contains the two files 14652, giving the source text for the default cultural definition specified in ISO/IEC 14652, and sort-order, containing the string sorting rule definitions for use by implementations of the international ordering mechanism specified in ISO/IEC 14651.  They are provided as two files for convenience in handling - the sort-order file is referred to within the cultural definition by a copy directive.

     The bin sub-directory is a convenient place to store the generated binary files when running lcc.  The files may be produced and then moved into the correct resource 'bin' directory as desired.

Repmaps
-------
     This directory contains the definition of character repertoire maps in a variety of cultures as may be added to when incorporating additional culture specifications into this directory.  There will need to be at least one file per cultural encoding repertoire - which may or may not contain all of the codes in any given coding standard.  This will almost certainly be the case for cultures opting to use the ISO/IEC 10646 (Unicode) standard for encodings.

Sather
------
     This directory will need to contain a file for each operating system for which the Sather language has been ported.  The initial release presumes that a 'unix library' is available and used by the installation.

     The files contain three sections :-

     a.   The standard 'punctuation' character names used within the
     Required library.  Any change to the required library class LIBCHARS in
     respect of adding removing characters from this universal set will need
     to be accompanied by a change to the class BUILDER of the cultural
     compiler and, of course, to the first section of the files in this
     directory.

     b.   The second section defines the character strings which may be used
     by a specific operating system to indicate the modes in which a file may
     be opened/created (see the required library class FILE_MODES).  If an
     operating system does not use string literals then this section still
     needs to be present - but the count of entries must be set to zero.

     c.   This section contains the character names for those character strings
     used as name/separator tokens by the underlying operating system for
     construction of file path names and search paths see the required library
     classes LIBCHARS and FILE_PATH for further detail.

Other Directories
-----------------
     Apart from the directories mentioned above any other sub-directory in this directory is given the name of the culture (according to the convention specified in ISO/IEC 14652) and contains one or more culture description (and possibly ordering) files plus a bin sub-directory as described above for the default directory.

Ordinary Files
--------------
     The ordinary files in this directory, in addition to this file, are configuration files for use with lcc.  They are provided, not only for initial use but also as templates for the production of other configuration files needed in other cultures.  See the lcc class BUILDER for details of lcc configuration.
     
     