
 ˻            ɻ  ɻ               ɻ
   ˻        λμ   ˻  ͹   MaXimus eXternal msgEDitor
       ɻɻ   μ    ʼ         Copyright (C) 1996-2002
       μ   λ    ʼ  ʼ       By Thomas Mueller
 ȼ      λ  μλ   MxXEd/2               All Rights Reserved
     ȼ  ȼ  ȼȼ  ȼ  ȼ


              D O K U M E N T A T I O N - Stand 14.06.1998


Ŀ
 Version 

    Aktuelle Version ist die 1.02.000 und somit die zweite Release. Erzeugt
    wurde sie am 24.02.2002. Bitte bei Mails an mich dies immer kurz mit
    angeben.

Ŀ
 Haftungsausschluss 

    Dieses Programm wird so, wie es ist, verteilt. Der Autor ist nicht
    fuer Schaeden verantwortlich, die durch dieses Programm direkt
    oder indirekt verursacht werden. Die einzige Garantie, die gegeben
    werden kann, ist die, dass das Programm Platz auf dem Datentraeger
    beansprucht.

Ŀ
 Features 

    - Steuerung per Cursortasten
    - sehr einfache Installation, da die Maximus-Config benutzt wird
    - Unterstuetzung fuer Maximus-Divisions
    - automatische Umlautkonvertierung in Areas, fuer die kein
      HiBit-Flag gesetzt ist.
    - MxXEd beruecksichtigt die in der System-Sektion angegebenen
      Flags fuer Netmails (Message Edit Assume/Ask).
    - Watchdog ueberprueft den Carrier (Lost) und Timeout (wie bei Maximus)
    - Areasortierung vom Benutzer einstellbar
    - Nodelistlookup bei V7(+)-Nodelist (bei Maximus nicht implementiert!)
    - kontextsensitive Onlinehilfe
    - Newmail-Rescan
    - Hervorhebungen mit *fett*, _unterstrichen_ und /kursiv/ werden farbig
      gekennzeichnet.
    - Rules-Anzeige fuer Mailechos
    - Alias Untersttzung von Maximus
    - MxXEd bietet die in Maximus fehlende Funktion: Comment an Cosysop.

      uvm.

Ŀ
 Sinn und Zweck 

    MxXEd/2 ist ein Maileditor fuer Maximus, der zum Schreiben und
    Lesen von Messages sowohl fuer Onlineuser als auch fuer den Sysop
    als Offlineeditor verwendet werden kann.

Ŀ
 Umgebung 

    Hardware: Jeder Rechner, auf dem OS/2 und die OS/2-Version
              von Maximus laeuft.
    Software: Getestet wurde MxXEd/2 unter OS/2 Warp 3.0, er sollte
              jedoch auch unter OS/2 2.x und Warp 4 laufen. Da das Format
              der Konfigurationsdateien in der neuen Maximus-Version
              geaendert wurde, muss Maximus 3.x verwendet werden.

Ŀ
 Arbeitsweise 

    MxXEd wird als Door in Maximus eingebunden, liest dessen
    Konfiguration inklusive aller Berechtigungen ein und zeigt die
    Areas nach Divisions gegliedert an. Es ist auch moeglich, MxXEd
    als lokalen Messageeditor zu benutzen, dazu braucht man lediglich
    die Nummer des Lastread-Pointers in der Messagebase, die fuer den
    Sysop gilt. In der Regel ist das die 0, weil der Sysopaccount der
    erste angelegte ist.

Ŀ
 Bedienung und Moeglichkeiten von MxXEd 

    Zur Steuerung werden die Pfeiltasten, Escape, Return/Enter und
    die Wordstar-Tastenkombinationen benutzt. Welche Tasten verfuegbar
    sind, haengt davon ab, welches Terminalprogramm der User verwendet.
    Sinnvoll ist es, in den Doorway-Modus zu schalten. Lokal sind
    natuerlich alle Tasten verwendbar.

    MxXEd benutzt die Maximus-Konfiguration in allen Bereichen:

    Bei Mailareas, in denen das HiBit-Flag nicht gesetzt wurde
    (siehe Maximus Dokumentation), konvertiert MxXEd automatisch die
    Umlaute!

    MxXEd beachtet die in der MAX.CTL in der System-Sektion gesetzten
    Flags fuer Netmails. Mehr dazu bitte in der Maximus-Doku nach-
    schlagen.

    Mehr zur Bedienung und eine genaue Beschreibung zu den einzelnen
    Tastenbefehlen befindet sich in der Datei MXXED.HLP - die, in MxXEd
    remote mit ? und lokal mit F1 angezeigt werden kann.

