Subversion Repositories DevTools

# -*- mode: perl; tabs: 8; indent-width: 4; show-tabs: yes; -*-

# Copyright (C) 1998-2004 ERG Transit Systems, All rights reserved

#

# Module name   : makelib.pl2

# Module type   : Makefile system

#

# Description:

#       This modules builds the platform definition makefiles(s)

#

# Notes:                *** DO NOT DETAB ***

#       Beware the use of space v's tab characters within the

#       makefile generation sessions.

#

# Version   Who      Date        Description

#           APY      11/08/99    Created EMBEDDED version (from CB)

#                    11/10/99    PushObjects

#           APY      26/11/99    GBE_DEPENDS defines platform/toolset

#                                  dependencies, used by the 'makefile'

#                                  rules invoked by the build system

#                                  (See makefile.pl for details)

#           APY      09/12/99    toolset cleanup,

#                                   TOOLSETDIRS generated directories

#                                   TOOLSETPROGS generated programs

#                                   TOOLSETTREE generated directories trees

#           APY      03/03/00    Support ! within platform specifications

#           APY      09/03/00    Inc/Src/Lib paths defines within 'global'

#                                sections are now ordered after 'local'

#                                definitions (v1.1).

#                    13/03/00    LIBDIR wasn't explicity defined.

#                                Removed -e switch from usage echo statement

#                    20/03/00    NOSCMDEPEND, allowing clean without

#                                dependency tests against build env.

#                    21/03/00    remove *.cmd during clean operations

#                    22/03/00    AddIncDir(), --NoDepend switch

#           APY      06/04/00    Pass arguments thru PlatformRequire() .

#           APY      17/05/00    Added pl and awk to known extensions

#                    05/06/00    Gave GBE_DEPENDS a default value of <NUL>

#                    15/06/00    PROGOBJS and limited source processing

#                                  within Prog() statements

#                                .PHONY default usage

#                                v1.20

#           GM       xx/08/00    Release build option

#           APY      03/10/00    Renamed several internal rules.

#           APY      02/10/00    UNIX builds

#                    13/11/00    - Handle empty "exe" definitions

#                                - Under unix, Prog(-Lx, -Lx) switch imply -Llibx.a

#           APY      29/11/00    Solaris builds,

#                                - Shared library support

#                                - Required to push library target definition

#                                  into ToolsetAR macros.

#                                - GBE_TARGET, allowing auto hosted PLATFORMS

#                                  (eg SOLARIS, results in SOLARIS_sparc)

#                                - Prog() and Lib() didn't delete objects generated

#                                  from in-line source references.

#                                - Completed package support

#                                OPTIONS

#           APY      27/12/00    'clean' no longer uninstalls, 'use clean uninstall'

#           APY      02/01/01    v2.0

#           APY      12/01/01    Added 'interface' to standard include paths.

#           APY      17/01/01    InstallProg()/PackageProg() defaults to handling

#                                target as a script installation if unknown.

#           APY      24/02/01    Corrected LibNameSplit()

#           GT       26/02/01    TestProg()

#           APY      26/02/01    v2.01

#           APY      07/03/01    - SRC_ARGS parsing using incorrect key,

#                                  which disabled source argument support.

#                                - Following variables can be set via env,

#                                     ScmDebug   = GBE_DEBUG   (0|1)

#                                     ScmVerbose = GBE_VERBOSE (0|1)

#           APY      07/03/01    v2.02, toolset cleanup,

#                                  ToolsetDirTree() generated directories trees

#                                  which recursively remove the specified path.

#                                     <<USE WITH CAUTION, try like "rm -f *">>

#           APY      25/05/01    AddSrcDir() directive was broken by

#                                shlib support.

#           APY      29/06/01    WIN32 support using ActivePerl

#                                v2.1

#           APY      24/09/01    WIN32 dll support (dll naming)

#                                v2.2

#           APY      18/02/02    --expert switch

#                                v2.21

#           APY      26/02/02    - Subdir directory install corrected,

#                                  using StripFileExt.

#                                - $ScmMajor and $ScmMinor

#                    27/02/02    - ScmTargetMach override to GBE_MACHTYPE,

#                                  to support cross compiler toolsets.

#                                - ScmPackage global switch, that disables

#                                  packaging support to support older

#                                  makefiles.

#                    04/05/02    - $mkdiract incorrectly referenced

#                                  LIBDIRS, should modified to LIBDIR.

#                                - modeline inserted into generated image.

#                    05/07/02    - InstallHdr() should search SRCS using the

#                                  basename only (ie StripDir).

#                    16/07/02    - The above InstallHdr() change implied that

#                                  installed images must be basename unique,

#                                  breaking several existing builds. Added

#                                  --Abs attribute, bypassing the SRCS list

#                                  resolved check, assuming an absolute path

#                                  allowing non-unique installations.

