CLICKRUN
------------------------------------------------------------------------
Version 1.4 vom 19.02.1996


ein Programm von


	David Reitter
	Albinistr. 10
	55116 Mainz
	Tel./Fax: (49) (0)6131 233255
	Email: david_reitter@wi2.maus.de
	       David Reitter @ WI2 (MausNet)



Inhalt
------

1 Wofr das gut ist?
2 Shareware
3 Installation
4 Funktionsbersicht und Kurzanleitung
  1 Rubriken
  2 Programme
  3 ClickRun-Fenster
5 Konfiguration
  1 Dialog 'Optionen/Allgemein'
  2 Dialog 'Optionen/Pfade'
  3 Dialog 'Optionen/Programme'
6 Icon-Verwaltung in ClickRun
  1 Formatbeschreibung ICONS.INF
7 Interna
8 Neuerungen


1. Wofr das gut ist?
---------------------------------------

ClickRun stellt Ihnen ein Fenster zur Verfgung, in dem Sie die 
Programme, die Sie benutzen, als Icons installieren knnen. Ein Klick 
auf ein Icon, und schon wird das betreffende Programm gestartet. Sie 
knnen fnf oder zehn Programme fr jede der acht Rubriken 
installieren. Die Rubriken knnen Sie frei bestimmen, die Icons knnen 
aus einer Icon-Datei ausgewhlt werden.

Zahlreiche Optionen passen ClickRun in Aussehen und Funktionalitt 
Ihren Wnschen an.

Anstatt der Programme knnen Sie, wenn Sie einen AV-kompatiblen 
Desktop (z.B. Gemini, Ease, Thing...) benutzen, auch Ordner und 
andere Dateien starten. Ordner werden beim Klick auf diese geffnet, 
Dateien angezeigt.


2. Shareware, Rechtliches
---------------------------------------

ClickRun ist Shareware. Das bedeutet, da Sie das Programm kopieren 
und weitergeben drfen und sollen. Bei der Weitergabe mssen alle 
Files des Programmpakets weitergegeben werden:

CLICKRUN.PRG
CLICKRUN.TXT
SETUP.PRG
ICONS.RSC
ICONS.INF

Sie drfen ClickRun ausprobieren und testen. Doch wenn Sie sich zur 
Benutzung entschlieen, mssen Sie sich beim Autor registrieren 
lassen. Tun Sie dies nicht, steht Ihnen nur ein eingeschrnkter 
Funktionsumfang zur Verfgung: Sie knnen nur ein Programm - nmlich 
das erste Programm (ganz links) aus der ersten Rubrik - starten.

Die Registrierung kostet 25.- DM. Wenn Sie ClickRun auf der proTOS '95 
erstanden haben, werden Sie automatisch registriert. Sie erhalten dann 
den Benutzerschlssel per Post zugeschickt. (Dies gilt natrlich nicht 
fr die Demo-Disks.)

Um sich registrieren zu lassen, schicken Sie einen frankierten 
Rckumschlag sowie 25 DM als Scheck, in bar oder Briefmarken der 
Deutschen Bundespost an folgende Adresse:

David Reitter
Stichwort "ClickRun"
Albinistr. 10
55116 Mainz

(Fehlt der frankierte Rckumschlag, gehe ich davon aus, da Sie auf 
die Zusendung eines Benutzerschlssels verzichten.)

Falls Sie Ihren Benutzerschlssel per Email erhalten wollen, oder 
Ihnen der Postweg zu unsicher ist, knnen Sie mir das Geld auch berweisen:

Konto 0229773
Deutsche Bank, Mainz
BLZ 550 700 40

Vergessen Sie bitte nicht, Ihre Email-Adresse bei der berweisung 
anzugeben.

Der Schlssel darf in keiner Form an Dritte weitergegeben werden. Eine 
Zuwiderhandlung stellt einen Versto gegen das Urheberrechtsgesetz dar 
und kann strafrechtlich verfolgt werden.

ClickRun darf nicht ohne die schriftliche Genehmigung des Autors 
kommerziell - auch als Teil von CD-Rom-Zusammenstellungen -
vertrieben werden.

Der Autor haftet weder fr Funktionsweise des Produkts noch fr 
irgendwelche Schden, die Ihnen oder Dritten durch die Anwendung 
entstehen.

Warenzeichen sind in dieser Anleitung nicht als solche gekennzeichnet. 
-------------------------------------------------------------------------------



3. Installation
---------------------------------------

ClickRun ist lauffhig:

- Als PRG in Single-Tasking-Systemen (normales TOS)
- Als PRG und ACC in Multi-Tasking-Systemen (z.B. mit MagiC!)
- Als ACC zusammen mit einem AV-kompatiblen Desktop (z.B. Gemini, Thing, Ease...)
  ClickRun kann nur dann Programme starten, wenn auch dieser Desktop 
  gerade aktiv ist!

Sie knnen das Programm CLICKRUN.PRG in ein beliebiges Verzeichnis 
kopieren. Um es als Accessory zu betreiben, benennen Sie das Programm 
in CLICKRUN.ACC um und kopieren es dorthin, wo sich ihre Accessories 
befinden (meistens C:\).

Registrierung: Beim ersten Programmstart erwartet ClickRun die Eingabe 
Ihres Namens und eines Benutzerschlssels, den Sie vom Autor erhalten 
knnen.

ClickRun bentigt Icon-Dateien. Eine solche wird als ICONS.RSC 
mitgeliefert.

Falls Sie die mit ihrem Desktop benutzten Icons in ClickRun verwenden 
wollen, gehen Sie bitte wie folgt vor:

1. Starten Sie das Programm SETUP.PRG

2. Whlen Sie das Programm CLICKRUN.PRG bzw. CLICKRUN.ACC aus.

3. Whlen Sie den Menpunkt "Pfade" im Fenstermen "Optionen".

3. Installieren Sie per Klick auf die Buttons neben 
   "Icon-Resourcedatei" bzw. "Icon-Datei-Zuordnungsdatei"
   folgende Dateien:

   - Fr Benutzer des Standard-GEM-Desktops (NEWDESK):
           Icondatei: DESKICON.RSC im Wurzelverzeichnis
                      des Bootlaufwerks (meistens C:\)

   - Fr Gemini-Benutzer
           Icondatei: GEMINIIC.RSC
     Zuordnungsdatei: GEMINI.INF im Gemini-Ordner

   - Fr Ease-Benutzer
     hier mssen Sie eine solche Datei erst erzeugen. Dazu whlen Sie 
     zuerst in EASE.PRG den Menpunkt "Icondatei ndern" im 
     "Sonstiges"-Men. Im nun gestarteten ICONCONS.PRG whlen Sie den 
     Menpunkt "Resource speichern" im Men "Datei" an und speichern 
     die Icons unter einem beliebigen Namen ab.
     Stellen Sie nun diese Datei als Icondatei im Dialog ein.

   - Fr Thing-Benutzer
           Icondatei: ICONS.RSC
     Zuordnungsdatei: ICONS.INF im Thing-Ordner

   Falls eine der hier erwhnten Resourcedateien nicht vorhanden ist, 
   oder Sie einen anderen Desktop benutzen, verwenden Sie
           Icondatei: ICONS.RSC
     Zuordnungsdatei: ICONS.INF im ClickRun-Ordner.
     
   Diese Dateien werden bereits mitgeliefert und sind vorinstalliert.
   
4. Verlassen Sie den Dialog mit dem 'OK'-Button.

5. Schlieen Sie das Iconfenster, um ClickRun zu beenden.

______________________________________________________________________________________

4. Funktionsbersicht und Kurzanleitung
---------------------------------------

4.1 Rubriken

- Um eine Rubrik zu installieren, klicken Sie doppelt in den Bereich 
  der Rubriken. Es erscheint ein Dialog, in dem Sie der Rubrik einen 
  Namen geben knnen.

- Um eine Rubrik zu entfernen, drcken Sie die Alternate- oder die
  Control-Taste und klicken Sie auf den Button der betreffenden 
  Rubrik.

  Wenn keine Rubrik installiert ist, verwendet ClickRun die 
  'Default'-Rubrik. Sie knnen diese Rubrik auch aktivieren, indem sie 
  in den Hintergrund (neben die Rubrik-Buttons) klicken.

4.2 Programme

- Um ein Programm zu installieren,
  - ziehen Sie die betreffende Datei vom Desktop-Fenster ins ClickRun-Fenster
    oder
  - Doppelklicken Sie an beliebiger Stelle ins ClickRun-Fenster und 
    whlen Sie das Programm im darauf erscheinenden Fileselektor
  
- Um ein Programm zu entfernen, halten Sie die Alternate- oder die
  Control-Taste gedrckt und klicken Sie auf das Programmicon im
  ClickRun-Fenster. Whlen Sie im nun erscheinenden Dialog 'lschen'.