Ŀ
 Installation als Online Editor 

    Zum Start von MxXEd sind folgende Dateien notwendig:

      MXXED.EXE - das Programm
      MXXED.CFG - die Konfiguration
      MXXED.TPL - Template, anhand dessen neue Msgs ersteltt werden.
      MXXED.HLP - die Online-Hilfe.

    Diese Dateien koennen in ein beliebiges Verzeichnis kopiert werden, z.B.
    nach \MAX\MXXED, also ein Unterverzeichnis des Maximus-Verzeichnisses. Die
    angegebenen Beispiele gehen davon aus, dass sich die Dateien in diesem
    Verzeichnis befinden.

    MxXEd/2 benoetigt zum Start die Angabe der Maximus-Nodenummer (nicht
    die Fidonet-Nodenummer, sondern die von Maximus. vgl. Multinode operation
    in der Maximus Dokumentation) und den COM-Handle. Alle weiteren Daten
    werden aus den Maximus Config Files ausgelesen.

    Aufruf-Parameter:

       MXXED /H:xx /K:<nodenumber> [optional params]

           /H:xx         = COM handle, das benutzt werden soll
                           (NICHT die COM-Port Nummer!)
           /K:XX         = Nodenummer von Maximus
                           (Nicht die Fido-Nodenummer, sondern die Nummer
                            der Line)

       folgende optionale Parameter werden akzeptiert:

           /C:<mxxedcfg> = Config-Datei fuer MxXEd, falls nicht im
                           aktuellen Verzeichnis oder in dem der
                           EXE-Datei. (mehr dazu in der Beispiel-Config)
           /L:<lreadidx> = Lastread Index des Users (nur im
                           lokalen Modus)
           /M:<maxdir>   = Verzeichnis, in dem die Konfigfiles
                           von Maximus (MAREA.*, USER.BBS und
                           ACCESS.*) stehen, normalerweise das
                           Maximus-Verzeichnis, nur noetig, wenn
                           es nicht das aktuelle Verzeichnis ist.
           /S:<msgbase>  = Basisverzeichnis der Messagebase,
                           falls die Angabe in marea.dat nicht
                           vollstaendig ist.
           /N:<nodelist> = Basisverzeichnis der Nodeliste, falls die
                           Angabe in max.prm nicht vollstaendig ist.

           Die Switches /S: und /N: koennen benutzt werden, um
           z.B. MxXEd von einem anderen Rechner aus zu starten.
           Das angegebene Verzeichnis wird _ohne_ Plausibilitaets-
           pruefung einfach vor den in MAREA.DAT/MAX.PRM angegebenen
           Pfad gesetzt. Normalerweise sind sie nicht notwendig.


           /R:<time>     = Starte den Hintergrund-Rescan alle <time> Sekunden.
                           (default: no rescan)
                           Hinweis: Einige User haben mir mitgeteilt, dass
                                    MxXEd/2 beim Beenden nach dem
                                    Herunterzaehlen haengenbleibt.
                                    Dies kann mittels /R:0 verhindert werden.

           Mit folgendem Parameter kann man bestimmte Daten vorbestimmen:

           /E:[dest_name[@destaddr]]/[area]/["subject"]

                   [dest_name] = destination name of msg.
                                 (defaults to sysop name)
                   [destaddr]  = destination address of msg. if needed
                   [area]      = area to post msg in (defaults to Maximus
                                 comment area)
                   ["subject"] = subject of message (defaults to "Comment
                                 from <username>")

           /A:<area>     = legt eine Startarea/-division fest.
           /F:<area>     = beschraenkt den Zugriff auf eine Area/division.


    Beispielaufruf aus der MENUS.CTL:

    Menu Message
      UsrRemote reread Xtern_Run  \max\mxxed\MxXEd.exe_/H:%P_/K:%k disgrace/x "MxXEd"

    Man kann diese Zeilen auch in eine eigene MECCA-Datei eintragen,
    dann sieht der Aufruf in der MENUS.CTL wie folgt aus:

    Menu Message
            Display_File  Mail\MxXEd\mxxed      Limited/B    "M"

    Die Datei MXXED.MEC sieht folgendermassen aus:

    ------------------- MXXED.MEC -------------------------
    Starting MxXEd Maileditor, please wait ...

    [Xtern_Run]\max\mxxed\mxxed.exe /H:%P /K:%k
    -------------------------------------------------------

    Um MxXEd zu benutzen, wenn der User beim Logoff noch eine Nachricht
    hinterlassen will, kann man folgende Zeile in die Konfiguration aufnehmen:
    (Bitte Zeilen bei ... zusammenfuegen.)

      UsrRemote reread Xtern_Run ...
        ... \max\mxxed\mxxed.exe_/H:%P_/M:\MAX_/K:%k_/E://"Kommentar_zu_Deiner_Box" ...
        ... disgrace "Kommentar an Sysop"

      UsrLocal reread Xtern_Run ...
        ... \dfue\max\mxxed\mxxed.exe_/K:%k_/E://"Kommentar_zu_Deiner_Box" ...
        ... disgrace "Kommentar an Sysop"

    Und mit folgendem Aufruf kann man den User auch einen Kommentar an den Cosys
    schreiben lassen:

      UsrRemote reread Xtern_Run ...
        ... \max\mxxed\mxxed.exe_/H:%P_/M:\MAX_/K:%k_/E:Co-Sysop//"Kommentar_zur_Box" ...
        ... disgrace "Kommentar an Co-Sysop"

      UsrLocal reread Xtern_Run ...
        ... \dfue\max\mxxed\mxxed.exe_/K:%k_/E:Co-Sysop//"Kommentar_zur_Box" ...
        ... disgrace "Kommentar an Co-Sysop"


Ŀ
 Config-Datei 

    In der Config-Datei zu MxXEd fangen alle Zeilen, die als Kommentar
    gelten sollen, mit einem ; (Strichpunkt) an. Die hier erklaerten
    Befehlswoerter werden in der Config-Datei nochmals kurz beschrieben.

    Befehle sind klein geschrieben, die Parameter werden in spitze
    Klammern gestellt. In der Config-Datei wird Gross-/Kleinschreibung
    nicht beachtet

    lastread=<NUMMER> : Irgendeine Nummer fuer den Lastread-Index, der
                        fuer die Squish-Dateien gefuehrt wird. Fuer den
                        Sysop wird normalerweise die 0 eingesetzt.
                        Sollte Dein Sysop-Name nicht mit dem Index 0
                        uebereinstimmen, kannst Du ihn mit den zwei bei-
                        liegenden Programmen aendern. Siehe dazu den
                        passenden Abschnitt weiter unten.
                        (vgl. Kommandozeilen-Parameter /L )

    maxdir=<PFAD> : Verzeichnis, in dem die Konfigfiles von Maximus
                    (MAREA.*, USER.BBS und ACCESS.*) stehen, normaler-
                    weise das Maximus-Verzeichnis, nur noetig, wenn es
                    nicht das aktuelle Verzeichnis ist.
                    (vgl. Kommandozeilen-Parameter /M )

    msgbase=<PFAD> : Basisverzeichnis der Messagebase, falls die
                     Angabe in MAREA.DAT nicht vollstaendig ist.
                     (vgl. Kommandozeilen-Parameter /S )

    nodelist=<PFAD> : Basisverzeichnis der Nodeliste, falls die
                      Angabe in MAX.PRM nicht vollstaendig ist.
                      (vgl. Kommandozeilen-Parameter /N )

    helpfile=<PFAD>\<DATEI> : Verzeichnis und Datei fuer die Anzeige
                              der Hilfe (HelpFile) im Editor mit ?
                              Standardmaessig wird das File MXXED.HLP
                              im Verzeichnis von MXXED.EXE angezeigt.
                              Achtung: Bei Aenderungen im Help-File
                                       (z.B. Uebersetzungen) muessen
                                       die Kapitelmarkierungen und -nummern
                                       unbedingt gleich bleiben, sonst
                                       funktioniert die Online Hilfe
                                       nicht mehr.

    template=<PFAD>\<DATEI> : Verzeichnis und Datei fuer die Template
                              Funktion des Editors beim Schreiben einer
                              Mail. Normalerweise ist das die Datei
                              MXXED.TPL im Verzeichnis von MXXED.EXE.
                              Mehr zu dem Template-File siehe im
                              Abschnitt Template.

    BrowseFields=<BEFEHL> : Beeinflusst die Darstellung der Nach-
                            richtenliste. Folgende Varianten sind moeglich:

                            Befehl     Beschreibung              Taste

                            MsgNum     Messagenummer             N
                            FromName   Absendername              F
                            ToName     Empfaengername            T
                            Subject    Betreff                   <keine>
                            DTWritten  Uhrzeit, zu der die Mail  W
                                       geschrieben wurde
                            DTArrived  Uhrzeit, zu der die Mail  A
                                       im System angekommen ist

    Lines=<ANZAHL> : Hier werden die Anzahl der Zeilen im Offline-Modus
                     gesetzt. Im Online-Modus wird diese Angabe direkt
                     aus der LASTUSxx.BBS gelesen.


    ColorXX=<FARBCODE> : Hier koennen fuer die verschiedenen Elemente Farbcodes
                         eingestellt werden. Welcher Color-Code fuer was steht
                         kann man der beiliegenden Datei MXXED.COL entnehmen.

                         Die Farben werden als zweistellige Hex-Zahl
                         angegeben, die erste Stelle gibt die Vordergrund-
                         farbe, die zweite die Hintergrundfarbe an.

                         Beispiel:
                         Color29=0F
                         Konfiguriert fuer den Areaselector Schwarz
                         auf Weiss.

    RulesPath=<PFAD> : Hier stehen die Rules-Dateien, die mit Shift-F1
                       bzw. * angezeigt werden.


Ŀ
 Templates 

    Wie eine Mail aussieht, bestimmt der Benutzer des Editors, aber man kann
    ihm eine kleine Hilfe geben oder auch nur seine Faulheit unterstuetzen.
    ;-). Vor allem wenn Nachrichten weitergeleitet (FORWARD), verschoben oder
    kopiert (MOVE und COPY) werden.

    Oft sind dann irgendwelche Textstellen sinnvoll, die darauf hinweisen,
    was mit der angezeigten Mail geschehen ist.

    Templates koennen auch fuer einzelne Areas gesondert vorgegeben werden.
    Bei Squish-Areas heisst diese Datei wie die zugehoerige Squish-Base aber
    mit der Extension *.TPL, z.B. \msgbase\ger\os2prog.tpl
    Bei *.MSG-Areas heisst sie MXXED.TPL und steht im Verzeichnis der Area.
    MxXEd sucht immer zuerst nach einem arespezifischen Template.

    Im folgenden wird nur kurz aufgezaehlt welche Template-Befehle (Tokens)
    MxXEd kennt. In der Beispiel Datei MXXED.TPL ist dann eine Moeglichkeit
    gezeigt.

    Wie auch in der Config-Datei fangen Kommentare mit einem ; (Strich-
    punkt) in der ersten Spalte an.

    Alle Tokens fangen mit einem @ (Klammeraffen) an. Alle sonstigen
    Zeichen werden genau so, wie sie im Template stehen, in die Mail
    uebernommen.

     @Follow    = Die Zeilen mit diesem Token werden bei einem Reply in
                  einer anderen Area eingefuegt.

     @Moved     = Die Zeilen mit diesem Token werden beim Verschieben
                  einer Nachricht eingefuegt.

     @Copied    = Die Zeilen mit diesem Token werden beim Kopieren
                  einer Nachricht eingefuegt.

     @Reply     = Die Zeilen mit diesem Token werden fuer Replys ohne
                  Quotes verwendet.

     @Request   = Die Zeilen mit diesem Token werden eingefuegt, wenn
                  ein Filerequest erzeugt wird. Bitte mit Vorsicht benutzen,
                  denn normalerweise sollte bei einem Filerequest eine leere
                  Mail mitgeschickt werden.

     @Changed   = Die Zeilen mit diesem Token werden eingefuegt, wenn
                  eine fremde Nachricht geaendert wird.

     @Own       = Die Zeilen mit diesem Token werden eingefuegt, wenn man
                  eine eigene Nachricht anfaengt (nicht Change/Copy/Move)

     @Comment   = Diese Zeilen werden bei einem Comment-Reply eingefuegt.

     @Quoted    = Diese Zeilen werden bei einem Reply mit Quotes eingesetzt.

     @New       = Diese Zeilen (z.B. Leerzeilen) fuer alle neuen
                  (nicht Reply-) Nachrichten.

     @Quotes    = Hier werden die Quotes der Originalnachricht eingefuegt.

     @Forward   = Die Zeilen mit diesem Token werden bei einem Forward
                  (Weiterleitung einer Nachricht) eingefuegt.

     @Message   = Hier kommt bei Forward, Copy, Move und Change die
                  Originalnachricht hin.

     @Position  = Hier wird der Cursor eingefuegt - kann auch hinter einem
                  anderen Token stehen.

     @CAddr     = aktuelle Anwender Adresse
     @CDate     = aktuelles Datum
     @CLName    = aktueller Nachname (Anwender)
     @CName     = aktueller Benutzername
     @CFName    = aktueller Vorname (Anwender)
     @CTime     = aktuelle Zeit
     @DName     = Empfaenger Name
     @DFName    = Empfaenger Vorname
     @DLName    = Empfaenger Nachname
     @OAddr     = Original Adresse
     @ODate     = Original Datum
     @ODesc     = Original Area Beschreibung wenn entfernt, sonst die
                  aktuelle
     @OEcho     = Original Echoid wenn entfernt, sonst die aktuelle
     @OFName    = Original Vorname
     @OLName    = Original Nachname
     @OName     = Originalname
     @OTime     = Original Zeit
     @Subject   = die Nachrichten Subject Zeile
     @TName     = Empfaenger Name
     @TFName    = Empfaenger Vorname
     @TLName    = Empfaenger Nachname

     @@         = ergibt ein einfaches @, damit man z.B. auch Internet-
                  adressen angeben kann.


