@DATABASE DArc
->fs "main"
@Node MAIN
                        DArc V1.5   Release vom 5.11.95
                  DArc  1995 by Frank Weber & Holger Kasten

   @{" Unbedingt lesen      " link wichtig}  Copyright, Disclaimer etc.

   @{" Was ist DArc         " link was}  Was Sie mit DArc alles machen knnen
   @{" Features             " link features}  Was kann DArc ???
   @{" Neue Funktionen      " link neu}  Was in dieser Version neu ist

   @{" Installation         " link install}  So installieren Sie DArc richtig
   @{" Tooltypes            " link tt}  Tooltypes, die Sie DArc bergeben knnen

   @{" Hauptfenster         " link gui}  Beschreibung des Hauptfensters von DArc
   @{" Scannen              " link scan}  Der 'Scannen'-Teil des Hauptfensters
   @{" Multiscan            " link multiscan}  Erklrung der Multiscan-Funktion
   @{" Suchen               " link find}  Der 'Suchen'-Teil des Hauptfensters
   @{" Suchmuster           " link patterns}  Verwendung von AmigaDOS Suchmustern
   @{" Optionen             " link options}  Das Options-Fenster

   @{" Ansehen              " link watch}  Ansehen von gefundenen Dateien
   @{" Button-Konfiguration " link config}  Konfiguration der frei belegbaren User-Knpfe
   @{" Befehlssyntax        " link syntax}  Befehle, mit denen Sie diese Knpfe belegen knnen
   @{" Dateierkennung       " link filetypes}  DArc kann Dateien erkennen...

   @{" Registration         " link regi}  Wie Sie sich registrieren lassen knnen
   @{" Credits              " link credits}  Diese Leute waren an der Entwicklung beteiligt
   @{" Fehler               " link fehler}  Falls Sie Fehler in DArc finden...
   @{" History              " link history}  berblick ber alle Versionen
   @{" Zukunftsplne        " link future}  Was sich an DArc noch ndern soll

    Wir freuen uns immer ber Verbesserungsvorschlge oder sonstige Post,
                     auch von nichtregistrierten Usern.

    Falls Sie sich aus einem bestimmten Grund nicht registrieren lassen,
      und dieser von uns behoben werden knnte, schreiben Sie uns !!!
@endnode
->fe
->fs "wichtig"
@node wichtig "Sehr Wichtig"
1. Dieses Programm ist Shareware. Alle Rechte an diesem Programm bzw. der
   Anleitung liegen bei den Programmiererern:

    Frank Weber              Holger Kasten
    Schlizstr. 53            Jgerhausstr. 72
    74076 Heilbronn          74074 Heilbronn
    Germany                  Germany

   Wenn Sie es hufiger benutzen und Sie die Vollversion haben mchten,
   knnen Sie sich bei uns @{" registrieren " link regi} lassen.

2. Wir bernehmen keinerlei Haftung fr irgendwelche Schden, die in
   unmittelbarem oder mittelbarem Zusammenhang mit der Benutzung dieses
   Programmes entsetehen. Das gesamte Nutzungsrisiko liegt beim Anwender.
   Wir knnen weiterhin keine Garantie fr die vollstndige Richtigkeit dieser
   Anleitung bernehmen.

3. Verndern Sie weder das Programm selbst noch irgendwelche anderen zu
   DArc gehrenden Dateien auf irgendeine Weise, da das Programm sonst
   unbrauchbar werden kann oder evtl. sogar Schden an Ihrem System
   verursachen kann.

4. Dieses Programm darf nur mit allen dazugehrigen Datein weitergegeben
   werden.

5. Dieses Programm darf in jede PD-Serie aufgenommen/in jedes Netz
   eingespeist werden, solange daraus kein kommerzieller Nutzen gezogen
   wird. Die PD-Disketten drfen nicht mehr als 5 DM kosten.
   (Wir wrden uns ber eine kleine Benachrichtigung freuen !!!)

   Wenn Sie DArc mit der Coverdisk eines Magazins vertreiben wollen, dann
   schicken uns beiden bitte diese Ausgabe mit der Coverdisk.

6. Die Demoversion darf nicht nur frei weitergegeben werden, sondern soll
   es sogar, um das Programm zu verbreiten. Wenn Sie die Vollversion
   besitzen, darf diese UNTER KEINEN UMSTNDEN weitergegeben werden. Wer
   das trotzdem tut macht sich strafbar, wie wenn er ein kommerzielles
   Programm weitergibt.

7. Fr die Weitergabe der Demo-Version darf nicht mehr verlangt werden, als
   die Unkosten, die einem selbst dabei entstehen (hchstens 5 DM).

   Mit dem Starten oder Verbreiten des Programms erklren Sie sich mit
   diesen Nutzungsbedingungen einverstanden.
@endnode
->fe
->fs "was"
@node was "Was ist DArc"
DArc (="DiskARChiver") ist ein FileFinder. Wenn Sie also einmal nicht
genau wissen, wo Sie jetzt diese oder jene Datei "verloren" haben, brauchen
Sie DArc. DArc kann aber noch viel mehr, es knnen CDs oder ganze PD-Serien
archiviert werden.

Mit DArc ist es mglich, entweder ein Verzeichnis bzw. ein Device direkt
nach einer oder mehreren Dateien zu durchsuchen oder den Inhalt von
Diskette/Festplatten oder gar CD-ROMs in Dateien zu schreiben und dann
diese Dateien nach best. Dateinamen(-mustern) durchsuchen.

Vorteile der direkten Suche:

- Aktualitt


Vorteile der Suche aus einer Datei:

- ca. 5 mal schneller als direkte Suche

- bei manchen Datentrgern ndert sich der Inhalt nie oder fast nie
  (z.B. PD-Disketten oder CD-ROMs)

- mehrere Devices knnen in einer Datei stehen, so werden beim Finden
  gleichzeitig die (passenden) Dateien von mehreren Devices angezeigt.

  So knnen ganze PD-Sammlungen in eine Datei geschrieben werden,
  anschlieend wird die eine Datei (die ja den Inhalt von allen Disketten
  enthlt) nach best. Namen/Mustern durchsucht.

