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.
Installing SHELF
Getting ready to build
Building SHELF
Running SHELF
Using SHELF
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
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.
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.
To invoke the debug SHELF, do the following:
% cd exec
% delf
For the optimized version, do the following
% elf
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