Ŀ
 Rules-Anzeige 

    Mit Shift-F1 (lokal) bzw. * (remote) kann eine Datei mit den Rules der
    jeweiligen Area angezeigt werden.

    Bei Squish-Areas heisst diese Datei wie die zugehoerige Squish-Base aber
    mit der Extension *.SQR

    Beispiel:
    echoarea os2.ger m:\msgbase\os2 -> Rules = m:\msgbase\os2.sqr

    Bei *.MSG-Areas heisst sie rules.bbs und steht im Verzeichnis der Area.
    Alternativ koennen die Rules auch in einem gesonderten Verzeichnis
    gesammelt werden. Dies muss in der MXXED.CFG mit RULESPATH angegeben
    werden.
    Achtung: In diesem Fall muessen alle Areas unterschiedliche Dateinamen
             haben, also nicht OS2.GER=\ger\os2 und OS2=\intern\os2.
    Wenn Rules gefunden wurden, wird ein Hinweis in der Statuszeile
    angezeigt.


Ŀ
 Tools 

    ChgLrIdx - ChangeLastreadIndex

      Mit diesem Programm kann man den LastreadIndex von zwei Usern
      tauschen. Wenn zum Beispiel ein anderer User als der Sysop den
      Index 0 hat und dies stoerend ist, sucht man sich einfach den
      User mit Index 0 und tauscht sie gegeneinander aus.
      Normalerweise ist es sowieso unsinnig, wenn ein anderer User
      als der Sysop den Index 0 hat, da die meisten externen Tools
      und Editoren diesen Index benutzen.
      Dieser User hat sich dann bestimmt schon gewundert, wieso sich
      sein Lastread-Pointer ohne sein Zutun veraendert hat ;-)

      Befehl:

        ChgLrIdx <OrigUserBBS> <NewUserBBS> <Lastread index> <Username>

      Beispiel:

        Wenn JOCHEN SCHNUERLE = 0 und THOMAS MUELLER = 1

        CHGLRIDX USER.BBS  USER1.BBS 0 THOMAS MUELLER

        Ergebnis: In USER1.BBS hat JOCHEN SCHNUERLE den Index 1 und
                  THOMAS MUELLER den Index 0.

        Das gleiche Ergebnis kann man auch mit diesem Aufruf erzielen:

        CHGLRIDX USER.BBS USER1.BBS 1 JOCHEN SCHNUERLE

        Aus Sicherheitsgruenden darf der Dateiname von <OrigUserBBS> und
        <NewUserBBS> nicht uebereinstimmen, wenn alles klargeht, muss man
        hinterher natuerlich die Datei umkopieren.
        Dieses Programm ist ein Quick'n'dirty Hack, der bei mir
        (Thomas W. Mueller) und Jochen funktioniert. Benutzung auf eigene
        Gefahr!


    SortUserBBS

      Sortiert die USER.BBS Datei nach dem LastreadIndex neu.

      Befehl:

        SortUser <OrigUserBBS> <NewUserBBS>

      Beispiel:

        SORTUSER USER.BBS USER1.BBS

      Auch hier gilt das unter ChgLrIdx Gesagte!