#                                  (eg ./eosboot.h and CPU/eosboot.h)

#                                - 2.24

# 2.30      APY      09/02/04    o CORE_DEVL merge 1.9.6

#                                  New options;

#                                    --version, --pversion, --name,

#                                    --includes, --libs

#                                  PDB installation and packaging

#                                  New macros

#                                    GBE_PBASE

#                                    BUILDNAME, BUILDVER and BUILDPREVIOUSVER

#                                    FORCECCOMPILE

#                                  --Shared=current option

#                                o 'Include' directive

#                                o LinkPkgArchive support

#                                   - Include platform.rul

#                                   - LINCDIRS allowing mkdepend trimming

#                                     of package directories.

#                                o ScmTargetHost override of ScmHost

#                                  to support cross compiler toolsets.

#                                o MAKTAG filtering

#                                o Trim drive from cwd.

#                                o PackageHdr, --Strip option

#                                o SetProjectBase

#                                o --interface switch

#                                o Ignore case during platform compares.

#                                o Corrected several var references due

#                                  to 'strict' testing.

#                                o GBE_HOST

#                    16/02/04    o Trim whitespace during ActivePlaform tests

#                                o Strip leading/trailing whitespace

#                                  from platform names.

#                                o --arg switch

#                    18/02/04    o InstallHdr, --Strip option

#                    24/02/04    o Import 'build.cfg'.

#                                o GBE_ARGS

#                                o GBE_PRODUCT

#           DDP      04/03/04    o Added MergeLibrary directive to formalise

#                                  the process of merging two or more libraries

#                    09/03/04    o Moved PDB installation and packaging into the

#                                  VCWIN32 toolset - where it belongs.

#                                o Modified used of chmod to use a -f flag

#                                  to supress warning messages when the file

#                                  does not exist.

#                    12/03/04    o Consolidated the packaging code

#                                o mkdir -p does not like a trailing "/"

#                                  It generates a useless warning message

#                                  Ensure that traling "/"s are removed

#                                o Ensure that the "depend" target creates

#                                  directories before using them

#                    23/03/03    o Include target specific paths within the

#                                  interface/include directory to support

#                                  both include.xxx and include/xxx style

#                                  of paths.

#                    30/03/04    o Add CompileOptions

#                                  Remove leading/trailing spaces from file

#                                  and directory names

#                    07/04/04    o Add support for Product specialisation

#                                  Add VARIABLES to allow the PRODUCT and the BASE

#                                  to be used when installing.

#           APY      14/04/04    ActivePlatform must accumulate ! expressions.

#                    16/04/04    o INCDIR_LOCAL expanded to be,

#                                       inc/$Platform

#                                       inc/$Product

#                                       inc/$Target

#                                       inc

#                                o {Install|Package}{Hdr|Lib|Prog},

#                                       --Product, --Product, --Target options

#                                o PackageProg,

#                                       --Prod and --Debug options

#                                o GBE_TARGET redefined as the products base

#                                  platform, defaults (as normal) to

#                                  GBE_PLATFORM.

#                                o InstallLib upgrading to std interface.

#                                o PKGDIR

#                                   - redefined as PKGDIR/$Pbase

#                                   - Packaging directives strip leading

#                                     $Pbase from --Dir specification.

#                    19/04/04    o MakePaths

#                                   Common search path functionality

#                                   Specialisation of product includes.

#                                   Restored previous !product includes.

#                                o PackageLib and PackageJar,

#                                   --Prod and --Debug options

#                                o AddDir/AddSrcDir/AddIncDir/AddLibDir,

#                                   --NoWarn

#                    20/04/04    o Merged common target directory processing

#                                  of Install/Package directives creating

#                                  __TargetDir

#                                o Add[Src|Inc|Lib]Dir wont generate

#                                  warnings if the path contains embedded

#                                  variables eg. $(GBE_ROOT).

#                                o ActivePlatform --Target/Platform/Product

# 2.32               21/04/04    o __TargetDir, added 'pdir parameter.

#                    03/05/04    o fixes to 'release' generation

#                                o Library ifdef & ifndef conditionals (restored)

#                                  e.g  (--ifdef=TEST, -ltest)

#            DDP     05/05/04    o Generate DSP file

#            APY     06/05/04    TOOLSET/common

#                    12/05/04    PlatformEntry

#                    12/05/04    - Installation directories, mirrored

#                                  defaults of package directory.

#                                - Generate ITAG defined, requiring explicit

#                                  rules for each SUBDIR, plus maintainence of

#                                  'gdbdir' files to remove timestamp issues.

#                                - Seperate IFLAGS for libraries, shlibraries

#                                  and application stages.

#                                - mkdiract replaced within mkdirdep and

#                                  explicit mkdir rules.

#                                - ScmToolsetGenerate and ScmToolsetIFLAG3

#                                  toolset options.

