@DATABASE VersCheck_deutsch
@$VER: V1.13 (02.09.1999)
@(C) 1991-1999 by Michaela Prüß, All Rights Reserved
@AUTHOR Michaela Prüß
@MASTER Development/Gateway-5
@INDEX INDEX
@WIDTH 4
@WORDWRAP
@SMARTWRAP

@REMARK Created with Guided by Linus McCabe


@NODE "Main" "Inhalt"
@KEYWORDS Inhalt
@TOC Main
@INDEX INDEX
@NEXT Copyright
@WORDWRAP
@SMARTWRAP

@{U}@{B}VersCheck Guide (02.09.1999)@{UU}@{UB}               @{" Index " link Index}

           

     @{U}Inhaltsverzeichnis@{UU}

     @{" Copyright, Nutzungsbedingungen " link Copyright}
     @{" Support und Fehlermeldungen    " link Support} 
     @{" Programm-History               " link History}
     @{" CPU-Unterstützungen            " link CPU}

     @{" Wichtig, unbedingt Lesen       " link Important}
     @{" Installation des Programmes    " link Install}

     @{" Benutzung des Programms im CLI " link Usage}
     @{" Benutzung von der Workbench    " link UseWB}
     @{" Verwendete Fremdprodukte       " link ThirdPartyProd}

     @{" Über VersCheck (Hintergründe)  " link ProgInfo}
     @{" Zukunft und Planungen          " link Future}
     @{" Bekannte Fehler und Probleme   " link Bugs}

     @{" Die Vergleiche und Listen!     " link CheckGuides}

     @{" Offene Punkte (To Do)          " link ToDo}

     @{" Sprachverwaltung (Locale)      " link Locale}
@ENDNODE
@NODE "Copyright" "Copyright"
@TOC Main
@INDEX INDEX
@NEXT Support
@PREV Main
@WORDWRAP
@SMARTWRAP
{U}VersCheck: Copyright


@{B}VersCheck ist Copyright 1998, 1999 by Michaela Prüß@{UB}
@{U}                                                                    @{UU}

@{B}LibGuide, DevsGuide und DTypesGuide sind@{UB}
@{B}COPYRIGHT © Heiko Schröder (age@thepentagon.com) 1996-1999@{UB}
@{U}                                                                    @{UU}

@{B}COPYRIGHT © Stuart Kelly (@{FG SHINE}stuart@dkelly1.demon.co.uk@{FG TEXT})@{UB}@{FG TEXT}
@{B}By Stuart Kelly Copyright 1999 ©@{UB}
@{U}                                                                    @{UU}

@{I}Die vorliegende Version ist Freeware@{UI}.

Das Programm darf nicht kommerziell benutzt werden, ansonsten ist
die Nutzung frei. Das Aminet hat die Erlaubnis zur Verbreitung
über alle Server, Mirror's und die AmiNet-CD's.

Diese Software wird verbreitet, wie sie ist, ohne eine Garantie
jeglicher Art. In keinem Fall, weder direkt noch indirekt ist die
Autorin haftbar für Schäden oder Datenverluste die durch die
Verwendung dieser Software entstehen. Die Benutzung erfolgt
ausschließlich auf eigenes Risiko des Benutzers. Jede Änderung
des Archives oder Teilen davon ist verboten. Das Archiv darf auf
elektronischm Weg via Maibox oder Internet verbreitet werden.

@{" Inhalt " link Main}   @{" Updates, Fehler " link Support}   @{" CheckGuides " link CheckGuides}
@ENDNODE
@NODE "History" "History"
@TOC Main
@INDEX INDEX
@NEXT CPU
@PREV Support
@WORDWRAP
@SMARTWRAP
@{U}HISTORY VersCheck@{UU}

@{B}V 1.17 / 29.08.1999@{UB} - Neues Flag für HTML-Output im
                      Lib-Check
                    - Änderung im einzel Filecheck

@{B}V 1.16 / 27.08.1999@{UB} - Fehlerbeseitigungen
                    - ENV-Variable für c:version

@{B}V 1.15 / 07.07.1999@{UB} - Server / eMail angeasst
                    - Neue Funktion für Anti-Listen zugefügt

@{B}V 1.14 / 10.06.1999@{UB} - Fehlerbeseitigung (Erstellung der
                      HTML-Seiten für MUI und Handler Guide war
                      ein Fehler!)
                    - MUIClassesGuide aktualisiert.

@{B}V 1.13 / 09.06.1999@{UB} - WarpOS und PowerUP-Versionen fertig-
                      gestellt. Beide Versionen OHNE Requester
                      da es zum Crash beim Aufruf kommt.
                    - Installer für neue Versionen aktualisiert.
                    - Kleinere interne Änderungen.

@{B}V 1.12 / 06.06.1999@{UB} - Zu jeder Liste kommt ein File für
                      den Autor der Liste hinzu. Dieses liegt an
                      der gleichen Stelle und endet auf Mail
                      statt auf List.
                    - Der Autor aus dem Mail-File wird in die
                      Variable $email eingesetzt.
                    - Language-Files mit $email angepasst (V1.4)

@{B}V 1.11 / 17.05.1999@{UB} - Fehlerbeseitigung: Eine interne
                      Variable war zu klein.
                    - Versionscheck nun ohne Fehlermeldung von
                      c:version (mit besonderem Dank an Gerald
                      Schnabel <Gerald@Schnabel-online.de>).
                    - Nach kompletter Neuübersetzung ist das
                      CPU-Problem verschwunden.
                    - Die FPU-Anzeige war fehlerhaft wenn keine
                      FPU vorhanden war. Die Variable wird jetzt
                      korrekt initialisiert und der Fehler ist
                      beseitigt.

@{B}V 1.10 / 14.05.1999@{UB} - Problem bei der Anzeige des
                      Versionsstring mit c:version beseitigt.
                    - Die CPU/FPU wird falsch angezeigt. Das
                      ist kein Fehler in VersCheck sondern
                      das Problem tritt beim Compilieren des
                      C-Codes auf. Leider finde ich im Moment
                      die genaue Ursache nicht so das ich keinen
                      Bugbericht an Volker senden kann. Aber ich
                      suche weiter.