Ŀ
 MxXEd als Offline-Editor 

    Natuerlich kann MxXEd auch offline - also ohne Mailbox benutzt werden,
    so dass der Sysop sich das Geld und den Konfigurationsaufwand fuer einen
    weiteren Editor sparen kann.
    Dazu wird dann nicht die LastusXX.BBS ausgelesen, denn die existiert
    ja nur, wenn MxXEd aus Maximus heraus aufgerufen wird.
    Der Parameter /l:<lastreadidx> gibt in diesem Fall an, welcher
    Eintrag der user.bbs benutzt werden soll, fuer den Sysop in der Regel
    die 0.

    mxxed.exe /m:\max /l:0

    Alternativ kann der Eintrag lastread in MXXED.CFG verwendet werden.
    Solltet Ihr keine Berechtigung fuer die Netmailarea haben oder
    sonst irgendwelche Probleme auftreten, ueberprueft zuerst, ob
    Euer Username auch wirklich den Lastread Index 0 hat und aendert
    ihn gegebenenfalls mit dem beigefuegten Tool.


Ŀ
 Rueckgabe-Werte 

    Besser bekannt als Errorlevel werden von MxXEd auch zurueckgegeben.
    Dabei werden so oft wie moeglich die Einstellungen von Maximus
    uebernommen. (Die Beschreibungen stammen aus der deutschen
    Uebersetzung der Maximus Dokumentation.)

    Errorlevel

     [ 0] Carrier Lost und Timeout, wie in der MAX.CTL angegeben:

           Input Timeout <Minuten>
             Hiermit wird Maximus angewiesen, nach <Minuten> In-
             aktivitaet des Benutzers die Verbindung abzubrechen.
             Die Standardeinstellung ist 4 Minuten. Der zulaessige
             Bereich fuer dieses Schluesselwort ist 1 bis 255 Minuten.


     [ 1] Fehler

     [ 5] Errorlevel nach Beenden ohne Mail-Eingabe, wie in der MAX.CTL
          angegeben:

           After Call Exit <Errorlevel>
             Dieses Schluesselwort instruiert Maximus, welchen Errorlevel
             es nach dem LogOff eines Benutzers benutzen soll, sofern
             dieser keine Nachricht eingegeben hat.

     [11] Errorlevel nach EchoMail-Eingabe, wie in der MAX.CTL angegeben:

           After EchoMail Exit <Errorlevel>
             Dieses Schluesselwort gibt Maximus den Errorlevel an,
             welchen es zu benutzen hat, wenn ein Benutzer EchoMail
             eingegeben hat. Dieser Eintrag hat hoehere Prioritaet
             als der bei "After Edit" angegebene Errorlevel.

     [12] Errorlevel nach Netmail-Eingabe, wie in der MAX.CTL angegeben:

           After Edit Exit <Errorlevel>
             Dieses Schluesselwort gibt Maximus den Errorlevel an,
             welchen es zu benutzen hat, wenn ein Benutzer NetMail
             eingegeben hat. Dieser Eintrag hat eine geringere
             Prioritaet als der bei "After EchoMail" angegebene
             Errorlevel.

     [13] Errorlevel nach Lokal-Mail-Eingabe, wie in der MAX.CTL angegeben:

           After Local Exit <Errorlevel>
             Dieses Schluesselwort gibt Maximus den Errorlevel an,
             welchen es zu benutzen hat, wenn ein Benutzer lokale
             Nachrichten eingegeben hat. Dieser Eintrag hat eine
             geringere Prioritaet als die beiden bei "After EchoMail"
             und "After Edit" angegebenen Errorlevel.