Nach dem Suchen werden alle gefundenen Dateien angezeigt. Hier zeigt sich
eine groe Strke von DArc, da mit den gefunden Dateien gleich 'Aktionen'
durchgefhrt werden knnen. Hierzu gibt es 12 frei konfigurierbare Gagdgets,
ber die eine gefundene Datei ber DArc z.B. ins RAM: kopiert,
gelscht, ein Archiv entpackt oder eine Textdatei angezeigt werden kann.
(Diese Knpfe sind wie gesagt frei konfigurierbar und knnen mit jedem
beliebigen Programm belegt werden)
@endnode
->fe
->fs Features
@node Features
DArc ist ein leistungsfhiger und vor allem ein sehr schneller (der
schnellste ?) Filefinder. Wenn Sie also einmal nicht mehr wissen, wo Sie
jetzt diese oder jene Datei "verloren" haben, brauchen Sie DArc.

Features:

- 2 Anwendungsmglichkeiten:

    1. Direkte Suche in einem Verzeichnis oder auf einem Device.
       (Schon ziemlich schnell...)

    2. Scannen des Inhalts von Disketten/Festplatten
       oder ganzen CD-ROMs in eine Datei, die spter durchsucht wird.
       (=> Noch viel schneller als direkte Suche.)

- Multiscan-Funktion: Eingelegte Disketten werden sofort gescannt.
  (=> In Vebindung mit Dateiscan ideal fr PD-Sammlungen.)

- Es kann nach mehreren Dateien gleichzeitig gesucht werden. Dabei
  knnen auch Suchmuster mit Platzhaltern eingegeben werden.
  (=> Zeitersparnis: 1x3 Dateien suchen schneller als 3x1 Datei)
- Neben Dateien kann auch nach Verzeichnissen gesucht werden.

- Beim Anschauen der gefundenen Dateien/Verz. zeigt sich eine weitere
  Strke von DArc: Mit den gefundenen Dateien knnen ber FREI
  konfigurierbare Knpfe sofort aus DArc heraus Aktionen
  durchgefhrt werden.

  Die Dateien knnen z.B. ins RAM kopiert, entpackt (=> Aminet-CD),
  gelscht oder bei einer Textdatei angezeigt  werden. Dabei kann
  ein Knopf mit jedem beliebigen AmigaDOS-Programm belegt werden.

  Auerdem stehen einige interne Befehle zur Verfgung, z.B
  ein Informationsrequester mit Infos ber die Datei.

DArc ist also das ideale Tool fr alle Besitzer von Festplatten oder
PD-Sammlungen und fr CD-ROM Benutzer.
@endnode
->fe
->fs neu
@node neu "Was in diese Version neu ist"
Dieses Kapitel ist nur fr Umsteiger von einer lteren Version. Wenn Sie
noch keine ltere Version benutzt haben, knnen Sie es getrost berspringen.

Falls der KEYFILE Tooltype nicht gesetzt ist, wird angenommen, da das
Keyfile 'S:DArc.key' heit.

Folgendes hat sich gendert:

Sie knnen die Knpfe, mit denen Sie im Hauptfenster direkt das Scannen
eines Laufwerkes starten knnen und die Laufwerke, die fr den Multiscan
verwendet werden, jetzt ber @{" Tooltypes " link tt} konfigurieren.

Der Konverter hat jetzt ein eigenes Fenster.

Wenn Sie jetzt irgendwo die Help-Taste drcken, erscheint die Anleitung.
Voraussetzung ist allerdings, da der @{" Tooltype DOC " link tt} richtig gesetzt ist.


Wenn Sie gefundene Dateien ansehen, knnen Sie jetzt auch mehrere Eintrge
selektieren. Dazu gibt es ein paar neue Gadgets:

Multiselect: RMB: Eintrge mit rechter Maustaste anwhlen, damit Multiselect
                  erfolgt
              an: Multiselect erfolgt grundstzlich
             aus: kein Multiselect mglich

  Alle: Selektiert alle Eintrge
 Keine: Deselektiert alle Eintrge
Invers: Alle nicht selektierten Eintrge werden selektiert,
        alle selektierten deselektiert.

Dateierkennung:

Mit Hilfe der Datei `DARC-FileTypes` kann DArc nun erkennen ob es sich bei einer
Datei um eine Animation, um ein Programm, um ein Bild etc. handelt. Es knnen
dann Dateispeziefische Operationen ausgefhrt werden.
@endnode
->fe
->fs install
@node install "Installation"
Um DArc zu bentzen, bentigen Sie mindestens OS 2.0 und 1 MB RAM.
DArc wird mit dem Installer von Commodore (ESCOM ?!?!?) installiert.

Falls Sie DArc starten, das Programm geladen wird, sich aber sonst nichts
tut, liegt dies mit groer Wahrscheinlichkeit daran, da die
reqtools.library ( by Nico Franois) nicht installiert ist.

Beim Programmstart sucht DArc nach den Dateien 'S:DArc-Options' (Options-
Datei), 'S:DArc.config' (Buttonconfig-Datei) 'DArc-FileType' (fr die
Dateierkennung)

Wenn Sie registrierter Benutzer sind, erhalten Sie ein Keyfile, das sich
im S:-Verzeichnis befinden mu.

Wir wrden uns freuen, wenn jemand den Catalog in andere Sprachen
bersetzen knnte. (vor allem Franzsisch)
Falls Sie sich wundern, warum es einen englischen Catalog gibt: Er ist
nur dafr da, um das bersetzen in andere Sprachen zu erleichtern.
@endnode
->fe
->fs tt
@node tt "Wie Sie DArc ber Tooltypes konfigurieren knnen"
Folgende Tooltypes knnen Sie im DArc-Icon angeben:

BUTTON1, BUTTON2, BUTTON3, ... BUTTON11

  Laufwerke fr die Direktanwahlknpfe des Scandirectories

  Bsp: BUTTON1=df0:


