@DATABASE CMP
@WORDWRAP
@$VER: "1.5"
@NODE MAIN "DIE STARTSEITE __--__ THE STARTPAGE"





			     @{fg highlight}CMP V1.5@{fg text}



    @{" Deutsche Dokumentation" LINK 2main.dtsch} ....... vergleichen von Datein mit einem GUI

    @{" English Documentation"  LINK 2main.engl} ........ compare files via GUI

@ENDNODE

@NODE 2main.dtsch " TREFFEN SIE IHRE AUSWAHL "

  Dieses Programm ist Freeware, das heißt, sie dürfen es nach belieben
  kopieren, solange nichts am Programmcode oder an der Dokumentation
  verändert wird.


   0.@{"fg text} @{" Was ist und kann CMP ?          " LINK was}

   1.@{"fg text} @{" Wie benutzt man CMP?            " LINK benu}

   2.@{"fg text} @{" Steuerung über die Tastatur ... " LINK tast}

   3.@{"fg text} @{" Was benötigt CMP ?              " LINK copy}

   4.@{"fg text} @{" Über den Autor                  " LINK auto}

   5.@{"fg text} @{" Der Autor dankt ...             " LINK dank}

   6.@{"fg text} @{" Die Entwicklungsgeschichte      " LINK gesc}

@ENDNODE


@NODE was " Was ist und kann CMP ? "

  CMP ist ein nütliches Utility um 2 Dateien zu vergleichen und die
  Unterschiede mittels eines GUI zwischen ihnen anzuzeigen.
  Die Unterschiede werden hervorgehoben und sowohl in ASCII als auch
  in HEX angezeigt. Außerdem können die Versions-Strings verglichen werden.

@ENDNODE


@NODE benu " WIE BENUTZT MAN CMP ? "

  Benutzung:

  Um CMP zu starten, geben "CMP [Datei1] [Datei2] in der Shell ein oder
  führen sie ein Doppelklick über dem Icon aus.

  Drücken sie die Gadgets "Load 1" und "Load 2" um 2 Dateien zu laden.
  Clicken sie nun das "Compare" Gadget an, um die Daten zu vergleichen.
  Sie können sich nun die Unterschiede ansehen, indem sie die Gadgets
  "Next Ln" , "Prev Ln" , "Next Pg" , "Prev Pg" , "Next Dif" , "Prev Dif"
  drücken.

  NextLn   .......................... zur nächsten Zeile springen
  Prev Ln  .......................... zur vorhergehenden Zeile springen
  Next Pg  .......................... zur nächsten Seite springen
  Prev Pg  .......................... zur vorhergehenden Seite springen
  Next Dif .......................... zum nächsten Unterschied springen
  Prev Dif .......................... zum vorhergehenden Unterschied springen

  Wenn 2 Bytes der Files verschieden sind, wird der Hintergrund blau ein-
  gefärbt.

  Am linken Rand des Fensters wird das aktuelle Offset vom Beginn der Files
  angezeigt (hex), in der Mitte der Hex-Code (mit den gefärbten
  Unterschieden) und am rechten Rand der ASCII-Code.

  Um nach eventuell vorhandenen Version-Strings zu suchen, drücken sie das
  "Version" Gadget. CMP wird nun nach einem String im Format "$VER: xxx ,0"
  suchen. Bitte beachten sie, daß wenn die "0" am Ende des Strings nicht
  vorhanden ist, der String auch nicht angezeigt wird. Dies ist öfters der
  Fall, wenn in Text oder AmigaGuide-Files gesucht wird.

  Nach dem Drücken des "Info" Gadgets, erscheinen einige Informationen über
  die Größe der Files, deren Namen, die Anzahl der Unterschiede und über den
  freien Speicher.

  Clicken sie das Close-Gadget, um CMP zu verlassen.

  Wenn sie möchten, können sie CMP über das Menü oder über die Tastatur,
  anstatt mit den Gadgets, benutzen.

@ENDNODE


@NODE tast " WIE STEUERT MAN CMP ÜBER DIE TASTATUR ? "

  Die Tasten :

  1 ................................... Datei 1 laden
  2 ................................... Datei 2 laden
  c ................................... Die Files vegleichen
  i ................................... Informationen
  v ................................... Nach dem Versionstring suchen
  a ................................... Über den Autor
  cursor runter........................ Nächste Zeile
  cursor hoch ......................... Vorhergehende Zeile
  cursor rechts ....................... Nächstes Zeichen
  cursor links ........................ Vorhergehendes Zeichen
  shift cursor runter ................. nächste Seite
  shift cursor hoch ................... vorhergehende Seite
  ctrl cursor hoch .................... Springe an den Anfang
  ctrl cursor runter................... Springe an das Ende
  n ................................... Nächsten Unterschied
  p ................................... Vorhergehenden Unterschied
  q ................................... Beenden

@ENDNODE

@NODE copy " WAS BENÖTIGT CMP ? "

  CMP benötigt die "reqtools.library" von Nico François. Stellen sie darum
  sicher, daß sie sich in ihrem LIBS: Directory befindet.
  Durch klicken auf das "InstallRT"-Icon wird die Library installiert.

  Außerdem wird eine Betriebsystemversion von OS 2.04 oder höher
  vorrausgesetzt.


@ENDNODE


@NODE auto " ÜBER DEN AUTOR "

  Bitte benachrichtigen sie mich, wenn sie Fehler im Programm finden oder
  Verbesserungsvorschläge haben.

  Meine Adresse:

  Andreas Wiencke
  Hamburger Allee 98
  19063 Schwerin
  Deutschland

  Telefon: 0385/215778                E-MAIL: insider@spybox.shnet.org

@ENDNODE

@NODE dank " ANDREAS DANKT : "

  Vielen Dank an Crazy Copper/DFT für seine unermüdliche Suche nach Fehlern,
  an Jan Blumenthal für die Idee für dieses Programm und an Latte für das
  Guide.

@ENDNODE

@NODE gesc " WAS GESCHAH WANN, WO, WIE UND WESHALB ? "

  Geschichte der Entwicklung:

  V1.0   * erste offizielle Version
  V1.01  * CMP stürzte ab, wenn sehr kleine Files verglichen wurden
  V1.1   * CMP setzt nun den Topaz 8 Font
  V1.2   * Bei Info werden nun auch die geladenen Dateien angezeigt.
	 * Die Tastaturbelegung wurde geändert.
	 * Man kann nun auch zum nächsten bzw. zum vorhergehenden
	   Zeichen springen.
	 * Um nach Versionsstrings zu suchen brauchen die Files nicht mehr
	   verglichen zu werden. Es reicht nun auch ein File zu laden.
	 * Mit dem Scrollbalken kann man nun in "Echtzeit" durch die Daten
	   scrollen
	 * Es wurde manchmal Müll angezeigt, wenn der Scrollbalken schnell
	   bewegt wurde. Fehler beseitigt.
  V1.3   * Dateien werden nun korrekt eingeladen, auch wenn beim
	   Filerequester kein Laufwerk angewält wurde.
	 * Wenn einmal auf den Scrollbalken geclickt wurde, verfing sich
	   CMP in einer Endlosschleife. Fehler beseitigt.
	 * Installscript für reqtools.library geschrieben.
  V1.4   * CMP stürzte auf einigen Amigas ab, Fehler beseitigt.
	 * Scrollbar hat nun das OS3-Aussehen.
	 * Menus haben nun OS3-Aussehen
  V1.5   * CMP passt sich nun besser an Titelfont an
	 * Scrollbar passt sich besser an Dateigrößen an
	 * Programm wird nun mit q statt mit ESC verlassen
	 * Startup_asm 3.4 , © 1995 by Kenneth C. Nilsen, wird verwendet
	 * Anleitung liegt nun im AmigaGuide-Format vor

@ENDNODE


@NODE 2main.engl " TAKE YOUR CHOICE "


  This program is Freeware. That means that you may copy it as long as you
  do not change anything on the documentation and the code.

   0.@{"fg text} @{" Introduction              " LINK int}

   1.@{"fg text} @{" How to use CMP            " LINK how}

   2.@{"fg text} @{" Keyfunctions              " LINK atur}

   3.@{"fg text} @{" Requirements              " LINK requ}

   4.@{"fg text} @{" About the autor           " LINK auth}

   5.@{"fg text} @{" Thanks to                 " LINK than}

   6.@{"fg text} @{" History                   " LINK hist}

@ENDNODE

@NODE int " Introduction "

  CMP is a useful tool to compare 2 files and display the differents between
  them. Additionally it is possible to compare the version-strings.


@ENDNODE

@NODE how " HOW TO USE CMP ? "

  How to use ?

  To start CMP type "CMP [file1] [file2]" in the Shell or simply doubleclick
  its icon from workbench.
  Click the "load 1" and "load 2" gadgets to load 2 files and compare them
  by pressing the the "compare" gadget. After a short time the files are
  compared and now you can watch the differents by clicking the scrollbar or
  the "Next Ln" , "Prev Ln" , "Next Pg" , "Prev Pg" , "Next Dif" , "Prev Dif"
  gadgets.

  NextLn   - Jump to the next line.
  Prev Ln  - Jump to previous line.
  Next Pg  - Jump to next page.
  Prev Pg  - Jump to previous page.
  Next Dif - Jump to next different.
  Prev Dif - Jump to previous different.

  If there is a differnt between two bytes of the files the backround is
  marked blue.

  To look for version-strings click the "Version" gadget. CMP will now
  search for a string in the format "$VER: xxx ,0".
  Please notice that if the "0" at the end of the string is not found the
  string won`t be displayed. This often happens if you search in text or
  AmigaGuide files.

  If you click the "Info" gadget some informations about the size of the
  files, their names, the number of differents and free memory will be given.

  To quit CMP press the closegadget.

  If you want to, you can use the menu and the keyboard instead of clicking
  the gadgets.

@ENDNODE

@NODE atur " KEY FUNCTIONS "

  Key functions are :

  1  .................................. load file 1
  2 ................................... load file 2
  c ................................... compare the files
  i ................................... informations
  v ................................... search for version-strings
  a ................................... about
  cursor down ......................... next line
  cursor up ........................... previous line
  cursor right ........................ next byte
  cursor left ......................... previous byte
  shift cursor down ................... next page
  shift cursor up ..................... previous page
  ctrl cursor down .................... bottom
  ctrl cursor up ...................... top
  n ................................... next different
  p ................................... previous different
  q ................................... quit

@ENDNODE

@NODE requ " REQUIREMENTS "

  CMP makes use of the "reqtools.library" by Nico François. So make sure
  you have installed it in your LIBS: Directory.
  Simply doubleclick the "InstallRT"-Icon to install reqtools.library.

  Additionally CMP needs at least OS 2.04 to run.

@ENDNODE

@NODE auth " ABOUT THE AUTHOR "

  Do not hesitate to contact me if you find bugs or if you have ideas for
  improving CMP.

  Hope you`ll find this program useful.

  My adress:

  Andreas Wiencke
  Hamburger Allee 98
  19063 Schwerin
  Germany

  Phone: 0385/215778                 E-MAIL: insider@spybox.shnet.org

@ENDNODE

@NODE than " THE AUTHOR THANKS : "


  Many thanx to Crazy Copper/DFT for his endless bugreports and suggestions,
  to Jan Blumenthal vor the idea to code this tool and to Latte for the
  guide.

@ENDNODE

@NODE hist " HISTORY "

  History:
  V1.0   * First official release.
  V1.01  * CMP crashed when comparing very small files, bug removed.
  V1.1   * CMP now sets topaz 8 font.
  V1.2   * Info now showes the filenames, too.
	 * Changed the functions of some keys.
	 * Now its possible to jump to the next/previous byte.
	 * Looking for a version-string is now possible without comparing
	   the files. Its possible to look in one file only.
	 * Its easier to use the scrollbar now.
	 * CMP sometimes displayed wrong adresses, when the scrollbar was
	   used. Bug removed.
  V1.3   * Files are now readed correctly even if the user does not select a
	   drawer in the filerequester.
	 * CMP looped endless when scrollbar was clicked once. Bug removed.
	 * Added a script to install reqtools.library.
  V1.4   * CMP used to crash on some machines, fixed.
	 * Scrollbar now looks 3.0-alike.
	 * Menus now look 3.0-alike.
  V1.5   * CMP now better adapts to the titelfont
	 * scrollbar now adapts better to filesizes
	 * key for quitting changed from ESC to q
	 * Startup_asm 3.4 , © 1995 by Kenneth C. Nilsen, now used
	 * Changed doc to AmigaGuide

@ENDNODE