Ŀ
 spezielle Features 

    ECHOAREA.LOG

      Wenn in der Maximus-Config unter "Matrix and Echomail Section"
      der Parameter "log echomail" angegeben wird, schreibt MxXEd
      eine Liste der Areas, in denen Mails geschrieben wurden, in
      diese Datei. Achtung! Die Datei wird nicht ueberschrieben,
      neue Eintraege werden nur angehaengt, fuer das gelegentliche
      Loeschen muss der Sysop selbst sorgen.

    Speichern / Drucken / Download

      Mit W in der Messageansicht kann die aktuelle Msg. in eine
      Datei bzw. auf den Drucker oder in das zur Area gehoerende
      Rules-File geschrieben werden. Remote ist auch ein Download
      der Msg moeglich. Schreiben auf die lokale Platte bzw. auf
      den Drucker duerfen nur User mit der Berechtigung fuer
      MsgXport (override message Msg_XPort).
      Achtung! Dies ist ein potentiell gefaehrliches Kommando,
      da evtl. auch z.B. ein boeswilliger User die config.sys
      ueberschreiben kann, wenn die Berechtigungen nicht stimmen.
      Deshalb ist dieser Befehl in MxXEd nur fuer den Sysop
      zugaenglich und muss explizit per Override fuer z.B. den
      Cosys freigegeben werden.

    Maximus Alias System

      MxXEd unterstuetzt das Alias-Systen von Maximus. Wichtig ist,
      dass es 1. aktiviert ist und 2. auch ein Alias fuer den User
      existiert, sonst wird immer der Realname verwendet.
      * Bei Areas, in denen auch anonyme Mails zugelassen sind (das sind
        solche, bei denen weder der Realname noch der vorgegebenen Alias
        benutzt werden muss, vgl. Areastyle Anon), bekommt man die Auswahl
        zwischen Realname und Alias, wenn man bei *leerem* Eingabefeld
        Tab, Return oder Down drueckt.
      * In Areas, in denen nur Realname oder Alias zugelassen sind
        (Areastyle weder Alias noch RealName, aber das Aliassystem
        aktiviert), kommt diese Auswahl bei jeder Eingabe in das
        Absenderfeld.
      * Bei Areas mit Areastyle Alias bzw. RealName wird dieser zwangsweise
        gesetzt und kann nicht geaendert werden.
      (Ich hoffe, ich habe damit das Verhalten von Maximus einigermassen
      getroffen. Da ich das Aliassystem nicht benutze, habe ich wenig
      Testmoeglichkeiten.)
      Die Template-Token CNAME, CFNAME und CLNAME beziehen sich bei
      Verwendung eines Alias auf diesen Alias und nicht auf den Realnamen.
      Die Config-Einstellung "No RealName Kludge" und der Areastyle
      NoNameKludge wird ebenfalls unterstuetzt. Zu beachten ist, dass
      der Areastyle die Config-Einstellung *um*schaltet. Maximus macht
      das uebrigens laut Doku genauso.

    Binkley und andere "Dumb"-Terminals
      Das interne Terminalprogramm von BinkleyTerm und diverse andere
      unterstuetzen die ANSI-Sequenz zum Loeschen einer Zeile nicht.
      Da dies aber die effizienteste Methode zum Scrollen ist, moechte
      ich die Benutzer "intelligenterer" Terminalprogramme nicht bestrafen.
      Deshalb bekommt jeder User beim ersten Start von MxXEd einmalig eine
      Abfrage zu sehen, mit der festgestellt wird, ob sein Terminalprogramm
      zur Gruppe der "Dumb"-Terminals gehoert. MxXEd speichert dann das
      Ergebnis in MXXUSER.BBS, so dass der User sich darum nicht mehr
      kuemmern muss.

    V7+ Nodelisten
      Die neueste Version von Fastlist kann eine sog. V7+ Nodeliste erzeugen,
      die einige Mankos des V7-Formats behebt (Stichwort: Gross- Klein-
      schreibung und Punkte in den Sysopnamen.)
      Dieses Format ist abwaertskompatibel zu V7 und stellt somit kein
      Problem mit "alter" Software dar.
      MxXEd unterstuetzt dieses Format.