#                                - Uninstall/package, attribute/chmod test

#                                  and set.

#                                - Noisy file removal via GBE_RM

#                                - v2.33

#                     20/05/04   - MergeLibrary syntax extended.

#                     02/07/04   - Added support for --List=xxx in Src directives

#                                  Will create a LIST_xxx array for the user

#                     22/07/04   - Merge common Lib and Prog directives.

#           APY       04/08/04   - Makeinterface

#                                - PLATFORM definition searching

#                                - RmfileCmd, silent clean

#                                - v2.34

#

# $Source: /cvsroot/etm/devl/TOOLS/makelib.pl2,v $

# $Revision: 1.34 $ $Date: 2004/10/20 05:56:04 $ $State: Exp $

# $Author: ayoung $ $Locker:  $

#............................................................................#

##############################################################################

# Globals:

#  $ScmVersion          Makelib.pl2 version

#  $ScmRoot             Command line parameter that gives the root directory

#                       location for this directory tree.

#  $ScmMakelib          Command line parameter that points to the location

#                       of THIS script.  ie. location of makelib.pl.

#  $ScmPlatform         Current platform

#  $ScmProduct          Current product (if any)

#  $ScmTarget           Resulting target (derived from Platform)

#  @ScmPlatformArgs     Platform arguments

#  $ScmToolset          Toolset

#  @ScmToolsetArgs      Toolset arguments

#  $ScmDebug            Debug level

#  $ScmVerbose          Verbose setting

#  $ScmSourceTypes      Source types, aliasing for C, C++ and assembler

#                       source.

#  @CFLAGS              List containing all of the defined C flags

#  @CXXFLAGS            List containing all of the defined C++ flags

#  @ASFLAGS             List containing all of the defined assembler flags

#  @CLINTFLAGS          List containing all of the defined C lint flags

#  @CXXLINTFLAGS        List containing all of the defined C++ lint flags

#  @{G|L}_INCDIRS       List containing all of include paths

#  @{G|L}_SRCDIRS       List containing all of source search paths

#  @{G|L}_LIBDIRS       List containing all of library search paths

#  @LDFLAGS             List containing all of the defined linker flags

#  @SRCS                List of ALL source files. ie. C/C++ and other (eg .x)

#                       Key is source file, value is source path

#  @OBJS                List of ALL (non-shared) object files.

#  %SHOBJ_LIB           List of ALL shared library object files and there

#                       associated library.

#  %OBJSOURCE           List of ALL object files

#                       from that should result from later makes.

#                       Key is objectfile, value is source file

#  %OBJREFS             List of ALL object files, built options.

#  @PROGOBJS            List of ALL application object files.

#  %SRC_ARGS            List of arguments that are to be used when making the

#                       nominated source.  Key is the source name, the

#                       value is a string of arguments to apply.  The

#                       arguments are '$;' separated.

#  %SRC_TYPE            Source file type (user override).

#  @CHDRS               List of C header files.

#  @CSRCS               List of C files

#                       Key is objectfile, value is source file

#  @CXXSRCS             List of C++ files

#  @ASHDRS              List of assembler include files (.inc)

#  @ASSRCS              List of assembler source files

#  @GENERATED           List of files that should result from a 'generate'

#                       make rule.  The programmer is expected to provide

#                       the necessary rule(s).

#  @RULES               List of additional make rules the programmer

#                       has specified to be included in the make.

#  %INSTALL_HDRS        List of headers that are to be installed for later

#                       "public" consumption.

#  %INSTALL_CLSS        List of Java classes or JAR files that are to be installed

#                       for later "public" consumption.

#  @LIBS                List of libraries that are to be built.

#  %LIB_OBJS            List of objects that are to be combined to build the

#                       nominated library.  Key is the library name, the

#                       value is a string of object files to go into

#                       the library.  The object files are '$;' separated.

#  %LIB_ARGS            List of arguments that are to be used when making

#                       the nominated library.  Key is the library name, the

#                       value is a string of arguments to apply.  The

#                       arguments are '$;' separated.

#  %INSTALL_LIBS        List of libraries that are to be installed for later

#                       public consumption.

#  @MLIBS               List of libraries that are to be built via merging

#  %MLIB_LIBS           List of objects that are to be combined to build the

#                       nominated library.  Key is the library name, the

#                       value is a string of library files to go into

#                       the library.  The object files are '$;' separated.

#  @SHLIBS              List of shared libraries that are to be built.

#  %SHLIB_OBJS          List of objects that are to be combined to build the

#                       nominated library.  Key is the library name, the

#                       value is a string of object files to go into

#                       the library.  The object files are '$;' separated.

#  %SHLIB_ARGS          List of arguments that are to be used when making

#                       the nominated library.  Key is the library name, the

#                       value is a string of arguments to apply.  The

#                       arguments are '$;' separated.

