README: Waffle Vacation Droid, Version 1.7.1

--
Waffle Vacation Droid.

  Vacation processes mail files in Waffle's user directories.  Its
  operation is conditioned on command line options.  Vacation may be
  run from the command line, a Waffle extern command, "RUN.BAT" or
  the SCHEDULE file.
  
  A list of all mail for all users is written to stdout when Vacation
  is run with no options.  The list shows which user, based on
  the directory name, has mail; the sender of the mail is listed.

  Vacation attempts to detect and inhibit bounce loops.  Vacation
  will not reply to any "From:", "Reply-to:", or "Sender:" address
  containing the string "MAILER-DAEMON". Vacation will detect and
  suppress replies to mail from another VacationDroid program.


Syntax: vacation [options]

  where options are:

  -v    vacation operates in verbose mode; Each mail file listed shows the
        date, sender, subject line contained in the message.
  
  -h    if a user directory has a file named "vacation" the program
        will mail that file to the sender of any new mail in the
        directory.  A log of all automatic replies is written to the 
        file VACLOG in Waffle's ADMIN directory.

        When Waffle 1.65 mail folders are being processed, new mail
        is determined by a flag in the mailbox.i file. Vacation updates
        the flag for each piece of mail he sends the automatic reply
        to. Don't ask where the flag is.
  
  -q    the "splash" is not written to the screen.
  
  -d    some diagnostic data is written to stdout.  Use this option
        if you are having a hard time getting vaction to run. Some users
        have reported problems; in each case it has turned out to be some
        strangeness with their Waffle static file.

  -u username  This option causes the directory for "username" to be 
        processed. No other user directories are processed. All other
        options apply to the processed directory.

The special case where '-h' and '-u username' are coded cause
vacation to process only the directory for username and only then if
the vacation file exists.


Examples:

  vacation 
        Displays all mail.

  vacation -h
        Generates automatic replies for all mail in all user 
        directories having a "vacation" file.
        
  vacation -u gork
        Displays mail for user "gork".

  vacation -h -u gork
        Sends the automatic reply for user "gork" if gork has a file
        named "vacation" in his user directory.


Hint:

  Make a file, "pmail", in the waffle/extern directory. The file
  should contain this (customize for your site):

    pmail /command="f:\waffle\bin\vacation -v -q -u %A" /access=1 

  This will give your users a list of their own mail.

Environment:

  The MS-DOS environment variable "waffle" must be set and point to a
  valid Waffle static file.

  Vacation uses other STATIC file statements; he uses:  WAFFLE,
  UUCPNAME, NODE, TEMPORARY, BIN, USER, ORGAN.  Vacation uses what it
  finds; if any of these statements are missing the results may be
  unpredictable.

Caveats: 
  Use at your own risk!

  vacation updates user's mailbox.i files.  Tom gave me some real
  estate in the file to keep score.  When (if) he changes the format
  of the mailbox.i file, all bets are off.

History:
  1.7.1 Bug processing "-h -u <uid>" option combination
  1.7.0 Enhanced error reporting for corrupt mailbox
  1.6.8 Add special case code for -h -u <user>
  1.6.7 Improve error detection/reporting when invoking RMAIL.EXE (10/93).
  1.6.6 Suppress replies to yet another automated server.
  1.6.5 Fix ill formed 'From ' header statement (uunet complained!)
  1.6.4 Do not reply when header has 'X-MailServer:' statement.
  1.6.3 Remove dependency on the 'bin' STATIC file statement.
        Use 'X-Vacation:' message header. Was 'Comment:'.
  1.6.2 Updated the README file to document the environment better.(1/93)
  1.6.1 Broke display of reply address.(12/92)
  1.6   Suppress mail loops with another VacationDroid.(12/92)
  1.5   Support for Waffle 1.64 mail files is removed.
        Logfile is more terse.
        Logfile message beautification.
  1.4   Improved bounce detection and suppression.

Author:
  Larry Hardiman
  The Birdsong Company
  POB 2031
  Sunnyvale, CA 94087-2031

  larry@Birdsong.Suvl.CA.US

Permitted use:  
  A no-fee license is granted to all.  You may not charge for
  redistributing VAC.  This documentation must accompany the
  executable.
---
