@database ListWizard.guide

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

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


         Ein Tool für das Universal Message System, mit dem man
        neue MailingList Nachrichten in Gruppen verschieben bzw.
     Kommentare von Gruppen zu den pers. Nachrichten kopieren kann.

                      Copyright ©1995 Andreas Baum


 @{" Copyright " link Copy}                  Copyright und andere rechtliche Dinge
 @{" Autor " link Author}                      Die Adresse des Autors

 @{" Einführung " link Intro}                 Was ist ListWizard ?
 @{" Installation " link Install}               Installation von ListWizard
 @{" Konfiguration " link Config}              Konfiguration von ListWizard
 @{" ListWizard starten " link Start}         ListWizard starten

 @{" PGP Key " link PGP}                    PGP PublicKey

 @{" Geschichte " link History}                 Entwicklung von ListWizard
 @{" Danksagungen " link Credits}               Der Autor möchte danken ...
 @{" Bugreports etc. " link Bugs }            Wohin Bugreports und Wünsche ?

@endnode

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


@{b}@{u}Copyright und andere rechtliche Dinge@{ub}@{uu}


@{b}Copyright:@{ub}

Copyright ©1995 Andreas Baum

   Diese Dokumentation darf kopiert und  weitergegeben  werden,  solange
die  Copyright-Notiz  und  diese  Erlaubnis unverändert auf allen Kopien
enthalten ist.

   Das Programm darf nicht ohne eine schriftliche Genehmigung des Autors
in kommerziellen Programmen benutzt werden.

@{b}Keine Garantie:@{ub}

   Es wird keine Garantie gegeben, daß das Programm, welches  in  dieser
Dokumentation  beschrieben  wird,  100%ig  zuverlässig ist. Sie benutzen
dieses Programm auf eigene Gefahr. Der Autor kann auf  keinen  Fall  für
irgendwelche  Schäden  verantwortlich  gemacht  werden,  die  durch  die
Anwendung dieses Programmes entstehen.

@{b}Weitergabe:@{ub}

   Dieses Paket ist @{b}freely  distributable@{ub}.  Es  darf  auf  jedes  Medium
überspielt  werden,  das  für die Weitergabe von freier Software benutzt
wird.  Das  schließt  Public-Domain  Serien,  CDROMs,  FTP  Server   und
Mailboxen ein.

   Wenn  Sie  dieses  Paket  weitergeben  wollen,  so  sollte  nur   das
Originalarchiv   dafür  benutzt  werden.  Der  Autor  kann  nicht  dafür
verantwortlich gemacht werden,  wenn  die  Software  durch  unsachgemäße
Veränderung des Archivs unbrauchbar geworden ist.

   Es existiert keine Begrenzung für die Kosten, die für das Medium  wie
Disketten,  Streamerbänder  oder  CDROMs  oder  für das Kopieren erhoben
werden dürfen. Es muß nur absolut  klargestellt  sein,  daß  die  Kosten
@{b}nicht@{ub}  für  die  Software sondern allein für das Medium und das Kopieren
erhoben werden. Begrenzungen  haben  sich  in  der  Vergangenheit  immer
wieder  als  absolut  sinnlos  herausgestellt,  da  nicht  der Preis der
Disketten gesenkt wurde, sondern die Software von den  Originaldisketten
entfernt wurde.

   Wenn der Autor auch keine Einschränkung für die Kosten der Weitergabe
macht,  will  er  wenigstens  seine persönliche Meinung zu diesem Aspekt
abgeben:

   @{b}*@{ub} Dieses Softwarepaket sollte  jedem  frei  und  möglichst  kostenlos
     zugänglich gemacht werden, sobald dies nur irgendwie möglich ist.

   @{b}*@{ub} Wenn Sie diese Software über den normalen  Weg  von  einem  Public-
     Domain Versand auf einer Diskette erstanden  haben  und  sie  haben
     mehr als 5,-DM oder $5,-US dafür gezahlt, dann war das definitiv zu
     teuer. Sie sollten sich dann möglichst schnell nach einer  anderen,
     günstigeren Quelle für Public-Domain Software umsehen.

