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 Hhe von 10 DM (exklusive Versandkosten)
  berschreiten.

- Das Programm darf nur mit allen zugehrigen Dateien und in unvernderter
  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 erhltlich. 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 Schden - einschlielich, aber nicht beschrnkt auf -
materielle oder finanzielle Schden, die durch die Benutzung von 'NIU',
oder die Untauglichkeit von 'NIU' fr einen bestimmten Zweck, entstehen.



NDERUNGEN
==========

0.80: Erstverffentlichung
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 erhht (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 zugehrige Ikone und Eingabe der
  Kommandozeilen-Parameter
- durch Draggen einer Datei vom Typ `NEWDESK.INF' auf  die zugehrige
  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 mglich - 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 schlielich nicht
bei Jrgen von der Lippe's `Geld oder Liebe' ;-)



BERPRFUNG
===========

NIU berprft derzeit die Zeilen einer NEWDESK.INF folgendermaen:

- 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 knnen
  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 lnger als 13 Zeichen ist, welches die maximale vom
  Desktop darstellbare Lnge ist. Der Desktop scheint lngere Ikonentexte
  brigens zu tolerieren.
- NIU prft bei angemeldeten Anwendungen, ob die Lnge 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 gehrig ins Schleudern.
- Die #d-Zeile mu exakt 47 Zeichen lang sein. Ist sie es nicht, so wird
  ein Hinweis darauf ausgegeben.
- Die #M-Zeile enthlt die Kennung des zugehrigen Laufwerks. NIU prft,
  ob diese zulssig 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 mglich)
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 folgendermaen:

- 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 Lnge
  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 nchsten Versionen von NIU wird es
mglich 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 knnen.



INTERNA
=======

- erstellt mit Pure Pascal V1.1 vom 30. Juni 1993
- maximale Dateianzahl: 128
- maximale Dateigre:  1024 Zeilen
- maximale Zeilenlnge: 255 Zeichen



Viel Spa mit NIU,

Dirk Hagedorn, 23. November 1993