@{B}V 1.9  / 30.04.1999@{UB} - norsk-Catalog zugefügt
                    - Option -4 and -5 für MUI und Handler
                      aufgenommen. Interne Erweiterung für
                    - Namensvergleich mit * und ?
                      Im $VER wurden Zeichen über 127 ge-
                      filtert. Jetzt wird 32-127 und alles
                      über 159 akzeptiert.

@{B}V 1.8  / 15.04.1999@{UB} - Bereinung der internen V1.7                                                und weitere Test's der Funktionen für
                      die Class-Guide.
                    - Das in der 1.7 noch auskommentierte
                      WB-Interface ist jetzt fertig und
                      einsetzbar.
                    - Die aus diesen Erweiterungen resul-
                      tieren Änderungen im Archiv, Installer-
                      script und scripts-Verzeichnis.
                    - Kleine Fehlerbeseitigung: Die letzte
                      Zeile der Lokalefiles wurde nicht
                      gelesen, dadurch gab es englische
                      Tasten in einem deutschen Requester.

@{B}V 1.7  / 14.04.1999@{UB} - Version für die ClassGuide.
                      *** Nur für interne Benutzung ***

@{B}V 1.6  / 12.04.1999@{UB} - Verzeichnis Script und / oder
                      die Locale-Dateien werden jetzt auch
                      gefunden wenn sie im Startdir des
                      Programmes liegen (PROGDIR:).
                    - Die Filetypenerkennung beherrscht jetzt
                      die iff-Header und div. andere Typen.
                      Die Daten habe ich aus Gateway-5
                      übernommen.
                    -  Noch immer fehlende getargs-Funktion ist
                      drin (endlich).
                    - Bei -f wird jetzt der absolute Pfad
                      angezeigt, nicht nur ein Teilpfad.
                      Fehlerkorrektur: Die Logik für die HTML-
                      Seiten war verdreht (Ja=nicht anlegen,
                      Nein=Anlegen). Jetzt OK.

@{B}V 1.5  / 06.04.1999@{UB} - Merge-Modus (-m) geändert.
                      Es wird auch dann kein Header angezeigt
                      wenn -1, -2 oer -3 gesetzt sind. Nur
                      mit -s kann der Header geschaltet werden.
                      Soll mehrfache Header vermeiden.
                    - Neue Option -f (fullpath) zugefügt.
                    - Fehler im Installerscript gefixed. Unab-
                      hängig von der Einstellung JA/NEIN wurde
                      das Verzeichnis Scripts immer kopiert.
                    - Anzeige -v(erbose) jetzt ordentlich.
                    - Mehrere kleinere Änderungen.

@{B}V 1.4  / 01.04.1999@{UB} - Neue Filetypen zugefügt.
                    - Neue Option -n unterdrückt die Requester.
                    - Neue Option -m fügt die neuen Ausgaben
                      an vorhandene Dateien an.
                      Das ist für die CheckGuides.
                    - Installerscripte in deutsch und englisch
                      sind jetzt fertig. Für eine leichtere
                      und fehlerfreie Installation.

@{B}V 1.3  / 01.04.1999@{UB} - Bessere Aufsplittung des
                      Versionstrings.
                      Leerzeichen werden jetzt berücksichtigt.
                    - Prüfung einzelner Files zugefügt.
                      Ist ein Verzeichnis angegeben, wird das
                      gesamte Verzeichnis geprüft. Ist ein Filename
                      angegeben, wird die Version des Files angezeigt.
                      Die Angabe von -1/-2/-3 mit einem einzelnen File
                      vergleicht das File mit den CheckGuides. In
                      diesem Fall werden alle Ausgabedateien in der
                      Ram-Disk angelegt. Nur das HTML-Update-Formular
                      wird nicht erzeugt.
                    - Readme-Files durch AmigaGuide ersetzt.
                    - Versionstest der Localedateien zugefügt.

@{B}V 1.2  / 27.03.1999@{UB} - Requester zugefügt.
                      Zeigt Info's über den Check in Reqtools-Requestern,
                      wenn die reqtools.library installiert ist. 
                      Anderenfalls wird nur eine Ausgabe in den CLI
                      getätigt.
                    - HTML-Formular (Update-Formular) integriert.
                    - Bei Angabe von -x werden jetzt .elf, .wos und
                      .ppc zur Vergleichsliste hinzugenommen. Grund:
                      Bisher gab es nur ein oder zwei Library's, die
                      einen Namen wie xxxxxx.elf benutzten. Inzwischen
                      hat z.B. Andreas Kleinert auch Datentypen mit
                      folgender Syntax erstellt:
                      akXXXX.datatype, akXXXX.elf, akXXXX.wos
                      Andere Authoren werden wohl ähnlich handeln.
                      VersCheck ist jetzt auf jeden
                      Fall in der Lage das zu verarbeiten.

@{B}V 1.1  / 13.03.1999@{UB} - Die Headerinformationen werden jetzt in die
                      Ausgabedateien geschrieben.

******************************************************************
*** Es war geplant V1.0 ins Aminet zu senden. Jedoch macht     ***
*** wuarchive ein newfs (Zitat Homepage: 112 G takes a while). ***
*** So ist diese Version nur auf meiner Homepage erschienen.   ***
******************************************************************

@{B}V 1.0  / 10.03.1999@{UB} - Neue Funktion um das eigene
                      Hauptverzeichnis zu erkennen.
                    - Wegen Probleme mit unbekannter Ursache wurden
                      spezielle Debug-Funktionen integriert (normalerweise
                      sind diese auskommentiert und werden nicht in
                      einem veröffentlichten Stand compiliert).
                    - Bugfix: Sprachtexte werden jetzt in jedem Fall
                      korrekt geschlossn.
                    - Funktion -1, -2 und -3 können jetzt ohne Angabe
                      eines Verzeichnisses benutzt werden, es werden dann
                      Standardvorgaben verwendet. Die Defaultwerte sind:
                      -1 = Libs: / -2 = Devs: / -3 = Sys:Classes/Datatypes

