#!/bin/sh

OS=$1
TOPDIR=$2
INST_LIBS=$3
INST_PLUGINS=$4
INST_INCLUDE=$5
INST_DEMOS=$6
INST_DEMO_SRC=$7
INST_DOC=$8
INST_DATA=$9


cat <<- EOF

The following targets can be used with any subsystem as well as the top
level build (build in the OpenThreads Root directory).  Note that debug 
versions and optimized version of targets reside in parallel.

  make                - Same as 'make opt'
  make opt            - Makes optimized versions of all targets
  make debug          - Makes debug versions of all targets.
  make clean          - Removes all object files (both optimized and debug 
                        versions)
  make cleanopt       - Removes optimized version of object files
  make cleandbg       - Removes debug version of object files
  make cleandepend    - Removes Makedepend file (both optimized and debug 
                        versions)
  make cleandependopt - Removes optimized version Makedepend file 
  make cleandependdbg - Removes debug version Makedepend file 
  make cleantarget    - Removes only targets but leaves object files (both
                        optimized and debug versions)
  make cleantargetopt - Removes only optimized targets but leaves optimized
                        objects files.
  make cleantargetdbg - Removes only debug targets but leaves debug object
                        files
  make clobber        - Removes object files and targets (both optimized and
                        debug versions)
  make clobberopt     - Removes optimized object files and targets
  make clobberdbg     - Removes debug object files and targets
  make beautify       - Pretty print C++ files
  make documentation  - Builds documentation database for current target
  make depend         - Force a rebuild of the dependency file.  Note that
                        dependency files are generated automatically during
                        builds.

Note for Linux users:
On some linux kernels (2.4 kernels with backdated 2.6 functionality) there is a two param sched_setaffinity defined, instead of
the standard three param sched_setaffinity.  This will lead to a compile failure, if this occurs then use the make line:

   make COMPILE_USING_TWO_PARAM_sched_setaffinity=yes

Or set up the COMPILE_USING_TWO_PARAM_sched_setaffinity env var in your .bashrc
  
  export COMPILE_USING_TWO_PARAM_sched_setaffinity=yes
  make


Solaris and IRIX can build 64 bit targets.  These require the ARCH=64 argument.
For example:

  make ARCH=64         - Same as 'make ARCH=64 opt'
  make ARCH=64 opt     - Builds 64 bit optimized targets
  make ARCH=64 debug   - Builds 64 bit debug versions of targets
  make ARCH=64 clean   - Removes all 64 bit object files (both optimized and
                         debug versions).

  etc.

The following targets may only be issued from the top-level OpenThreads build:

  make install      - Install both execution environment and development
                      targets 
  make instbin      - Install execution environment targets only.  These
                      consist of libraries, plugins and demo programs.
                      Libraries are installed in
                        o $INST_LIBS,
                      plugins are installed in 
                        o $INST_PLUGINS,
                      and demos are installed in 
                        o $INST_DEMOS
                      on $OS

  make instdev      - Install development targets only.  These consist of
                      header files, source code to the demo programs, and
                      documentation.
                      Header files are install in 
                        o $INST_INCLUDE,
                      demo source code is installed in
                        o $INST_DEMO_SRC,
                      and documentation is installed in
                        o $INST_DOC
                      on $OS

  make instlinks    - Installs symbolic links at install locations for both
                      execution environment and development targets rather
                      than copyied files.  Installing links is ideal for a
                      development environment for avoiding confusion about
                      which binaries are being run or linked to.

  make instlinksbin  - Installs symbolic links at install locations for
                       execution environment targets only.
  make instlinksdev  - Installs symbolic links at install locations for
                       development targets only
  make instclean     - Removes installed targets (files or links) from 
                       installation locations for both execution environment
                       and development targets
  make instcleanbin  - Removes installed targets from installation locations
                       for execution environment targets only
  make instcleandev  - Removes installed targets from installation locations
                       for defelopment targets only

Note that the following variables can be used to directly override the default 
installation locations for $OS.

  make  INST_LIBS=<libs_location> \\
        INST_PLUGINS=<plugins_location>\\
        INST_INCLUDE=<header_file_location>\\
        INST_DEMOS=<demos_location>\\
        INST_DEMO_SRC=<demo_src_location>\\
        INST_DOC=<doc_location>\\
        install

                     - Installs libraries in <libs_location>, plugins in 
                       <plugins_location>, header files in 
                       <header_file_location>, demos in <demos_location>,
                       demo source code in <demo_src_location> and 
                       documentation in <doc_location>

Note also that INST_LIBS, INST_PLUGINS, and INST_INCLUDE share a common 
prefix by default: INST_LOCATION. Further INST_DEMOS, INST_DEMOS_SRC, 
INST_DOC, and INST_DATA share a common prefix by default : INST_SHARE_PREFIX.
This provides a short cut for the above 'make' usage.  For example,

  make INST_LOCATION=/usr install


These values can be tested by reissuing 'make help' with these arguments.

After doing a 'make install' or 'make instlinks', and if not already added, 
add

    $INST_DEMOS

to your PATH environmental variable to run the demos.  If it is not already 
present, add

    $INST_LIBS

and  

    $INST_PLUGINS

to your LD_LIBRARY_PATH environmental variable.  When compiling programs 
using OpenThreads headers add to your -I compile flags:

    $INST_INCLUDE




EOF

exit 0