MULTIDRIVE1, MULTIDRIVE2, MULTIDRIVE3, MULTIDRIVE4

  Laufwerke fr den Multiscan.

  Bsp: MULTIDRIVE3=pc0:

KEYFILE=

  Wo sich das Keyfile befindet (Bsp: KEYFILE=S:DArc.key)

DOC=

  Wo sich die Anleitung befindet (Bsp: DOC=Anleitung.guide)
@endnode
->fe
->fs gui
@node gui "DArc's Bedienungs-Oberflche"
Das Hauptfenster ist in 2 Teile aufgeteilt:

Auf der linken Seite befinden sich alle Gadgets die sich auf das @{"Scannen" link scan}
beziehen.

Auf der rechten Seite befinden sich alle Gadgets die sich auf das @{"Suchen" link find}
beziehen.

Rechts unten befinden sich jedoch noch einige Knpfe, die nichts mit dem
Suchen zu tun haben:

ber: Ein Requester mit Informationen ber DArc bzw. den  Benutzer wird
      angezeigt.

Konverter: Konvertiert ein Scanfile in ein sinnvolles ASCII-Format.
           (mit Zeilen wie: Work:Devs/Monitors/PAL)
           Geben Sie im neuen Fenster Quell- und Zieldatei an.
           Da es erst eine Konvertierungsmethode gibt erbrigt sich
           die Modus-Einstellung. In kommenden Version wird evtl. noch
           'Scanfile --> AmigaGuide' hinzugefgt

Optionen: Das @{" Options " link options}-Fenster ffnet sich. Sie knnen
          hier einige Einstellungen machen.

Beenden: Hmmmm !?!, was knnte dieser Knopf bedeuten...

Auerdem befindet sich am unteren Bildschirmrand noch die Statuszeile.
DArc gibt hier, sofern mglich, seine (Fehler-) Meldungen aus. Bei Fehler-
Meldungen blitzt auerdem der Bildschirm einmal kurz auf.
@endnode
->fe
->fs scan
@node scan "Scannen"
Beim Scannen werden - wie schon erwhnt - alle Dateien zusammen mit ihren
Verzeichnissen in eine Datei geschrieben, um diese Dateien spter einmal
mit der @{"Suchen" link find}-Funktion zu bearbeiten.

Geben Sie unter Datei die Datei an, in die gescannt werden soll. Ein Druck
auf 'R' lt einen File-Requester erscheinen, in dem Sie eine Datei
auswhlen knnen.

Wenn Sie auf '=>' drcken, wird der Name des Scanfiles in das Eingabegadget
fr die Suche kopiert.

Name doppelt: Wenn Sie in eine Datei mehrere Devices scannen, die den
              gleichen Namen besitzen kann dies sehr rgerlich werden, da
              beim Suchen dann auch bei Dateien von diesen beiden Disketten
              jewels der gleiche Name angezeigt wird, und Sie erst nicht
              wissen, auf welcher Diskette die Datei jetzt ist.

              Wenn bei einem doppelten Name ein Requester erscheinen soll,
              in dem Sie einen neuen Namen eingeben knnen stellen Sie diesen
              Schalter auf 'Requester' sonst auf 'Ignorieren'.

#?.info: Wenn der Schalter aktiviert ist, werden auch '#?.info'-Dateien
         mitgescannt, die sonst ignoriert werden.

Anhngen: Wenn dieser Schalter an ist, werden alle Scan-Ausgaben an die
          angegebene Datei angehngt, andernfalls wird die Scan-Datei
          neu geschrieben, alle Inhalte gehen also verloren.

Multiscan: Beschreibung siehe @{"Multiscan" link multiscan}


Im unteren Drittel des Bildschirms befinden sich noch 12 Gadgets.
Diese starten bei Bettigung den Scanvorgang mit dem angegebenen Laufwerk.

Eine Ausnahme bildet der Knopf 'Andere'. Es ffnet sich ein Filerequester,
in dem Sie ein Device oder Directory angeben knnen, das gescannt werden
soll. Man kann mit DArc also nicht nur ganze Devices sondern auch einzelne
Directories scannen. (z.B. das Verz. "PD" (oder so hnlich) auf Ihrer
Festplatte)

Whrend des Scanvorgangs werden Sie stndig darber auf dem Laufenden
gehalten, wie weit der Scanvorgang schon fortgeschritten ist. Mit einem
Klick auf den Cancel-Button unterbrechen Sie das Scannen.

Falls Sie diesen Requester nicht mchten, knnen Sie ihn im @{" Options " link options}-
Fenster abstellen. Der Scanvorgang kann dann mit einem Druck auf <Escape>
abgebrochen werden.
@endnode
->fe
->fs multiscan
@node multiscan "Multiscan"
Wenn Sie groe Diskettensammlungen scannen wollen, wre sehr umstndlich,
immer eine Diskette einzulegen, den 'df0:' (bzw. 'df1:') -Knopf zu drcken,
eine zweite Diskette in das andere Laufwerk (sofern vorhanden) einzulegen,
den anderen Knopf zu drcken usw.

Darum bernimmt DArc diese Aufgabe fr Sie und macht das alles automatisch
fr Sie (bis auf das Einlegen der Diskette natrlich !!). Dies bedeutet:
alle Disketten, die in best. ausgewhlte Laufwerke eingelegt werden,
werden automatisch gescannt.

Zuerst whlen Sie die Laufwerke, die einbezogen werden sollen, dann starten
Sie den Multiscan.

In der Statuszeile erscheint nun eine Meldung, die etwa so aussieht:
(Wenn in einem der Laufwerke schon eine Diskette eingelegt ist, wird
natrlich sofort mit dem Scannen begonnen und es erscheint eine andere
Meldung.)

    df0: insert  | df1: insert  | df2: inaktiv  | df3: inaktiv

Dies bedeutet: df0: ist leer - legen Sie eine Diskette ein
               df1: ist leer - legen Sie eine Diskette ein
               df2: wurde nicht fr den Scanvorgang ausgewhlt
               df3: wurde nicht fr den Scanvorgang ausgewhlt