@{B}V 0.9  / 04.03.1999@{UB} - Letzte Beta-Version
                      Version für die 'CheckGuide' zum Test

@{B}V 0.4  / 03.03.1999@{UB} - Neucompilierung (Intern)
                    - Preversion vbcc 0.7 gegen Releaseversion 0.7
                      getauscht. Neucompiling von allen Lib's, Library's
                      und Programmen mit neuen, aktuellen Includes und
                      Libs von vbcc.
                    - Umfangreiche Testreihe.

@{B}V 0.3  / 28.02.1999@{UB} - Pre-Version (Intern)
                    - Interne Sprache ist jetzt englisch.
                    - Texte in Dateien ausgelagert.

@{B}V 0.2  / 27.02.1999@{UB} - Beta-Version (Intern)
                    - Fehler in Rekursion ExAll() korrigiert (unnötig
                      hoher Stackverbrauch)
                    - Ausgabefiles (Ram:) für Check.
                    - Ausgabe zentralisiert und optimiert.
                    - CPU-Check verändert
                    - Fehler (GURU) in Versionstextaufteilung korrigiert.
                    - Internes Flag (-v) eingefügt (Verbose Info's)

@{B}V 0.1  / 23.02.1999@{UB} - Erste Version (Intern)
@ENDNODE
@NODE "CPU" "CPU"
@TOC Main
@INDEX INDEX
@NEXT Important
@PREV History
@WORDWRAP
@SMARTWRAP
@{U}@{B}Unterstützte CPU's@{UU}@{UB}

Da ich vbcc als Compiler einsetze ist es möglich, Versionen für alle derzeit verfügbaren CPU-Typen zu erstellen. Und
genau das ist auch geschehen.

Alle Versionen für mc68000 bis mc68060 sollten bei einer entsprechenden CPU ohne Probleme funktionieren. Da ich inzwischen selber ausschließlich mit WarpOS arbeite ist die Version für PowerUP "VersCheck.elf" nicht getestet!

Die WarpOS-Version ist beim Aufruf der Requester gecrashed. Ich habe den Fehler noch nicht lokalisiert, vermutlich findet sich dieser aber in der REQUEST.lib an der ich noch arbeite. Daher wird im Moment der No-Request-Modus automatisch bei den PPC-Programmversionen aktiviert. Die WarpOS-Version muß noch als Beta-Version angesehen werden und hat definitiv noch Fehler!
  
@ENDNODE
@NODE "Important" "Important"
@TOC Main
@INDEX INDEX
@NEXT Install
@PREV Support
@WORDWRAP
@SMARTWRAP
@{U}@{B}Wichtige Hinweise:@{UU}@{UB}

Das Programm braucht einiges an Stack. Wenn der Stack nicht reicht wird
es zum GURU kommen (oder auch nicht, dank MCP). Die benötigte Größe des
Stack hängt von der Verzeichnistiefe in 'Libs:' ab. StackSnoop hat als
höchstens Wert bei mir 74966 gezeigt. Ich denke mal so 100.000 sollten
als Minimum gesetzt sein.
@ENDNODE
@NODE "Support" "Support"
@TOC Main
@INDEX INDEX
@NEXT History
@PREV Copyright
@WORDWRAP
@SMARTWRAP
@{U}Support:@{UU}

Michaela Prüß
Berlin


@{I}eMail:@{UI}

Gateway5@gmx.net



@{I}Supportseite im Internet (aktuelle Version und andere Projekte):@{UI}

http://amigadownload.amiga.webjump.com/index.html

@ENDNODE
@NODE "Install" "Install"
@TOC Main
@INDEX INDEX
@NEXT Usage
@PREV Important
@WORDWRAP
@SMARTWRAP
@{U}@{B}Installation:@{UU}@{UB}

Das Programm VersCheck kann überall liegen. Für den Versionsvergleich
mit den Testlisten muß im aktuellen Verzeichnis das Unterverzeichnis
"scripts" mit den Listen vorhanden sein bzw. das Verzeichnis muß sich
dort befinden, wo das Programm selber liegt. Beides ist gleichermaßen
möglich.

Als reiner Versionslister/-tester wird dieses Verzeichnis nicht benötigt
und das Programm kann von überall aus gestartet werden.

Wenn die ENV-Variable VCheck/VersCom benutzt wird kann ein alternativer
Pfad oder ein anderer Name für den Versionsbefehl gesetzt werden.

@{" Installation der Sprachtexte " link Locale}
@ENDNODE
@NODE "Usage" "Usage"
@TOC Main
@INDEX INDEX
@NEXT UseWB
@PREV Install
@WORDWRAP
@SMARTWRAP
@{U}@{B}Benutzung:@{UU}@{UB}

@{B}VersCheck [[-<0|opt|hlp>] [<pathname>|<filename>]] | <?>@{UB}
          @{I}opt = <123>afmnpvs[x<123>]   hlp = ?h@{UI}
          @{I} 0  = 0  = [-0s <.suffix> -0l <cmplist> -0n <name outfile>]@{UI}


-1    = Versionsvergleich <dir> mit "scripts/LibList". Fehlt die
        Angabe <dir>, wird Libs: benutzt.
-2    = Versionsvergleich <dir> mit "scripts/DeviceList". Fehlt
        die Angabe <dir>, wird Devs: benutzt.
-3    = Versionsvergleich <dir> mit "scripts/DTypesList". Fehlt die
        Angabe <dir>, wird Sys:Classes/Datatypes benutzt.

        Diese Funktionen wurden für das Prüfsystem von
        '@{I}age@thepentagon.com@{UI}' geschrieben.

        Werden -1 bis -3 mit einem Filenamen statt einem Verzeichnis
        gestartet wird nur dieses eine File geprüft. Bei Angabe eines
        Verzeichnisses wird immer -a gesetzt. Außerdem wird in beiden
        Fällen -s (ausgenommen Modus -m) gesetzt.

        -----------------------------------------------------------------
        Um weitere Listen zu aktivieren ohne das dazu ein Update von
        VersCheck erforderlich ist wurden diese speziellen Options ge-
        schaffen:

-0s   = Versionsvergleich, freie Definition. Festlegung des Suffix.
-0l   +       "              "      "      . Festlegung der Liste in scripts.
-0n   +       "              "      "      . Festlegung der Namensendung für
        die Ergebnislisten. (Z.B.: -0n CLASS erzeugt Ram:NewCLASS,
        Ram:AltCLASS)
        -0s, -0l, -0n MÜSSEN immer als complette Gruppe angegeben sein.
        Es gibt keine voreingestellten Default-Werte!  
        -----------------------------------------------------------------

-f    = Zeit den Pfad zu jeder geprüften Datei. Sinnvoll bei längeren
        Prüfläufen ohne das man dabei ist.

-n    = Unterdrückung der Requester beim Versionstest.

-m    = Ausgabedaten anfügen, statt überschreiben für die CheckGuides.

-o    = Erzwingt HTML-Output in Lib-Check

-p    = Keine Programme, dafür IFF Bilder.
-P    = Keine Programme, dafür alle Bilder.

-a    = Alle Unterverzeichnisse ebenfalls bearbeiten.

-s    = System-Informationen (OS-Version/CPU) anzeigen.
        Die System-Info zeigt installierte PPC-CPU's und MMU's an, wenn
        die mmu.library (Thor) bzw. die ppc.library (Phase5) installiert
        sind.

-v    = Zusätzliche Anzeigen für Testzwecke.

-x    = WarpOS-Programme und PowerUP-Programme wie Amiga-Programme
        behandeln.
-x1   = Nur PowerUP-Programme wie Amiga-Programme behandeln.
-x2   = Nur WarpOS-Programme wie Amiga-Programme behandeln.
-x3   = Identisch mit '-x'.

dir   = Verzeichnis mit dem der Prüflauf beginnt. Unterverzeichnisse
        werden nur bei -a berücksichtigt.

file  = Einzelnes File von dem die Version angezeigt werden soll.


File oder Dir müssen alternativ benutzt werden.
Die Optionen können einzeln oder in Gruppen gesetzt werden.
-1sav ist identisch mit -1 -s -a -v oder -1 -sav usw.
Nur bei -x gilt die Regel: Muß einzeln oder am Ende stehen, maximal
gefolgt von 1,2 oder 3
Die drei Definitionsgruppen (0) müssen jeweils einen einzelnen
Aufruf haben.
@ENDNODE
@NODE "UseWB" "Benutzung von der WB"
@TOC Main
@INDEX INDEX
@NEXT ThirdPartyProd
@PREV Usage
@WORDWRAP
@SMARTWRAP
{U}@{B}Benutzung von der Workbench@{UB}

Die Steuerung erfolgt mittels Tool-Types aus dem Icon heraus.

Normalerweise gibt das Programm ja seine Daten im CLI aus. Als Ersatz wird hier kurz nach
dem Start ein Fenster geöffnet.
Fehlermeldungen werden per @{I}Reqtools-Requester@{UI} ausgegeben.

@{U}Tool-Types im Programmicon:@{UU}

@{B}WINDOW=CON:0/10/640/180/VersCheck@{UB} - Ausgabefenster für die Vergleiche.
                                    CON: = Console
                                      0/ = Erste Spalte von links
                                     10/ = Erste Zeile von oben
                                    640/ = Breite des Fensters
                                    180/ = Höhe des Fensters
                               VersCheck = Fenstertitel

@{B}DEFAULT_PATH=Sys:@{UB}   Pfadname von wo der Scan startet, Ausgenommen
                    der COMPARE-Funktionen.

@{B}ALLDIRS@{UB}             Wenn aktiv, dann werden alle Unterverzeichnisse
                    ebenfalls gescannt.

@{B}COMPARE_LIBS@{UB}        Aktiviert den Vergleich mit den Daten der LibGuide.

@{B}COMPARE_DEVS@{UB}        Aktiviert den Vergleich mit den Daten der DevsGuide.

@{B}COMPARE_DTYPES@{UB}      Aktiviert den Vergleich mit den Daten der DTypesGuide.

@{B}COMPARE_MUI@{UB}         Aktiviert den Vergleich mit den Daten der MUIGuide.

@{B}COMPARE_HANDLER@{UB}     Aktiviert den Vergleich mit den Daten der HandlerGuide.
                    Es darf immer nur ein COMPARE aktiviert sein.

@{B}HTMLOUTPUT@{UB}          Erzwingt HTML-Output im Lib-Check

@{B}MERGE_OUTPUT@{UB}        Ergebnissdateien in der Ram-Disk (falls vorhanden)
                    nicht überschreiben sondern neue Daten anfügen.

@{B}REQUESTER@{UB}           Anzeige des Ergebnisses bzw. Abfrage HTML-Generierung
                    per Requester (entfernen wenn nicht gewünscht).

@{B}SHOW_FULLPATH@{UB}       Pfadnamen komplett anzeigen.

@{B}SHOW_SYSTEMINFO@{UB}     Systeminformationen anzeigen.

@{B}ACCEPT_ELF@{UB}          PPC-Programme (.elf) wie normale Amigaprogramme behandeln
                    und in den Lauf einbeziehen.

@{B}ACCEPT_WOS@{UB}          WarpOS-Programme (.ehf) wie normale Amigaprogramme behandeln
                    und in den Lauf einbeziehen.

@{B}CMP_SUFFIX=.library@{UB} Legt ein Suffix fest das geprüft werden soll (ClassesGuide).

@{B}CMP_LIST=LibsList@{UB}   Name der Vergleichsdatei (ClassesGuide)

@{B}CMP_OUTNAME=Libs@{UB}    Namenszusatz Ergebnsdateien (ClassesGuide)
                    Durch Benutzung des CMP_OUTNAME wird der Vergleich aktiviert.
                    Die beiden anderen Tool-Types wirken auch auf die anderen
                    Vergleichsscans.

@{B}ONLY_PICTURES@{UB}       Nur Bilder suchen.

@{B}ONLY_IFFPICTURES@{UB}    Nur IFF-Bilder suchen.

@{B}VERBOSE@{UB}             Zusätzliche Anzeigen aktivieren.

@ENDNODE
@NODE "ThirdPartyProd" "ThirdPartyProd"
@TOC Main
@INDEX INDEX
@NEXT ProgInfo
@PREV UseWB
@WORDWRAP
@SMARTWRAP
@{U}@{B}Fremdprodukte@{UU}@{UB}

Das Programm nutzt ggf. einige Fremdsoftware:

1.) Befehl @{I}VERSION@{UI} von AmigaDOS. VORSICHT mit den sogenannten
    "verbesserten Ersetzungen". Meist lesen diese nur den $VER-
    String, also sehr viel weniger als das Originalprogramm.