Ŀ
 Netmail-Flags 

    MxXEd beachtet die Message Edit Eintraege in der Matrix and EchoMail
    Sektion in der MAX.CTL bei den Mailflags:

    Message Edit <Aktion> <Attribute> <Zugriffsberechtigung>

       Die Reihe der "Message Edit"-Schluesselworte instruiert Maximus
       bezueglich des gewuenschten Verhaltens, wenn ein Benutzer eine
       Nachricht in einem NetMail-Bereich eingibt.

       Wenn im Eintrag <Aktion> der Befehl ASSUME steht, setzt MxXEd
       automatisch diese Flags.

       Wenn im Eintrag <Aktion> der Befehl ASK steht, stellt MxXEd die
       dahinterstehenden Eintraege in der Flag-Auswahlbox zur Auswahl
       dar.

       Gueltige Eintraege fuer <Attribut> sind:

           * Private
           * Crash
           * FileAttach
           * KillSent
           * Hold
           * FromFile
           * FileReq
           * UpdateReq
           * LocalAttach

       Beispiel:

           Message Edit Assume Private       Normal
           Message Edit Assume Crash         Hidden
           Message Edit Assume FileAttach    Hidden
           Message Edit Assume KillSent      Hidden
           Message Edit Assume Hold          Hidden
           Message Edit Assume FileRequest   Hidden
           Message Edit Assume UpdateRequest Hidden

           Message Edit Ask Private          Hidden
           Message Edit Ask Crash            Sysop
           Message Edit Ask FileAttach       Sysop
           Message Edit Ask KillSent         Hidden
           Message Edit Ask Hold             Sysop
           Message Edit Ask FileRequest      Hidden
           Message Edit Ask UpdateRequest    Hidden
           Message Edit Ask LocalAttach      Normal

       Achtung! Default-Einstellung bei Maximus ist

           Message Edit Assume Crash         Sysop

       d.h. die Mails, die der Sysop schreibt, bekommen standardmaessig das
       Crashflag. Das duerfte meist nicht erwuenscht sein.


