======================================================================
Dokumentation zu "DiskToHard" Version 1.1
Autoren: Norbert Klapczynski, Kochelseestr. 9, D8900 Augsburg
         Nicolas Benezan, Postwiesenstr. 2, D7000 Stuttgart 60
======================================================================

Kopierrecht
­­­­­­­­­­­
Das komplette Packet (Quelltext, Dokumentation und Objectcode) ist
Public Domain Software. Es darf beliebig kopiert und verbreitet werden
solange...

* unsere Namen und dieser Kopierrechtshinweis erhalten bleiben,
* die Vollständigkeit des ganzen Packets gewährleistet ist, und
* mit dem Vertrieb dieser Software kein Gewinn erwirtschaftet wird.

Die Kommerzielle Nutzung ohne meine ausdrückliche schriftliche
Genehmigung ist untersagt (über Gewinnbeteiligung läßt sich reden).
W i c h t i g: Dies gilt insbesondere auch für "schwarze Schafe" der "PD"-
Versandhäuser, die ganz offensichtlich Gewinn machen, was z.B. durch
ganzseitige Anzeigen in Zeitschiften erkennbar ist.

Verbesserungsvorschläge sind stets willkommen. Falls Sie Veränderungen
am Programm vornehmen, dokumentieren Sie diese bitte gut verständlich.
Es würde mich freuen, wenn Sie mich über größere Veränderungen in
Kenntnis setzen würden.

(c) 1988 Norbert Klapczynski, Nicolas Benezan.


Übersicht
­­­­­­­­­
* Umfang des Packets
* Einleitung
* Beschreibung der Prozeduren

Umfang des Packet
­­­­­­­­­­­­­­­­­
Das komplette Packet "DiskToHard" beinhaltet folgendes:

* DiskToHard.dok        Diese Dokumentation
* DiskToHard.mod        Quelltext des Kopierprogramms Disk -> HardDisk
* HardToDisk.mod        Quelltext des Kopierprogramms HardDisk -> Disk
* DiskToHard            Ausführbares Programm
* HardToDisk            Ausführbares Programm
* Disks (dir)           Subdirectory, wichtig zur Installation
* Disk.info             Default-Icon, wichtig zur Installation

(Stand 1.Dez.1989)


Einleitung
­­­­­­­­­­
Nein, die Diskette ist nicht zu hart! Dafür ist ein "o" zu wenig. Dies ist
vielmehr eine Lösungsmöglichkeit für das folgende Problem:
Angenommen Sie besitzen einen Amiga mit 1MB und eine Festplatte, auf der
noch einige MB frei sind, aber kein zweites Laufwerk. Wenn Sie jetzt von
Disketten jeweils mehrere Kopien anfertigen wollen, wäre es vorteilhaft,
wenn eine Diskette ganz in den Speicher geladen und dann mehrmals auf Disks
geschrieben werden könnte. Leider ist das mit Workbench und einigen
Background-Utilies im Speicher bei 1MB nicht möglich (oder fast nicht! -
siehe unten *). Man ist also gezwungen, Diskjockey zu spielen oder sich
eine spezielle Bootdisk zu basteln, die mit jedem kB geizt.

Aber es gibt einen Ausweg: warum nicht den freien Platz auf der Harddisk
nutzen? Genau das macht DiskToHard. Der Inhalt einer ganzen Diskette wird
in einem zusammenhängenden File auf der Harddisk abgelegt. Von dort aus
kann er wieder beliebig oft auf Disketten kopiert werden.

Installation
­­­­­­­­­­­­
Leider sind zur korrekten Funktion von DiskToHard einige Vorbereitungen zu
treffen:

* erstellen Sie ein Directory auf Ihrer Harddisk
* kopieren Sie die Files "DiskToHard", "HardToDisk", "Disk.info" und das
  Subdirectory "Disks" in dieses Verzeichnis.

Sie können aber auch wie folgt vorgehen:

* kopieren Sie das ganze Verzeichnis "DiskToHard" von der Amok-Disk samt
  Inhalt auf Ihre Harddisk.
* Wenn Sie den Quellcode nicht benötigen, können Sie "DiskToHard.mod" und
  "HardToDisk.mod" löschen.

Bedienung
­­­­­­­­­
* legen Sie die Quelldiskette in das interne Laufwerk
* starten Sie das Programm "DiskToHard"

Wenn Sie sich jetzt das Subdirectory "Disks" anschauen, werden Sie darin
eine Datei bemerken, die denselben Namen und dasselbe Icon hat, wie Ihre
Quelldiskette.
Wenn Sie genügend Platz auf der Harddisk haben, können Sie diesen Vorgang
beliebig wiederholen und sich eine regelrechte "Diskettensammlung" auf der
Festplatte anlegen.
Zum kopieren auf Diskette:

* legen Sie eine Leerdiskette in das interne Laufwerk
* aktivieren Sie eine "Diskettendatei" im "Disks"-Directory auf der
  Festplatte durch Doppelklicken. Dadurch wird automatisch das Programm
  "HardToDisk" gestartet, das die Datei auf die Diskette schreibt.

Vorsicht! Vergewissern Sie sich, daß sich keine wertvollen Daten auf der
eingelegten Disk befinden! Sie werden sonst ohne Warnung überschrieben!


Verbesserungsmöglichkeiten
­­­­­­­­­­­­­­­­­­­­­­­­­­
DiskToHard ist ein praxisbezogenes Programm, das knapp und sachlich ohne
viel Schnickschnack geschrieben wurde. So besitzt es keinerlei
Bedienungsoberfläche und benutzt immer das interne Laufwerk. Sicher ließen
sich noch einige Dinge verbessern:
- bessere Behandlung von Screib/Lesefehlern
- Warnung vor Überschreiben einer Diskette
- Angabe des Laufwerks möglich
- bessere Prozessorausnutzung durch asynchronen I/O
- nur belegte Blöcke speichern
- packen der Daten
Dies liegt daran, daß das Programm ursprünglich aus der in der Einleitung
beschriebenen Notlage heraus entstand. Es leistete bei mir [bne] lange Zeit
gute Dienste (auch beim Kopieren der Amok-Disks), ich habe es jedoch nicht
mehr weiterentwickelt, da ich jetzt 5MB Speicher habe.
Es spricht jedoch nichts dagegen, daß jemand das Programm noch erweitert.
Da es relativ kurz und übersichtlich ist, dürfte dies keine Schwierigkeiten
machen.


* Anmerkung:
Zu dem in der Einleitung beschriebenen Problem gibt es doch eine andere
Lösung: Ein "geniales" Produkt von Data-Becker packt die Daten im Speicher
und kann deshalb auch bei <880k freiem Speicher eine Diskette ganz laden.
Leider ist, der Pack/Entpack-Algorithmus wohl verwanzt (wen wundert das bei
einem Data-Becker Produkt?), denn er baut in eine vorher einwandfreie
Diskette immer genau einen Fehler (immer an der selben Stelle) ein. Auch
läßt sich das Programm nicht ohne Reset verlassen (typisches Assembler-
Programm), was alle Genialität wieder zunichte macht.