This directory contains the source code for the collection of shells
known as the "Extended Shells" package. Currently, the shells included
are bash, tcsh and zsh.  Other shells may be added in the future.

Each subdirectory has two build scripts: OSR5BUILD and OSR6BUILD. These
are for SCO OpenServer5 and SCO OpenServer 6 respectively.  The OSR6BUILD
script can also be used for compiling for SCO UnixWare 7.

Before compiling these shells, you should make sure you have the latest
version of the GWXLIBS package, and for OpenServer 5, the latest version
of the 'GNU Development Tools' package.

For the Z shell, you should create a directory below the source directory
in which to do the compile, and run ../OSR5BUILD or ../OSR6BUILD.  The
other shells currently build in place.

To create the 'Extended Shells' package, you will need the MetaPKG tool,
and the 'common open source install scripts' package.  For the purposes
of this discussion, I will assume you are using a base directory of
/pi/opensrc for the root of the common open source install scripts.  This
should contain the directories 'data/common', 'dist/osr5' and 'dist/uw7'.
The first step is to copy the contents of the packaging directory to
/pi/opensrc/data:

    cd packaging
    cp -r * /pi/opensrc/data

Next, create a directory that will contain the shells.  The directory must
be called 'extshells'.  Lets call this directory $EXTSH_PI:

    EXTSH_PI=/x/pi/opensrc/extshells
    mkdir -p $EXTSH_PI

Now build and install all of the shells thus:

    cd bash
    mkdir osr5 (or osr6)
    cd osr5 (or osr6)
    ../OSR5BUILD (or ../OSR6BUILD)
    gmake
    gmake install DESTDIR=$EXTSH_PI/bash
    cd ../..

    cd tcsh
    mkdir osr5 (or osr6)
    cd osr5 (or osr6)
    ../OSR5BUILD (or ../OSR6BUILD)
    gmake
    gmake install DESTDIR=$EXTSH_PI/tcsh
    gmake install.man DESTDIR=$EXTSH_PI/tcsh
    cd ../..

    cd zsh
    mkdir osr5 (or osr6)
    cd osr5 (or osr6)
    ../OSR5BUILD (or ../OSR6BUILD)
    gmake
    gmake install DESTDIR=$EXTSH_PI/zsh
    cd ../..

    cd ksh93
    make
    make install DESTDIR=$EXTSH_PI/ksh93
    cd ..

A small wrapper script that does exact this is included, called BUILD.sh.
Run it with two arguments, the first fo which is one of osr5, osr6 or uw7,
for the OS type you are building on, and the second is the directory that
will contain the builds ($EXTSH_PI).  For example:

    EXTSH_PI=/x/pi/opensrc/extshells
    mkdir -p $EXTSH_PI
    ./BUILD.sh osr5 $EXTSH_PI

Once the shells are build, you need to create a cpio archive of $EXTSH_PI
and put it in the correct distribution directory in /pi/opensrc/dist.  You
MUST create the archive such that it starts with the directory 'extshells':

    cd /x/pi/opensrc
    find extshells | cpio -oc -O /pi/opensrc/dist/osr5/extshells.cpio
       or
    find extshells | cpio -oc -O /pi/opensrc/dist/uw7/extshells.cpio

You would then build any other open source packages you want to create
packages for, putting their contents in the appropraite cpio archives
in /pi/opensrc/dist, and when you are done, run the main open source
integration script:

    cd /pi/opensrc
    ./mkopensrc osr5 (or osr6 or uw7 or all)

If you are only building a subset of the packages defined by the common
opensource integration script, you will need to set various environment
variables to tell mkopensrc that.  See the README file in that dirctory
for details.