#  %INSTALL_SHLIBS      List of libraries that are to be installed for later

#                       public consumption.

#  @PROGS               List of programs (binary executables) that are

#                       to be built

#  %PROG_OBJS           List of objects that are to be combined to build the

#                       nominated program.  Key is the program name, the

#                       value is a string of object files to go into

#                       the program.  The object files are '$;' separated.

#  %PROG_LIBS           List of libraries that are to be combined to

#                       build the nominated program.  Key is the program

#                       name, the value is a string of library files to

#                       go into the program.  The library files are '$;'

#                       separated.

#  %PROG_ARGS           List of arguments that are to be used when making the

#                       nominated program.  Key is the program name, the

#                       value is a string of arguments to apply.  The

#                       arguments are '$;' separated.

#  %SCRIPTS             List of scripts to 'create' (key) and whether they

#                       should be made executable or not (value).  Script

#                       set to executable is denoted by the value being

#                       defined AND true.

#  %INSTALL_PROGS       List of programs for "public" cosumption to install

#                       where (key) is the file and where to install it

#                       to vs. (value) which is composed of the original

#                       location of the file, the destination directory

#                       and a list of service providers this file applies to.

# $ProjectBase          Base of the user's project. This variable is designed to

#                       be used by the user.

#....

require 5.006_001;

use strict;

use warnings;

use Data::Dumper;

use JatsEnv;

use MakeEntry;

use JatsLocateFiles;

use JatsDPackage;

our $ScmVersion             = "2.34";

our $ScmForce               = 0;

our $ScmGlobal              = 0;

our $ScmRelease             = 0;

our $ScmExpert              = 0;

our $ScmInterface           = "interface";      # default 'interface'

our $ScmPackage             = 1;                # package active by default.

our $ScmProcessingRootMake  = 0;                # Processing root makefile.pl

our $ScmPlatformSeen        = 0;                # Platform directive has been seen

our $ScmToolsetVersion      = "";               # version of toolset

our $ScmToolsetIFLAG3       = 0;                # IFLAGS3 support disabled

our $ScmToolsetGenerate     = 1;                # generate active by default.

our $ScmToolsetProgDependancies = 1;            # 1: Write program dependancies

                                                # 0: Don't write progdeps. Prog is Phony

our $ScmToolsetProgSource   = ();               # Toolset Program Source

our $ScmRoot                = "";

our $ScmMakelib             = "";

our $ScmPlatform            = "";

our $ScmMachType            = "";

our $ScmSrcDir              = "";

our @ScmPlatformDirs        = ();

our @ScmPlatformArgs        = ();

our $ScmProduct             = "";

our $ScmTarget              = "";

our $ScmTargetHost          = "";

our $ScmToolset             = "";

our @ScmToolsetArgs         = ();

our @ScmDepends             = ();

our %ScmSourceTypes         = ();

our $ScmDeploymentPatch     = "";

our $ProjectBase            = "";               # Base of the user's project

our $ScmNoToolsTest         = "";               # Supress compiler tests

our $ScmDependTags          = 0;                # Create dependancy scanning tag

our @CFLAGS                 = ();

our @CFLAGS_DEBUG           = ();

our @CFLAGS_PROD            = ();

our @CLINTFLAGS             = ();

our @CLINTFLAGS_DEBUG       = ();

our @CLINTFLAGS_PROD        = ();

our @CXXFLAGS               = ();

our @CXXFLAGS_DEBUG         = ();

our @CXXFLAGS_PROD          = ();

our @CXXLINTFLAGS           = ();

our @CXXLINTFLAGS_DEBUG     = ();

our @CXXLINTFLAGS_PROD      = ();

our @ASFLAGS                = ();

our @LDFLAGS                = ();

our @INCDIRS                = ();

our @NODEPDIRS              = ();

our @S_INCDIRS              = ();

our @G_INCDIRS              = ();

our @L_INCDIRS              = ();

our @SRCDIRS                = ();

our @S_SRCDIRS              = ();

our @G_SRCDIRS              = ();

our @L_SRCDIRS              = ();

our @LIBDIRS                = ();

our @S_LIBDIRS              = ();

our @G_LIBDIRS              = ();

our @L_LIBDIRS              = ();

our %SRCS                   = ();

our %SRC_ARGS               = ();

our %SRC_TYPE               = ();

our %SRC_DEPEND             = ();

our %SCRIPTS                = ();

our @COPYIN                 = ();

our @INITS                  = ();

our @DEFINES                = ();

our @OBJS                   = ();

our %SHOBJ_LIB              = ();

our @PROGOBJS               = ();

our %OBJSOURCE              = ();

our @CHDRS                  = ();

our @CSRCS                  = ();

our @CXXSRCS                = ();

our @ASHDRS                 = ();

our @ASSRCS                 = ();

our @GENERATED              = ();

our @GENERATED_NOTSRC       = ();