Whrend des gesamten Multiscan-Vorgangs hat jedes Laufwerk jeweils einen
Status, der sich bei best. Aktionen/Ereignissen verndert :

    inaktiv: Laufwerk wurde nicht ausgewhlt
     insert: Laufwerk ist leer
      ready: Im Laufwerk befindet sich eine Diskette, es wird aber im Moment
             ein anderes Laufwerk gescannt.
    working: Das Laufwerk wird gerade gescannt
     remove: Das Scannen des Laufwerks ist beendet, und Sie knnen die
             Diskette entnehmen.

Beispiel (bezogen auf 'df0:' -  in chronologischer Reihenfolge):

Status:  |   Was passiert/Was Sie tun sollten:        | Neuer Status:|
=========|===========================================================|
Insert   |  Sie legen eine Diskette in das LW ein    ->  Ready       |
---------+-----------------------------------------------------------|
Ready    |  Das Laufwerk ist 'an der Reihe'          ->  Working     |
---------+-----------------------------------------------------------|
Working  |  Die Scanoperation ist beendet            ->  Remove      |
---------+-----------------------------------------------------------|
Remove   |  Sie entnehmen die Diskette               ->  Insert      |
---------+-----------------------------------------------------------|
Insert   |  Sie legen eine Diskette in das LW ein    ->  ....        |
---------+-----------------------------------------------------------|
  .                           .                             .        |
  .                           .                             .        |
=====================================================================+

Wenn Sie eine Diskette entnehmen und Sie gleich wieder in das selbe Lauf-
werk einlegen, erscheint statt 'Insert' gleich wieder 'Remove', um zu
verhindern, da die gleiche Diskette zweimal gescannt wird.

Wenn Sie den Multiscan beenden wollen, drcken Sie einfach <Escape>, wenn
GERADE KEIN SCANVORGANG LUFT. Ggf. knnen Sie einen gerade laufenden
Scanvorgang ja abbrechen.
@endnode
->fe
->fs find
@node find "Auffinden von Dateien"
Die Scan-Dateien allein ntzen Ihnen ja praktisch nichts, Sie mssen auch
irgendwie ausgewertet werden. Dafr ist die Suchen-Funktion zustndig.
Alle Knpfe, die sich auf der rechten Seite befinden, beziehen sich auf das
Suchen.

Sie knnen - wie schon erwhnt - entweder in einer Scandatei suchen oder
direkt in einem Verzeichnis oder auf einem Device.

Whlen Sie deshalb entweder 'Datei' oder 'Verz.'

Geben Sie unter 'Datei:' den Namen der DArc-Scandatei an, falls Sie in einer
Datei suchen wollen. 'R' ffnet einen Filerequester.

Falls Sie direkt suchen mchten, geben Sie unter 'Verz.:' das Verzeichnis
bzw. das Device an, auf dem gesucht werden soll. (z.B. 'dh0:' oder 'dh0:pd')

In die Gadgets ST1-ST3 knnen Sie 3 @{"Suchmuster" link patterns} eingeben, nach
denen die Datei durchsucht werden soll.

Nur Files/Files&Dirs/Nur Dirs bestimmt, ob nur Files, nur Directories oder
beides gefunden werden sollen.

#?.info finden: Wenn dieser Schalter an ist, werden auch Info-Dateien, die
auf das angegebene Muster passen, gefunden, andernfalls werden Sie nicht
bearbeitet.

Gro/Klein beachten: Wenn dieser Schalter an ist wird bei den Suchmustern
die Gro- bzw. Kleinschreibung bercksichtigt.

Suchen: Startet den Suchvorgang

Das Suchen kann vor allem bei greren Dateien je nach Prozessor etwas
dauern. Wenn DArc fertig ist, kommen Sie automatisch auf den @{"Ansehen" link watch}-Screen.

letztes zeigen: Sie knnen sich die letzten Suchergebnisse noch einmal
                ansehen.
@endnode
->fe
->fs patterns
@node patterns "Suchmuster"
Sie knnen bei der Suche entweder Dateinamen oder Suchmuster angeben, nach
denen DArc suchen soll. Ein Dateiname wre z.B. 'Anleitung.guide'. Es werden
dann nur Dateien gefunden, die 'Anleitung.guide' heien.

Vielleicht mchten Sie aber nicht nur die Datei 'Anleitung.guide' finden,
sondern alle Dateien, die mit '.guide' enden finden. Hier kommen Suchmuster
mit Platzhaltern ins Spiel.

Diese Platzhalter werden im Suchstring dort eingsetzt, wo die
bereinstimmung nicht geprft werden soll.

Die 2 wichtigsten:     1. '#?' Steht fr einen beliebig langen Text
Platzhalter            2. '?' Steht fr einen Buchstaben


Beispiele:
=========

Alle Dateinamen, die mit '.guide' aufhren: '#?.guide'

Das #? steht fr beliebig viele Zeichen, deren bereinstimmung nicht
berprft werden soll. Der Dateiname mu also mit '.guide' aufhren.

Da ganze funktioniert auch am Ende: z.B. 'Mod.#?'
Gibt alle Dateien aus, die mit'Mod.' anfangen und beliebeig weitergehen.

Zu guter letzt geht das ganze auch zweimal: z.B. '#?Amiga#?'
Gibt alle Dateien aus, in denen die Zeichenkette 'Amiga' vorkommt.

Zum '?':
-------

Es steht immer nur fr einen Buchstaben. z.B. 'a?c'
Wrde ausgeben, wenn vorhanden: 'aac','abc','acc',...,'a1c',...,'a^c',...

Das ganze lt sich auch verknpfen:

Z.B. gibt 'M?d.#?' folgende dateien aus, wenn vorhanden:
'Mad.irgendwas',...,'Med.irgendwas',...,'Mod.irgendwas',... (endlich mal
                                                    ein sinnvolles Bsp.)

Wer sich genauer ber Suchmuster und Platzhalter informieren mchte, dem
empfehle ich einen Blick in das Amiga-Magazin Ausgabe 5/95, Seite 47,
Kasten 'Platzhalter'.
@endnode
->fe
->fs watch
@node watch "Ansehen von gefundenen Dateien"
Nach dem @{" Suchen " link find} gelangen Sie automatisch in diesen Bildschirm.

