About JEWL.
  -----------

  JEWL (John English's Window Library) is a set of Ada packages aimed at
  novices which enables reasonably sophisticated GUI applications to be
  built with a minimum of effort. This software is released under the
  terms of the GNU General Public License (see the file "copying.htm"
  in the "docs" subdirectory for details). The latest version is always
  available at the JEWL home site, http://www.it.bton.ac.uk/staff/je/jewl/.

  This distribution contains three subdirectories:

  * source   -- the source files for JEWL
  * examples -- example applications developed using JEWL
  * docs     -- documentation in HTML format (see docs/jewl.htm)

  There are three primary packages included in JEWL: 
  
  * JEWL.IO: a substitute for Ada.Text_IO which provides input/output
    facilities for strings and characters, integers, floats, Booleans
    and generic enumeration, integral and floating-point types, as well 
    as useful facilities such as message boxes to display error messages.
    Input is based on GUI dialogs which echo the input received to the
    standard output, so that a standard text-based program can easily be
    transformed into a partially GUI-based program. 

  * JEWL.Windows: a generic package providing a selection of common
    GUI building blocks (frames, dialog windows, buttons, menus, editboxes,
    checkboxes, and so on).

  * JEWL.Simple_Windows: an instantiation of JEWL.Windows for type Character.
    The dialogs in JEWL.IO are built using the facilities in this package.

  Installation instructions.
  --------------------------

  1. Compile the source files. If you are using the GNAT compiler, go into
     the source subdirectory and type: 

         gnatmake jewl-io.adb

     This will generate .ali and .o files for each of the packages 
     which make up the JEWL library. 
      
   
  2. You will need to ensure that the compiler can find the files in the
     source subdirectory. For the GNAT compiler, you can copy the contents
     of this directory into the same directory as your own source code,
     although this is wasteful of disk space. A better solution is to define
     environment variables called ADA_INCLUDE_PATH and ADA_OBJECTS_PATH which
     give the full pathname of the source subdirectory. For example, if you
     use Windows 95/98, add the following lines to your C:\AUTOEXEC.BAT file: 

         set ADA_INCLUDE_PATH=C:\JEWL\source
         set ADA_OBJECTS_PATH=C:\JEWL\source

     (assuming that the path to the source subdirectory is C:\JEWL\source). 
     Other solutions are possible: for example, you can use the -I compiler 
     switch with the GNAT compiler. For details of how your compiler locates
     library files, consult the documentation for the compiler.
     
   
  3. Change to the examples subdirectory and compile the example programs.
     For example, the sketch example (a simple sketchpad) can be compiled
     using GNAT as follows: 

         gnatmake sketch.adb

     or, if you haven't used the ADA_INCLUDE_PATH and ADA_OBJECTS_PATH 
     environment variables as described above, you can specify the path
     to the source subdirectory using the -I switch:

         gnatmake -IC:\JEWL\source sketch.adb
  
  The packages have been tested with the GNAT compiler for Windows NT.
  They should also work with Object Ada, but this has not been tested.
  Although the current version is implemented for Windows only, there
  is nothing platform-specific in any of the package specifications.
  If anyone is interested in porting this to another platform, I'd be
  delighted to hear from you.

                                        John English, November 2001
                                        Contact address: je@brighton.ac.uk