How to run this test and interpret the results:
-----------------------------------------------

  - Make sure the compiler is in your PATH
  - run 'make' to build the test read_ali driver
  - From this directory, launch the run_regression_test.sh script
    (this script assumes that it was launch from the directory where
     read_ali is located).

    What this script does is that it goes into each subdirectories of
    the current directory, and look for 2 files:
       + build: This file should contain the build commands. It is
         executed first.
       + test.cmd: This file should contain the commands needed to
         perform the regression test. It is executed immediately after.
    If either of these two files is missing, then the test is skipped.
    The output of test.cmd is then compared against the file called
    test.out, and any difference is reported.

Here is a typical output of the script, where you can see 1 test that failed,
producing some differences, and one test that passed.

<<
==========   Tests output  ============
---------  9528-013__typeref_entities
*** test.out	Fri Nov 30 09:45:44 2001
--- output	Fri Nov 30 09:45:44 2001
***************
*** 8,14 ****
  
  U derived%s derived.ads
  
! D derived.adsD system.ads
  
  X derived.ads
  6i4*Global_Gnat 
--- 8,15 ----
  
  U derived%s derived.ads
  
! D derived.ads
! D system.ads
  
  X derived.ads
  6i4*Global_Gnat 
---------  9529-003__binary_operators
==========   Build output  ============

--  Building in 9528-013__typeref_entities:

--  Building in 9529-003__binary_operators:
>>
    
How to add a new regression test:
---------------------------------

It's very easy. Create a new subdirectory where you create the following
files:
  - your sources
  - build: this file should contain the commands to compile your sources
    and generate the ali files
  - test.cmd: this file should contain the commands to to run the
    regression test.
  - test.out: this file should contain the output from stdout *and*
    stderr of test.cmd.

Some notes about this regression test suite:
--------------------------------------------

  - dummy.gpr is a dummy project. I need it because the current src_info
    API needs a valid project. I can't create it by hand just the way we
    do when we create a default project because we would miss the spec
    and body suffices for Ada files, which would lead src_info to blow
    up...
