@DATABASE archiver.guide
@FONT xcourier.font 11
@%start main
@NODE MAIN "archiver.bat © copyright 1994-97 by Timo Stamm"


  @{u}Kurz:@{uu}

  Archiver.bat ist eine Batch-Datei, die einem
  den Umgang mit Packern wie lha und lzx erleichtern
  sollte.

  @{u}Geistiges:@{uu}

  @{" Copyright     " link copyright    }   Kopierrecht
  @{" Einleitung    " link einleitung   }   warums sgibt
  @{" Features      " link features     }   nette Sachen, die's kann
  @{" History       " link history      }   Geschichte

  @{u}Praktisches:@{uu}

  @{" Voraussetzung " link voraussetzung}   was man braucht
  @{" Installation  " link installation }   wies auf Platte
  @{" Einstellung   " link einstellung  }   Packer, etc definieren
  @{" Benutzung     " link benutzung    }   wie mans benutzt


  @{i}nec bella fuerunt;
  faginus astabat dum scyphus ante dapes@{ui}

@ENDNODE
@%end

@%start copyright
@NODE copyright "Archiver.bat/Kopierrecht"

Archiver.bat © copyright 1994-1997 by

 @{"Timo Stamm" link t.iff/main}
 Trockenpützstraße 38
 41472 Neuss

Die Batchdatei darf nicht verändert und nur mit dieser Dokumentation im selben
Verzeichnis weitergegeben werden.

Wer sie auf einer Kompilation veröffentlichen will, ist selber schuld.

Es wird keine Verantwortung übernommen für irgendwelche Schäden, die die
Batch-Datei verursachen könnte.


@ENDNODE
@%end
@%start einleitung
@NODE einleitung "Archiver.bat/Einleitung"

Es macht keinen Spaß, für jedes kleine Archiv in die shell zu gehen und da was
einzutippen. Das haben schon viele herausgefunden und diverse GUIs geschrieben,
die dagegen helfen sollen, es aber nicht tun, sondern im Gegenteil sehr
häßlich aussehen, schlecht zu handhaben sind und einem immer auf der Workbench
herumhängen.


Weil es mir manchmal Spaß macht, unnötige Batch-Dateien zu schreiben, habe ich
halt auch mal eine geschrieben, die für lha und so weiter zuständig ist. In
Verbindung mit @{"ToolManager" link toolman} ist sie sogar einigermaßen nützlich.

Ja, ja.


@ENDNODE
@%end
@%start features
@NODE features "Archiver.bat/Features"

Alle wichtigen @{"Vorgaben" link einstellung} lassen sich @{"ändern" link einstellung}.

Man kann den @{"Archiver vorwählen" link einstellung}.

Man kann die Argumente zum Packen und zum Entpacken für den Archiver @{"vorwählen" link einstellung}.
Wobei sich die restlichen Angaben allerdings so verhalten wie für lha und so
fort. Ach ja, den Suffix des Packers kann man auch @{"aussuchen" link einstellung}, d. h. muß man.

Während des Packens eines Verzeichnisses machts plünk (eine Onomatopoesie), wenn
man es öffnen will. Allerdings nur wenn das Verzeichnis, in dem sich das
Verzeichnis befindet, nicht aktualisiert wird.

Man kann auch @{"DMS" link dms}-Dateien entpacken. Entweder nach DF0:
oder zum einem @{"selbstgewählten" link einstellung} device.

Man kann ein Icon @{"vorwählen" link einstellung}, daß zu jedem Archiv gesichert wird.

Das Ausgabefenster kann @{"gewählt" link einstellung} werden.

Wenn man kein Argument angibt, erscheint ein Menu.


@ENDNODE
@%end
@%start "history"
@NODE history "Archiver.bat/History"

Tja, eine richtige history gibt es wohl nicht. Zumindest ließ sie sich nicht
so schön tabellarisch zusammenfassen, wie man das bei richtigen Programmen
sieht.


@ENDNODE
@%end

@%start voraussetzung
@NODE voraussetzung "Archiver.bat/Voraussetzung"

Man braucht mindestens OS 3.0 wegen der requester-Befehle, die es erst ab hier
gibt.

Lha oder lzx oder so was. Muß nach dem selben Muster funktionieren.

@{"ToolManager" link toolman} oder etwas Ähnliches, um die Batch-Datei überhaupt
richtig ausnutzen zu können.


@ENDNODE
@%end
@%start "installation"
@NODE installation "Archiver.bat/Installation"

Zum Installieren kopiert man die Batch-Datei irgendwo auf die Platte. Am besten
ist aber C:, denn da wird sie eigentlich immer gefunden. Das macht man zum
Beispiel so:

 @{i}copy archiver.bat c:@{ui}

Der eigentliche Sinn ist die Benutzung mit @{"ToolManager" link toolman}. So erst kann sich
ein ganzheitlich-dynamisches DragnDrop entwickeln.

