Date: June 11, 1999

NOTE: In the following document, the string "shelf_x.y" represents the actual pathname of the directory into which you installed SHELF. For example, if you install shelf in /opt/shelf_1.3, then "shelf_x.y/src" represents /opt/shelf_1.3/src on your machine.

Getting Started

Installing SHELF
Getting ready to build
Building SHELF
Running SHELF
Using SHELF

Installing SHELF top of page

The web site or organization that supplied SHELF to you should also supply installation instructions. If you download SHELF from www.applixware.org, you must do the following:

% gzip -d SHELF_x.y.src.tar.gz

% tar -xvf SHELF_x.y.src.tar

Getting ready to build top of page

First, read README.txt, which describes the build process in detail.

Next, run the Test-Shelf.bsh script, which will verify that your system has the proper environment for building and running SHELF, which is as follows:

% cd shelf_x.y

% ./Test-Shelf.bsh

If the script detects problems, you will need to fix them (e.g., by moving or symbolically linking certain utilities, etc.) The script may also direct you to edit an include file; follow the instructions carefully.

SHELF uses a special build process called amake, which itself must be created from another script as follows:

% cd ./src/amake

% ./amake.bsh LINUX

This should create amake, acpp, and acproto in the "shelf" directory. These executables are necessary to build SHELF.

Building SHELF top of page

Once you have these programs, invoke amake as follows:

% cd ../..

% ./amake shelf

This builds the debug version of the X Window System-based SHELF. This includes all the tools, dialogs, and images for the standard SHELF release.

To build the optimized version instead, do the following:

% ./amake -o shelf

Hint: When build errors are encountered, use the -v flag for a verbose build. This will help you pinpoint and analyze build issues. However, do not use this flag on the very first build, because spurious errors will be generated and you will have to do another build to clean them up.

The actual executable will be named delf (for the debug version) or elf (for the optimized version) and will be located in shelf_x.y/exec.

Running SHELF top of page

To invoke the debug SHELF, do the following:

% cd exec

% delf

For the optimized version, do the following

% elf

Using SHELF top of page

To find out how to create and run ELF and Builder applications in SHELF, refer to our Using SHELF document. Sample applications are available for download at www.applixware.org