In der groen Liste sehen Sie alle Dateien, die auf das angegebene Muster
passen. Direkt unter ihr sind einige Knpfe:

Multiselect... RMB: Mit der rechten Maustaste knnen Sie mehrere Eintrge
                    gleichzeitig anwhlen
                an: Sie knnen immer mehrere Eintrge anwhlen
               aus: Sie knnen nur einen Eintrag anwhlen

  Alle: Alle Eintrge werden selektiert
 Keine: Alle Eintrge werden deselektiert
Invers: Selektierte Eintrge werden deselektiert, nicht selektierte
        selektiert.

Darunter befinden sich 12 Gadgets, die Sie frei konfigurieren und so nach
Ihren Wnschen einrichten knnen. Sie knnen diese Gadgets mit Aktionen
belegen und damit AmigaDOS-Befehle aufrufen (z.B. Copy oder Delete). Somit
knnen Sie aus DArc heraus direkt eine Datei lschen, kopieren, umbenennen
usw. Diese Aktion bezieht sich immer auf den gerade angewhlten Eintrag.
(Mehr dazu siehe @{" Button-Konfiguration " link config})


Noch weiter unten (man sinkt hier ja richtig tief !?!) ist eine Gadgetreihe.

Mit den Gadgets 1,2,3 knnen Sie zwischen der Anzeige der auf das
1. Muster (1), das 2. Muster (2),... passenden Dateien umschalten. Neben
dem jeweiligen Knopf wird das Suchmuster noch einmal angegeben. Ein weier
Text, zeigt an, da dieses Muster gerade angeschaut wird.

Save: Mit diesem Knopf knnen Sie die Suchergebnisse speichern bzw.
      ausdrucken. Geben Sie einen Dateinamen zum Speichern oder 'PRT:' zum
      Ausdrucken an.

Config: Es ffnet sich ein neues kleines Fenster fr die
        @{" Button-Konfiguration " link config}. Whrend es geffnet ist, knnen
        Sie im Hauptfenster nichts machen.

Zurck: Zurck zum Hauptfenster

Ganz ganz unten befindet sich nich eine Statuszeile, in der manchmal
Meldungen ausgegeben werden. (siehe @{"Oberflche" link gui})
@endnode
->fe
->fs config
@node config "Button-Konfiguration"
Wie schon gesagt, Sie knnen die 12 User-Gadgets frei konfigurieren und die
Konfiguration - sofern Sie registrierter User sind - auch abspeichern.

Es gibt grundstzlich 2 Mglichkeiten von Befehlen, die einem Knopf
zugewiesen werden knnen: interne und externe Befehle.

Interne Befehle: Sind in DArc eingebaut
Externe Befehle: Aufruf von AmigaDOS Programmen mit Parametern wie z.B.
                 das angewhlte File. (z.B. 'run c:delete %file')

Beschreibung der Gadgets in diesem Fenster:

Konfig laden: Ldt eine DArc-Buttonkonfig-Datei
Konfig speichern: Speichert die aktuellen Einstellungen als DArc Button-
                  konfig-Datei.

Knopf editieren: Wenn Sie den Befehl oder die Parameter eines Knopfes
                 verndern wollen, drcken Sie zuerst dieses Gadget
                 (also 'Knopf editieren'). Drcken Sie anschlieend den
                 Knopf, bei dem Sie etwas verndern wollen. Es ffnet sich
                 dann ein Neuer Requester fr die @{"Einstellungen des Knopfes" link buttonconfig}.

Knopf kopieren: Drcken Sie diesen Knopf, dann den Knopf, den Sie kopieren
                mchten, zuletzt den Knopf, auf den Sie den ersten kopieren
                wollen. (Es erscheint KEINE Sicherheitsabfrage, falls der Ziel-
                knopf bereits belegt ist.)

Knopf tauschen: Drcken Sie zuerst diesen Knopf, dann den 'Quellknopf', dann
                den 'Zielknopf'. Der Quellknopf wird dann mit dem Zielknopf
                vertauscht.

Knopf lschen: Drcken Sie zuerst diesen Knopf und dann den Knopf, der nach
               einer Sicherheitsabfrage gelscht werden soll.
@endnode
->fe
->fs buttonconfig
@node buttonconfig "Wie Sie ein Gadget editieren"
Name: Jedes Gadget braucht einen Namen, der angezeigt wird (max. 10 Zeichen)

Typ: Bestimmt, ob der Befehl ein interner oder externer Befehl ist.

     Interne Befehle sind in DArc eingebaut,
     externe Befehle sind AmigaDOS-Kommandos, die aufgerufen werden.

Befehl: Hier geben Sie den Befehl und seine Parameter an. Eine genaue
        Beschreibung finden Sie unter @{"Befehlssyntax" link syntax}

mit: Whlen Sie aus, ob die Aktion nur mit Files, mit Files & Dirs oder
     nur mit Dirs durchgefhrt werden soll. (nicht bei allen
     internen Befehlen relevant)

Muster: Wenn das Gadget rechts neben dem Eingabefeld fr das Muster aktiv
        ist (Hkchen), wird bei dieser Operation berprft, ob die
        angewhlte Datei auf ein bestimmtes (also das eingegebene) Muster
        pat. (Wird als Muster z.B. '#?.lha' angegeben, wird die dem Knopf
        zugewiesene Aktion nur ausgefhrt, wenn eine Datei auswhlt wurde,
        die mit '.lha' aufhrt)

        Beachten Sie: Es wird nur berprft, ob die DATEI auf das Muster
                      pat.

        Wenn Sie ein leeres Muster eingegeben haben und Sie die Muster-
        berprfung angeschaltet haben, wird beim Drcken von OK der
        Bildschirm einmal kurz aufblinken, und Sie werden im Fenstertitel
        eine Fehlermeldung erhalten.

