Howto create a new package for the NPA makefile
-----------------------------------------------

- Note: you need the standard NPA setup in order to build a package
under the NPA makefile system, ie:

source /afs/slac/g/npa/setup/npa.csh


- cd to your build area, checkout the package 'release', assign a name
  to it (<mydir>) and cd to it:

cd <build>
cvs co -d <mydir> release
cd <mydir>


- create the new package(s):

./make/tools/pkgcreate.py --project <project> --package <package_a>
./make/tools/pkgcreate.py --project <project> --package <package_b>
...


- edit the list of projects in your build in:

./projects.mk


- edit the list of packages for your project in:

./<project>/packages.mk


- edit the list of constituents for your package(s) in:

./<project>/<package>/constituents.mk


- The generic form of a make target specification is:

gmake [<proj>[.<pkg>].]<architecture>[-opt][-dbg][.<rule>]

Currently the supported values for <architecture> are:

i386-linux
ppc-rtems-rce405

The supported values for <rule> are:

all
dir
obj
lib
bin
clean
cleanall
userall
userclean
print

If no rule is specified, 'all' is assumed.

Examples of valid build commands hence are:

gmake i386-linux               # Build 'all' for every package for linux 
gmake i386-linux.lib           # Build linux libraries
gmake rce.i386-linux.clean     # Delete objects built for project rce
gmake rce.elf.i386-linux.clean # Delete objects built for package elf
gmake i386-linux.cleanall      # Delete linux build directory structure
gmake ppc-rtems-rce-opt        # Build optimized code for rtems
gmake ppc-rtems-rce-opt-dbg    # Build optimized code with debugging symbols

Note that gmake may be invoked from the top level (<mydir>), from the
project level (<mydir>/<project>) or from the package level
(<mydir>/<project>/<package>). In the second case the current working
directory defines the project. In the third case the current working
directory defines both the project and the package.