- Um einem Programm ein anderes Icon zuzuweisen oder Einstellungen zu 
  diesem Programm vorzunehmen, halten Sie die Control- oder die
  Shift-Taste gedrckt und klicken Sie auf das Programmicon im
  ClickRun-Fenster. Whlen Sie im nun erscheinenden Dialog 'Optionen'.
  Sie knnen nun im Setup-Programm, das automatisch gestartet wird, 
  Einstellungen vornehmen. Um ein anderes Icon einzustellen, klicken 
  Sie auf das Icon im Dialog und whlen ein neues Icon aus dem 
  Fenster.

- Sie knnen Icons verschieben, indem Sie auf das Icon klicken, die 
  Maustaste gedrckt halten und das Icon verschieben.
  Um ein Icon in eine andere Rubrik zu verschieben, verschieben Sie es 
  einfach auf den entsprechenden Rubrik-Button.

- Wenn Sie einen AV-kompatiblen Desktop benutzen, knnen Sie auch 
  Ordner und Dateien in ClickRun installieren. Dazu ziehen Sie diese 
  einfach auf das ClickRun-Fenster. Ordner werden bei einem Klick 
  darauf geffnet, Dateien sollen angezeigt werden. Sollten Sie 
  Objekte von ihrem Desktop ins ClickRun-Fenster auf einen Ordner 
  ziehen, werden die Objekte kopiert.
 
- Mit oben erwhntem AV-kompatiblen Desktop knnen Sie auch das 
  Verzeichnis, in dem das zu ffnende Objekt liegt, ffnen lassen.
  Dazu einfach die Alternate-Taste gedrckt halten und auf das Objekt 
  klicken.
  Also z.B.:  Alt-Doppelklick auf   D:\TOOLS\EGALE\EGALE.PRG
                   ffnet           D:\TOOLS\EGALE\
              
- Falls Ihr Desktop dies untersttzt, knnen Sie auch Objekte aus 
  ClickRun herausziehen und auf dem Desktop ablegen oder diese in 
  andere Verzeichnisse kopieren.


4.3 ClickRun-Fenster

- Sie knnen das ClickRun-Fenster verschieben, indem Sie den normalen
  Bewegungsbalken verwenden. Ist dieser abgeschaltet, sollten Sie 
  einfach mit der Maus in den Fensterhintergrund (dort, wo keine 
  Buttons oder Icons sind) klicken, um das Fenster zu verschieben. 
  Falls Sie die Option 'Hintergrund-Rubrik zugnglich' eingeschaltet 
  haben, mssen Sie zustzlich die Shifttaste drcken.
	
	
				
5. Konfiguration
---------------------------------------

Im folgenden soll das Programm SETUP kurz dokumentiert werden.

5.1 Dialog 'Optionen/Allgemein'

  ^Q/^U beendet ClickRun
      Wenn diese Option aktiviert ist, knnen Sie ClickRun mit den 
      Tasten Control-Q und Control-U beenden.

  ClickRun automatisch ikonifiziert
      Unter MultiTaskingsystemen (MagiC!, MultiTOS) ist evtl. 
      sinnvoll, ClickRun automatisch starten zu lassen, aber das 
      ClickRun-Fenster zunchst ikonifziert zu lassen. Wenn diese 
      Option aktiviert ist, ist das ClickRun-Fenster nach dem Start 
      immer zunchst ikonifiziert.

  Doppelklick startet Programme auch
      Normalerweise knnen Sie ein neues Programm installieren, wenn 
      Sie einen Doppelklick in den Bereich mit den Programmicons 
      machen. Wenn diese Option aktiviert ist, werden Programme 
      gestartet, falls Sie einen Doppelklick auf das betreffende Icon 
      machen.

  Ton ein
      ClickRun gibt, sofern diese Option eingeschaltet ist, beim 
      Klick auf ein Icon (und dem Starten eines Programmes) ein 
      Klick-Gerusch aus.
  
  Position merken
      Ist diese Option selektiert, merkt sich ClickRun die Position 
      seines Fensters. Nach einem Neustart befindet sich dann ClickRun 
      an der gleichen Position liegen, an der es auch geffnet wurde.
      
      Sobald Sie diese Option abschalten, wird sich das ClickRun-Fenster 
      immer an der zuletzt gemerkten Position ffnen.
      
  Hintergrund-Rubrik zugnglich
      Ist diese Option eingeschaltet, knnen Sie in einer zustzlichen 
      Rubrik, die keinen Namen besitzt, weitere Programme 
      installieren. Diese Rubrik ist erreichbar, indem Sie in den 
      Dialog-Hintergrund klicken.

  Fenstertitel verstecken
      Diese Option ermglicht es, den Titelbalken von ClickRun zu 
      entfernen. Dies fhrt dazu, da ClickRun noch weniger Platz auf 
      Ihrem Bildschirm einnimmt. Falls die Option '^Q/^U beendet 
      ClickRun' abgeschaltet ist, werden Sie dann aber ClickRun nicht 
      mehr normal beenden knnen! (Es fehlt nmlich dann auch der 
      Closer.)
   
   Rubrik-Anzahl
      Hier knnen Sie whlen, fr wieviele Rubriken Platz vorhanden 
      sein soll.
   
   Programm-Anzahl
      Stellen Sie hier ein, fr wieviele Programme Platz vorhanden 
      sein soll.

   Rubrik-Anordnung
      Sie knnen einstellen, ob die Rubriken links neben den 
      Programm-Icons oder ber ihnen angeordnet werden sollen.
      Vorsicht: In der Kombination <8 Rubriken, 5 Programme, Rubriken 
      links> erhht sich die Breite des ClickRun-Fensters erheblich.