2.) @{I}ppc.library@{UI} (sofern vorhanden) zur Ermittlung der Daten von
    installierten PowerPC-Prozessoren.
    Orginal von Phase-5.
    (Die Emulation von Frank Wille ist noch @{B}NICHT @{UB}getestet!). 

3.) @{I}mmu.library@{UI} V0.24+ (sofern vorhanden) zur Ermittlung der
    MMU-Daten.
    Original von Thor, siehe Aminet.
    PPC-Besitzer lesen bitte den Anhang @{"Bekannte Fehler" link Bugs}'.

4.) @{I}reqtools.library@{UI} für Requester.
    Copyright by © Nico François and Magnus Holmgren.

Fehlen die angegebenen Libs wird der jeweilige Check ausgelassen. Falls
die mmu.library nicht läuft (PPC-Systeme), wird die Anzeige ebenfalls
einfach weggelassen. Ist der Befehl Version nicht installiert, werden
diese Daten nicht zum Vergleich benutzt was die Erfolgsquote senkt.
Falls die reqtools.library nicht installiert ist, erscheinen die
Hinweise nur im CLI. Die Abfrage der HTML-Seite wird mit JA angenommen
und eine HTML-Update-Seite generiert.

Diese AmigaGuide wurde mit Guided von Linus McCabe erstellt.
@ENDNODE
@NODE "ProgInfo" "ProgInfo"
@TOC Main
@INDEX INDEX
@NEXT Future
@PREV ThirdPartyProd
@WORDWRAP
@SMARTWRAP
@{U}@{B}Programmfunktion und Hintergrund@{UU}@{UB}