@{b}Benutzungsbeschränkungen:@{ub}

   Kein Teil dieses  Softwarepaketes  (Programme,  Dokumentation,  etc.)
darf  auf  einer  Maschine  benutzt  werden,  die  für  folgende  Zwecke
eingesetzt wird:

   Für die Forschung, Entwicklung, Konstruktion,  Tests  und  Produktion
von  Waffen oder sonstigen militärischen Gütern. Das gilt natürlich auch
für Maschinen, die für das Training  von  Personen  in  irgendeiner  der
obengenannten Tätigkeiten benutzt werden.

@endnode

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


@{b}@{u}Adresse des Autors@{ub}@{uu}

Der Autor kann unter den folgenden Adressen erreicht werden:

     @{b}Andreas Baum:@{ub}

     Snail-Mail:
      Eugen-Roth-Straße 25
      92318 Neumarkt
     
     E-Mail:
      fatso@turtle.insider.sub.de
      Andreas Baum 2:2490/1092.6@fidonet
     
     Telefon:
      09181/20950

@endnode

@node Intro "Einführung"
@next Install
@prev Author


@{b}@{u}Was ist der ListWizard?@{ub}@{uu}

ListWizard ist ein Tool für das @{b}Universal Message System@{ub},  mit  dem  man
neue  MailingList Nachrichten in Gruppen verschieben bzw. Kommentare von
Gruppen zu den pers. Nachrichten kopieren kann.

Folgende @{b}Features@{ub} werden unterstützt:

   @{fg highlight}ImportModus:@{fg text}

      @{b}*@{ub} Scannen der pers. Nachrichten nach neuen  Nachrichten  und  nach
        dem Vorkommen eines angegebenen Suchtextes in  einem  bestimmten
        Feld.
      @{b}*@{ub} Erzeugen einer Kopie in  der  Gruppe  <GroupPrefix>.<Listenname>
        (das Versandflag  bleibt dabei gesetzt und  die  Nachricht  wird
        als neu markiert).
      @{b}*@{ub} Ausgangsnachricht wird als alt und entweder als  verworfen  oder
        als gelöscht markiert.

   @{fg highlight}Exportmodus:@{fg text}

      @{b}*@{ub} Scannen aller MailingLists  die  in  der  Konfigurationsvariable
        ListWizard.MailingList angegeben sind.
      @{b}*@{ub} Erzeugen  einer  Kopie  in  den  pers.   Nachrichten   mit   der
        Absenderadresse  und  -namen,  welcher  in  der  Konfigurations-
        variable ListWizard.MailingList abgelegt ist.
      @{b}*@{ub} Ausgangsnachricht wird als versand markiert.
      @{b}*@{ub} Kopierte Nachricht kann als verworfen markiert  werden,  so  daß
        beim  nächsten  Aufräumen  die  Nachricht  gelöscht wird (vorher
        sollte natürlich exportiert werden).

   @{fg highlight}Allgemein:@{fg text}

      @{b}*@{ub} Programm wurde nach den @{b}Richtlinien für eine einheitliche Login-@{ub}
        @{b}Prozedur in UMS-Programmen@{ub} erstellt.

@endnode

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


@{b}Installation@{ub}

Die Datei @{b}ListWizard@{ub} sollte am besten zu den anderen  UMS-BIN's  kopiert
werden.

@endnode

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


@{b}@{u}Konfiguration@{ub}@{uu}

   ListWizard wird  ausschließlich  durch  UMS  Konfigurations-Variablen
konfiguriert.

   Für die Konfiguration sollte man am besten ConfUMS  v1.1a  (UMS  v10)
bzw. v1.2 (UMS v11) verwenden.

@{b}UMS Konfigurations-Variablen:@{ub}

   UMS stellt  Programmen,  die  auf  die  UMS-Datenbank  zugreifen  die
Möglichkeit  zur  Verfügung,  ihre  Konfiguration  aus einer allgemeinen
Konfigurations-Datei  zu   laden.   Diese   Konfigurations-Datei   heißt
@{b}ums.config@{ub}  und  ist in dem gleichen Verzeichnis wie  die  UMS-Datenbank
zu finden. ListWizard macht von dieser  Fähigkeit Gebrauch  und  benutzt
daher keine eigene Konfigurations-Datei.

