@database ListWizard.guide

@node Main "ListWizard v1.2"
@next Copy


                            @{b}@{u}@{fg highlight}ListWizard v1.2@{ub}@{uu}@{fg text}


         A tool for the Universal Message System, with this you
              can move new mailistings to groups resp.copy
                  followup's from groups to the mails.

                      Copyright ©1995 Andreas Baum


 @{" Copyright " link Copy}                  Copyright and other legal stuff
 @{" Author " link Author}                     How to reach the author

 @{" Introduction " link Intro}               What is ListWizard ?
 @{" Installation " link Install}               Installation of ListWizard
 @{" Configuration " link Config}              Configuration of ListWizard
 @{" Starting ListWizard " link Start}        Starting ListWizard

 @{" PGP Key " link PGP}                    PGP PublicKey

 @{" History " link History}                    The development of ListWizard
 @{" Credits " link Credits}                    The Author wish to thank...
 @{" Bugreports etc. " link Bugs }            Where to send bugs and features ?


                 SORRY, but my English is horrific :-(

@endnode

@node Copy "Copyright"
@next Author
@prev Main


@{b}@{u}Copyright and other legal stuff@{ub}@{uu}


@{b}Copyright:@{ub}

Copyright ©1995 Andreas Baum

   Permission is granted to make and distribute verbatim copies of  this
manual  provided  the  copyright  notice  and this permission notice are
preserved on all copies.

   Neither the programs nor the source code (nor parts  of  it)  may  be
included  or used in commercial programs unless by written permission of
the author.

@{b}No Warranty:@{ub}

   No Warranty of any kind is given that the program described  in  this
document  are  100%  reliable.  You  are using this material at your own
risk. The author can not be made responsible for  any  damage  which  is
caused by using these program.

@{b}Distribution:@{ub}

   This package is @{b}freely distributable@{ub}. It may  be  transfered  to  any
media  used  for distributing free software. This includes public domain
series, CDROMs, FTP servers and mailboxes.

   If you want to distribute this program  you  must  use  the  original
distribution  archives.  The  author can not be made responsible for any
damage if the software was damaged by modifying the archive.

   There is no limit for the  fee  taken  for  this  media  like  disks,
streamer  tapes,  CDROMs or for copying. It must only be clear that this
fee is taken for the media and the copying and  @{b}not@{ub}  for  the  software.
Limitations  of  the fee have proved to be senseless in past because the
fee was not lowered but the files were removed from the original medias.

   Although the author do not restrict  the  cost  for  distribution  he
want to tell his opinion abouth this topic:

   @{b}*@{ub} This software package should be available for everybody without any
     fee if it is possible.

   @{b}*@{ub} If you purchased this software the normal way from a Public domain
     distributor on a disk and you have payed more than 5,-DM or $5,-US
     for it you have  definitely  overpayed.  You  should  look  for  a
     cheaper source for Public-Domain software as soon as possible.

@{b}Limitations of Usage:@{ub}

   None of the program nor the source code (nor parts  of  it)  may  be
used  on  any  machine  which  is  used  for the research, development,
construction, testing  or  production  of  weapons  or  other  military
applications. This also includes any machine which is used for training
persons for any of the above mentioned purposes.

@endnode

@node Author "Author"
@next Intro
@prev Copy


@{b}@{u}Address of the Author@{ub}@{uu}

The author can be reached at the following address:

     @{b}Andreas Baum:@{ub}

     Snail-Mail:
      Eugen-Roth-Straße 25
      92318 Neumarkt
      FR Germany

     E-Mail:
      fatso@turtle.insider.sub.de
      Andreas Baum 2:2490/1092.6@fidonet
     
     Telephone:
      +49-9181-20950

@endnode

@node Intro "Introduction"
@next Install
@prev Author


@{b}@{u}What is ListWizard?@{ub}@{uu}

ListWizard is a tool for the @{b}Universal Message System@{ub}, with this you can
move new mailistings to groups resp. copy followup's from groups to  the
mails.

Following @{b}features@{ub} were supported:

   @{fg highlight}Importmode:@{fg text}

      @{b}*@{ub} Scan mails to find new mails which contains  the  searchtext  in
        given fields.
      @{b}*@{ub} Make a copy in the group <groupprefix>.<listname>  (the  export-
        flag  stays and the mail will be marked as new).
      @{b}*@{ub} Starting mail will be marked as old and either as expired or  as
        deleted.

   @{fg highlight}Exportmode:@{fg text}

      @{b}*@{ub} Scan all mailinglists which were listed  in  the  configvariable
        ListWizard.MailingList.
      @{b}*@{ub} Make a copy in the mails with the senderaddress and -name  which
        were listed in the configvariable ListWizard.MailingList.
      @{b}*@{ub} Starting mail will be marked as exported.
      @{b}*@{ub} The copy of the mail can be marked as expired, so the next clean
        up deletes the mail (you should export the mails before cleaning
        up).

   @{fg highlight}General:@{fg text}

      @{b}*@{ub} Program uses the @{b}Guidelines of  a  standardized  login-procedure@{ub}
        @{b}in UMS-programs@{ub}.

@endnode

@node Install "Installation"
@next Config
@prev Intro


@{b}Installation@{ub}

Copy the file @{b}ListWizard@{ub} to the other UMS-bin's.

@endnode

@node Config "Configuration"
@next Start
@prev Install


@{b}@{u}Configuration@{ub}@{uu}

   ListWizards's  setup  is  mainly  controlled  by  UMS   configuration
variables.

   For the configuration you should use ConfUMS  v1.1a  (UMS v10)  resp.
v1.2 (UMS v11).

@{b}UMS configuration variables:@{ub}

   Applications using UMS have  the  possibility  to  access  their  own
variables  in  the  main UMS configuration file. This file is located in
the same directory as the messagebase. Because ListWizard makes  use  of
this feature it does not require an own configuration file.

@{b}@{fg highlight}Attention:@{fg text}@{ub}  Because  AmigaGuide  and  MultiView  react  differently   on
backslashes  you  may see two backslashes. Of course you should use only
one in the UMS configuration.

 @{" General " link General}
     Configure UMS-Variables.

Configuration variables, @{b}global@{ub} or @{b}local@{ub}:

 @{" ListWizard.GroupPrefix " link GroupPrefix}
     What prefix should be used for the mailinglists ?

 @{" Listwizard.Delete " link Delete}
     Should be set the expire- or the deleteflag when  mailinglists  get
     imported ?

 @{" ListWizard.Expire " link Expire}
     Should be set the expireflag when mailinglists get exported ?

 @{" ListWizard.MailingList " link MailingList}
      All mailinglists with name and address ...

@endnode

@node General "General"
@toc Config
@next GroupPrefix
@prev Config


@{b}@{u}General@{ub}@{uu}

Before using ListWizard you have to  change  and  create  the  following
general UMS-variables:

     @{b}@{fg highlight}UMS v10@{fg text}@{ub}

     You have to change @{b}Import = %@{ub} to @{b}Import = #?@{ub}  at  all  mailinglist-
     users.

     If the sysop will  receive  mailinglists,  you  have  to  create  a
     Dummy-Sysop. If the sysop already have a userentry who receives the
     mailinglists then you mustn't create this Dummy-Sysop.

     Dummy-SysOp:

     User
       Name              = Dummy
       Password          = "Secret"
       SysOp
       ReadAccess        = #?
       WriteAccess       = #?
       Import            = %
       NetAccess         = #?
     EndUser

     @{b}@{fg highlight}UMS v11@{fg text}@{ub}

     You have to change @{b}( Import % )@{ub} to @{b}( Import * )@{ub} at all mailinglist-
     users.

     If the sysop will  receive  mailinglists,  you  have  to  create  a
     Dummy-Sysop. If the sysop already have a userentry who receives the
     mailinglists then you mustn't create this Dummy-Sysop.

     ( Sysop
         ( ReadAccess * )
         ( WriteAccess * )
         ( NetAccess * )
         ( Import % )
         ( Name Dummy )
         ( Password "Secret" )
     )

@endnode

@node GroupPrefix "ListWizard.GroupPrefix"
@toc Config
@next Delete
@prev General


@{b}@{u}ListWizard.GroupPrefix@{ub}@{uu}

   You can use this variable to define the GroupPrefix.

@{b}Example:@{ub}

     @{b}@{fg highlight}UMS v10@{fg text}@{ub}

     ListWizard.GroupPrefix = "list"

     @{b}@{fg highlight}UMS v11@{fg text}@{ub}

     ( ListWizard.GroupPrefix "list" )

@{b}Default:@{ub}

     "mailinglist"

@{b}Remark:@{ub}

     This variable is optional.

@endnode

@node Delete "ListWizard.Delete"
@toc Config
@next Expire
@prev GroupPrefix


@{b}@{u}ListWizard.Delete@{ub}@{uu}

   You can use this variable to define if  the  starting  mail  will  be
marked as delete or as expired when mailinglists get imported.

@{b}Example:@{ub}

     @{b}@{fg highlight}UMS v10@{fg text}@{ub}

     ListWizard.Delete = "Yes"

     @{b}@{fg highlight}UMS v11@{fg text}@{ub}

     ( ListWizard.Delete "Yes" )

@{b}Default:@{ub}

     "No"

@{b}Remark:@{ub}

     This variable is optional.

@endnode

@node Expire "ListWizard.Expire"
@toc Config
@next MailingList
@prev Delete


@{b}@{u}ListWizard.Expire@{ub}@{uu}

   You can use this variable to define if the copy  will  be  marked  as
expired  or not when mailinglists get exported. (You have to think  that
a really export is advisable before cleaning up the messagebase ;-))