Das Programm selber sucht nach dem "$VER:"-String und zerlegt ihn.
Außerdem führt es den Befehl @{U}VERSION@{UU} aus und zerlegt dessen Ausgabe
ebenfalls.

Es wird nicht sortiert, sondern direkt das Filesystem gescannt und
dann jeweils sofort verglichen (es wird ExAll() verwendet!). Dies
spart Zeit, besonders bei den Systemen mit sehr vielen Dateien.

Diese Daten sind sicherlich für diverse Zwecke nutzbar. Aber der
eigentliche Verwendungszweck ist der Vergleich mit den Daten der
Libs-, DT- und Device-Checks.

Ich finde die Idee dieser Test's gut und sehe auch, wieviel Zeit
und Energie darin investiert wird, das ganze zu Katalogisieren und
zu Pflegen.

Es gibt aber ein Problem, das recht komplex ist und sich nur sehr
schwer mit CLI-Batches, ARexx oder ähnlichen Dingen lösen läßt.
Gerade bei älteren Lib's sind häufig Probleme vorhanden.
Versionsnummern die z.B. "1.-1" lauten, falsche oder merkwürdige
Angaben im Namensbereich der Version und zu guter letzt noch
Versionsnummern die mal x.x, dann V x.x oder Vx.x lauten.

Dieses Programm "versucht" diese Daten identifizieren und dann 
das Ergebnis mit den Vergleichsdateien zu prüfen. "Versucht"
deshalb, weil ich natürlich erstmal nur mit meinen Daten testen
kann. Die Erkennung wird sicherlich nicht gleich perfekt sein,
aber das wird mit jeder Version verbessert.

Sollte es zu ganz unsinnigen Anzeigen kommen, bitte eine Kopie
des Files an mich senden. Wenn es sich um geschützte Software
handelt, dann bitte vorher Kontakten, denn dann ist es besser
nur einen Ausschitt zu senden da ich keine Raubkopien haben
möchte.
@ENDNODE
@NODE "Future" "Future"
@TOC Main
@INDEX INDEX
@NEXT Bugs
@PREV ProgInfo
@WORDWRAP
@SMARTWRAP
@{U}@{B}Zukunft@{UU}@{UB}

Neben Verbesserung im Vergleich und laufender Wartung werden
gerne auch Wünsche für andere Einsatzzwecke berücksichtigt.

Das Programm DVC, das vor einiger Zeit diese Tests durchführte,
hat einige Funktionen, die für mich unverzichtbar geworden sind.
Z.B. das man Dateien auf ihre Version testen kann und ein
Requester gleich nachfragt ob man sie installieren möchte.
Leider ist DVC längst nicht mehr auf dem laufenden Stand. Zudem
fehlt mir z.B. eine Möglichkeit neuere Dateien sofort zu
installieren (vorherige Version evtl. Sichern) und ebenso, bei
alten Versionen keine Abfrage zu bringen. Daher soll eine
Copy-Funktion, ähnlich DVC, hinzukommen die diese Dinge
verbessert.

