@DATABASE BrettEd.guide @node MAIN T.O.M. Software _______ _____ __________ __ _______ / ___ /\ /\ / ___ \ / ___ ___ \ /_/\ / _____/\ / /__/ / // \ / /\_/ /\ / /\_/ /__/ /\ _\_\// /\____\/ / ___ / // \/ / // / // / // ___ / // /\ /____ /\ / /\_/ /_// /\ / // /_// / // /__/ / // /_/_\___/ / / /_/ //______/ /\_ / //______/ //______/ //___________/ / \_\/ \______\/ \_\/ \______\/ \______\/ \___________\/ Allgemeines Nachrichten - und Binär - Informations - System ----------------------------------------------------------------------------- ANUBIS BrettEditor V 0.77 ----------------------------------------------------------------------------- @{" Einleitung " link EINLEITUNG} Sinn des BrettEd @{" Die Brettliste " link BRETTLISTE} Die Liste der Bretter @{" Gadgets " link GADGETS} Die Gadgets @{" Das Editwindow " link EDITWINDOW} Editieren eines Eintrags @{" Schnittstellenhandling " link SCHNITTSTELLE} Schnittstelle zu ANUBIS @{" Versionsnummern " link VERSIONEN} bisherige Versionen ----------------------------------------------------------------------------- 18.09.93 * 15:32:07 * Olli ----------------------------------------------------------------------------- @endnode @node EINLEITUNG "Einleitung" Der BrettEditor stellt dem Sysop auf lokaler Ebene eine umfangreiche und komfortable Möglichkeit zur Verfügung, die Brettliste seiner Box zu be- arbeiten. Der BrettEd benötigt das Verzeichnis "Anubis:Daten", um die Liste zu speichern. Der BrettEd benötigt die req.library, die Bestandteil des ANUBIS Paketes ist. Der BrettEd ist fester Bestandteil des ANUBIS Paketes und darf nur mit diesem weitergegeben werden. Es gelten die im File ANUBIS.guide festgelegten Urheberrechtsbestimmungen. Autor : Oliver Graf - T.O.M. Software @endnode @node GADGETS "Gadgets" Quit ¯¯¯¯ Dient zum verlassen des Programmes. Sollten Änderungen an der Liste ge- macht worden sein, erscheint eine Sicherheitsabfrage. Save ¯¯¯¯ Speichert die Liste unter "Anubis:Daten/Brettliste". Dabei wird ab Version 0.50 automatisch die alte Brettliste nach "Anubis:Daten/Brettliste.bak" gesichert. Load ¯¯¯¯ Lädt die unter "Anubis:Daten/Brettliste" befindliche Liste. Edit ¯¯¯¯ Schaltet um in den Editiermodus. Es erscheint das @{" Edit Window " link EDITWINDOW} mit den Daten des letzt ausgewählten Eintrag. Diese Funktion kann auch mit einem Doppelklick auf die linke Maustaste über dem entsprechenden Eintrag ausge- führt werden. Dieses Gadget ist nur aktiv, wenn ein Brett in der Brettliste angewählt wurde. Neu ¯¯¯ Mit diesem Gadget wird ein neuer Bretteintrag angelegt. Es erscheint wieder das @{" Edit-Window " link EDITWINDOW} mit leeren Gadgets. Diese Funktion kann auch mit einem Druck auf die rechte Maustaste ausgeführt werden. Löschen ¯¯¯¯¯¯¯ löscht den angewählten Eintrag aus der Liste. Es erscheint eine Sicher- heitsabfrage. Außerdem kann noch das zum Brett gehörige Datendirectory vom Datenträger gelöscht werden. Sollte auf das gelöschte Brett ein weiteres Brett folgen, wird dies automatisch zum aktuell angewählten Brett gemacht. Sollte es sich bei dem aktiven Element um ein Brettverzeichnis handeln, in dem sich noch Unter-Bretter befinden, erscheint eine gesonderte Sicherheitsabfrage. Nach positiver Bestätigung können dann alle Bretter in diesem Verzeichnis gelöscht werden (MAPS-Listen werden automatisch aktualisiert, die Directories werden auch sofort gelöscht). Achtung : Damit kann man sehr sehr viel Schaden anrichten ! Dieses Gadget ist nur aktiv, wenn ein Brett in der Brettliste angewählt wurde. Vorgaben ¯¯¯¯¯¯¯¯ Hier werden alle Daten eingetragen, die bei der Anwahl von "Neu" direkt in die verschiedenen Felder eingetragen werden sollen. Die kann bei der Ein- richtung von mehreren Brettern in einem @{" Brettverzeichnis " link ED.02} sehr viel Arbeit sparen. Drucken ¯¯¯¯¯¯¯ Hiermit kann die komplette Brettliste ausgedruckt werden. Nach der Anwahl des Gadgets wird der FileRequester geöffnet, mit dem Sie bestimmen können, wohin Sie drucken wollen (damit kann die Brettliste auch in ein File gedruckt werden und weiterverarbeitet werden). @endnode @node BRETTLISTE "Die Brettliste" In der Brettliste erscheinen die ersten 20 Einträge der Brettliste in sortierter Reihenfolge. Die Sorterreihenfolge ist alphabetisch, Unter- bretter stehen direkt unter ihren Brettverzeichnissen. Sollten mehr als 20 Bretter in der Liste sein, kann man mittels des Proportionalgadgets auf der rechten Seite durch die Liste scrollen. Mittels der linken Maustaste kann man ein Element aus der Liste anwäh- len. Dazu muß man einfach nur über dem entsprechenden Eintrag einmal auf die linke Maustaste drücken. Der angewählte Eintrag wird invers dargestellt. @endnode @node EDITWINDOW "Das EditWindow" In diesem Window werden alle Daten für das Brett festgelegt. Die Gadgets werden im weiteren von oben nach unten beschrieben. @{" Brettname " link ED.01} @{" Msg Limit " link ED.08} @{" Brettpfad " link ED.02} @{" Routelimit " link ED.09} @{" Diskpfad " link ED.03} @{" Routlimit Point " link ED.10} @{" Paßwort " link ED.04} @{" Brett-Typ " link ED.11} @{" Verwalter " link ED.05} @{" Gruppen " link ED.12} @{" Leselevel " link ED.06} @{" Infozeile " link ED.13} @{" Schreiblevel " link ED.07} @{" Brett Flags " link ED.14} Mittels 'OK' wird der Eintrag in die Liste übernommen, sofern vorher keine @{" Fehlermeldungen " link FEHLERMELDUNGEN} auftreten. 'Abbruch' dient dazu, den ganzen Eingabe- Vorgang abzubrechen. Mit 'Drucken' kann man die aktuellen Eingaben in den Editierpuffer aus- drucken. Nach der Anwahl des Gadgets werden alle Daten zum logischen Device 'prt:' ausgegeben, daß über die Workbench Preferences eingestellt werden kann. Alle Feldbezeichnungen werden im Fettdruck, alle Feldinhalte in Normalschrift ausgedruckt. 'Vererbe' hat ein ganze spezielle Bedeutung : Es ist nur aktiv, wenn das angewählte Brett ein Brettverzeichnis mit Unterbrettern ist. Dann kann man bestimmte Daten, die man am Verzeichniskopf geändert hat, an alle Unter- bretter vererben. Nach der Anwahl dieser Funktion erscheint ein Requester, in dem man alle möglichen Vererbungsparameter einstellen kann. Ist das CheckBox Gadget zu einer Funktion aktiv, wird der entsprechende Wert an die Unterbretter weitergegeben. Wenn in dem aktuellen Eintrag Veränderungen gemacht wurden, sind die entsprechenden Gadgets direkt aktiv. Mittels 'OK' wird der Vererbungsvorgang gestartet. @endnode @node ED.01 "Brettname" Der Name des Brettes innerhalb eines @{" Brettpfad " link ED.02}. Innerhalb einer Ebene darf der Name nur einmal vorkommen. Für den Brettnamen sind die Zeichen "/<>+-*" als erstes Zeichen erlaubt. Umlaute sind im gesamten Namen nicht erlaubt. @endnode @node ED.02 "Brettpfad" Der Name des Brettverzeichnisses, in dem das Brett stehen soll. Der Brettpfad teilt Bretter in logische Einheiten ein. Der Brettpfad muß in der Brettliste mit @{" Brett-Typ " link ED.11} Verzeichnis existieren ! @endnode @node ED.03 "Diskpfad" Ein kompletter AmigaDOS Pfad, in dem alle Daten, die für dieses Brett ge- speichert werden. Wenn das Directory nicht existiert, erscheint bei der Übernahme der Daten ein Requester, der abfragt, ob der Pfad angelegt werden soll. Wenn bei einem neuen Brett ein Verzeichniss angegeben wird, wird der Diskpfad des Verzeichnisses vorgegeben. @endnode @node ED.04 "Paßwort" Ein Paßwort, daß das Brett vor unberechtigtem Zugang schützt. Ein User, der auf das Brett zugreifen will, muß zuvor das korrekte Paßwort ein- geben. @endnode @node ED.05 "Verwalter" Der Name eines Users, der das Brett verwaltet. Dieser Name wird vom BrettEd nicht überprüft, tragen Sie also nur Namen ein, die wirklich existieren. Ein Brettverwalter kann in seinem Brett Nachrichten löschen und crunchen und so dem Sysop die Arbeit erleichtern. @endnode @node ED.06 "Leselevel" Diesen Level braucht ein User oder ein Point zur Anwahl des Brettes. Bretter, die einen höheren Leselevel als der User haben, werden für den User oder den Point nicht angezeigt. @endnode @node ED.07 "Schreiblevel" Diesen Level braucht ein User oder ein Point mindestens, um in dieses Brett Nachrichten schreiben zu können. Bretter mit einem höheren Schreiblevel als der User oder der Point können von diesem nicht beschrieben werden. @endnode @node ED.08 "Msg Limit" Hiermit wird festgelegt, wieviele Nachrichten bei CRUNCH LIMIT herausge- löscht werden sollen. Dies ist unterschiedlich zu der Einstellung des @{" Flags " link ED.14} "Crunch Tage". Ist dieses Flag gesetzt, werden alle Nachrichten, die älter als die hier eingestellte Zeit in Tagen sind, aus dem Brett gelöscht. Im anderen Fall ist dieser Wert das absolute Nachrichtenlimit. Ein Wert von -1 bedeutet unbegrenzte Haltedauer. @endnode @node ED.09 "Routelimit" Gibt die Länge von Nachrichten an, die an die Boxpuffer maximal geroutet werden sollen. Im Z-Netz gilt z.B. eine Maximal Länge von 20 kB. (Dieses Feld nur für den Netz- bzw. Pointbetrieb benötigt). Ein Wert von -1 bedeutet, das alle Nachrichten, gleich welcher Länge, weitergeroutet werden (z.B. für das FRAS). @endnode @node ED.10 "Routlimit Point" Gibt die Länge in Bytes an, bis zu der Nachrichten in diesem Brett an Points weitergeroutet werden sollen. Bei Brettern mit sehr langen Nachrichten (z.B. FRAS/BIN) ist es meistens nicht sinnvoll, diese an alle Points zu ver- teilen. Ein Wert von -1 leitet auch hier alle Nachrichten weiter. @endnode @node ED.11 "Brett-Typ" In diesem Gadget können Sie den Typ des Brettes durchschalten. Folgende Brett-Typen sind definiert : ASCII - Ein Brett für Textnachrichten auf lokaler Ebene. Binär - Ein Brett für Binärnachrichten (nur Binärupload möglich). Netz - Ein Brett, das vernetzt ist. Dient fast nur als Kennzeichnung für den User und für CRUNCH NET, ansonsten wie ASCII-Brett. Verz. - Dieses Brett ist ein übergeordnetes Verzeichnis. Schreiben ist hier nicht möglich, es gibt auch keine Index- und MAPSListen für dieses Brett. @endnode @node ED.12 "Gruppen" Ein Klick auf dieses Gadget öffnet ein Window, in dem alle Gruppen durch Gadgets dargestellt werden. Ein blau unterlegtes Gadget bedeutet dabei, daß die entsprechende Gruppe angewählt ist. Setzen Sie die gewünschten Gruppen und klicken Sie auf OK, um die Belegung zu übernehmen. Ein User oder ein Point müssen mindestens eine dieser Gruppen gesetzt haben, um auf dieses Brett zugreifen zu können. Mit dem entsprechenden Level wird das Brett angezeigt, kann aber nur mit einer Gruppe ange- wählt werden. Achtung : Gesetzte Gadgets mit der Aufschrift "-unbelegt-" sollten gelöscht werden. @endnode @node ED.13 "Infozeile" Eine Zeile, die bei der Anwahl des Brettes als kurzer Informationstext für den User ausgegeben wird. @endnode @node ED.14 "Flags" Die Bedeutung der verschiedenen Flags (linker Rand) : FileRequest Dies ist das erste Special Flag, daß für die Bretter eingefügt wurde. Der Inhalt eines Brettes, das mit diesem Flag markiert ist, ist für den FileRequest freigegeben. Nur Bretter, die mit diesem Flag gekennzeichnet sind, werden von CreateFRL in die FileListe übernommen. Zensur Ist dieses Flag gesetzt, sind alle Nachrichten, die ein User in dieses Brett schreibt, zunächst nicht lesbar für andere User. Erst wenn der Sysop oder CoSysop der Box diese Nachricht freigibt, können auch andere User die Nachricht lesen. Download frei Mit diesem Flag werden Bretter markiert, bei denen nach einem Download dem User kein Downloadfreiraum abgezogen wird. MAPS Zugriff Für den Point-Betrieb. Points können nur Bretter mapsen, bei denen dieses Bit gesetzt ist. (Wird erst nur für den Pointbetrieb benötigt) Crunch Tage Dieses Flag hat direkten Einfluß auf die Bedeutung des Gadgets @{" Msg Limit " link ED.08}. Das gesetzte Flag bedeutet für ANUBIS, bei einem CRUNCH LIMIT in einem Brett nicht mehr die Anzahl der Nachrichten zur Berechnungsgrundlage zu nehmen, sondern das Alter der Nachrichten. Dann werden alle Nachrichten, die älter als die angegebenen Tagezahl sind, gelöscht. @endnode @node FEHLERMELDUNGEN "Edit Fehlermeldungen" Nach der Anwahl von OK werden einige Einträge des Brettes auf Korrektheit über- prüft. Sollte dabei ein Fehler auftreten, werden diese vom BrettEd in einem Requester dargestellt. Dieser kann mittels des Gadgets OK beendet werden. Der Eingabevorgang wird solange fortgesetzt, bis alle Fehler korrigiert sind oder der Vorgang per "Abbruch" abgebrochen wird. Hier die möglichen Fehlermeldungen : "Brettname enthält unerlaubte Zeichen !" Der @{"Brettname" link ED.01} darf aus bestimmten Gründen einige Zeichen nicht enthalten. Die Zeichen "<>+-./* #$?§" und alle undruckbaren ASCII-Zeichen sind für Brettnamen verboten (dazu gehören auch die deutschen Umlaute). Zum Teil sind diese Einschränkung wegen verschiedener Netzsysteme nötig, zum anderen aus technischen Gründen von ANUBIS. "kein Brettname angegeben !" Um ein Brett anlegen zu können, muß es einen Namen haben, sonst hat das keinen Sinn. "Brettverzeichnis existiert nicht !" Der im Gadget @{" Brettpfad " link ED.02} eingetragene Pfad existiert nicht. Deshalb konnte das Brett nicht angelegt werden. Wählen Sie einen anderen Pfad oder legen Sie zunächst den gewünschten Pfad an. "Brettverzeichnis ist vom falschen BrettTyp !" Der im Gadget @{" Brettpfad " link ED.02} eingetragene Pfad hat nicht den @{" Brett-Typ " link ED.11} "Verz.". Ändern Sie dies, bevor Sie Bretter für dieses Verzeichnis anlegen. @endnode @node SCHNITTSTELLE "Schnittstellenhandling" Ab BrettEd-Version 0.51 und ANUBIS V 0.433 ist es möglich, die Resourcen für die Brettliste und deren Handling zwischen den beiden Programmen aus- zutauschen. Dies hat den Vorteil, daß man ANUBIS nicht mehr zu beenden braucht, wenn man schnell mal was an der Brettliste etwas ändern will. Dies funktioniert übrigens auch während des XPR Transfers. @endnode @node ERWEITER "Erweiterungen und Bugs" Erweiterungen und Bugs ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ bekannte Fehler ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ zur Zeit sind keine Fehler beim Autor bekannt. Erweiterungen ¯¯¯¯¯¯¯¯¯¯¯¯¯ - Editor für die Zugangsdatei - Ausgabe genauerer Informationen über das Brett - editieren des Datums @endnode @node VERSIONEN "Versionsnummern" Version Datum Anmerkung 0.44 31.12.91 erste öffentliche Version 0.45 01.01.92 Doppelklick links im leeren Listenbereich abgefangen Dir wird nur angelegt, wenn Name vorhanden PropGadget wurde Neu und Löschen nicht berechnet. 0.46 02.01.92 Bugfix : Wenn ein neues Brett ganz nach oben in die Liste gehörte, gab es Ärger. 0.47 02.01.92 Das erste Brett in Unterbrettern wird jetzt auch kor- rekt einsortiert. 0.48 03.01.92 Über das @{"Edit Window" link EDITWINDOW} kann man die aktuellen Eingaben jetzt ausdrucken. Beim Ändern eines Brettverzeichnisses werden jetzt die Pfade der Unterbretter angepaßt. 0.49 08.01.92 Der BrettEd besitzt jetzt einen kompletten Satz neuer Listenroutinen, die eigentlich funktionieren sollten. 0.50 27.01.92 Editieren der @{"Gruppen"Bits link ED.12} eingebaut. 18.02.92 Die Listenroutinen wurden nochmals komplett überar- beitet. Der BrettEd legt jetzt auch beim Speichern ein Backup der alten Brettliste an. 0.51 05.04.92 kleinere Änderungen optischer Natur. FileRequest Flag eingefügt Übernahme der Brettliste aus dem laufenden ANUBIS Schutzprotokolle für das Speicher Sharing Der BrettEd koppelt sich jetzt vom CLI Task ab, so daß ANUBIS weiterarbeiten kann, wenn der BrettEd über das Tools Menü aufgerufen wird. 0.52 10.05.92 Bei Edit Zensur Gadget eingefügt kleinere Änderungen optischer Natur. 23.05.92 Die Edit StringGadgets etwas an OS 2.0 Look angepaßt Edit- und Hauptwindow mit ClosingGadgets versehen Das angewählte Brett wird jetzt durch einen Quer- balken angezeigt und nicht mehr durch den Namen unter der Liste. 0.60 06.06.92 Crunch Funktion eingebaut. einige Gadgets sind nur noch aktiv, wenn ein Brett angewählt ist Bei 'Edit' mit nachfolgendem OK wurde der Pointer auf das aktuelle Element verschlunzt. 0.61 11.06.92 Gadget für "Download frei" eingebaut, um Bretter zu markieren, bei denen kein Downloadfreiraum berechnet wird. 0.62 26.06.92 Die Gadgets für "Zensur" und "Download frei" wurden nicht korrekt zurückgesetzt. Nach dem Löschen eines Brettes wird jetzt das nach- folgende Brett als aktuelles gewählt. kleinere Änderungen optischer Natur. Nach der Anwahl eines Aktions Gadgets bei Edit (@{"Flags" link ED.14}, @{"Gruppen" link ED.12}, @{"Brett-Typ" link ED.11} usw.) wird jetzt das zu- letzt aktivierte StringGadget wieder aktiviert. 0.63 28.06.92 Beim Anlegen eines neuen Brettes wird jetzt der Pfadname des Brettverzeichnisses vorgeben, nach- dem das Verzeichnis bestimmt wurde. 23.07.92 Kleiner Fehler bei der @{"Brettliste" link BRETTLISTE} Routine behoben. Das PropGadget wurde beim Eintrag eines neuen Brettes oder beim Löschen eines alten nicht korrekt updated. Fehler beim Grafikaufbau behoben. Nach dem Anlegen eines neuen Brettes wurden die Gad- gets nicht eingeschaltet. 0.64 08.09.92 Gadget für @{"Bytelimit" link ED.09} eingebaut. 0.70 08.09.92 Vorgaben Gadget 0.71 06.11.92 Gadget für Haltezeit eingebaut. 08.11.92 wenn für ein bestehendes Brett das Directory nicht existiert, wird gefragt, ob es angelegt werden soll. 23.11.92 Fehler beim Gadget mit der Haltezeit behoben. Beim Löschen wird die unterste Zeile nicht mehr nach- gezogen. 24.11.92 Der BrettEd Cruncher beachtet jetzt auch das Crunch- Date Flag. Der BrettEd Screen hat endlich einen Namen. 0.72 18.01.93 Beim Löschen von Brettern werden jetzt auch die MAPS- Listen der Points aktualisiert. Gadget für @{"Routelimit Point" link ED.10} eingebaut, altes Bytelimit Gadget in @{"Routelimit" link ED.09} umbenannnt. Optische Änderungen im Editwindow Das Durchschalten der Stringgadgets funktioniert jetzt wieder richtig. 0.73 21.01.93 Gadget "Vererbe" eingebaut. 0.74 31.03.93 Wegen der neuen Verwaltung der Brettliste im Speicher mußte der BrettEd umgeschrieben werden. Dadurch ist aber die Fehleranfälligkeit gesunken. Die @{"Fehlermeldungen" link FEHLERMELDUNGEN} im Edit Requester werden jetzt nicht mehr quer über die Gadgets gestempelt, sondern in einem separaten Requester ausgegeben. 0.75 10.05.93 Das Backup der alten Brettliste wurde beim Speichern nicht angelegt. 29.05.93 Vererben funktioniert wieder. Es können jetzt auch Brettverzeichnisse mit ihrem Inhalt gelöscht werden. 0.76 19.06.93 Flag "Check Baud" eingebaut. 12.07.93 BrettEd.dok in BrettEd.guide umgeschrieben. 07.08.93 Im Gadget @{"MsgLimit" link ED.08} ist jetzt ein Wert von -1 für die unbegrenzte Haltedauer möglich. 0.77 13.09.93 Das Flag "Check Baud" wurde nach dem Editieren eines Brettes nicht zurückgesetzt. 18.09.93 Das Gadget "Crunch" wurde entfernt und durch "Drucken" ersetzt. Der BrettEd.guide kann jetzt mit einem Druck auf die HELP Taste automatisch nachgeladen werden. @endnode