Ausgabe: Wenn Sie ein externes Kommando aufrufen, kann es sein, da Sie
         von diesem Programm irgendeine wichtige Ausgabe erhalten.
         Sie knnen hier bestimmen, ob die Ausgabe ignoriert, in einem
         CLI-Fenster angezeigt oder in eine Datei umgelenkt werden soll.

Datei: Hier geben Sie die Datei an, in die die Ausgabe umgeleitet werden
       soll.

Verzeichnis wechseln: Da es hiermit leider Fehler gibt, wurde diese Funktion
                      vorrbergehend herausgenommen.

                      Wenn sie an ist, wird vor der Ausfhrung des Kommandos
                      in das Verzeichnis des Files gewechselt.

File mu existieren: Wenn dieser Schalter an ist, wird der Befehl nicht
                     ausgefhrt, falls das File/der Pfad nicht vorhanden ist.

Abbruch ohne  : Wenn bei der Befehlsausrstung irgendwelche Parameter per
User-Parameter  Requester noch vom User bergeben werden mssen, kann es
                sein, da der User einen solchen Requester abbricht.
                Wenn dieser Parameter angeschaltet ist, wird ohne den
                Parameter des Users abgebrochen, andernfalls wird eine leere
                Zeichenkette bergeben.

Sicherheits- : Manchmal kann es sinnvoll sein (z.B. vor dem Lschen einer
Requester      Datei), einen Sicherheitsrequester erscheinen zu lassen,
               bevor die Aktion wirklich durchgefhrt wird.

Shanghai-: Aktiviert den Shanghai-Modus des Screens. D.h. die meisten
Modus      Programme, die gestarted werden, ffnen Ihre Fenster auf dem
           Bildschirm von DArc. "DIE MEISTEN", denn Multiview tut dies
           z.B. nicht. (Benutzen Sie 'Multiview %file PUBSCREEN DARC')


OK: Hiermit verlassen Sie den Requester. Es kann sein, da der Requester
    nicht verschwindet, sondern dafr der Bildschirm aufblitzt und ein
    Stringgagdet aktiviert wird. Dies liegt daran, da Sie irgendeinen
    Fehler bei der Eingabe gemacht haben. (z.B. kein Name, kein Befehl...)
    In der Titelzeile des Fensters knnen Sie dann eine Fehlermeldung
    ablesen. Nach der Korrektur mssen Sie dann nochmals OK drcken.
    Sobald Sie den Reqester verlassen haben, werden die Einstellungen
    bernommen und die Gadgets aktualisiert.

Abbruch: Dient zum Verlassen des Requesters, ohne da die Einstellungen
         bernommen werden.
@endnode
->fe
->fs syntax
@node syntax "Befehls-Syntax"
Wie Sie (hoffentlich) bereits wissen, wird in DArc zwischen internen und
externen Befehlen unterschieden.

Interne Befehle sind in DArc eingbaut.
Externe Befehle sind AmigaDOS-Kommandos, die ber DArc (via die Execute()-
Funktion) gestartet werden.

Befehlssyntax:
==============

interne Befehle:

Fr interne Befehle reicht es, das Kommando alleine anzugeben. Es gibt
bis jetzt erst 5 interne Befehle:

    INFO: Wenn die angewhlte Datei vorhanden ist, ffnet sich ein
          Requester, der verschiedene Informationen zu dieser Datei enthlt,
          andernfalls wird eine Meldung ausgegeben (Statuszeile), da die
          Datei nicht existiert.

    CHECK: Wie INFO, nur da beim Vorhandensein der Datei nur die Meldung
           ausgegeben wird, da die Datei existiert und kein Requester
           erscheint.

   WBINFO: Lt den selben Requester erscheinen, wie wenn man auf der
           Workbench den Menpunkt 'Piktogramm/Information' anwhlt.
           Bentigt mindestens WB 2.1 oder hher !!!

   ACTION: Versucht, den Dateityp (Text, Bild etc.) der angewhlten Dateien
           zu anlysieren, anschlieend kann je nach Dateiart eine andere
           Aktion (daher der Name) ausgefhrt werden. Dies geschieht mit
           Hilfe der Datei @{" S:DArc-FileTypes " link filetypes}.

   RENAME: Sie knnen so Dateien umbennen

Um einen dieser Befehle zu benutzen, stellen Sie 'Typ' auf 'intern' und
geben den Befehlsnamen an.


externe Befehle:

Etwas komplizierter sieht es da schon bei externen Befehlen aus, da Sie
zur Ausfhrung meist als Argumente das zu bearbeitende File erwarten.

Darum knnen Sie in der Befehlszeile einige Argumentfunktionen eingeben,
die vor der Befehlsausfhrung durch etwas bestimmtes ersetzt werden.

bersicht:

(als angewhlte Zeile stellen wir uns jetzt einmal
 'Anwender:S/Startup-Sequence' vor)


Funktion:   Wird ersetzt durch:

%file       den kompletten Namen des Files (also 'Anwender:S/Startup-Sequence')
%fname      den Namen des Files (also 'Startup-Sequence')
%pname      den Namen des Pfades (also 'Anwender:S/')

Der jeweilige File-/Pfadname wird NICHT in Anfhrungszeichen gesetzt.
Falls Sie Anfhrungszeichen brauchen, geben Sie bitte die Funktion
in Anfrhrungszeichen gesetzt an. (z.B. "%file")

Auerdem gibt es noch weitere Funktionen, die durch das Auswahlergebnis
eines Requesters ersetzt werden.

%fr         Es ffnet sich ein Filerequester, und das ausgewhlte/eingegebene
            File wird mit seinem vollen Pfad fr '%fr' eingesetzt.

%pr         Wie %fr, nur da hier ein Pfadrequester erscheint.

