PROGRAMM ======== NEWDESK.INF-Utility NIU.TTP V0.86ž 04.01.1994 ™ffentliche Betaversion. Bitte Abschnitt "Wichtiger Hinweis" beachten! Mit dem NIU kann die NEWDESK.INF, welche vom Desktop ab TOS V2.0x angelegt wird, berprft, korrigiert und interpretiert werden. AUTOR ===== 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!) COPYRIGHT ========= 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 im einzelnen: - NIU.TTP Das Programm selbst - NIU.UPL Kurzinformationen fr den Upload in Mailboxen - NIU_ICON.RSC Ein paar monochrome Icons fr den Newdesk - LIESMICH.TXT Diese Datei Der Upload in (gebhrenfreie) Mailboxen ist ausdrcklich erwnscht! 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. Dort findet man auch jeweils die aktuelle Version der NEWDESK.INF-Dokumentation als NEW_DOKU.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. Lassen Sie NIU daher besser nur auf Dateien los, von denen Sie noch ein Backup besitzen. Nicht, daž Sie hinterher ankommen, ich h„tte Sie nicht gewarnt. ;-) Eine Bitte: Wenn jemand einen Fehler findet, dann soll er mir diesen auch mitteilen. Nicht umsonst sind in diesem Text meine eMail-Adressen aufgelistet. Danke! 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.86ž: - Da die Sortier-Option in den meisten F„llen nur Probleme bereitete, ist sie nun wieder draužen - Leere Ordner werden jetzt auch wieder gefunden (ja, ich sch„me mich dafr noch nachtr„glich) - Ausgaben k”nnen in eine Datei geschrieben werden - #I-Zeile wird nun auch richtig ausgegeben, wenn sie zwei Masken enth„lt. - Speicherbegrenzung fr MultiTOS wird ausgegeben - Die Versionsnummer von NIU l„žt sich mit einem "what" (z.B. aus den Mupfel-Tools von Julian F. Reschke oder der Okami-Shell von Wolfram R”sler) ermitteln - Dokumentation der NEWDESK.INF liegt nun als seperates Archiv vor 0.85ž: - Die #b-Zeile wurde falsch interpretiert - #C-Zeile (ROM-Modul) wird nun ausgewertet - Die Farbeinstellungen der #c-Zeile werden nun (hoffentlich korrekt ausgegeben) - TT-Mittel und TT-Niedrig werden in der #E-Zeile erkannt - Neues r-Kommando: Die NEWDESK.INF kann damit sinnvoll "sortiert" und gesichert werden. - Wurde NIU eine Kommandozeile ohne Dateimaske aber mit Kommandos bergeben, so strzte es ab. Der Fehler wurde beseitigt. 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] eingabe [ausgabe] Kommandos und Schalter werden durch einen vorangestellten Bindestrich gekennzeichnet. "eingabe" steht fr eine beliebige Dateimaske oder einen Dateinamen. "ausgabe" steht fr den Namen der Datei, in welche die Meldungen von NIU gesichert werden. Ist er leer, so wird auf die Standardausgabe ausgegeben, welche gew”hnlich der Bildschirm ist. 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 bergeben, so gibt NIU lediglich ein paar Informationen ber sich selbst aus. Kommandos: -v: Eine Auswertung jeder Zeile der Datei wird ausgegeben. 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) Eine Besonderheit tritt noch auf, wenn die Meldungen von NIU in eine Datei ausgegeben werden. In diesem Falle wrde es wenig Sinn machen, auf einen Tastendruck zu warten, da der Benutzer ja nicht mitbekommt, wann eine Taste zu drcken ist. In diesem Falle werden die eventuell gesetzten Schalter -s und -h ignoriert. Beispiele: -h c:\newdesk.inf Die Datei C:\NEWDESK.INF wird lediglich berprft und das Ergebnis dieser šberprfung auf dem Bildschirm 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*.* c:\niu.log -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 nicht auf einen Tastendruck gewartet, da die Meldungen von NIU in die Datei C:\NIU.LOG geschrieben wurden. newdesk.inf NIU berprft lediglich die Datei NEWDESK.INF aus dem aktuellen Ordner und gibt alle fehlerhaften Zeilen aus. š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 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: Da NIU Zeilen mit nicht vorhandenen Dateien l”scht, ist das besonders dann sehr „rgerlich, wenn man mal eben ein als Programm lauff„higes Accessory in .PRG umbenannt hat und NIU das Accessory somit nicht wiederfindet. In diesem Falle sollten Sie nicht die Korrektur benutzen, sondern sich die fehlerhaften Zeilen in eine Datei ausgeben lassen und die jeweilige NEWDESK.INF manuell mit einem Editor bearbeiten. SORTIERUNG ========== Diese Option wird erstmal nicht weiter untersttzt, da sie mehr Probleme bereitete als Nutzen brachte. INTERNA ======= - erstellt mit Pure Pascal V1.1 vom 30. Juni 1993 - maximale Dateianzahl: 128 - maximale Dateigr”že: 1024 Zeilen - maximale Zeilenl„nge: 255 Zeichen - LIESMICH.TXT ist immer noch kleiner als NIU.TTP ;-) Viel Erfolg mit NIU und ein frohes neues Jahr 1994 wnscht Ihnen Dirk Hagedorn Paderborn, den 3. Januar 1994