@{b}Example:@{ub}

     @{b}@{fg highlight}UMS v10@{fg text}@{ub}

     ListWizard.Expire = "Yes"

     @{b}@{fg highlight}UMS v11@{fg text}@{ub}

     ( ListWizard.Expire "Yes" )

@{b}Default:@{ub}

     "No"

@{b}Remark:@{ub}

     This variable is optional.

@endnode

@node MailingList "ListWizard.MailingList"
@toc Config
@next Config
@prev Expire


@{b}@{u}ListWizard.MailingList@{ub}@{uu}

   You can use this variable  to  define  the  searchfield,  searchtext,
groupname, name and address for all mailinglists. The structure  of  the
variable:

@{b}Searchfield  Searchtext  Groupname  Name  Address@{ub}

@{b}Searchfield:@{ub} You can search in the fields  replyname,  replyaddress  and
             comment.

@{b}Searchtext:@{ub}  This text will be searched to find out the mailinglist.

@{b}Groupname:@{ub}   Name of the group for the created mailinglist  (the  group-
             prefix will be inserted at the beginning and a dot seperate
             the groupprefix and the groupname).

@{b}Name:@{ub}        Mailinglist receiver name

@{b}Address:@{ub}     Mailinglist receiver address

@{b}@{fg highlight}Attention: Don't use a '=' in this variable.@{fg text}@{ub}