Die reine Erkennung der Dateien an ihrer Endung ist ein
Schwachpunkt von DVC. So wird das ReadMe xxx.library von DVC
nach Libs: kopiert. Nicht so sinnvoll.

Weitere Dateitypen sollen erkannt werden.

Ein Brainfile für die Copyfunktion ist in Vorbereitung.
Eine Anti-Liste mit aktuellen Warnungen (z.B. Viren)
ist auch geplant.
@ENDNODE
@NODE "Bugs" "Bugs"
@TOC Main
@INDEX INDEX
@NEXT CheckGuides
@PREV Future
@WORDWRAP
@SMARTWRAP
@{U}@{B}Bekannte Fehler@{UU}@{UB}

Die aktuelle mmu.library arbeitet mit PPC-System nicht
zusammen und kann auf diesen daher keine Anzeige bringen.
Laut Autor ist das Problem mangelnde Kooperationsbereitschaft
der Firma Phase-5 (Info's über die MMU-Verwaltung auf
PPC-Systemen). Das wird sich aber wohl bald ändern (Dank
Sam Jordan/Haage & Partner).


@{U}@{B}Probleme mit anderen Programmen@{UU}@{UB}

Beim Test kam es mehrfach zum Rechnerstillstand bei
umfangreicheren Verzeichnissen. Gründe:

1.) Output in einem KingCon-CLI-Fenster (CON: und AUX:
    von KingCon). Ursache unklar, gleiches passiert auch
    bei Benutzung von vim und anderen Programmen, war aber
    nicht immer so. Vermutlich ein Konflikt zwischen KCon
    und einer nicht identifizierten, anderen Software.
    Abhilfe: Tritt nicht auf, wenn der Verbose-Modus (-v)
    aktiv ist.

2.) Stillstand beim Versionstest mpegavideo.datatype.
    Ursache ist C:Version. Aus unerfindlichen Gründen stürzte
    der Befehl hierbei ab. Ist aber sehr wahrscheinlich ein
    Hardware-Problem auf meinem Rechner. Abhilfe: Tritt nicht
    auf, wenn das Verzeichnis statt auf der Platte in der
    Ram-Disk liegt. Nach der Installation von WarpOS und
    einem decrunch aller Files in Sys: war das Problem weg.
    Ich weiß nicht, warum. Aber ich denke, es lag an einigen
    gecrunchten Files. WARUM CRUNCHET JEMAND ÜBERHAUPT?
    Festplatten sind inzwischen extrem billig und gecrunchte
    Files machen nur das System langsamer.
@ENDNODE
@NODE "CheckGuides" "CheckGuides"
@TOC Main
@INDEX INDEX
@NEXT ToDo
@PREV Bugs
@WORDWRAP
@SMARTWRAP
@{U}@{B}Anhang für die Vergleichslisten@{UU}@{UB}

@{I}(siehe Ende dieser Seite!)@{UI}

@{B}- LibGuide@{UB}
@{B}- DTypesGuide@{UB}
@{B}- DevsGuide@{UB}
@{B}- ClassesGuide@{UB}
@{B}- HandlerGuide@{UB}
@{B}- MUIClassGuide@{UB}

@{U}Der Vergleich:@{UU}

Jede Datei wird zunächst anhand der "Magic-Number" identifiziert.
Die "Magic-Number" sind die ersten 4 Bytes (evtl. 8, hier aber
belanglos), einer binären Datei. Daran kann man identifizieren,
was es ist. Z.B. ein Amigaprogramm, genau wie ein MS-Dos-Programm
usw.! Da sowohl Libs, als Devs und DT's den Magic-Code eines 
ausführbaren Programmes haben, werden im Moment nur Dateien
geprüft, die eine solche Amigaprogrammkennung tragen. Also eine
Textdatei "Libs:Irgendwas.Library" wird garnicht erst geprüft.
Aus diesem Grund werden auch ELF/EHF (PowerUP/WarpOS) übergangen,
wenn sie nicht per '-x'-Option aktiviert werden.

Je nach Check wird auch noch ".Library", ".Device" oder ".Datatype"
geprüft. Bei Bedarf könnte das natürlich ausgedehnt werden (z.B.
MUI '.mcc' und '.mcp'). Aber diese Anforderung behalte ich dem
Autor der CheckGuides vor. Lediglich -x bewirkt hier das zusätzlich
.wos, .elf und/oder .ppc aktiviert werden können.

Für den Header werden die MMU-Library und die PPC-Library eingesetzt,
falls nicht vorhanden, wird der jeweilige Part halt nicht angezeigt.

Der Versionsvergleich findet NUMERISCH, durch Zerlegen der
Versionsnummer aus X.Y(.Z) statt. Dabei entstehen bis zu maximal 3
numerische Teile, wodurch aus 1.-1 die korrekte Version 1,
Revision 1 wird.

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}

@{U}@{B}Amiga shared libraries guide@{UU}@{UB}

Autor: Heiko Schröder

COPYRIGHT © Heiko Schröder (age@thepentagon.com) 1996-1999
@{FG SHINE}
              %      %  %      %%%%        %      %
              %         %     %   %               %
              %     %%  % %%  %     %   % %%   %% %  %%%%
              %      %  %%  % %  %% %   %  %  %  %% %
              %      %  %   % %   % %   %  %  %   % %%%%
              %      %  %   % %   % %   %  %  %   % %
               %%%% %%% %%%%  %%%%%  %%%% %%%  %%%% %%%%%
@{FG TEXT}
                    at http://amigasystem.org

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}@{FG TEXT}

@{U}@{B}Amiga Device Guide@{UU}@{UB}

Autor: Heiko Schröder

COPYRIGHT © Heiko Schröder (age@thepentagon.com) 1996-1999
@{FG SHINE}
    %%%                %                      %%%%        %      %
    % %%                                     %   %               %
    %  %%  %%%% %   % %%   %%%  %%%%  %%%%   %     %   % %%  %%% %  %%%%
    %   % %     %   %  %  %    %     %       %  %% %   %  %  %  %% %   
    %   % %%%%  %% %%  %  %    %%%%  %%%%%   %   % %   %  %  %   % %%%%
    %   % %      %%%   %  %    %         %   %   % %   %  %  %   % %
     %%%  %%%%%   %   %%% %%%% %%%%% %%%%    %%%%%  %%%% %%%  %%%% %%%%%
