This readme file gives installation and use instructions that are different
from the ones given in the file readme.txt provided with the original
distribution of JEWL.  The original file is included in the folder JEWL.  

These instructions describe several possible ways of using JEWL to 
build an application, starting with the simplest.  Method 3 is preferred. 

These instructions assume that you are creating an application called
my_app.adb in a folder called app_folder.

1.  This method simply puts all of the JEWL files in to the same folder as
    your application.  It is simple, but it adds clutter to app_folder.
    Steps are as follows:

    a. Copy all of the files in JEWL/source into app_folder

    b. Include a with statement for the appropriate package 
        (eg with JEWL.IO) in my_app.adb 

    c. Compile your application as usual: gnatmake my_app.

2.  This method involves a local copy of JEWL for each application, but
    the files are in folders and so there is less clutter.  it needs to 
    be done for every folder in which you build JEWL applications.  
    You also need to create a project file for each application.  
    Steps to install are as follows:

    a. Copy the entire contents of folder JEWLfiles to app_folder.
        (You should copy folders: JEWL and obj,
        and files: JEWL.gpr, hello.gpr, hello.adb, and README.txt) 

    b. Test your installation by compiling hello (gnatmake -P hello.gpr)
        and running hello.exe

    Create your own application as follows:

    c. Copy hello.gpr to my_app.gpr

    d. Edit my_app.gpr and change hello to my_app in 3 places

    e. Create my_app.adb, perhaps using hello.adb as a pattern. 
        Include a with statement for the appropriate package 
        (eg with jewl.io;) in my_app.adb 

    f.  Compile using: gnatmake -P my_app.gpr and run my_app.exe.

3.  The preferred option allows a JEWL application to be in any folder.
    It copies JEWL into a folder, sets an environment variable to access 
    this folder, and then uses a project file in the application folder.  
    Steps to install are as follows:

    a. Decide on a location for your jewl folder 
        (Examples: C:\Software\GNAT or C:\Users\yourname\Software\GNAT).  
        Assume you use C:\Software\GNAT
    b. Create this folder, if necessary.
    c. From folder JEWL-files, copy folder JEWL and file JEWL.gpr
        to folder C:\Software\GNAT:
    d. Set environment variable GPR_Project_Path to point to your install
        folder. In a command window you can use the command
            set GPR_Project_Path=C:\Software\GNAT, 
        but this only works until that command window is destroyed.  
        You can also use the control panel to set the environment variable:
            ControlPanel/System/AdvancedSystemSettings/EnvironmentVariables
            Under User (not System) variables, select NEW and enter
            GPR_Project_Path for the name and C:\Software\GNAT for the value.

    Create your application my_app.adb in folder app_folder as follows:

    e. Create the folder app_folder\obj
    f. Copy the project file JEWL-files\hello.gpr into app_folder
    g. Change the name of hello.gpr to my_app.gpr
    h. Edit my_app.gpr and change hello to my_app in 3 places
    i. Include a with statement for the appropriate package 
        (eg with jewl.IO-windows) in my_app.adb 
    j.  Compile using: gnatmake -P my_app.gpr

    You can test your installation by copying hello.adb from JEWL-files to 
    app_folder, compiling with gnatmake -P hello.gpr, and running hello.exe.

The folder JEWL\examples contains a number of demonstration files.  They
can all be compiled using the project file all-examples with this command:

  gnatmake -P all_examples.gpr

The project file all-examples.gpr expects to find JEWL.gpr in the
grandparent folder.  If option 3 above is followed, then the folder 
example can be moved anywhere if the with statement in the project file 
all-examples.gpr is changed to 

   with "JEWL";


Many thanks to John English for creating the JEWL library and for his very
useful Ada text!