@{b}Example:@{ub}

     @{b}@{fg highlight}UMS v10@{fg text}@{ub}

     ListWizard.Mailinglist = "ReplyName    \\"MailingList 'UMS-Intl'\\" UMS-Intl UMS-Intl UMS-Intl@lyssa.owl.de
     ReplyName    \\"MailingList 'BGUIM'\\"    BGUIM    BGUIM    bguim@aobh.xs4all.nl
     ReplyAddress adsp-tng@mail.iM.Net       ADSP     ADSP     adsp-tng@mail.iM.Net
     Comment      "\\AmigaOS 4 Mailinglist\\"  AmigaOS4 OS4      amigaos-4-0@rachael.franken.de
     Comment      amok-l@info2.rus.uni-stut  AMOS     AMOS     amok-l@info2.rus.uni-stuttgart.de
     "

     @{b}@{fg highlight}UMS v11@{fg text}@{ub}

     ( ListWizard.MailingList
         "ReplyName    \\"MailingList 'UMS-Intl'\\" UMS-Intl UMS-Intl UMS-Intl@lyssa.owl.de\\n"
         "ReplyName    \\"MailingList 'BGUIM'\\"    BGUIM    BGUIM    bguim@aobh.xs4all.nl\\n"
         "ReplyAddress adsp-tng@mail.iM.Net       ADSP     ADSP     adsp-tng@mail.iM.Net\\n"
         "Comment      "\\AmigaOS 4 Mailinglist\\"  AmigaOS4 OS4      amigaos-4-0@rachael.franken.de\\n"
         "Comment      amok-l@info2.rus.uni-stut  AMOS     AMOS     amok-l@info2.rus.uni-stuttgart.de\\n"
     )