our @RULES                  = ();

our @TOOLSETRULES           = ();

our @TOOLSETDIRS            = ();

our @TOOLSETDIRTREES        = ();

our @TOOLSETGENERATED       = ();

our @USERGENERATED          = ();

our @TOOLSETOBJS            = ();

our @TOOLSETLIBS            = ();

our @TOOLSETPROGS           = ();

our %INSTALL_HDRS           = ();

our %INSTALL_CLSS           = ();

our @LIBS                   = ();

our %LIB_OBJS               = ();

our %LIB_ARGS               = ();

our %LIB_PKG                = ();

our %LIB_INS                = ();

our %INSTALL_LIBS           = ();

our @MLIBS                  = ();

our %MLIB_LIBS              = ();

our %MLIB_ARGS              = ();

our @SHLIBS                 = ();

our @SHLIB_TARGETS          = ();

our %SHLIB_VER              = ();

our %SHLIB_OBJS             = ();

our %SHLIB_LIBS             = ();

our %SHLIB_ARGS             = ();

our %SHLIB_PKG              = ();

our %SHLIB_INS              = ();

our %INSTALL_SHLIBS         = ();

our %TESTPROGS              = ();

our %TESTPROG_OBJS          = ();

our %TESTPROG_LIBS          = ();

our %TESTPROG_ARGS          = ();

our @PROGS                  = ();

our @PROGS_EXTRA            = ();

our %PROG_OBJS              = ();

our %PROG_LIBS              = ();

our %PROG_ARGS              = ();

our %PROG_PKG               = ();

our %PROG_INS               = ();

our %INSTALL_PROGS          = ();

our %PACKAGE_DIST           = ();

our %PACKAGE_SETS           = ();

our %PACKAGE_HDRS           = ();

our %PACKAGE_LIBS           = ();

our %PACKAGE_CLSS           = ();

our %PACKAGE_SHLIBS         = ();

our %PACKAGE_PROGS          = ();

our %PACKAGE_FILES          = ();

our @PACKAGE_VARS           = ( '%PACKAGE_CLSS',  '%PACKAGE_FILES', '%PACKAGE_HDRS',

                                '%PACKAGE_LIBS',  '%PACKAGE_PROGS', '%PACKAGE_SHLIBS' );

our @INSTALL_VARS           = ( '%INSTALL_CLSS',  '%INSTALL_HDRS',  '%INSTALL_LIBS',

                                '%INSTALL_PROGS', '%INSTALL_SHLIBS');

our @LINTLIBS               = ();

our @LINTSHLIBS             = ();

our @TESTS_TO_RUN           = ();

our @TESTPROJECT_TO_URUN    = ();

our @TESTPROJECT_TO_ARUN    = ();

my  $TESTS_TO_AUTORUN       = undef;

#our $CurrentTime           = "";

#our $CurrentDate           = "";

#our $Cwd                   = "";

our @GENERATE_FILES         = ();

our %DEPLOYPACKAGE          = ();

#

#   Some toolset options that affect the generation of the makefile

#

our $UseAbsObjects          = 0;                # Default is relative paths to objects

our $UseRelativeRoot        = 0;                # Default is absolute paths to build root

###############################################################################

#

#   Packaging and Installation Information

#   Held in a structure as its used in a few places

#   Items

#       PBase   - Package Base directory. Used for user overrides

#       IBase   - Local Install Base directory

#       Dir     - Default directory suffix for components. Added to Pbase and IBase

#

#

our %PackageInfo = (

    'File' => { 'PBase' => '$(PKGDIR)'       ,'IBase' => '$(LOCALDIR)'       , 'Dir' => '' },

    'Hdr'  => { 'PBase' => '$(INCDIR_PKG)'   ,'IBase' => '$(INCDIR_LOCAL)'   , 'Dir' => ''},

    'Lib'  => { 'PBase' => '$(LIBDIR_PKG)'   ,'IBase' => '$(LIBDIR_LOCAL)'   , 'Dir' => '/$(GBE_PLATFORM)'},

    'Prog' => { 'PBase' => '$(BINDIR_PKG)'   ,'IBase' => '$(BINDIR_LOCAL)'   , 'Dir' => '/$(GBE_PLATFORM)$(GBE_TYPE)'},

    'Jar'  => { 'PBase' => '$(CLSDIR_PKG)'   ,'IBase' => '$(CLSDIR_LOCAL)'   , 'Dir' => ''},

    'Tool' => { 'PBase' => '$(PKGDIR)'       ,'IBase' => '$(LOCALDIR)'       , 'Dir' => '/tools/bin/$(GBE_HOSTMACH)'},

    );

MakeLib2Init();                                 # Runtime initialisation

sub MakeLib2Init

