Short:        PMBS Client/Server-Filelister, V1.3, German only!
Author:       sysop@legacy.dame.de (Joerg Fenin)
Uploader:     sysop legacy dame de (Joerg Fenin)
Type:         comm/bbs
Version:      1.3
Replaces:     comm/bbs/ProGuideList.lha
Requires:     OS2.04+, MUI 3.3
Architecture: m68k-amigaos
Kurz:         PMBS Client/Server-Filelister, V1.3, deutsch

ProGuideList is the ultimate online filelister for Prometheus-Mailbox-
Systems.

This version (V1.3) is shareware, the unregistered version works with
minmal restrictions.

Since PMBS is a German system, this tool and the documentary is German
only as well.

However, foreign versions may be requested from the author.


                     ---- Deutsche Zusammenfassung ----

ProGuideList bietet zwei bislang einmaliges Features aller File-Lister für
Prometheus:
                 +=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=+
                 | EINE FILELISTE IM AMIGA-GUIDE FORMAT! |
                 +=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=+

D.h. die Bretter sind genau wie in der Box hierarchisch sortiert. Statt
mühevollem Cursor-Rumscrollen reichen ein paar wenige Mausklicks um das
gewünschte Brett und dessen Inhalt sichtbar zu machen!

                 +=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=+
                 |       CLIENT / SERVER - PRINZIP       |
                 +=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=+

D.h. die User in der Box starten auf ihrem Port den Client, senden ihre
Listenanforderung an einen Server, der seinerseits einen Listclient aufruft,
der die Liste für den User im Hintergrund erstellt.

DER USER KANN WÄHREND DER LISTENERSTELLUNG IN DER BOX WEITERARBEITEN!! Nach
der Fertigstellung der Liste wird sie im Postfach (PM) des Users abgelegt!


Folgende Funktionen sind in der Version 1.3 vorhanden:

+ die Bretter werden über einen binären Baum abgearbeitet, d.h. eine
  1:1-Umsetzung der Fileliste wie die Bretthirachie in der Box

+ die Brettliste wird direkt aus dem RAM gelesen -> sehr schnell und
  sehr speicherschonend

+ es werden nur die Bretter in die Liste aufgenommen, die der User,
  der ProGuideList benutzt, auch sehen kann (Inhaltsgruppe)

+ Übernahme des Brettes in der User sich gerade befindet und Aufbau der
  Liste nur ab diesem Brett (so daß man sich auch nur Teile der Box
  auflisten lassen kann)

+ dynamische Taskpriorität, je mehr Ports belegt sind, desto niedriger die
  Task-Priorität, so daß auf den anderen Ports normal weitergearbeitet
  werden kann (einstellbar)

+ Brettkommentare werden mit in die Liste übernommen

+ dem User werden die eingestellten Packer zum Packen der Liste
  angeboten, gepackt wird mit dem in Prometheus eingetragenen
  Packstring, default ist immer der Packer, den der User in seinem
  Setup eingetragen

+ der User kann entscheiden, ob er Binär-, ASCII- oder beide Brettarten in
  die Liste mit aufnehmen will

+ der User kann entscheiden, ob er den ganzen Kommentar, nur die 1. Zeile
  oder überhaupt keinen Kommentar zu jedem File in die Liste mit aufnehmen
  will

+ der User kann seine eigene Konfiguration speichern, so daß er
  beim erneuten Aufruf nicht wieder alles neu einstellen muß

+ der User erhält eine Online-Message, wenn die Liste fertiggestellt
  ist und in seinem Postfach liegt.

  Hat sich der User mittlerweile ausgeloggt, wird die Online-Message
  nicht erzeugt und die Liste "still und leise" :-) im Postfach des
  Users abgelegt, so daß er sie beim nächsten Login zu sehen bekommt.

+ Nutzung zahlreicher Routinen, die sich bereits in anderen Tools
  bewährt haben, daher sehr robust und leistungsfähig

+ umfangreichere Carrier-Checks beim PGLClient

+ Beachtung von Passwort-geschützten Brettern

+ Konfigurations-Programm für den Sysop, GUI

+ ASCII-Listclient und AmigaGuide-Listclient

+ Zeilenvorschübe für AMIGA, PC oder MAC einstellbar

+ korrekte Behandlung von Netzbrettern

+ Online-Hilfe

+ Ausfiltern von Brückie-Farb-Codes

+ die Liste kann wahlweise nur die Einträge enthalten, die seit dem
  Bezugsdatum des Users neu in der Box sind (d.h. eine Liste mit nur
  den neuen Einträgen!)

+ Herausfiltern von Prometheus-Farbcodes auch aus den Brettnamen!
  (obwohl ich sowas ja krank finde, die auch noch farbig zu machen...)

+ Die B*-Baum-Erstellung kann jetzt wahlweise auch im Hintergrund
  ablaufen, d.h. keine Wartezeit mehr für den User!

+ Listclients werten unterschiedliche Brettratios aus (Text-Ausgabe)

+ Installer-Skript!

+ Daemon zum automatischen Erstellen von Filelisten über den
  Prometheus-Zeitplan oder aus der Shell (PGLAutoList)

+ für PGLAutoList kann ein relatives Bezugsdatum angegeben werden,
  so daß immer eine Liste der z.B. letzten 7 Tage erstellt werden kann


Versionsgeschichte V1.0 -> V1.3
===============================

V1.3 - 11-Aug-1996

     - Änderungen in Kürze:

       Bug in der Brettlistenverwaltung in PGLAutoList/PGLSysopPrefs
       behoben, die Auswahl des Wurzel- und des Empfängerbrettes
       verschob sich, wenn es neue Bretter in der Box gab, die
       vor dem Wurzel- und Empfängerbrett lagen
       (Bugreport von TIGER@HSH-BOX)

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

V1.2 - 25-Jul-1996

     - Änderungen in Kürze:

       Man kann jetzt in den PGLSysopPrefs einstellen, wie viele
       Listen maximal pro User gleichzeitig bearbeitet werden, damit
       nicht Hacker oder Dumm-User auf die Idee kommen, einen Box-
       rechner mit Listenanforderungen "dichtzumachen"

       (Vielen Dank an TIGER@HSH-BOX für diesen guten Hinweis)

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


V1.1 - 18-Jul-1996

     - Änderungen in Kürze:

       PGLGuide und PGLAscii erzeugten falsche Packeraufrufe, korrigiert;
       der Name des registrierten Users im PGLClient wurde nicht vom Namen
       der Box getrennt, korrigiert