Ŀ
 Kontrollzeichen / Zeilen 

    A Kludge Zeilen:
    ~~~~~~~~~~~~~~~~
    Kludge Zeilen sind besondere Steuerzeilen, die mit einem ^a (ASCII 1)
    als erstes Zeichen beginnen. Nach dem Steuerzeichen folgt ein Befehl
    (siehe Liste unten) und die Information. Folgende Kludges werden von
    MxXEd unterstuetzt:

    MSGID: <origaddress> <serialno>
      Wie im Fidodokument FTS-0009 beschrieben ist dies eine Methode zur
      eindeutigen Identifikation der Nachricht. Findet Anwendung fuer Dupe
      Check und Replylinking.

      Beispiel: ^aMSGID: 2:2474/10 32c56444

    PID: <identifier> <Version> [serialno]
      Dies ist kein offizielles Kludge, wird aber im Fidodokument FSC-0046
      als Vorschlag gut beschrieben. Schreibt einen Hinweis, mit was diese
      Mail erstellt wurde, - dies wird nicht wie bei der Tearline von einer
      nachfolgenden Software wie z.B. Tosser veraendert.

      Beispiel: ^aPID: GED/2 A0715 636ML3
                ^aPID: FleetStreet 1.18+

    REPLY: <replyaddress> <replyserialno>
      Definiert in FTS-0009, beim Beantworteten einer Message mit MSGID:,
      wird die MSGID: des Originals in REPLY: uebernommen.

      Beispiel: ^aREPLY: 2:240/5353.0 2c4e5421

    CHARSET:<charset identifier>
      Vorgeschlagen in FSC-0050 und FSC-0054, diese Kludge ist ein Versuch
      eine Loesung fuer das Problem der high-Bit Zeichen (wie IBM PC vs
      Amiga vs Mac usw. nationale Zeichen) in Nachrichten zu finden.

    CHRC:<font change id>
      Vorgeschlagen in FSC-0054, dies ist ein Kludge zum Aendern der
      Schriftart, Unterstreichen und anderen Dingen.

    CHRS:<charset identifier>
      Alternative FSC-0054 Version der Zeichensatz Kludge.

      Beispiel: ^aCHRS: IBMPC 2

    INTL <destaddress> <origaddress>
      Festgelegt in FTS-0001, loest das Problem der fehlenden Zonennummer
      bei Netmails in einer Area.

      Beispiel: ^aINTL 2:240/5353 2:2474/10

    TOPT <to point>
      Definiert in FTS-0001, enthaelt die Point Zieladresse. Nur fuer
      Netmail. MxXEd erzeugt bei Bedarf diese Zeile.

      Beispiel: ^aTOPT 44

    B Tearline:
    ~~~~~~~~~~~
    In der Tearline wird das Programm, das diese Mail bearbeitet hat, ein-
    getragen. Wenn es nicht vom Tosser veraendert wird, ist dies meistens
    der Maileditor. Die Tearline kann bis zu 30 Zeichen lang sein
    (abzueglich der fuehrenden "--- ").

    Beispiel:  --- MxXEd/2 0.04b5

    C Origin:
    ~~~~~~~~~
    Schliesst eine Mail ab - meistens werden irgendwelche Sprueche oder
    Werbezeilen in die Origin geschrieben. Wichtig ist die am Ende stehende
    Fido-Adresse, sie gibt an, wer diese Mail erstellt hat. Dies ist die
    *einzige* per FTS definierte Methode, wie man die Absenderadresse einer
    Echomail bestimmen kann.

    Beispiel: * Origin: Written by my Boxuser - BetaBox  (2:2474/10)

    D VIA:
    ~~~~~~
    Diese Control-Zeilen treten nur bei Netmails auf und zeigen wie die
    Mail geroutet wurde. Dadurch kann man verfolgen wann die Mail welche Station auf
    dem Weg vom Absender bis zum Empfaenger passiert hat.

    Beispiel:
    ^aVia 2:24/99@FiDoNeT @19961228.104728.78.UTC Itrack+
    ^aVia 2:2474/0@FidoNet @19961229.001352.02.UTC Itrack+
    ^aVia SFSQ/32 0.98.2 2:2474/10.0, Sat Dec 28 1996 at 19:28