@{b}@{fg highlight}Achtung:@{fg text}@{ub} Bei der Verwendung von AmigaGuide  wird  ein  Backslash  zuviel
dargestellt.

 @{" Allgemein " link General}
     UMS-Variablen richtig konfigurieren.

Konfigurations-Variablen, wahlweise @{b}Global@{ub} oder @{b}Local@{ub}:

 @{" ListWizard.GroupPrefix " link GroupPrefix}
     Welchen Gruppennamenvorsatz sollen die MailingLists bekommen ?

 @{" Listwizard.Delete " link Delete}
     Soll das Verworfen- oder das Gelöschtflag beim Importieren  gesetzt
     werden ?

 @{" ListWizard.Expire " link Expire}
     Sollen das Verworfenflag beim Exportieren gesetzt werden ?

 @{" ListWizard.MailingList " link MailingList}
     Alle MailingLists mit Namen und Adressen ...


@endnode

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


@{b}@{u}Allgemein@{ub}@{uu}

Bevor  mit  dem  ListWizard  gearbeitet  werden  kann,  müssen  folgende
allgemeine Variablen geändert und angelegt werden:

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

     @{b}Import = %@{ub} muß bei jedem Mailinglistuser auf  @{b}Import = #?@{ub}  geändert
     werden.

     Ein Dummy-SysOp muß, falls der SysOp selber Mailinglists  empfangen
     will,  angelegt werden. Hat der SysOp einen eigenen Usereintrag und
     empfängt er die Mailinglists über diesen Usereintrag, dann ist  die
     Erstellung eines Dummy-SysOp's nicht notwendig.

     Dummy-SysOp:

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

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

     @{b}( Import % )@{ub} muß bei jedem  Mailinglistuser  auf  @{b}( Import * )@{ub}  ge-
     ändert werden.

     Ein Dummy-SysOp muß, falls der SysOp selber Mailinglists  empfangen
     will,  angelegt werden. Hat der SysOp einen eigenen Usereintrag und
     empfängt er die Mailinglists über diesen Usereintrag, dann ist  die
     Erstellung eines Dummy-SysOp's nicht notwendig.

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

@endnode

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


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

   Mit dieser Variable wird der Gruppennamenvorsatz  angegeben,  welcher
für alle MailingLists verwendet werden soll.

@{b}Beispiel:@{ub}

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

     ListWizard.GroupPrefix = "Liste"

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

     ( ListWizard.GroupPrefix "Liste" )

@{b}Voreinstellung:@{ub}

     "mailinglist"

@{b}Hinweis:@{ub}

     Diese Variable kann angegeben werden.

@endnode

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


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

   Mit dieser Variable wird angegeben,  ob  die  Ausgangsnachricht  beim
Importieren als gelöscht oder nur als verworfen markiert werden soll.

@{b}Beispiel:@{ub}

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

     ListWizard.Delete = "Yes"

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

     ( ListWizard.Delete "Yes" )

@{b}Voreinstellung:@{ub}

     "No"

@{b}Hinweis:@{ub}

     Diese Variable kann angegeben werden.

@endnode

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


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

   Mit dieser Variable wird angegeben, ob die  erzeugte  Nachricht  beim
Exportieren  als  verworfen markiert werden soll. (Man sollte dabei aber
bedenken, daß ein echtes Exportieren der Nachrichten vor  einem  CleanUp
wirklich ratsam ist ;-))

@{b}Beispiel:@{ub}

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

     ListWizard.Expire = "Yes"

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

     ( ListWizard.Expire "Yes" )

@{b}Voreinstellung:@{ub}

     "No"

@{b}Hinweis:@{ub}

     Diese Variable kann angegeben werden.

@endnode

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


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

   In dieser Variable werden alle MailingLists mit  Suchfeld,  Suchtext,
Gruppenname, Name  und  Adresse konfiguriert. Der  Aufbau  der  Variable
is folgendermaßen:

@{b}Suchfeld  Suchtext  Gruppenname  Name  Adresse@{ub}