5.2 Dialog 'Optionen/Pfade'

  Resource-Datei
      Hier knnen Sie eine andere Icon-Datei im RSC-Format 
      installieren.

  Icon/Datei-Zuordnungsdatei
      Hier sollten Sie die Zuordnungsdatei fr die Icons installieren. 
      Sie knnen hier entweder Ihre ICONS.INF-Datei von Thing oder 
      die Datei GEMINI.INF von Gemini angeben. Sie knnen sich eine 
      Datei im Format der ICONS.INF-Datei auch selbst erzeugen (s.u.).
      
      Die Datei wird Ihnen die automatische Zuordnung von Icons 
      ermglichen. Sie ist zum Betrieb von ClickRun aber nicht 
      zwingend notwendig.

  Konfigurationsprogramm:
      Zum ndern von Programmeinstellungen (Icons) mu ClickRun das 
      Konfigurationsprogramm SETUP.PRG aufrufen. Deshalb mssen Sie 
      hier den richtigen Programmpfad des SETUP-Programms angeben.


5.3 Dialog 'Optionen/Programme'

  Rubrik/Programm: Bitte whlen Sie hier die gewnschte Rubrik bzw. 
  das gewnschte Programm aus. Die Rubrik 'Default' wird verwendet, 
  falls keine anderen Programme und Rubriken installiert sind.
  
  Sie knnen das zu startende Programm einstellen und den Eintrag 
  wieder lschen ('DEL'). Der Button 'versteht VA-Start' ist nur in 
  MultiTasking-Systemen von Bedeutung. Ist er aktiviert, wird dieses 
  Programm niemals doppelt gestartet, sondern nur aktiviert, falls es 
  sich schon im Speicher befindet.
  
  Sie knnen auerdem eine Kommandozeile (Parameter) angeben, welche 
  dem Programm bei Start bergeben wird. Vorsicht: Das funktioniert 
  nur, wenn kein VA-Desktop verwendet wird!
  
  Auerdem knnen Sie dem Programm ein anderes Icon zuweisen.


6. Icon-Verwaltung in ClickRun
---------------------------------------

Icons werden aus der Datei ICONS.RSC geladen.

ClickRun mu wissen, welches Icon fr welches installierte Programm 
verwendet werden soll:

a) Sie knnen jedoch auch fr jedes in ClickRun installierte Objekt 
   selbst eine Zuordnung im Setup-Programm vornehmen.

b) Entspricht der Dateiname ohne Extension dem Icontext eines Icons, 
   wird dieses Icon verwendet.

c) Eine Zuordnungsdatei ICONS.INF bzw. GEMINI.INF wird ausgewertet.
   Sie sollten im Setup-Programm eine solche Datei installieren.

Falls Sie gerne selbst an einer Zuordnungsdatei namens ICONS.INF
basteln wollen, hier die Formatbeschreibung - aus der THING-Doku:


6.1 Formatbeschreibung ICONS.INF
---------------------------------------

Zeilen mit einem fhrenden '#' werden ignoriert und knnen zur
Kommentierung verwendet werden. Leerzeilen werden ebenfalls
ignoriert. Die Zeilenlnge darf 510 Zeichen nicht berschreiten.