Anwendungsbeispiele:
(Befehle natrlich immer ohne die ' eingeben !!!)


Kopieren des ausgewhlten Files ins RAM:

Typ: extern   Befehl: 'c:copy "%file" TO RAM:'

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

Lschen des ausgewhlten Files:

Typ: extern   Befehl: 'c:delete "%file"'

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

Entpacken eines Archives ins RAM:

Typ: extern   Befehl: 'c:lha e "%file" RAM:'


Entpacken eines Archives in ein vom User ausgewhltes Verzeichnis:

Typ: extern   Befehl: 'c:lha e "%file" "%pr"'


Bei diesen Funktionen ist es praktisch, das Muster auf '#?.lha' zu
setzen, damit nur LHA-Archive bearbeitet werden knnen.

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

Anzeigen einer Textdatei:

Typ: extern   Befehl: 'c:more "%file"'

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

Ich hoffe, da Sie das Prinzip jetzt verstanden haben. Falls nicht, knnen
Sie sich diesen Abschnitt ja noch einmal durchlesen.
@endnode
->fe
->fs filetypes
@node filetypes "DArc-FileTypes"
Mit Hilfe der Datei DArc-FileTypes kann der ACTION-Befehl von DArc erkennen,
um welche Dateiart es sich bei der angewhlten Datei handelt.
Diese Datei sollte sich im S: Verzeichnis Ihrer System-Partition befinden.

Sie ist wie folgt aufgebaut: (Ohne die Einrckung am linken Rand!)

    DARC-FileTypes

    IFF-Animation   ;Bezeichnung
    FORM????ANIM#?  ;Dateipattern
    c:ViewTek %file ;Befehl

    Outline Font
    FORM????OFNT#?
    c:showfont %file

    GIF-Picture
    #?GIF8#?
    c:ViewTek %file

    AmigaGuide
    #?@DATABASE#?
    multiview %file


Sie knnen diese Datei nach genanntem Schema beliebig erweitern. Vor jedem
neuen Typ mssen Sie eine Zeile freilassen.

Auf dieser Datei sttzt sich die komplette Dateierkennung von DArc, als
Befehl knnen Sie nur AmigaDOS-Programme verwenden, interne Befehle werden
hier nicht untersttzt.

Nach dem Dateipattern sucht DArc in den ersten 80 Zeichen einer Datei
und identifiziert so die Dateien.

Die Bezeichnung wird vom INFO Befehl (internes DArc Kommando) vewendet.
@endnode
->fe
->fs options
@node options "Optionen"
Sie knnen hier einige Einstellungen machen:

Standard-Pfad: Der Pfad, in dem Sie alle Ihre scanfiles aufbewahren.
scanfiles

Standard- : Sprache, die verwendet werden soll, wenn kein Catalog geffnet
Sprache     werden konnte. Da die Version 1.0 noch keine Cataloge unter-
            sttzt, ist dies die Sprache, die verwendet wird.

   Wichtig: Diese Einstellung wird erst beim nchsten Programmstart
            bercksichtigt. Whlen Sie also Ihre Sprache aus, speichern
            Sie dann die Options-Datei und starten Sie DArc erneut.

Statistik: Hiermit legen Sie fest, ob Sie nach dem Scannen in eine Datei
           einen Statistik-Requester sehen mchten oder nicht.

           'Nur Einzellaufwerke':  Nicht bei Multiscan, sonst ja
                         'immer':  Auch bei Multiscan
                           'nie':  Hmmm, mal schwer berlegen...

ReqTools...

bentzen: Wenn dieser Schalter aktiviert ist, werden Reqtools-Requester
          verwendet, ansonsten normale Requester.

WICHTIG: Auch Sie keine Reqtools-Requester bentzen, BENTIGEN Sie
         UNBEDINGT die Reqtools.library ( by Nico Franois).

Vorgangsanzeige: Hiermit bestimmen Sie, ob Sie whrend des Scannens in
                 eine Datei die Vorgangsanzeige sehen mchten oder nicht.
                 Falls Sie ausgeschaltet ist, knnen Sie den Scanvorgang
                 mit der <Escape>-Taste beenden.

Bildschirmmodus: Sie knnen hier einstellen welche Auflsung DArc vewenden
                 soll.

   Laden: Mit diesem Knopf knnen Sie eine Optionsdatei laden.
 Sichern: Mit diesem Knopf knnen Sie eine Optionsdatei abspeichern.
          Wenn Sie beim Programmstart geladen werden soll, MU Sie
          'S:DArc-Options' heien.

OK: Sie verlassen den Requester und bernehmen die Einstellungen.

Abbruch: Sie verlassen den Requester, ohne die Einstellungen zu ber-
         nehmen.
@endnode
->fe
->fs regi
@node regi "Registration"
DArc ist Shareware und hat deshalb einige Einschrnkungen:

    - Die Buttonconfig-Datei kann nicht abgespeichert werden
    - Nerviger Requester beim Programmstart

Wenn Sie eine uneingeschrnkte Vollversion haben mchten, knnen Sie sich
bei mir registrieren lassen.

Bitte benutzen Sie dafr die eingebaute Registrationsoberflche. Falls Sie
keinen Drucker besitzen, schreiben Sie bitte einen kurzen Brief, in dem Sie
mir mitteilen, da Sie sich gerne bei DArc registrieren lassen mchten.
Vergessen Sie bitte Ihre volle Anschrift nicht.

Registrationsgebhr:   20 DM oder 15 US$

So knnen Sie bezahlen:

  1. Bargeld
  2. Euroscheck
  3. berweisung des RegiBetrages auf mein Kto. 324 195 bei der
     Sparda-Bank Stuttgart (BLZ 600 908 00)
     Bitte vermerken Sie auf auf der Registrationsvorlage das Datum der
     berweisung. Geben Sie bei der berweisung als Verwendungszweck
     "DArc"+Ihren Namen+Ihren Wohnort an, nicht mehr und nicht weniger.
     Falls Sie Alfred Maier heien und in Mnchen wohnen, wre das
     "DArc Alfred Maier, Mnchen".

Bitte haben Verstndnis dafr, da ich keine anderen Whrungen als DM
und US$ annehmen kann.

Schicken Sie Ihre ausgefllte Registrationsvorlage an:

    Frank Weber
    Schlizstr. 53
    74076 Heilbronn
    Germany

Sie erhalten dann die neuste Version von DArc, sowie ein Keyfile, mit dem
Sie auch zuknftige Versionen als Vollversionen bentzen knnen.


Denken Sie daran:
=================

Mit Ihrer Registration frdern Sie die Weiterentwicklung von DArc und
helfen, den Shareware-Markt fr den Amiga am leben zu erhalten.
Wenn sich nur wenige User registrieren lassen, mssen wir uns doch zwangs-
lufig berlegen, ob wir nicht auf dem PC programmieren sollen, den wir
zwar persnlich nicht besonders schtzen, wo wir allerdings aufgrund der
greren Verbreitung sehr viel mehr Kunden htten.

berlegen Sie es sich !!!!
@endnode
->fe
->fs credits
@node Credits
DArc wurde programmiert von Frank Weber und Holger Kasten.
DArc ist 1995 by Frank Weber & Holger Kasten.

Credits:
========

            Idee: Holger Kasten & Frank Weber
  Programmierung: Frank Weber & Holger Kasten
       Anleitung: Frank Weber

    Beta-Testing: Mirko Lumpp, Daniel Frank & Martin Kasten

Wir mchten uns auerdem bei allen bedanken, die sich bereits @{" registrieren " link regi}
lieen oder das noch vorhaben.

DArc bentzt die Reqtools-Library  by Nico Franois.
@endnode
->fe
->fs Fehler
@node Fehler
Keine Software kann absolut fehlerfrei sein, auch nicht DArc. Wenn Sie
also irgendwelche Fehler finden oder DArc bei bestimmten Aktionen abstrzt,
dann schreiben Sie mir bitte, damit der Fehler ihn einer spteren Version
behoben weden kann.

Schreiben Sie an:

    Frank Weber
    Schlizstr. 53
    74076 Heilbronn
    Germany


Bitte geben Sie folgende Dinge an:

Ihr Amiga-Modell
Workbench- bzw. Kickstartversion
Prozessor
Speicher (ChipRAM und FastRAM)
Bei Abstrzen Gurunummer
laufende Zusatzprogramme (z.B. Toolmanager, MagicMenu, MyMouse, SuperDark...)

GENAUE Beschreibung des Fehlers:

z.B.: DArc strzt gleich nach dem Starten des Suchens ab, wenn man einen
      Suchtext unter ST1 und ST3 angibt, nur Files gefunden werden sollen
      und die Gro/Klein Unterscheidung angeschaltet ist.


und NICHT: DArc kann beim Suchen abstrzen, wenn bestimmte Voreinstellungen
           gemacht werden.

(Der hier genannte Fehler existiert natrlich (hoffentlich ???) nicht
wirklich, er ist nur ein Beispiel !!!)
@endnode
->fe
->fs history
@node History
                           Die Geschichte von DArc
                         ===========================

Irgendwann an einem heiem Sommertag 1994: Die Idee fr DArc wurde geboren.

Es folgten Wochen harter Programmierarbeit, bis endlich die 2 Hauptroutinen
(Scannen und Suchen) fertig waren, aber noch keine Spur einer Oberflche zu
sehen war. Doch auch diese lie nicht mehr lange auf sich warten.

Diese Oberflche wurde dann noch etwas ausgebaut, und so entstand im Sept.
1994 die vorlufig letzte Version v0.5, bei der es dann lange Zeit blieb.

Dann, im Februar 1995 entschlossen wir, da DArc es doch irgendwie wert
sei, der Amiga-ffentlichkeit zugnglich gemacht zu werden.

Wir machten uns also an die Arbeit, und neben einer komplett neuen
Oberflche entstanden auerdem noch 2 komplett neue (und natrlich VIIEEEL
schnellere) Routinen fr das Scannen und Suchen. Zusammen mit einer
grandiosen (???) Idee (die User-Gadgets fr das Anschauen von gefundenen
Dateien) arbeiteten wir auf die Version v1.0 hin.

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

bersicht ber die Versionen:
-----------------------------

==========================================================================

V1.0: Erste Release  (15.05.1995)

===========================================================================

V1.4: (10.11.95)

- Konfiguration der (Multi-) Scan-Laufwerke ber ToolTypes.

- Verbessertes Handling der Liste beim Ansehen der Ergebnisse
  Auerdem knnen jetzt mehrere Eintrge angewhlt und bearbeitet werden

- OnLine-Hilfe: Beim Drcken der Help-Taste erscheint nun die Anleitung
                von DArc. Es wird automatisch an die richtige Stelle
                gesprungen.

- Konverter hat ein eigenes Fenster

- Neue interne Funktionen: RENAME
                           ACTION (Idee von Daniel Frank)

Bugfixes:

- Fehler, wenn man bei direkter Suche als Pfad einen Assign angab

  (Dieser und 2 kleinere Fehler wurde bereits in der v1.0a behoben,
  die hier aber nicht extra erwhnt ist.)

- Wenn das Options-Fenster offen war, wurde auch das Drcken von Knpfen
  im Hauptfenster als Knopfdruck im Options-Fenster akzeptiert.
@endnode
->fe
->fs future
@node future "Zukunftstrume (hoffentlich bald Realitt)"
Plne fr die Weiterentwicklung von DArc:

    - MUI-Version

    - Bessere AmigaGuide-Untersttzung (konvertieren von ganzen Scanfiles
      in das AmigaGuide-Format)

    - ARexx-Untersttzung. Das werden wir aber nur einbauen, wenn sich wirk-
      lich VIELE, VIELE User registrieren lassen. Und dazu gehren auch SIE.

    - Mehr interne Befehle

    - Mehr Argumentfunktionen

(geordnet nach Wichtigkeit)

DArc wird natrlich nur weiterentwickelt, wenn sich gengend Leute fr DArc
interessieren und sich registrieren lassen.

Wenn Sie irgendwelche Ideen zur Weiterentwicklung, Verbesserungsvorschlge
oder sonstiges haben, warten sie nicht darauf, da wir irgendwann einmal
dieselbe Idee haben, sondern schreiben SIE uns.

Wenn Sie noch nicht registriert sind, tun Sie das am besten mit Ihrer
@{" Registration " link regi}.
@endnode
->fe