@{b}Suchfeld:@{ub}    Es können die Felder ReplyName,  ReplyAddress  und  Comment
             nach dem Suchtext durchsucht  werden.

@{b}Suchtext:@{ub}    Text nach dem gesucht wird um  die  entsprechende  Mailing-
             Liste in Erfahrung zu bringen.

@{b}Gruppenname:@{ub} Name der Gruppe unter der  die  entsprechende  MailingList-
             Nachricht erzeugt wird. (Der Gruppennamenvorsatz  wird  vor
             diesen Namen gesetzt und mit einem Punkt getrennt.)

@{b}Name:@{ub}        MailingListEmpfängername

@{b}Adresse:@{ub}     MailingListEmpfängeradresse

@{b}@{fg highlight}Achtung:@{fg text}@{ub} In diser Variable darf kein '=' verwedet werden.

@{b}Beispiel:@{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}Voreinstellung:@{ub}

     keine

@{b}Hinweis:@{ub}

     Diese Variable muß angegeben werden.

@endnode

@node Start "Starten von ListWizard"
@next PGP
@prev Config


@{b}@{u}Starten von der Shell aus@{ub}@{uu}

   Beim Starten von der Shell aus kann man ListWizard mehrere  Parameter
übergeben:

@{b}NAME/A@{ub}
     Der Benutzername, unter dem sich ListWizard bei  der  UMS-Datenbank
     anmelden soll.

@{b}PASSWORD/A@{ub}
     Das Passwort, das beim Einloggen benutzt werden soll. Beim Passwort
     wird Groß- und Kleinschrift unterschieden.

@{b}SERVER/K@{ub}
     Der UMS-Server, bei dem sich ListWizard einloggen soll. Bei  diesem
     Parameter muß @{b}SERVER@{ub} mit angegeben werden.

@{b}EXPORT/S@{ub}
     Im- oder exportiere MailingList Nachrichten.

@{b}Beispielaufrufe:@{ub}

     1> ListWizard "Andreas Baum" Geheim
     1> ListWizard "Andreas Baum" Geheim EXPORT

@endnode

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


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

Diesem Text folgt mein öffentlicher Schlüssel für das PGP  Programm.  Um
ihn  zu  benutzen,  sollte  man  diese  Datei mit 'PGP ListWizard.guide'
aufrufen. Hierdurch wird, falsch gewünscht, der Schlüssel in den Keyring
des  PGP-Programmes  übernommen.  Um  die  Gültigkeit  der Binärdatei zu
überprüfen gibt man jetzt einfach 'PGP ListWizard ListWizard'  ein.  Wer
dem  Ergebnis  nicht  traut,  kann  sich  per  E-Mail  (bei Betreff MUSS
unbedingt PGPFINGERPRINT eingetragen werden)  den  Fingerprint  schicken
lassen.

-----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 "Geschichte"
@next Credits
@prev PGP


@{b}@{u}Entwicklungsgeschichte@{ub}@{uu}

   ListWizard v1.0

   @{b}*@{ub} Erste interne Version

   ListWizard v1.1

   @{b}*@{ub} Erste öffentliche Version

   ListWizard v1.2

      NEU: Beim Erzeugen der Nachrichten in der Gruppe werde jetzt Soft-
           links verwendet.

   @{b}*@{ub} Zweite öffentliche Version

@endnode

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


@{b}@{u}Danksagungen@{ub}@{uu}

@{b}Martin Horneffer@{ub}
     für das Universal Message System

@{b}Markus Stipp@{ub} und @{b}Matthias Scheler@{ub}
     für den Mail- und Newsreader IntuiNews

@{b}André Schenk@{ub}
     für UMSFido

@{b}Marc Jackisch@{ub}
     für UMSZer

@{b}Olaf Peters@{ub}
     für ConfUMS

und allen anderen UMS-Programmierern.

@endnode

@node Bugs "Bugreports etc."
@prev Credits


@{b}@{u}Wo sollen Bugreports und Wünsche nach Features hingeschickt werden@{ub}@{uu}


   Bugreports und  Wünsche  nach  neuen  Features  sollten  an  folgende
Adresse geschickt werden:

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

     Telefon:
      09181/20950

@endnode