# Licensed Materials - Property of IBM                       
# Rational Software Architect RealTime Edition - TARGET RTS                 
# Copyright IBM Corporation 1999, 2014. All Rights Reserved.      
# U.S. Government Users Restricted Rights -  Use, duplication or    
# disclosure restricted by GSA ADP  Schedule Contract with IBM Corp.

There is directory here for each supported library set.  Library sets
are defined by the choice of compiler and other related tools.

The actual names can be chosen arbitrarily, but by convention those
defined by ObjecTime Limited are structured as three components
separated by hyphens.

The first component identifies the processor architecture.  Examples
include:

    hppa        Hewlett Packard's precision architecture RISC processor
    m680x0      Motorola's 68000 family
    sparc       As defined by Sun Microsystems
    x86         Intel 486, Pentium, etc.

The second component names the source of the tools.  Examples include:

    HPC++       Hewlett Packard
    SunC++      Sun Microsystems
    gnu         Free Software Foundation

The third component specifies the version of the compiler as defined by
its vendor.

Within each directory should be a copy of 'libset.mk' which is included
in makefiles used both when compiling the libraries and when compiling
applications. It should define all the following variables.

    Macro         Purpose
    -----         -------
    AR_CMD        used to create object libraries (usually 'tools/ar.pl')
    CC            C++ compiler command prefix
    LD            linker
    SHLIB_CMD     shared library builder

    LIBSETCCFLAGS C++ compile options
    LIBSETCCEXTRA extra C++ compile options used only for building library
    SHLIBCCFLAGS  extra C++ compile options used when shared libraries selected
    LIBSETLDFLAGS C++ link options

    OBJ_EXT       extension of object files, usually '.o'
    LIB_EXT       extension of object libraries, usually '.a'
    SHLIB_EXT     extension of shared libraries, usually '.so'

    DEBUG_TAG     compile option to include debugging information
    DEFINE_TAG    compile option prefix for macro definitions
    DIR_TAG       compile option prefix for specifying link library search order
    INCLUDE_TAG   compile option prefix for specifying include search order
    LIB_TAG       compile option prefix for specifying link library
    OT_LIB_TAG    compile option prefix for specifying an ObjecTime-generated
		  link library
    OBJECT_TAG    compile option to bypass link phase
    OUTPUT_TAG    compile option to specify output file

There is one additional macro which may be defined: SHLIBS.  The file
which includes libset.mk will define SHLIBS as the list of shared
libraries that could be built.  If it is specified here as the empty
list, shared library creation is disabled.

Optionally a library set may include a copy of 'RTLibSet.h' which will
be included by RTConfig.h.  Currently there is just one macro which may
be defined to affect the interpretation of other header files.

That is 'INTEGER_POSTFIX'.  If its value is non-zero, the postfix
operators are included in the RTInteger class.  Some older compilers do
not support this recent addition to C++.  In those situations RTLibSet.h
should give this macro the value 0.  RTConfig.h supplies a default value
of 1 if not defined here.

In extreme cases, other header files may be altered to deal with specific
issues that arise out of using a particular compiler by placing the
modified copy in the appropriate libset directory.  Hopefully this will
be necessary only rarely.
