PROGRAMM ======== NEWDESK.INF-Utility NIU.TTP V0.82ž 23.11.1993 ™ffentliche Betaversion. Bitte Abschnitt `Wichtiger Hinweis' beachten! KURZINFO ======== Mit dem NIU kann die NEWDESK.INF, welche vom Desktop ab TOS V2.0x angelegt wird, berprft, korrigiert und interpretiert werden. COPYRIGHT ========= Autor: Dirk Hagedorn Anschrift: Platanenweg 36, D-33098 Paderborn MausNet: Dirk Hagedorn@PB MagicNet: Seep@Paderbox ZNet: D.Hagedorn@HSP InterNet: dirk_hagedorn@pb.maus.de (privat, kein Binaries, keine UUe's!) NIU.TTP ist in der vorliegenden Version Freeware und darf somit auf beliebige Art und Weise an Dritte weitergegeben werden, solange folgende Voraussetzungen erfllt sind: - Fr die Weitergabe (z.B. auf PD-Sammeldisketten) drfen keine Gebhren verlangt werden, die eine H”he von 10 DM (exklusive Versandkosten) berschreiten. - Das Programm darf nur mit allen zugeh”rigen Dateien und in unver„nderter Form weitergegeben werden. Dies sind folgende Dateien: - NIU.TTP Das Programm selbst - NIU.UPL Kurzinformationen fr den Upload in Mailboxen - NEWDESK.TXT Dokumentation der NEWDESK.INF - LIES_NIU.TXT Dieser Text, den Sie gerade lesen BEZUGSQUELLEN ============= Die jeweils aktuelle Version des Programms ist beim Autor gegen Einsendung einer formatierten Diskette sowie eines frankierten und adressierten Rckumschlags erh„ltlich. Meine Anschrift finden Sie am Anfang dieses Texts. Besitzer eines Modems finden die aktuelle Version dieses Programms in der Quark Paderborn im Brett ST-Tools sowie in der Maus Paderborn 2 im ”ffentlichen Programmteil als Archiv NIU_xxx.ZIP. Quark PB: (05251) 71409 (freier Gastdownload) Maus PB2: (05251) 541578 ( - "" - ) WICHTIGER HINWEIS ================= Dies ist eine ”ffentliche Betaversion. Daraus ergiebt sich, daž sich in diesem Programm noch Fehler befinden bzw. mit hoher Wahrscheinlichkeit noch Fehler enthalten sind. Ich, Dirk Hagedorn, bernehme keine Haftung fr irgendwelche direkten oder indirekten Sch„den - einschliežlich, aber nicht beschr„nkt auf - materielle oder finanzielle Sch„den, die durch die Benutzung von 'NIU', oder die Untauglichkeit von 'NIU' fr einen bestimmten Zweck, entstehen. ŽNDERUNGEN ========== 0.80ž: Erstver”ffentlichung 0.81ž: interne Version 0.82ž: - NIU sollte nun nicht mehr beim Anlegen der korrigierten Fassung abstrzen. Der Bug machte sich natrlich nur bei mir nicht bemerkbar. - maximale Zeilenanzahl auf 1024 erh”ht (sollte reichen) - erweiterte #E-Zeile wird nun ausgewertet PROGRAMM-AUFRUF =============== Starten Sie NIU genauso, wie Sie es von allen anderen TTP's her kennen: - vom Desktop durch Doppelklick auf die zugeh”rige Ikone und Eingabe der Kommandozeilen-Parameter - durch Draggen einer Datei vom Typ `NEWDESK.INF' auf die zugeh”rige Ikone - durch Aufruf durch einen Kommandozeileninterpreter oder eine Shell. NIU erwartet eine Kommadozeile mit folgendem Aufbau: [-cv] [-bhs] mask Kommandos und Schalter werden durch einen vorangestellten Bindestrich gekennzeichnet. `mask' steht fr eine beliebige Dateimaske oder einen Dateinamen. Werden keine Kommandos oder Schalter bergeben, so werden die gefundenen Dateien lediglich berpft und das Ergebnis sowie die eventuell vorhandenen fehlerhaften Zeilen angezeigt. Wird eine leere Kommandozeile ausgegeben, so gibt NIU lediglich ein paar Informationen ber sich selbst aus. Kommandos: -v: Eine Auswertung jeder Zeile der Datei wird ausgeben. Auf fehlerhafte Zeilen wird besonders hingewiesen. -c: Fehlerhafte Zeilen werden - falls m”glich - korrigiert oder entfernt. Schalter: -b: Beim Sichern der korrigierten Datei wird KEIN Backup angelegt. (Nur relevant, wenn -c benutzt wird) -h: Beim Programmende wird auf einen Tastendruck gewartet. -s: Single-Step-Modus beim Interpretieren der Zeilen. Nach jeder Zeile der Newdesk.Inf-Datei wird auf einen Tastendruck gewartet. (Nur relevant, wenn -v benutzt wird) Beispiele: -h c:\newdesk.inf Die Datei C:\NEWDESK.INF wird lediglich berprft und das Ergebnis dieser šberprfung ausgegeben. Danach wird auf einen Tastendruck gewartet. -v c:\inf\*.* Es wird eine ausfhrliche Beschreibung der Zeilen alle Dateien aus dem Ordner C:\INF ausgegeben. -vhc c:\new*.* -v -h -c c:\new*.* Eine Interpretation aller gefundenen Dateien wird ausgegeben. Fehlerhafte Zeilen werden korrigiert. Die Korrekturen werden gesichert, wobei ein Backup der alten Datei angelegt wird. Am Programmende wird noch auf einen Tastendruck gewartet. newdesk.inf NIU berprft lediglich die Datei NEWDESK.INF aus dem aktuellen Ordner und gibt alle fehlerhaften Zeilen aus. So, die Beispiele sollen auch gengen; wir sind hier ja schliežlich nicht bei Jrgen von der Lippe's `Geld oder Liebe' ;-) šBERPRšFUNG =========== NIU berprft derzeit die Zeilen einer NEWDESK.INF folgendermažen: - In einigen Zeilen stehen Zugriffspfade und/oder Dateinamen. NIU prft, ob diese vorhanden sind. - In einigen Zeilen ist die Position einer Ikone vermerkt. NIU prft, ob auf diese Position bereits eine andere Ikone liegt. Somit k”nnen Doppelbelegungen erkannt werden. Mir ist das brigens bereits schonmal passiert, man mag es kaum glauben ;-) - In einigen Zeilen ist der Text zu einer Ikone angegeben. NIU prft, ob dieser nicht l„nger als 13 Zeichen ist, welches die maximale vom Desktop darstellbare L„nge ist. Der Desktop scheint l„ngere Ikonentexte brigens zu tolerieren. - NIU prft bei angemeldeten Anwendungen, ob die L„nge der zu bergebenden Parameter kleiner oder gleich 11 ist und ob der Dateityp aus maximal 3 Zeichen (ohne *.) besteht. Der Dialog `Anwendung anmelden' des Desktops kommt im Fehlerfalle geh”rig ins Schleudern. - Die #d-Zeile muž exakt 47 Zeichen lang sein. Ist sie es nicht, so wird ein Hinweis darauf ausgegeben. - Die #M-Zeile enth„lt die Kennung des zugeh”rigen Laufwerks. NIU prft, ob diese zul„ssig ist, also A, B, ..., Z oder c (ROM-Modul) lautet. Anmerkung: Wird keine Interpretation der Zeilen ausgegeben, so werden im Falle des Vorhandenseins von fehlerhaften Zeilen nur diese ausgegeben. INTERPRETATION ============== Wird beim Start von NIU das Kommando -v bergeben, so wird die Bedeutung jeder einzelnen Zeile ermittelt und ausgegeben. Bei einigen Zeilen bin ich mir jedoch nicht ganz im Klaren, ob NIU die korrekten Werte ausgibt, da mir lediglich die Dokumentation zur alten DESKTOP.INF aus dem ST-Profibuch (7. Auflage) zur Verfgung stand und ich mir den Rest per Trial&Error selbst ermittelt habe. Keine Garantie kann ich fr die Richtigkeit der Interpretation folgender Zeilen geben: #c, #E, #Q, #S. KORREKTUR ========= Eine Datei wird automatisch korrigiert, wenn das Kommando -c bergeben wurde. Findet NIU eine fehlerhafte Zeile, so wird diese (falls m”glich) korrigiert oder entfernt. NIU legt dann ein Backup der alten Datei an (wenn der Schalter -b nicht gesetzt ist) und sichert eine korrigierte Fassung der jeweiligen Datei. NIU bearbeitet eine Datei folgendermažen: - Zeilen mit nichtgefundenen Ordnern und Dateien werden rigoros entfernt. - Sonstige Fehler werden korrigiert, d.h. eine neue Zeile wird aus den richtigen und korrigierten Werten der alten Zeile erstellt. Dies betrifft momentan: - berlange Ikonentexte - berlange Dateitypen - berlange Parameter - falsche Funktionstastenwerte - Ist die #d-Zeile nicht 47 Zeichen lang, so wird sie auf diese L„nge gebracht. - Keine Korrektur wird bei einer Doppelbelegung einer Ikonenposition vorgenommen. EIN TIP ======= Gerade beim Interpretieren bekommt man kaum mit, was NIU denn nun so alles ausgibt. In einer der n„chsten Versionen von NIU wird es m”glich sein, alle Ausgaben in einer Datei zu protokollieren. Derzeit kann ich lediglich darauf hinweisen, daž man die Ausgabe von NIU (und jedem anderen TOS/TTP-Programm) mit Control+S anhalten und mit Control+Q fortfhren kann. Benutzer einer Shell sind daher klar im Vorteil, da sie die Ausgaben von NIU jederzeit in eine Datei umlenken k”nnen. INTERNA ======= - erstellt mit Pure Pascal V1.1 vom 30. Juni 1993 - maximale Dateianzahl: 128 - maximale Dateigr”že: 1024 Zeilen - maximale Zeilenl„nge: 255 Zeichen Viel Spaž mit NIU, Dirk Hagedorn, 23. November 1993