{

#.. Test environment

#

    EnvImport( "GBE_CORE" );

    EnvImport( "GBE_BIN" );

    EnvImport( "GBE_PERL" );

    EnvImport( "GBE_TOOLS" );

    EnvImport( "GBE_CONFIG" );

    EnvImport( "GBE_MACHTYPE" );

#.. Common stuff

#

    require "$::GBE_TOOLS/common.pl";           # Common stuff

    push( @ScmDepends, "$::GBE_TOOLS/common.pl" );

    CommonInit( "makelib2" );

    Debug( "version:   $ScmVersion" );

#.. Cache arguments

#

    CommandLine();

#.. Build defaults

#

    $ScmSourceTypes{ ".h" }     = ".h";

    $ScmSourceTypes{ ".hpp" }   = ".h";

    $ScmSourceTypes{ ".c" }     = ".c";

    $ScmSourceTypes{ ".C" }     = ".c";

    $ScmSourceTypes{ ".cpp" }   = ".cc";

    $ScmSourceTypes{ ".cc" }    = ".cc";

    $ScmSourceTypes{ ".asm" }   = ".asm";

    $ScmSourceTypes{ ".x" }     = "--Ignore";

    $ScmSourceTypes{ ".ini" }   = "--Ignore";

    $ScmSourceTypes{ ".sh" }    = "--Ignore";

    $ScmSourceTypes{ ".pl" }    = "--Ignore";

    $ScmSourceTypes{ ".awk" }   = "--Ignore";

#.. Get the stuff from the build configuration file

#

    ConfigLoad();

    if ( defined(%::ScmBuildPlatforms) )        # Interface/build.cfg

    {

        AddPlatformArg( split( /$;/, $::ScmBuildPlatforms{ $ScmPlatform } ));

    }

    if ( defined(%::ScmBuildIncludes) )         # Interface/build.cfg

    {

        my( @includes ) = split( ',', $::ScmBuildIncludes{ $ScmPlatform } );

        my( $global ) = $ScmGlobal;

        $ScmGlobal = 1;                         # Follow defs are "global's" ...

        foreach my $elem ( @includes )

        {

            AddIncDir( "*", $elem ) if ($elem);

        }

        $ScmGlobal = $global;                   # Restore global status ...

    }

    if ( defined(%::ScmBuildLibraries) )        # Interface/build.cfg

    {

        my( @libraries ) = split( ',', $::ScmBuildLibraries{ $ScmPlatform } );

        my( $global ) = $ScmGlobal;

        $ScmGlobal = 1;                         # Follow defs are "global's" ...

        foreach my $elem ( @libraries )

        {

            AddLibDir( "*", $elem ) if ($elem);

        }

        $ScmGlobal = $global;                   # Restore global status ...

    }

    #

    #   Ensure that Data::Dumper module is available and has been loaded

    #

    $::ScmProjectSupport = (eval "require Data::Dumper")

        if ( $::ScmProjectSupport );

#.. Determine the value of $ScmMachType

#   In the makefile GBE_MACHTYPE will be set to $ScmMachType.

#

#   There is an compatibility issue here.

#   A lot of (legacy) package.pl files use GBE_MACHTYPE to specify platform

#   specfic directories and names. This is not to be encouraged.

#

#   Allow for a platformm specific override

#

    if ( exists( $::BUILDINFO{$ScmPlatform}{'SCMMACHTYPE'} ))

    {

        $ScmMachType = $::BUILDINFO{$ScmPlatform}{'SCMMACHTYPE'};

        Verbose("Override ScmMachType: $ScmMachType");

    }

    else

    {

        $ScmMachType = $ScmPlatform;

    }

#.. Get the stuff from the Package definition file

#   A convention is that package.pl provide a package name via $Pbase

#   This may be different to the BUILDNAME. Generate a default $Pbase

#   to allow the package.pl to use the package name part of the buildname

#

    $::Pbase = $::ScmBuildPackage;

    if ( -f "$ScmRoot/package.pl" )

    {

        Warning ("package.pl file used. Use is being deprecated");

        my( $global ) = $ScmGlobal;             # Follow defs are "global's" ...

        $ScmGlobal = 1;

        require "$ScmRoot/package.pl";

        $ScmGlobal = $global;                   # Restore global status ...

        if ( defined ($::ScmBuildPackage) && defined ($::Pbase) )

        {

            #   Special case.

            #   $Pbase is set to ".". Set $Pbase to the Build Name to force

            #   construction of a well formatted package.

            #

            $::Pbase = $::ScmBuildPackage

                if ( $::Pbase eq "." );

            #

            #   Error if Pbase has changed

            #

            Error ("Pbase is not the same as the BuildName (Check package.pl)",

                   "Pbase    : $::Pbase",

                   "BuildName: $::ScmBuildPackage")

                if ( $::Pbase ne $::ScmBuildPackage );

        }

    }

}

sub CommandLine

