			Mai 23rd, MCMXCII
			     ESHA #5

       __________________________________________________________
      /                                                         /
     /              DIA V1.3  -   by Stefan Hirth              /
    /                                                         /
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


F A L L S  S I E  S C H O N  E I N E  F R Ü H E R E  V E R S I O N  V O N
D I A  K E N N E N ,  L E S E N  S I E  B I T T E  N I C H T  D I E  K O M -
P L E T T E  A N L E I T U N G ,  S O N D E R N  D I E  D A T E I  " U P -
D A T E " , I N  D E R  A L L E  I N F O R M A T I O N E N  F Ü R  D I A -
U S E R  S I N D .


+++++++++++++++++++++++++++++++++++++++++++++++++++++++
Copyright-Hinweise siehe Gadget "Prg.-Info" im Programm
+++++++++++++++++++++++++++++++++++++++++++++++++++++++


                        *****************
                        **             **
                        **  Anleitung  **
                        **             **
                        *****************

---------------------------------------------------------------
 ! ! ! ! ! ! ! ! ! !      Weltneuheit      ! ! ! ! ! ! ! ! ! !
---------------------------------------------------------------
- Ein Programm zum Archivieren Ihrer Diasammlung,viele Editier-
  Möglichkeiten Diakastenfach-orientiert.
- Workbench-2.0-Look
- Einfach zu bedienen / Deutsch
- Mehr Funktionen als Gadgets durch Mehrfachbelegung
- viele Druckoptionen
- Standard - ASCII-Dateien
- parallele Diakastenbearbeitung
- Suchfunktion
- CLI-Aufruf
- tolle Requester
- superschnelles GFA-Basic-Kompilat
---------------------------------------------------------------
 ! ! ! ! ! ! ! ! ! !      Weltneuheit      ! ! ! ! ! ! ! ! ! !
---------------------------------------------------------------

Zum Start:

Das Programm benötigt keine Dateien, Libraries oder ähnliches. Mit den folgen-
den Dateien erreichen Sie aber eine Steigerung des Komforts. Falls das Pro-
gramm sie nicht vorfindet, wird eine Standardversion verwendet
- *** C:RUN ***
  Das RUN-Kommando ( normalerweise im "C"-Verzeichnis der WB-Disk )
  ermöglicht Ihnen, den Editor aus DIA aufzurufen und nebenher in DIA
  weiterzuarbeiten. Falls RUN fehlt, wartet DIA, bis der Editor beendet ist.
- *** DEVS:DIA.PREFS ***
  In dieser Datei sind Ihre individuellen Voreinstellungen gespeichert.
  Falls sie nicht vorhanden ist, werden Standardwerte verwendet.
- *** RAM: *** bzw. *** CLIPS: ***
  Um die Blockoperationen nutzen zu können, benötigt DIA als Zwischenspeicher
  ein Verzeichnis; normalerweise ist das das Gerät "CLIPS:". Bei der Standard-
  Workbench finden Sie in "S:Startup II" die Zeilen
   MAKEDIR ram:ClipBoards und
   ASSIGN CLIPS: ram:ClipBoards
  Falls Sie sich eine Sparversion gemacht haben, sollten Sie sich diese beiden
  Zeilen hinzufügen. Falls DIA das Gerät CLIPS: nicht vorfindet, benutzt es
  "RAM:" als Zwischenspeicher. Sie brauchen also in beiden Fällen die Datei
  "ram-handler" im "L:"-Verzeichnis.
  Diese beiden Wege haben den Vorteil, daß die Blockoperationen relativ zügig
  von statten gehen. Falls Sie jedoch das Ausgefallene lieben, können Sie auch
  eine normale Diskette als Zwischenspeicher benutzen. Legen Sie z.B. Ihre WB
  in DF0: und schreiben dann in die Shell:
   ASSIGN CLIPS: DF0:
  so werden die temporären Dateien auf Disk gespeichert.
  Falls Sie weder CLIPS: noch RAM: assigned haben, werden Sie das Block-Menü
  nicht öffnen können.
- *** LIBS:REQ.LIBRARY ***
  Mit Hilfe dieser Library gibt es tolle Requester: Der Filerequester ist
  einer der besten überhaupt, der Stringeingaberequester sorgt für komfortab-
  le Texteingabe und der Colorrequester dient zur Einstellung Ihrer persön-
  lichen Bildschirmfarben.
  Die req.library kann mit dem Hilfsprogramm "ReqMaker" im Verzeichnis "Req"
  erzeugt werden. Bitte lesen Sie hierzu auch den Info-text "Req Info" in die-
  sem Verzeichnis.
  Falls nicht vorhanden, werden der Standardfilerequester von GFA, und ein
  normales Eingabefenster für die Strings verwendet. Farben können dann nicht
  verändert werden.