Ŀ
 Anhang 

    A Probleme, Fehlende Funktionen
    -------------------------------
      Ja - sowas soll es bei einem Programm auch geben - damit die
      Probleme aber nicht unerkannt bleiben oder Wuensche nicht zu
      mir durchdringen, steht in der Datei MXXED.TD (TD fuer ToDo)
      eine Liste mit Bugs and Features. Weitere Anregungen werden gerne
      entgegengenommen.
      Bei Bugreports bitte unbedingt die verwendete Version von MxXEd
      angeben und die (hoffentlich) automatisch erzeugte Datei mxxed.err
      mitschicken.


    B Andere Betriebsysteme
    -----------------------
      MxXEd/2 gibt es nur als OS/2-Version, und es wird definitiv keine
      DOS Version geben. Eine Win32-Version ist evtl. etwas naeher
      gerueckt, da Virtual Pascal seit Version 2.0 auch Win32 als
      Plattform unterstuetzt. Trotzdem fehlen noch jede Menge Module
      fuer Win32: Z.B. Squish-Unterstuetzung und Com-Port Behandlung,
      um nur zwei zu nennen.
      Wer ernsthaft an einer Win32-Version interessiert ist (die
      vermutlich nur unter Windows NT laufen wird, da es unter Win95
      Probleme mit der Uebergabe geoeffneter Com-Port handles gibt),
      moege sich bei mir melden.


    C Hilfe, Tips und Fehlermeldungen
    ---------------------------------
      Bugreports bitte an mich (Thomas W. Mueller) unter folgenden
      Adressen:

        Thomas W. Mueller
        Fidonet...: 2:2454/917
        email.....: mxxedbug@s2h.cx


    D Programmversionen
    -------------------

      MxXEd ist im Internet auf meiner Homepage unter
      http://www.s2h.cx erhaeltlich. Dies ist sehr wahrscheinlich
      die letzte Version, denn ich setze sei Jahren kein OS/2 mehr
      ein.


    E Danksagung
    ------------
      Ich bedanke mich bei meinen Betatestern und allen, die mich bei
      der Entwicklung dieses Programms auf die eine oder andere Weise
      unterstuetzt haben und dies noch tun.

      Speziell gilt mein Dank:
      ------------------------
        * Peter Meerwald fuer seine Umsetzung der Squish MsgApi fuer
          Virtual Pascal, die mich erst auf die Idee gebracht hat,
          einen Messageeditor zu schreiben
        * Mike Nix, fuer die Umsetzung der Maximus CTL-Files in Pascal
          (leider nicht vollstaendig)
        * Matt Scott, von dessen xgetch.mh ich die Cursorsteuerung
          abgeschaut habe
        * Jim Dailey fuer die gute Dokumentation seiner V7NL.DLL, die
          mir die Implementation des Nodelist-Lookups sehr erleichtert
          hat
        * Joy Mukherjee, dessen V7Engine ich urspruenglich als Grundlage
          benutzt habe (Leider waren so viele Bugs drin, dass ich meine
          Routinen dann doch von Grund auf neu geschrieben habe.)
        * fPrint UK und Vitaly Miryanov fuer Virtual Pascal, einfach ein
          genialer BP-Clone fuer OS/2
        * Scott Dudley und Lanius Corp. fuer Maximus und Squish und die
          leider etwas fehlerbehaftete MsgApi32.DLL
        * Michael Buenter, der mit seiner Binkley EE Version massgeblich
          dazu beigetragen hat, dass mir Fido unter OS/2 Spass gemacht
          hat
        * Jochen Schnuerle, der mich immer wieder genervt hat, dass ich
          doch endlich die Schreibfunktion einbauen soll, und der mein
          mageres Readme in die Urspruengliche Version dieser Anleitung
          umgesetzt hat. Und der ausserdem meine fast taeglichen Betas
          immer wieder klaglos getestet hat. Leider musste er aus mir
          unbekannten Gruenden seine Mailbox aufgeben. (Hallo Jochen,
          melde Dich doch mal!)

      Und nicht zuletzt meiner Freundin, die jetzt seit vielen Jahren
      meine Fido- und Computerbesessenheit ertragen hat. :-)


    F Programmvertrieb
    ------------------

      MxXEd/2 ist jetzt FREEWARE und braucht deshalb nicht mehr
      registriert werden.


    G Copyrights
    ------------

       Virtual Pascal ist copyrighted by fPrint Uk Ltd.
       Maximus ist copyrighted by Scott J. Dudley, Lanius corp.
       OS/2 und OS/2 Warp ist copyrighted by IBM corp.
       Bug ist copyrighted by Microsoft corp.


    H sonstiges
    -----------

       Auch wenn ich zu dem Zeitpunkt, als ich MxXEd/2 entwickelte fuer
       die Firma fPrint Uk Ltd. arbeite, so hat dieses Programm nichts mit
       meinem Arbeitgeber zu tun. Er hat weder Rechte an MxXEd noch
       irgendwelche Verpflichtungen gegenueber den Usern.