@{FG TEXT}                    at http://amigasystem.org

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}@{FG TEXT}

@{U}@{B}Amiga shared datatypes guide@{UU}@{UB}

Autor: Heiko Schröder

COPYRIGHT © Heiko Schröder (age@thepentagon.com) 1996-1999
@{FG SHINE}
%%%          %          %                           %%%%        %      %
% %%         %          %                          %   %               %
%  %%  %%%% %%%   %%%% %%% %   %  %%%%  %%%%  %%%% %     %   % %%  %%% %  %%%%
%   % %   %  %   %   %  %  %   % %   % %     %     %  %% %   %  %  %  %% %
%   % %%%%%  %   %%%%%  %  %% %% %   % %%%%  %%%%% %   % %   %  %  %   % %%%%
%   % %   %  %   %   %  %   % %  %%%%  %         % %   % %   %  %  %   % %
 %%%  %   %  %%  %   %  %%  %%%  %     %%%%% %%%%  %%%%%  %%%% %%%  %%%% %%%%%
                             %   %
                             %   %

@{FG TEXT}                    at http://amigasystem.org

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}@{FG TEXT}

@{U}@{B}Classes.Guide@{UU}@{UB}

Author: Stuart Kelly

COPYRIGHT © Stuart Kelly (@{FG SHINE}stuart@dkelly1.demon.co.uk@{FG TEXT})

@{FG SHINE}
     %%%  %                                   %%%%        %      %
    %     %                                  %   %               %
    %     %   %%%%  %%%%  %%%%  %%%%  %%%%   %     %   % %%  %%% %  %%%%
    %     %  %   % %     %     %     %       %  %% %   %  %  %  %% %   
    %     %  %%%%% %%%%% %%%%% %%%%  %%%%%   %   % %   %  %  %   % %%%%
    %     %  %   %     %     % %         %   %   % %   %  %  %   % %
     %%%  %% %   % %%%%  %%%%  %%%%% %%%%    %%%%%  %%%% %%%  %%%% %%%%%
@{FG TEXT}
By Stuart Kelly Copyright 1999 ©

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}@{FG TEXT}


@{U}@{B}Handler.Guide@{UU}@{UB}

Authoress: Michaela Pruess

COPYRIGHT © Michaela Pruess (@{FG SHINE}Gateway5@gmx.net@{FG TEXT})

@{fg shine}
 %%  %%                      %%    %%                   
 %%  %%                      %%    %%                   
 %%  %%   %%%%   %%%%%    %%%%%    %%     %%%%   %%%%%  
 %%%%%%      %%  %%  %%  %%  %%    %%    %%  %%  %%  %% 
 %%  %%   %%%%%  %%  %%  %%  %%    %%    %%%%%%  %%     
 %%  %%  %%  %%  %%  %%  %%  %%    %%    %%      %%     
 %%  %%   %%%%%  %%  %%   %%%%%     %%    %%%%   %%     

  %%%%             %%        %%         
 %%  %%                      %%         
 %%      %%  %%    %%     %%%%%   %%%%  
 %% %%%  %%  %%    %%    %%  %%  %%  %% 
 %%  %%  %%  %%    %%    %%  %%  %%%%%% 
 %%  %%  %%  %%    %%    %%  %%  %%     
  %%%%%   %%%%%     %%    %%%%%   %%%%  
                                        
@{fg text}                    at http://amigadownload.amiga.webjump.com/index.html

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}@{FG TEXT}

@{U}@{B}MUIClass.Guide@{UU}@{UB}

Authoress: Michaela Pruess

COPYRIGHT © Michaela Pruess (@{FG SHINE}Gateway5@gmx.net@{FG TEXT})

@{fg shine}

 %%   %% %%   %%   %%    %%%    %                      %%%          %       %       
 %%% %%% %%   %%   %%   %   %   %                     %   %                 %       
 % %%% % %%   %%   %%   %       %    %%%   %%%   %%%  %     %   %   %    %%%%  %%%  
 %% % %% %%   %%   %%   %       %       % %     %     %  %% %   %   %   %   % %   % 
 %%   %% %%   %%   %%   %       %    %%%%  %%%   %%%  %   % %   %   %   %   % %%%%% 
 %%   %% %%   %%   %%   %   %   %   %   %     %     % %   % %  %%   %   %   % %     
 %%   %%  %%%%%    %%    %%%     %   %%%% %%%%  %%%%   %%%%  %% %    %   %%%%  %%%  

@{fg text}                    at http://amigadownload.amiga.webjump.com/index.html

@{U}@{B}---------------------------------------------------------------------------------@{UU}@{UB}@{FG TEXT}

@ENDNODE
@NODE "ToDo" "ToDo"
@TOC Main
@INDEX INDEX
@NEXT Locale
@PREV CheckGuides
@WORDWRAP
@SMARTWRAP
@{U}@{B}ToDo (CheckGuides):@{UU}@{UB}

- Versionsnummer alternativ scannen [suche '(DATUM)'] für die ganz
  mies programmierten Teile. Nur ein Fall bekannt.

- Versionsunsinn "%ld" etc. identifizieren. Nur ein Fall bekannt.



@{U}@{B}ToDo (VersCheck):@{UU}@{UB}

- Weitere Filetypen erkennen/anzeigen.

- Copy-Funktion mit Requester/Suffix-Datei/Sicherungen u.v.m.

- Alles, was die Praxis als sinnvoll erscheinen läßt.
@ENDNODE
@NODE "Locale" "Locale"
@TOC Main
@INDEX INDEX
@PREV CheckGuides
@WORDWRAP
@SMARTWRAP
@{U}@{B}Information über locale in VersCheck:@{UU}@{UB}