Ansonsten sind die Voreinstellungen zu beachten, die innerhalb der Batch-Datei
mithilfe eines Editors vorgenommen werden können. Hier lassen sich die Pfade und
so weiter von den Packern angeben.

Sonst braucht man eigentlich @{"nichts" link voraussetzung}.


@ENDNODE
@%end
@%start "einstellung"
@NODE einstellung "Archiver.bat/Einstellung"

Im Sinne der Effizienz sind alle Voreinstellungen innerhalb der Batch-Datei
untergebracht. Um etwas zu ändern, muß man sie also mit einem Texteditor
einlesen. Dabei ist zu beachten, daß einige Zeilen überlang sind, was manche
Editoren nicht verkraften. Etwa ab der 20. Zeile befindet sich ein Abschnitt,
der in Semikoloj gefaßt ist. 

Grundsätzlich kann man alle Angaben verändern, die in Anführungsstrichen gesetzt
sind. Hier die Erklärungen zu den Kommentaren, die jeweils rechts daneben
stehen:


@{u}Das Ausgabefenster:@{uu}
	 Hier lassen sich die Koordinaten der Ausgabefenster
	 eingeben. Das Muster ist das vielleicht schon Bekannte:

	 @{i}Gerät:x/y/Breite/Höhe@{ui}

@{u}Vorgabe-Piktogramm:@{uu}
	 Hier läßt sich ein Piktrogramm mit Pfad angeben, daß jeweils
	 zu Archiven kopiert wird. Wenn man keines will, muß man
	 einfach irgendetwas eintippen, zum Beispiel @{i}irgendwas@{ui}.

@{u}Suffix
und Packer mit Optionen zum Packen
bzw. Updaten:@{uu}
	 Hier sind der Suffix des Packers sowie er selbst einmal mit Optionen
	 zum Packen von Daten und einmal zum Updaten von Daten (wenn das
	 gewählte Archiv schon existiert) anzugeben.

@{u}Erkennungs-Suffix und
Pfad des n. Entpackers:@{uu}
	 Hier kann man 1. den Erkennungs-Suffix und 2. seine
	 verschieden Entpacker mit Pfad und den entsprechenden Optionen
	 zum entpacken angeben. Allerdings müssen diese im selben
	 Muster funktionieren wie Lha oder Lzx. Anhand des Erkennungs-
	 Suffixes werden die Packer zugeordnet. D. h. man kann so wie im
	 vorgegebenen Beispiel auf die Endungen @{i}lha@{ui} und @{i}lhz@{ui} lha
	 anwenden.

	 Wenn mehr als die nur 3 vorgebenen Punkte benötigt werden,
	 kann man einfach einen der Abschnitte kopieren und dahinter
	 wieder einfügen.

@{u}Pfad DMS
vorgegebenes device:@{uu}
	 Hier läßt sich der Pfad von @{"DMS" link dms} angeben.
	 Und das zweite device vorgeben. Es muß natürlich auch
	 dms-kompatibel sein und mit Doppelpunkt hinten geschrieben
	 sein. Zum Beispiel:
	 @{i}FF0:@{ui}

@{u}Für Besserwisser:@{uu}
	Es existiert in großer Unterschied zwischen @{i}-r -axe@{ui}
	und @{i}-raxe@{ui}.


@ENDNODE
@%end
@%start "benutzung"
@NODE  benutzung "Archiver.bat/Benutzung"

Wenn man alles richtig gemacht hat und alle Befehle hat, die die Batch-Datei
braucht und man sie beim @{"ToolManager" link toolman} in einem Dock oder als
icon benutzt, dann braucht man nur entweder zum Packen eine Datei oder ein
Verzeichnis darauf [Icon oder Dock] ablegen. Dann erscheint ein Filerequester,
in welchem man das Ziel-Archiv aussuchen kann. Zum Entpacken das Archiv darauf
[Icon oder Dock (von Toolmanager)] ablegen. Es erscheint der Ziel-Requester,
wohin das Ganze entpackt werden soll. DMS-Dateien nicht anders.

Wenn kein Argument angegeben wird (TM: einfach draufklicken), erscheint ein
Requester mit ein paar Informationen.

Bei Benutzung über Workbench mit IconX gibt es Probleme.


@ENDNODE
@%end

@%start "toolman"
@NODE  toolman "Archiver.bat/Toolmanager"

   Toolmanager ist

   Copyright (C) 1990-1997 Stefan Becker

   Der Autor kann unter den folgenden Adressen erreicht werden:

Postadresse:

		  Stefan Becker
		  Bonner Ring 68
	  D-50374 Erfstadt
		  GERMANY

Electronic Mail:

	  stefanb@yello.ping.de

   Es existiert auch eine ToolManager Homepage im World Wide Web:

     http://www.ping.de/sites/yello/toolmanager.html


@ENDNODE
@%end
@%start "dms"
@NODE  dms "Archiver.bat/DMS"

The DISK-Masher:  Command Line Version 1.11 TURBO GENERIC
Copyright © 1989-91 SDS Software. All Rights Reserved.


@ENDNODE
@%end