Diese Anleitung ist übrigens ins Programm integriert und sollte von dort aus
auch gedruckt werden können.

---------------------------------------------------------------

                       Inhalt:

        I. Diadatei             II. Edit
        - Laden                 - Editieren
        - Schreiben             - Einfügen
        - Drucken               - Nummer
        - Ende                  - Löschen
                                - Block-Menü

        III. Preferences        IV. Aktueller Diakasten
        - Editieren             - Anzeige
        - Laden                 - Benutzung
        - Speichern
        - Reset

        V. Aktuelles Dia        VI. Suchfunktion
        - Anzeige               - Suchen
                                - Case
                                - InStr

	VII. Sonstiges	        VIII. About Dia
	- parallel-Option       - Anleitung
	- Sicherheitsabfragen   - Prg.-Info
	- CLI-Aufruf
        - Shortcuts

---------------------------------------------------------------

I. Diadatei

- Laden

  mit LMB:

  Lädt eine Standard-ASCII-Datei:
  Die Datei wird zeilenweise gelesen und in den Diaspeicher geschrieben,
  d.h. Sie können Ihre Dias mit Ihrem Lieblings-Editor eintippen und dann
  mit DIA nachbearbeiten.
 
  Seit Version 1.2 haben Sie zum Laden und Speichern einen herrlichen File-
  requester, falls Sie die "req.library" im "LIBS:"-Verzeichnis haben.

  mit RMB:

  Ruft Ihren Lieblings-Editor ( siehe Prefs ) auf und übergibt ihm den Na-
  men der Dia-Datei, so daß sie Ihre ASCII-Datei aus dem Programm heraus nach-
  träglich verändern können. Der Editor läuft parallel zu "DIA", so daß Sie
  hin- und herspringen können.

- Schreiben

  Speichert die aktuelle Dia-Liste auf Diskette.
  Dabei werden die Dias jeweils durch einen Return-Code (10) getrennt, so daß
  Sie, wenn Sie mit Ihrem Editor die Datei laden, ein Dia pro Zeile sehen.

- Drucken

  Mit LMB:

  Je nach Druck-Preferences entweder Einzeldruck, bei dem ein Requester mit
  folgenden Feldern erscheint:
  - ändern
  Wenn Sie hier klicken, wird der Fachbuchstabe erhöht. Überschreitet er die
  Anzahl der Fächer, wird er wieder "A".
  - OK
  Wenn Sie das Fach haben, das Sie drucken wollen, drücken Sie dieses Gadget,
  und der Druck beginnt.
  - Abbruch
  Wenn Sie genug gedruckt haben, klicken Sie hier, dann kommen Sie wieder ins
  Programm zurück.
  oder Kastendruck:
  Es wird nach einer Sicherheitsabfrage der komplette Kasten gedruckt.

  Mit RMB:

  Druck-Menü:
  - Endvorschub
  an bedeutet, am Ende des Druckvorgangs wird ein FormFeed ausgegeben.
  - Spaltenzahl
  in soviel Spalten werden die Fächer unterteilt. Je mehr Spalten, desto we-
  niger Papier brauchen Sie, das Programm schneidet jedoch die Dias so ab,
  daß auch alles in die Zeile passt, d.h. schon bei drei Spalten wird erheb-
  lich gekürzt.
  - Zeilenzahl
  Nach dem Druck eines Fachs überprüft das Programm, ob noch ein weiteres auf
  die Seite passen würde. Andernfalls
  - Seitenvorschub
  wird ein FormFeed ausgegeben, sofern dieser Schalter "an" ist.
  - Ganzer Kasten
  wählt die beiden Druckarten ( siehe Druck,LMB )

  Anmerkung: Die Druck-Preferences werden zusammen mit den anderen Preferen-
	     ces abgespeichert.

- Ende

  Mit LMB:

  siehe Sicherheitsabfragen

  Mit RMB:

  Schließt den Screen von Dia und öffnet auf der WB ein kleines Fenster,
  durch das Sie zu DIA zurückkehren können. Währenddessen benötigt das Pro-
  gramm kaum Speicher und Rechenzeit.

---------------------------------------------------------------

II. Edit

- Editieren

  Auch hier kommt die "req.library" zum Einsatz: Der String-Eingabe-Requester
  kommt deutlich besser rüber, wenn sie im "LIBS:"-Verzeichnis ist.

  mit LMB:

  Zum Editieren des selektierten Dias im aktuellen Diakasten.


  mit RMB:

  Editiert die Textzeile im "Aktuelles Dia"-Feld.


- Einfügen

  Fügt den Text an der gewählten Position im aktuellen Diakasten ein, schiebt
  dafür alle Dias des Fachs um eins nach hinten und schreibt die Daten des
  letzten Dias im aktuellen Fach in den "Aktuelles Dia"-Feld.