@{b}Default:@{ub}

     none

@{b}Remark:@{ub}

     This variable is required.

@endnode

@node Start "Starting ListWizard"
@next PGP
@prev Config


@{b}@{u}Starting from a shell@{ub}@{uu}

   If you start ListWizard from a shell you  may  supply  the  following
arguments:

@{b}NAME/A@{ub}
     The name of the UMS user.

@{b}PASSWORD/A@{ub}
     The password for this user. The password is case sensitive.

@{b}SERVER/K@{ub}
     The UMS server to use. You must use the keyword @{b}SERVER@{ub} in front  of
     this argument.

@{b}EXPORT/S@{ub}
     Im- or export mailinglist messages.

@{b}Example:@{ub}

     1> ListWizard "Andreas Baum" Secret
     1> ListWizard "Andreas Baum" Secret EXPORT

@endnode

@node PGP "PGP"
@next History
@prev Start


@{b}@{u}PGP PublicKey@{ub}@{uu}

   Below you will find my public key.  Enter 'PGP  ListWizard.guide'  to
decode  it  and  add my key to your PGP keyring. To verify my signature,
now  enter  'PGP ListWizard ListWizard'. If  you  don't  trust  the  key
below you can still contact me via E-Mail to ask for the PGP fingerprint
(you have to use PGPFINGERPRINT as subject).

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: 2.3a.5

mQBNAi6O4SwAAAECAOHErvV7mRB/trVpCq6pf5Wt7RxgKEhe6N+0hpkNos4beVo1
j3Uzh1nax/x94Bte2lp0vrv5ttnDik/k+aUPo4kABRG0KkFuZHJlYXMgQmF1bSA8
ZmF0c29AdHVydGxlLmluc2lkZXIuc3ViLmRlPg==
=bZBx
-----END PGP PUBLIC KEY BLOCK-----

@endnode

@node History "History"
@next Credits
@prev PGP


@{b}@{u}History@{ub}@{uu}

   ListWizard v1.0

   @{b}*@{ub} First internal version

   ListWizard v1.1

   @{b}*@{ub} First public version

   ListWizard v1.2

      NEW: Create the messages in the groups with softlinks.

   @{b}*@{ub} Second public version

@endnode

@node Credits "Credits"
@next Bugs
@prev History


@{b}@{u}Credits@{ub}@{uu}

@{b}Martin Horneffer@{ub}
     for the Universal Message System

@{b}Markus Stipp@{ub} and @{b}Matthias Scheler@{ub}
     for the mail- and newsreader IntuiNews

@{b}André Schenk@{ub}
     for UMSFido

@{b}Marc Jackisch@{ub}
     for UMSZer

@{b}Olaf Peters@{ub}
     for ConfUMS

and all other UMS-programers.

@endnode

@node Bugs "Bugreports etc."
@prev Credits


@{b}@{u}Where to send bug reports and feature@{ub}@{uu}


   Bug reports and feature requests should go to this address:

     @{b}Andreas Baum:@{ub}
     
     E-Mail:
      fatso@turtle.insider.sub.de
      Andreas Baum 2:2490/1092.6@fidonet

     Telephone:
      +49-9181-20950

@endnode