
NAME
    RetR

SYNOPSIS

    Rx RetR <User>


SYSTEM REQUIREMENTS

    Amiga OS 2.0 is needed  for ARexx.  The  'RexxMast' executeable
    should have been executed by the standard 2.0 Startup-Sequence.
    The  'Rx' command must be in your path.  An 'T:' assign to your
    temporary directory must exist.


DESCRIPTION

    RetR is  quite a powerful tool to answer all your incoming mails
    which contain a 'Return-Receipt-To:' header entry automatically.
    All  messages sent by RetR are completely user definable in body
    and header.  Messages  to every user of your system can be indi-
    vidually answered.

    The installation  of  RetR  is quite simple: Store the RetR file
    whereever  you  want.  'UUCP:C/RetR' is a very good place for it
    Now you need  another  directory  to  store  the   RetR  related
    files.  If  you  have  'AutoMail'  by  Klaus Alexander  Seistrup
    <kas@mink.ping.dk>  already  installed  the  'UUCP:AutoMail/' or
    'AutoMail:'  directory  will be a very good choice. AutoMail can
    be found on  AmiNet:comm/mail/AutoMail_39_2.lha.  This directory
    must contain a file called  'RetR.<User>.Msg' for every user who
    wants his Return-Receipt requests to be answered by RetR. An ex-
    ample for such a file for me (User 'Carsten') might be :

    AutoMail:RetR.Carsten.Msg :

    ----------------------------------------------------------------
    From: Carsten@amiga.prima.ruhr.de (Carsten Becker)
    To: %R
    Cc: Carsten.RetR
    Subject: RetR: %s

    Hello %r !

    Your mail "%s" with Msg-ID "%m"
    to "%t" of %d
    was received by Carsten@amiga.prima.ruhr.de on %D.

    Note: This is no confirmation that your message has
          also been read !

    ----------------------------------------------------------------

    Of  course  you  *must not*  include the separation lines !  The
    format  of  these  files is very simple they contain the message
    header (first 4 lines in the example above)  followed by a blank
    line and the body afterwards.  NOTE:  DO NOT LEAVE OUT THE BLANK
    LINE  OR INCLUDE  ANY FURTHER  BLANK LINES IN THE HEADER OF THIS
    FILE !!!  Your Return-Receipt will *never* reach its destination
    if you do !  This .Msg file contains several place holders :


        %e  -  Senders email address. The email address is taken
               from the 'From:' line of the original message.

        %r  -  Senders real name if given. The real name is also
               taken from the 'From:' line of the original message.
               If no real name is given in the 'From:' line the
               output of %r will be "Unknown".

        %t  -  Email address of the receiver of the message. This
               address is taken from the 'To:' field of the original
               message. If there are multiple recipients in the
               'To:' line RetR will take the first address which
               is sent to your domain (see section 'UULib:Config'
               for further details). If no 'To:' header line exists
               the output of '%t' will be 'Unknown'. If a 'To:'
               line exists but contains no destination address of
               your domain (which may occur when you receive mails
               from mailing lists) the complete 'To:' line is
               displayed by '%t'.

        %s  -  Subject line of the original address. It is a clever
               idea to precede the subject line of the Return-Receipt
               with a unique prefix as shown in the example Msg file
               above to prevent mailers from mixing up all mails and
               Return-Receipts with the same subject.

        %m  -  Message-ID of the original message without '<' and
               '>' quotes. RetR also creates a logfile in the same
               dir as the .Msg file. The logfile contains the message
               IDs of all messages RetR already sent Return-Receipts
               to in order to prevent RetR from answering a Return-
               Receipt request twice.

        %R  -  'Return-Receipt-To:' address. A '%R' *MUST* be in-
               serted in the 'To:' line of the .Msg file to send
               the Return-Receipt to the guy who requested it. If
               a 'Return-Receipt-To:' header entry exists, but does
               not contain an email address, '%R' will output the
               address of the 'From:' line.

        %d  -  Date taken from the 'Date:' line of the original
               message.

        %D  -  Your system date in the shape 'Day, DD MMM YYYY
               HH:MM:SS +TTTT'.

        %l  -  Length of the original message.

        %%  -  Includes a single '%' into the Return-Receipt.


    Note: All place holders are case sensitive !

    If you  want to  get a local copy of the Return-Receipt you send
    just  include a 'Cc:' line in the .Msg file with a user name you
    like.  '<User>.RetR'  is a good choice. The user name should not
    be followed  by a  domain in order to prevent your sendmail from
    sending it to remote systems. See example .Msg file above.

    To  invoke RetR to send Return-Receipts you will have to add the
    call  "|Rx <Path>RetR <User>"  in  your  UULib:Aliases  file.  A
    sample for me (User 'Carsten') looks like this :


    Carsten:   \Carsten,     "|Rx UUCP:C/RetR Carsten"


    Note: Do not leave out the quotation marks !

    That's it.  Now you only have to set some config entries in your
    config file (if you don't have them already) :


UULib:Config


    There are several entries needed for RetR in your 'UULib:Config'
    or 'S:UUConfig' file.  Note: RetR will disregard all environment
    variables ! All settings have to be set in the Config file.  All
    entries ar *not* case sensitive !


    UserName <User>

    'UserName' is used to define the default user. This entry is
    only used if no user is given to RetR as a parameter (see
    section Synopsis). The user name is also used to build the
    file names 'RetR.<User>.Msg' and 'RetR.<User>.Log'. Note: A
    user name must be specified - either as a parameter to RetR
    or as the UserName entry in the Config file.


    DomainName <Your Domain>

    The domain name is used to decide in multiple recipient mails
    which destination address is yours. See '%t' for further de-
    tails. Note: Either 'DomainName' or - even better - 'HostName'
    have to be defined !


    HostName <Your fully domained Host Name>

    Your complete domain, i.e. everything that follows the '@' in
    your email address. The 'HostName' entry is used for the same
    reason as the 'DomainName' entry. If 'HostName' is specified
    it overrides the 'DomainName' entry. It is recommended to set
    the 'HostName' entry because it helps RetR to be more accurate
    in finding the correct recipient. Note: Either 'DomainName' or
    - even better - 'HostName' have to be defined !


    Note: All the following entries do not necessarily have to be
          defined. If they are not set the default values will be
          taken instead.


    TimeZone <Your TimeZone>

    Your local timezone in hours from Geenwich time. Defaults to
    '+0100' for Central European Time.


    SendMail <Your SendMail Command>

    Specifies the path and name of your SendMail command. You can
    also add some standard options for SendMail or redirect the
    output. The default is 'UUCP:C/SendMail >NIL:'.


    RetRDir <Msg File Dir>

    This is the only entry that is only used by RetR. It specifies
    the directory in which all .Msg and .Log files are stored. The
    default for this dir is 'AutoMail:'.


COPYRIGHT/AUTHOR/SUPPORT

    This  software  is provided by the author "as is" and any express
    or implied warranties, including, but not limited to, the implied
    warranties  of  merchantability and fitness for a particular pur-
    pose  are  disclaimed. In no event shall the author be liable for
    any direct,  indirect,  incidental, special, exemplary, or conse-
    quential damages  (including,  but not limited to, procurement of
    substitute  goods  or  services;  loss  of use, data, or profits;
    or business interruption) however caused and on any theory of li-
    ability,  whether in contract, strict liability, or tort (includ-
    ing negligence or otherwise) arising in any way out of the use of
    this software, even if advised of the possibility of such damage.

    You are not allowed to  modify the program itself or any documen-
    tation  that came with it.  All updates of  RetR will only be re-
    leased by me, Carsten Becker, the author. Updates can be received
    in uuencoded form by sending an email to the address:


                    RetR-Update@amiga.prima.ruhr.de


    This software is not free. It is emailware, i.e. you have to send
    me an email if you use this program. I think this is fair ;-)))
    Write your email to :


                    RetR-Support@amiga.prima.ruhr.de


    This is also the address to send your bug reports to, suggestions
    for  new features  or anything  else  you want the author of RetR
    to know.  If you send me  bug reports please include at least the
    *FULL*  header of the mail  that didn't get answered correctly by
    RetR.  You needn't send me the body of that mail, unless you feel
    that  the body  might be the  cause for the trouble you have with
    RetR.




BUGS

    o RetR doesn't always get the recipient of a mail correctly. In
      case a mail is sent to multiple recipients of which more than
      one reside on your maschine,  the output of  '%t' will always
      be the user mentioned *first* in the 'To:' line of the origi-
      nal message.  This might be fixed in future releases  if any-
      body sees a need in fixing that.

    o RetR doesn't always handle so called  'bang paths' correctly.
      I.E. something like 'fubar!uunet.uu.net!overload!someone'. If
      you use the standard form 'User@site.do.main' there should be
      no problems.


TO DO

    What would you propose ?




'97 by Carsten Becker <RetR-Support@amiga.prima.ruhr.de>