- Nummer

  mit LMB:

  Sie können zuerst die Fach-, dann die Dianummer im "Aktuelles Dia"-Feld
  verändern. Wenn Sie mit dem Wert zufrieden sind, drücken Sie "RETURN". Wenn
  Sie aus Versehen einen Wert eingeben, der von den Preferences her nicht zu-
  lässig ist, bleibt der alte.

  mit RMB:

  Springt die Fach- und Dianummer des "Aktuelles Dia"-Felds an und markiert
  diese im aktuellen Diakasten.

- Löschen

  Mit LMB:

  löscht das markierte Dia im aktuellen Diakasten und zieht dafür alle Dias
  des aktuellen Fachs um eins nach hinten. Falls Sie das Dia vor dem Löschen
  retten wollen, benutzen Sie die Kopierfunktion im aktuellen Diakasten.

  Mit RMB:

  löscht den gesamten Kasten

- Block-Menü

  Die wichtigste Neuerung der Version 1.3: Sie können jetzt nicht nur, wie
  bisher, einzelne Dias kopieren, verschieben, löschen und verändern, sondern
  ganze Blöcke markieren, abspeichern etc.

  Block markieren:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Im "Aktueller Diakasten"-Feld sehen Sie ganz rechts von oben nach unten ei-
  nen schmalen Streifen. Wenn Sie in diesen mit der linken Maustaste hinein-
  klicken, markieren Sie den Anfang des Blocks, mit der rechten dagegen das
  Ende.
  Nach der Markierung eines Blocks steht Ihnen das Block-Menü offen:

  Block kopieren:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Der markierte Block wird in den Zwischenspeicher kopiert. Von dort aus kann
  er wieder eingesetzt werden.

  Block schneiden:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Wie kopieren, jedoch wird zusätzlich das Original herausgeschnitten.

  Block löschen:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Wie kopieren, jedoch wird das Original gelöscht und der Abstand beibehalten

  Save Block:
  ¯¯¯¯¯¯¯¯¯¯¯
  Sie wählen eine Datei aus, in die der Block gespeichert wird.
  Diese Datei kann dann wieder geladen werden ( mit "Diadatei/Laden" ).

  Block überschreiben:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Der Block im Speicher wird an die aktuelle Block-Start-Position gesetzt.
  Die nachfolgenden Daten werden überschrieben.

  Block einsetzen:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Wie Überschreiben, nur werden die anderen Dias nach hinten gerückt und die
  hinten herausfallenden wieder in den Zwischenspeicher geschrieben.

  Springe an Anfang/Ende:
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  Der Anfang / das Ende des Blocks werden angesprungen.

---------------------------------------------------------------

III. Preferences

- Editieren

  Mit LMB:

  Öffnet ein neues Fenster, in dem 4 verschiedene Werte eingestellt werden
  können:
  - Fächer pro Kasten
  Hier kann man die Anzahl der Fächer pro Diakasten eingeben. Voreingestellt
  ist 6.
  - Dias pro Fach
  Stellt die Anzahl der Dias pro Fach ein. Voreingestellt ist 36
  - Editor
  Hier können Sie Ihren Lieblings-Editor ( mit Pfad ) eingeben, der dann auf-
  gerufen wird, wenn Sie "Editieren" aus dem Edit-Menü anklicken.
  - Standard-Dir
  Dieses Verzeichnis wird beim Laden/Speichern aufgelistet. Wenn Sie hier ein
  anderes eingeben, prüft das Programm, ob dieses Verzeichnis im Moment exi-
  stiert. Wenn nicht, kommt eine Warnung. Beispiele für gültige Verzeichnis-
  namen: "DF0:","C:","RAM:","DIA:",":Diafiles/".
  Voreingestellt ist "DIA:".

  Mit RMB:

  Mit "req.library" kommt nun ein Color-Requester, in dem Sie die Farben ein-
  stellen können, die selbstverständlich auch gespeichert und geladen werden.

- Laden

  ( wird beim Start des Programms automatisch ausgeführt )
  Lädt das File "DEVS:dia.prefs". Falls dieses nicht existiert, werden die
  Standard-Einstellungen geladen.

- Sichern

  Schreibt die aktuellen Voreinstellungen in die Datei "DEVS:dia.prefs".

- Reset

  Lädt die Standard-Voreinstellungen

---------------------------------------------------------------

IV. Aktueller Diakasten

- Anzeige

  In diesem Feld gibt es drei Spalten, in der ersten steht die Dianummer, in
  der zweiten der Fachbuchstabe, in der dritten Spalte der Name des Dias.
  In dem Feld darunter steht der Name des aktuellen Diakastens.