Das Progamm benutzt keine wirklichen Locale-Dateien. Es hat eine
eigene Sprachverwaltung.

Das Programm wurde für zwei unterschiedliche Anwendungen geschaffen.
Erstens, um in den CheckGuides den Vergleich zwischen deinem Rechner
und den Listen durchzuführen. Zweitens (in Zukunft), um Vergleiche und
Updates von Programmen und Systemfiles, ähnlich DVC, zu ermöglichen.
Allerdings mit einigen weiteren Funktionen und einem konfigurierbarem
Suffixfile.

Das Programm ist im AmiNet verfügbar, und es wird mit den CheckGuides
ausgeliefert. Was, wenn eine Version bereits installiert ist und eine
andere bei den Guides liegt wobei die beiden Version in den Texten
nicht zusammenpassen?

Um dieses Problem zu vermeiden und die Anpassung an weitere Sprachen
zu vereinfachen (kein besonderes Wissen notwendig), habe ich die
Programmtexte in einfache Ascii-Dateien ausgelagert. Zum Ändern oder
Anpassen ist lediglich ein Editor wie Ed, Edit, GoldEd, CygnusEd,
emacs, vi usw. nötig. Man sollte sich lediglich zuerst die 
Programmausgaben ansehen, damit man ein Gefühl dafür bekommt und nicht
eine sehr merkwürde Ausgabe produziert.

Zeile 1 bis 3 sind Kommentare. Bitte so belassen! Die Zeilen ab 4
sind die Progammausgaben von VersCheck. VersCheck sucht zunächst im
aktuellen Verzeichnis sowie dem Progammstart-Verzeichnis nach einer
Datei mit dem Namen VersCheck.<Locale>.

Dabei wird der Wert für <Locale> aus ENV:Language gelesen. Dies sollte
von der s:startup-sequence zur Bootzeit korrekt gesetzt worden sein.

Wird kein passendes File gefunden, dann sucht VersCheck das File
Locale:catalogs/<Locale>/VersCheck.catalog
Für eine dauerhafte Installation sollte das richtige File entsprechend
kopiert werden. Für die CheckGuide können die Files bleiben, wo sie
sind.

Zur Zeit sind insgesamt 4 Sprachfiles vorhanden:

VersCheck.deutsch   (Locale:catalogs/deutsch/VersCheck.catalog)
VersCheck.english   (Locale:catalogs/english/VersCheck.catalog)
VersCheck.norsk     (Locale:catalogs/norsk/VersCheck.catalog)
VersCheck.svenska   (Locale:catalogs/svenska/VersCheck.catalog)

Falls Du eine Anpassung an eine weitere Sprache vornimmst, bitte
schick eine Kopie an mich, damit ich die Übersetzung in den
Release-Stand übernehmen kann.

eMail: Gateway5@gmx.net

Niemals sollten Zeilen eingefügt oder gelöscht werden. Das führt
zu falschen Anzeigen!

Die maximale Länge pro Zeile ist 70, mehr wird abgeschnitten.

Leere oder fehlende Zeilen werden durch den internen, englischen
Text ersetzt


@{I}Übersetzungen:@{UI}

english   : von Michaela Prüß   (28.02.1999)
deutsch   : von Michaela Prüß   (28.02.1999)
norsk     : von Roger Hågensen  (20.04.1999)
svenska   : von Mikael Engström (02.09.1999)

ATO-Projekt läuft im Moment!

@ENDNODE
@NODE "INDEX" "Index"


@{"Bekannte Fehler und Probleme" link Bugs}
@{"Bekannte Fehler" link Bugs}
@{"Benutzung des Programms im CLI" link Usage}
@{"Benutzung von der Workbench" link UseWB}

C

@{"CheckGuides" link CheckGuides}
@{"Copyright, Nutzungsbedingungen" link Copyright}

D

@{"Die Vergleiche und Listen!" link CheckGuides}

I

@{"Index" link Index}
@{"Inhalt" link Main}
@{"Installation der Sprachtexte" link Locale}
@{"Installation des Programmes" link Install}

O

@{"Offene Punkte (To Do)" link ToDo}

P

@{"Programm-History" link History}

S

@{"Sprachverwaltung (Locale)" link Locale}
@{"Support und Fehlermeldungen" link Support}

U

@{"Updates, Fehler" link Support}

V

@{"Verwendete Fremdprodukte" link ThirdPartyProd}

W

@{"Wichtig, unbedingt Lesen" link Important}

Z

@{"Zukunft und Planungen" link Future}

Ü

@{"Über VersCheck (Hintergründe)" link ProgInfo}
@ENDNODE
@node INDEX Index
@remark Index created with 'mkagidx' (C) Captain CrossBones
B

@{"Bekannte Fehler und Probleme" link Bugs}
@{"Bekannte Fehler" link Bugs}
@{"Benutzung des Programms im CLI" link Usage}
@{"Benutzung von der Workbench" link UseWB}

C

@{"CheckGuides" link CheckGuides}
@{"Copyright, Nutzungsbedingungen" link Copyright}
@{"CPU-Unterstützungen" link CPU}

D

@{"Die Vergleiche und Listen!" link CheckGuides}

I

@{"Index" link Index}
@{"Inhalt" link Main}
@{"Installation der Sprachtexte" link Locale}
@{"Installation des Programmes" link Install}

O

@{"Offene Punkte (To Do)" link ToDo}

P

@{"Programm-History" link History}

S

@{"Sprachverwaltung (Locale)" link Locale}
@{"Support und Fehlermeldungen" link Support}

U

@{"Updates, Fehler" link Support}

V

@{"Verwendete Fremdprodukte" link ThirdPartyProd}

W

@{"Wichtig, unbedingt Lesen" link Important}

Z

@{"Zukunft und Planungen" link Future}

Ü

@{"Über VersCheck (Hintergründe)" link ProgInfo}
@endnode