Die Zuordnungen haben folgendes Format:

  <Typ> "<Icon>" <Wildcard>[,<Wildcard>..] [<Zeichen>]

  <Typ>       IFIL - Zuordnung fr Dateien/Programme
              IFLD - Zuordnung fr Ordner
              IDRV - Zuordnung fr Laufwerke

  <Icon>      Beschriftung des Icons in der Resourcedatei

  <Wildcard>  Eine oder mehrere Dateimasken durch Kommas getrennt,
              die Masken werden nicht case-sensitiv bewertet - d.h.
              die Masken "*.txt" und "*.TXT" fhren zum gleichen
              Ergebnis.
              Bei Laufwerken gibt man hier die Laufwerksbuchstaben
              an (z.B. IDRV "FLOPPY" A,B)

  <Zeichen>   Ein optionales Zeichen, dass ohne Komma, mit
              mindestens einer Leerstelle Abstand angegeben wird.
              Dieses Zeichen wird dann in der Textdarstellung am
              linken Rand vor dem Dateinamen ausgegeben, wenn es
              sich bei der Datei nicht um ein ausfhrbares Programm
              handelt.

Beispiel:

  # Einzelne Programme
  #
  IFIL "KOBOLD 2"   kobold_2.prg
  IFIL "PURE C"     pc.prg
  #
  # Dateien
  #
  IFIL "APP"        *.prg,*.app
  IFIL "TOS"        *.tos,*.ttp
  IFIL "RSC"        *.rsc r
  IFIL "TXT"        *.txt,*.doc
  #
  # Ordner
  #
  IFLD "AUTO DIR"   auto
  IFLD "GEMSYS DIR" gemsys
  #
  # Laufwerke
  #
  IDRV "DONALD" c
  IDRV "FILESYSTEM" i,u

Die Zuordnungen sollten so erfolgen, da man zunchst alle genau
bezeichneten Dateien, Programme und Ordner angibt (z.B. 'PC.PRG') und
danach Wildcards (z.B. '*.PRG'), da immer der erste passende Eintrag
verwendet wird - eine genauere Prfung wrde unverhltnismssig viel
Zeit in Anspruch nehmen und wurde deshalb nicht implementiert.
  
  
  
7. Interna
---------------------------------------

ClickRun versteht:

	AP_TERM, AES-Iconifying
	Drag&Drop

ClickRun verschickt:

	AV_PROTOCOL, AV_EXIT, VA_PROTOSTATUS
	AV_START, AV_PROGSTART, AV_OPENWIND
	AV_WHATIZIT, VA_THATIZIT, AV_DRAG_ON_WINDOW

Das SETUP-Programm zu ClickRun wurde mit Hilfe von faceVALUE 1.0 
von Columbus Soft, Darmstadt, erstellt.



8. Neuerungen
---------------------------------------

1.0: erste ffentliche Version, auf der proTOS '95 vorgestellt
1.1: Bugfixes
1.2: + Rubrik-Buttons nun auch im Hintergrund bedienbar
     + Mit Alternate plus Klick wird das zugehrige Verzeichnis geffnet
     + Die Rubrikenanzahl kann nun auf 4 (eine Zeile) reduziert werden
     + Das Fenster ist etwas kleiner+handlicher geworden
       geffnet 
     + In Single-Tasking-Umgebungen bei Programmlauf als ACC wird 
       nun der eventuell noch sichtbare Desktop des Programms 
       beseitigt.
     + Mover (Titelbalken) verstecken nun mglich (Setup-Programm)
       Verschieben geht dann mit Umschalttaste + Mausklick in 
       Dialoghintergrund
     + Unter Single-Tasking-Umgebungen wird nun der Bildschirm 
       (Desktop) restauriert, falls das Programm es nicht schon getan 
       hat.
     + Einige Bugfixes und Verbesserungen
1.3: + Iconzuordnung per Icontext auch mglich
     + Standard-Parameterbergabe nun mglich
     + Setup: Bugfixes, Erweiterungen
     + Icons knnen nun in andere Rubriken verschoben werden
     + Verschiedene Bugfixes (u.a. Absturz bei zu langen Parametern 
       fr zu startende Programme, unter Multitaskingsystemen ohne 
       AV-Umgebung gab's Probleme mit der Parameterbergabe an 
       Programme)
     + Fehler behoben, der dazu fhrte, da zur Laufzeit des Programms
       (besonders unter "Vielfarb-Bildschirmauflsungen") immer mehr 
       Speicher angefordert wurde...
1.4  + Bugfixes im Setup-Programm (Dialog 'Programme', AES-Font)
     + Positionierroutinen fr die Icons berarbeitet
       Auch mit AES-Fonts mit vernderten Ausmaen sollte ClickRun 
       noch ein ansehnliches Erscheinungsbild haben.
     + Die Rubriken knnen nun auch links neben den Icons angeordnet 
       werden. Dadurch knnen gnstigere Ausmae erreicht werden.
     + 3D-Optik etwas verbessert
     + Das ClickRun-Fenster ist noch etwas kompakter geworden
     + Bugfix: AV-Start
-------------------------------------------------------------------------------------