- Benutzung

  - Anwählen eines Dias
  Klicken Sie ein Dia mit der linken Maustaste ( LMB ) an, und es wird inver-
  tiert dargestellt. Auf dieses Dia wirken nun die Aktionen Löschen und Ein-
  fügen aus dem "Edit"-Menü ( siehe oben ).

  - Kopierfunktion
  Klicken Sie das Dia dagegen mit RMB an, geschieht dasselbe wie oben, außer-
  dem werden die Daten dieses Dias in das "Aktuelles Dia"-Feld kopiert ( sie-
  he oben ).

  - Pfeilgadgets
  In dem Feld darunter gibt es noch zwei Pfeilgadgets, die den sichtbaren Dia-
  bereich mit LMB um einen Ausschnitt, mit RMB dagegen ganz nach oben/unten
  bewegen.

---------------------------------------------------------------

V. Aktuelles Dia

- Anzeige

  Dieses Feld enthält drei Textzeilen. Die beiden oberen ( Fach / Num. ) sind
  nur für das RMB-Anklicken des Nummern-Gadgets ( siehe oben ) wichtig. Die
  Textzeile dagegen wird bei vielen Funktionen verwendet.

---------------------------------------------------------------

VI. Suchfunktion

- Suchen

  mit LMB:

  Startet den Suchvorgang
  Wenn der String gefunden wurde, wird er im aktuellen Diakasten angesprungen
  und markiert.

  mit RMB:

  Suchstring eingeben

- Case

  Bei eingeschaltetem Case findet das Programm nur Strings, die mit dem Such-
  string in Groß- und Kleinschreibung übereinstimmen

- InStr

  Bei eingeschaltetem InStr prüft das Programm auch, ob der Suchstring in ei-
  nem Dia-String enthalten ist

  Case und InStr werden mit LMB ein- und mit RMB ausgeschaltet.

---------------------------------------------------------------

VII. Sonstiges

- parallel-Option
  Wenn Sie im Kasten rechts unten das Gadget "@" anklicken, werden alle Daten
  des aktuellen Diakastens in einen Zusatzspeicher geschrieben. Statt dessen
  werden alle Daten aus dem Zusatzspeicher in den normalen Speicher kopiert.
  Sie können so zwei Diakästen parallel bearbeiten und  Dias auch zwischen
  mehreren Kästen hin- und herschieben.

- Sicherheitsabfragen
  Sie sehen oben rechts in der Ecke ( unter dem Screen-To-Front-Gadget ) eine
  kleine Anzeige - entweder "(-)" oder "(+)". Ein "(+)" zeigt an, daß der Kas-
  ten seit dem letzten Speichern verändert wurde. Wenn Sie in diesem Zustand
  die Funktionen "Laden","Löschen - RMB" oder "Ende" wählen, kommt eine Si-
  cherheitsabfrage.

- CLI-Aufruf
  Wenn Sie Dia aus dem CLI aufrufen, können Sie gleichzeitig ein File laden.
  Dazu geben Sie ein: "DIA [filename]". Dasselbe erreichen Sie auf der Work-
  bench, wenn Sie die Daten-Datei einmal anklicken, dann bei gedrückter Shift-
  Taste das "DIA"-Icon wählen. Im CLI gibt es noch die Möglichkeit "DIA [?]".
  Das zeigt eine kleine Info. Sie können natürlich auch einfach nur "DIA" ein-
  geben, das startet das Programm ganz normal. Besser ist "RUN DIA", weil Sie
  dann, während Dia läuft, im CLI arbeiten können.


- Shortcuts
  Sie können alle Gadgets auch mit der Tastatur anwählen. Die Kombinationen
  werden hier nicht aufgeführt, denn sie sind im Programm integriert. Klicken
  Sie hierzu "Anleitung" mit RMB an.

---------------------------------------------------------------

VIII. About Dia

- Anleitung

  Mit LMB:

  Gibt diese Anleitung auf dem Bildschirm oder auf dem Drucker aus.

  Mit RMB:

  siehe Shortcuts

- Prg.-Info

  LMB: Zeigt eine Kurzinfo über dieses Programm
  RMB: Zeigt den freien Speicher, den Dateinamen und das Dateiformat

####################################

- Über dieses Programm:

  Programmiersprache: GFA-Basic V3.5 Amiga
  Compiler:           GFA-Basic Compiler 3.52
  Programmautor:      Stefan Hirth
  Fertigstellung:     Mai/Juni 1992
  Version:	      1.3

- Sonstiges:

  Holt euch: FRANZ-PD #168 - World Trade Center II - DIE Handelssimulation

  Schreibt mir mal!
  Adresse:

  Stefan Hirth
  Akazienweg 10
  D-7120 Bietigheim

---------------------------------------------------------------