{

    my ( $argc, $element );

# Arguments

#

    $ScmRoot     = ${ARGV[0]};

    $ScmRoot = RelPath( $ScmRoot );

    $ProjectBase = $ScmRoot;

    $ScmMakelib  = ${ARGV[1]};

    $ScmPlatform = ${ARGV[2]};

    $ScmTarget   = $ScmPlatform;

    Message ("[$ScmPlatform] Generate Makefile");

    Debug( "root\t=$ScmRoot" );

    Debug( "makelib\t=$ScmMakelib" );

    Debug( "platform\t=$ScmPlatform" );

    $argc        = 3;

    while ($_ = $ARGV[ $argc++ ]) {

        last if ( ! /^-/ );                     # not an option

        Debug( "option:    $_" );

        /^-h$|^-help$|^--version$|^--help$|^--usage$|^-?$/ && Usage();

                                                # long arguments

        next if (/^--interface=(.*)/ && ($ScmInterface = $1));

        next if (/^--arg=(.*)/ && AddPlatformArg( "--$1"));

        next if (/^--release/ && ($ScmRelease = 1));

        next if (/^--dist/ && ($ScmRelease = 2));

        next if (/^--expert/ && ($ScmExpert = 1));

        next if (/^--all/);

        last if (/^--$/);                       # End of long arguments

        if (/^-D(.*)/) {

            if ($1) {

                $::ScmDebug = $1;

            } else {

                $::ScmDebug = $ARGV[0];

                $argc++;

            }

            next;

        }

        next if (/^-V/ && ($::ScmVerbose = 1));

        next if (/^-F/ && ($ScmForce = 1));

        /^-.*/ && Usage();

    }

}

#   Usage ---

#       Command line usage help.

#..

sub Usage

{

    print "" .

"Usage: perl Makefile.pl2 <ROOTDIR> <Makelib.pl2> <PLATFORM> [options ...]

Valid options:

\t-V                Verbose mode

\t-D[debug-level]   Set the debug level

\t-F                Force rebuild

\t--release         Create a release sandbox

\t--dist            Create a distribution sandbox, like a 'release'

\t                  except all GBE support files are removed (eg CVS).

\n";

    exit(42);

}

#-------------------------------------------------------------------------------

# Function        : SubDir

#

# Description     : Include a sub-makefile

#                   When called when processing by this script this directive

#                   does nothing. The processing will be done by makelib.pl

#

#                   This directive MUST occur before the Platform directive

#

# Inputs          : None that are used

#

# Returns         : Nothing

#

sub SubDir

{

    Error ("SubDir directive not allowed after the Platform directive")

        if ( $ScmPlatformSeen );

}

###############################################################################

#   Platform support

###############################################################################

sub Platform

