Installation instructions:
  Compile counter and install as a cgi-bin.
  Consult the documentation for your httpd for instructions on how to
  set up cgi-bin links.  At most sites, only the webmaster can install
  cgi-bin programs.


To compile for Unix:
  Edit Makefile and counter.c to adjust appropriate items (see below).
  If you do not have an ANSI compiler, things will be difficult.
  After you have adjusted the items below, type 'make' to compile the counter.

  In Makefile:
    GIFTOPNM is no longer directly used in the makefile, as all built in
      images have already been converted to pgm format.  If you add more
      images or fonts that are not pgm, you may need this.
    CFLAGS  adjust as apporpriate...  the default flags are for gcc.
      If you are not using gcc, you can probably remove all flags,
      and put in whatever optimization flags work with your compiler.
    LIBS  If dbm is not included directly in your libc, uncomment this.

  In counter.c: 
    DBbase  is the prefix for all the database and lock files.  Set this to
       the directory (ending in a /) to place the database files and lockfiles.
    DB_COUNT and DB_URL do not usually need adjusting unless you don't like
       the filenames I used.
    HOST and Doc_url give the URL location of the counter's documentation
    DB_PERMS  permissions the database will be created with
    MAX_URL   length that url's will be truncated to in the URL database

    USE_FCNTL USE_LOCKF USE_FLOCK  Pick one of these; USE_FCNTL should work
      on most systems.  If none of these are available on your system,
      a new lockfile method may be needed.  Or, you can try running without
      a lockfile (possibly dangerous!).  I have begun to suspect that at
      least some implmentations of ndbm automatically do locking internally,
      so this may be redundant.

  If you can't get this to work, or have patches or ideas or more fonts or
  bugs in my documentation, etc., send me mail!
  
  Note: Several of the .c and .h files should be built automatically in
  the makefile.  If they are not, your make is probably buggy.
  I found that some versions of make might require you to run make more than
  once to generate these files.

To add another font:
  The font must be added in three places:
    1) In the makefile, add a rule to convert the images to pgm and
       run them through digits2c.  There are several examples commented
       out for non-pgm images.
    2) In fontlist.c, add an #include for the header file that will
       be generated for the font, and add the font to the FontList array
       initialization.
    3) Add the font to the documentation for your counter so that people
       know about it.
    4) If you feel the font is worthy, send it to me, so everyone else
       can enjoy it.  :)

  Adding rejection images is slightly more difficult, as it would
  involve adding if statements in appropriate places in counter.c.

To compile the counter on non-unix platforms:
  If your platform supports dbm or ndbm and is POSIX compliant and
  has make, it may be trivial to get the counter working.  Otherwise
  some work may be required.  If you succeed in getting my counter working
  on a non-unix platform, please let me know!  If you would like help
  porting it to your non-unix platform, I may be able to give suggestions
  on unix specific parts of the code.  More detailed porting ideas
  can be found in  http://www-mae.engr.ucf.edu/~ssd/counter/c.html

Look in 'scripts.doc' for hints on how to use the administration scripts
I've written and disable counters that are causing your site problems.

	Steve
	ssd@mae.engr.ucf.edu
