/=====================================================================\
|                             DIPGREP                                 |
|                           v1.0  3/15/95                             |
|                          By Albert Macias                           |
|                       albertm@hfl.tc.faa.gov                        |
|                                                                     |
\=====================================================================/

This is the information file that explains the Dipgrep program.

The name Dipgrep comes from the UNIX grep command. Grep means Global
Regular EXpression and can be used to search in files for character
strings, among other things. Dipgrep allows you to search the Hall of
Fame data file for records you specify. Each record in the data file
is made up of fields. The fields are:

 1. Player                    (John Smith)
 2. Variant code              (aa000A)
 3. Gunboat code              (A)
 4. Press settings            (WP--)
 5. Irregularity codes        (Hopefully none)
 6. Access code               (A)
 7. Judge                     (USEF)
 8. Game name                 (love)
 9. EP number                 (94-069)
10. Boardman/Miller number    (1994LV)
11. Year/month game started   (December of 1993 would be 9312)
12. Year/month game ended     (June of 1994 would be 9406)
13. Power letter              (A)
14. Power name                (Austria)
15. Year player joined game   (1900)
16. Year player left game     (1906)
17. Game result               (Repl; AFG draw in F1914)
18. Number of hof points      (.57)
19. Were hof points awarded   (1 = yes, 0 = no)
20. Email address of player   (jsmith@heaven.gov)

You can search on almost every field in the data file.
For example, you can search for a player and see all the games the
person has played in. The search abilities of Dipgrep is very powerful.
Dipgrep will print all the records that match your search criteria to
the screen or to a file. You can pick which fields from each found
record you want to include in the output, and you can pick the order
that the fields will appear.

You can get the latest Hall of Fame data file by ftp from
sunburn.uwaterloo.ca in the pub/nick/diplomacy directory.
The Hall of Fame data file for DOS users is called halldata.zip.
The file is 379193 bytes and is over 2 MB when uncompressed.
UNIX users should get halldata.tar.Z.
It is 563617 bytes and is over 2 MB when uncompressed.

Dipgrep was written in C and has been compiled on every type
of UNIX machine I could find including; SUN, IBM, SGI and HP.
The code can also be compiled on a DOS machine with no changes.
Sorry, no Apple version is available.

How to get the source code for Dipgrep for UNIX.
1. Get dipgrep.tar.Z by ftp from sunburn.uwaterloo.ca or nda.com.
2. Uncompress the file with: uncompress dipgrep.tar.Z
3. Untar the file with: tar xvf dipgrep.tar
4. Use the included makefile to compile dipgrep with: make
5. Edit the config.dip file to set up the search parameters.
6. Waste lots of time using Dipgrep.
You may have to modify the makefile to point to the include files
Dipgrep needs. Email me if you can't find anyone at your site to help.

How to get the po'boys DOS executable.
1. Get dipgrep.zip by ftp from sunburn.uwaterloo.ca or nda.com.
2. Unzip the file with any pkunzip compatible program.
3. Edit the config.dip file to set up the search parameters.
4. Waste lots of time waiting for Dipgrep to finish the search.
I have tested Dipgrep on a 286 PC with 640k of memory and
it worked fine. Email me if you have problems.
The source code for DOS users is in the file dipcode.zip.
There is no difference between the UNIX code and the DOS code.

Dipgrep.zip:   28,851 bytes.
Dipcode.zip:   18,884 bytes.
Dipgrep.tar.Z: 27,948 bytes.

I would like to thank Nick Fitzpatrick for his help with the Hall of
Fame data format. I would also like to thank Conrad Minshall. I used
his DSI program as a starting point for Dipgrep. Although you would
have to look closely to find Conrad's code in Dipgrep (there is some),
some of the ideas and programming techniques used in Dipgrep were
originally Conrad's. I am making the source code for Dipgrep available
for free. I give permission to modify the code for your personal use
and to distribute the modified code for free to others. Incorporating
this code into any program that would be for sale would be looked down
upon. Not that I have anything against making a buck, but the world
needs more freebies and less greed.

Albert
(Job Supports Wife to Mall)