{

    my( $global, $file );

    Debug( "Platform( $ScmPlatform, @ScmPlatformArgs )" );

#.. Sanity test

#

    Error ("Platform directive is not allowed in common makefile.pl")

        if ( $ScmProcessingRootMake );

    Error ("Only one Platform directive is allowed")

        if ( $ScmPlatformSeen );

    $ScmPlatformSeen = 1;

#.. Arguments

#

    $ScmTargetHost = $::ScmHost;                # default

#.. Common configuration

#

    $global = $ScmGlobal;                       # Follow defs are "global's" ...

    $ScmGlobal = 1;

#.. Common rules (ScmHost specific)

#

    push( @ScmDepends, "$ScmMakelib" );         # parent

    $file = Require( "$::GBE_CONFIG", "Rules", "Common rules " );

    push( @ScmDepends, "$file" );

    require "$::GBE_TOOLS/makeif.pl";           # plug-in interface

    push( @ScmDepends, "$::GBE_TOOLS/makeif.pl" );

#.. Platform (defines ScmToolset)

#

    if ( defined( %::ScmBuildProducts ) &&      # interface/build.cfg

            $::ScmBuildProducts{ $ScmPlatform } )

    {

        my( @args ) = split( ',', $::ScmBuildProducts{ $ScmPlatform } );

        $ScmProduct = $args[0];

        $ScmTarget = $args[1];

        Debug( " mapping to product $ScmProduct" );

                                                # Platform/target specific

        MakeIf::PackageDirs( \@ScmPlatformDirs, $ScmPlatform, $ScmTarget );

        push @ScmPlatformDirs, "$::GBE_CONFIG"; # .. plus default

        @ScmPlatformArgs = ( "--product=$ScmProduct", @ScmPlatformArgs );

        $file = Require( "PLATFORM", $ScmTarget,

                    "Platform definition ", @ScmPlatformDirs );

    }

    else                                        # standard

    {

        Debug( " native platform" );

                                                # Platform specific

        MakeIf::PackageDirs( \@ScmPlatformDirs, $ScmPlatform );

        push @ScmPlatformDirs, "$::GBE_CONFIG"; # .. plus default

        $file = Require( "PLATFORM", $ScmPlatform,

                    "Platform definition ", @ScmPlatformDirs );

    }

    push( @ScmDepends, "$file" );

    Error( "Toolset undefined for platform $ScmPlatform ...")

        unless( $ScmToolset );

#.. Toolset

#

    $file = Require( "$::GBE_TOOLS/LIB", "ToolsetPrinter.pm", "Toolset common components " );

    push( @ScmDepends, "$file" );

    $file = Require( "$::GBE_CONFIG/TOOLSET", $ScmToolset, "Toolset definition " );

    push( @ScmDepends, "$file" );

#.. Package definitions

#

#   a)  Firstly the static buildlib.pl generated search paths, which

#       are $ScmPlatform specific.

#

#   b)  Secondly the global DPACKAGE definitions, which may pull in

#       $ScmTarget specific definitions.

#

    if ( -e "$ScmRoot/$ScmInterface/$ScmPlatform.rul" )

    {                                           # static configuration

        Defines( "$ScmRoot/$ScmInterface", "$ScmPlatform.rul" );

    }

    MakeIf::PackageLoad( $ScmPlatform );        # DPACKAGE's (if any)

#.. Package extensions

#   Import, into the current package, files of the form gbe/DIRECTIVES

#   These allow the JATS directives to be extended by the contents of a package

#   without the need to update the core JATS release.

#

#   Intended use: Associate a directive with a tool script, such that the

#   new directive simplifies the use of the tool script.

#

#

#   First: Extend the Perl Search Space to include the toolset extensions

#          Although the directives are in gbe/DIRECTIVES/*.pm, they may need

#          to reference other packages that are not.

#

    for my $path ( ToolExtensionPaths() )

    {

        UniquePush (\@INC, $path)

            if (glob( "$path/*.pm") || glob( "$path/*/*.pm"));

    }

    for my $entry (@{$::ScmBuildPkgRules{$ScmPlatform} })

    {

        my $cfgdir = $entry->{'CFGDIR'};

        next unless ( $cfgdir );

        my $base_dir = $entry->{'ROOT'} . $cfgdir . '/DIRECTIVES';

        next unless ( -d $base_dir );

        foreach my $file  ( glob ("$base_dir/*.pm") )

        {

            push( @ScmDepends, "$file" );

            require $file;

        }

    }

    #

    #   All makefile.pl's will include a makefile.pl found in the build

    #   root directory ( The same directory as build.pl ). This makefile.pl

    #   is a little bit different - It should not "require "$ARGV[1]", nor

    #   should it use a Platform directive.

    #

    #   Note: This makefile is processed AFTER the toolset has been initialised

    #         so that toolset extensions are available to the directives

    #

    $file = "$ScmRoot/makefile.pl";

    if ( -e $file ) {

        $ScmProcessingRootMake = 1;

        require "$file";

        $ScmProcessingRootMake = 0;

        push( @ScmDepends, "$file" );

    }

    #

    #   Restore global status ...

    #

    $ScmGlobal = $global;

}

sub PlatformRequire

{

    my( $script, @arguments ) = @_;

    my( $file );

    Debug( "PlatformRequire($script, @arguments)" );

    push( @ScmPlatformArgs, @arguments );       # additional arguments

    $file = Require( "PLATFORM", $script,

                "PlatformRequire ", @ScmPlatformDirs );

    push( @ScmDepends, "$file" );

}

sub PlatformInclude

{

    my( $script, @arguments ) = @_;

    my( $file );

    Debug( "PlatformInclude( @_ )" );

    $file = Require2( \@arguments, "PLATFORM", $script,

                "PlatformInclude ", @ScmPlatformDirs );

    push( @ScmDepends, "$file" );

}

sub PlatformDefine

{

    Debug2( "PlatformDefine(@_)" );

    Define( @_ );

}

sub PlatformDefines

{

    my( $script ) = @_;

    my( $line );

    Debug2( "PlatformDefine(@_)" );

    $script = Exists( "PLATFORM", $script,      # locate image

                "PlatformDefines", @ScmPlatformDirs );

    open( SCRIPT, $script ) || Error( "Opening $script" );

    while (<SCRIPT>) {

        $_ =~ s/\s*(\n|$)//;                    # kill trailing whitespace & nl

        push( @DEFINES, $_ );

    }

    push( @ScmDepends, "$script" );             # makefile dependencies

    close( SCRIPT );

}

sub PlatformEntry

{

    my( $prelim, $postlim, $prefix, $postfix, @elements ) = @_;

    my( $str, $element );

    $str = "$prelim";

    foreach $element ( @elements )

    {

        $str .= "${prefix}${element}${postfix}";

    }

    $str .= "$postlim";

    PlatformDefine( $str );

}

#

#   Add arguments to the ScmPlatformArgs, but remove "Global" arguments

#       --OnlyDebug

#       --OnlyProduction

#