home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / ui_utils / hdclick.lha / HDClick.dok < prev    next >
Encoding:
Text File  |  1992-02-21  |  37.1 KB  |  851 lines
  1.  ----------------------------------------------------------------------
  2. |                                                                      |
  3. |                          ------------------                          |
  4. |                         · H D - C L I C K  ·                         |
  5. |                          ------------------                          |
  6. |                         V e r s i o n  2 . 0                         |
  7. |                                                                      |
  8. |                       © 1991 by Claude Müller                        |
  9. |                                                                      |
  10.  ----------------------------------------------------------------------
  11.  
  12.  
  13.                          Zweck von HDClick:
  14.                          ------------------
  15.  
  16. HDClick ist ein Programmselector/HD-Menue mit dem schnell und einfach
  17. Programme durch Anklicken gestartet werden können.
  18. ------------------------------------------------------------------------
  19.  
  20.                              Copyright:
  21.                              ---------
  22.  
  23. HDClick ist Shareware. Wem dieses Programm gefällt , muss  die  Share-
  24. waregebür von...     ---------------------------
  25.                    ·          SFr. 20.-          ·
  26.                      ---------------------------
  27.                      ( SFr = Schweizerfranken )
  28.            ( resp. entsprechender Betrag in anderer Währung )
  29.  
  30.                                               ...an den Autor schicken.
  31. Wer weiss, dass das Rückporto hoch ist, soll mir bitte genug Geld dafür
  32. beilegen. Selbstverständlich darf man auch so mehr als 20 Fr. bezahlen!
  33.  
  34. -----------------------------------------------------------------------
  35.  DIE BENUTZUNG DER NICHT-REGISTRIERTEN VERSION MIT STöRREQUESTER BE-
  36.  RECHTIGT *NICHT* ZUR AUSLASSUNG DER SHAREGEBüHR-ZAHLUNG !
  37.  
  38. Auch die nicht registrierte HDClick-Version mit Störrequester ist Share-
  39. ware. Sharezahler erhalten die Version ohne Störrequester lediglich als
  40. "Belohnung" für ihre Ehrlichkeit.
  41. -----------------------------------------------------------------------
  42.  
  43. Es kann Bar, mit  Postanweisung, per Check¹ oder per EZ bezahlt werden.
  44. Für  letzeres  trägt man folgendes auf dem Einzahlungsschein ein:
  45.  
  46. =======================================================================
  47. Einzahlung für:
  48. ---------------
  49. Schweiz. Bankverein
  50. CH-4104 Oberwil BL
  51.  
  52. Zugunsten von:
  53. --------------
  54. Claude Mueller
  55. Auf den Hallen 32
  56. CH-4104 Oberwil
  57.  
  58. Konto: 40-854-2                Referenz-Nr: 3 32332 16806
  59. =======================================================================
  60.  
  61. ¹ Checks sollten auf eine Schweizer Bank lauten, da ich für Checks  mit
  62.   einer ausländischen Bankadresse eine Gebühr (ca. Fr.8.-) bezahlen muss.
  63.   Eine Postanweisung wäre besser.
  64. =======================================================================
  65.  
  66. Dem Sharebetrag MUSS EINE DISKETTE BEIGELEGT WERDEN, welche
  67.  
  68.                          !!  G R A T I S  !!
  69.  
  70.     mit PD-Programmen gefüllt wird. Natürlich mit der neusten Version von
  71. HDClick, ohne störende Requester.
  72.  
  73. Registrierte Benutzer erhalten eine Information, sobald eine neue Version
  74. HDClicks erschienen ist. Die Updates sind gratis (Disk und Porto NICHT in-
  75. begriffen).
  76.  
  77.  
  78.  
  79.                               Adresse:
  80.                        ------------------------
  81.  
  82.                              Claude Müller
  83.                              Auf den Hallen 32
  84.                           CH-4104 Oberwil (BL)
  85.                              SCHWEIZ
  86.  
  87.                          Tel: (061) 401 34 69
  88.                        ------------------------
  89.  
  90.           ****   Fidonet: 2:302/445.6  "Claude Mueller"  ****
  91.           ****   Z-NETZ : C.MUELLER@LINK-CH1.ZER         ****
  92.  
  93. Wer Fehler findet oder (Installations-) Probleme mit HDClick hat, kann mir
  94. schreiben oder mich anrufen.
  95.  
  96.         Was beim Bezahlen der Sharegebür sonst noch zu beachten ist:
  97.         ------------------------------------------------------------
  98.  
  99. - Nicht vergessen, eine Disk mitzuschicken.
  100.  
  101. - Sharezahler können einen eigenen Hotkey für die Iconify-Funktion wählen!
  102.   Falls das gewünscht wird, muss mir die Beschriftung der Taste (z.B."HELP"
  103.   oder "F1")  und/oder der enstprechende Hex-Code mitgeteilt werden.  Wenn
  104.   nicht unbedingt nötig, bitte keine Tastenkombinationen wie z.B. SHIFT-XX
  105.   oder ALT-XX.
  106.  
  107. - Mir  mitteilen,  welches Deine/Ihre neuste HDClick-Version ist. (wichtig
  108.   bei der Beantwortung von Fragen)
  109.  
  110. - Mir mitteilen, woher die HDClick(Demo-)version stammt.
  111.  
  112. - Bei  Problemen  betreff HDClicks wäre es am besten, wenn ich das/die be-
  113.   treffenden Configfiles und die STARTUP-SEQUENCE bekäme.
  114.  
  115. - Mir mitteilen, welche Kickstart/OS-Version (1.2 / 1.3 / 2.0) installiert
  116.   ist und ob Du/Sie vorhaben, auf Kickstart 2.0 zu wechseln falls noch
  117.   das alte Kickstart installiert ist.
  118.  
  119. - Warum mich fragen,  wenn das Problem schon in der Anleitung beschrieben
  120.   ist ? Bitte genau nachschauen !
  121.  
  122. - Den Absender nicht vergessen.
  123.  
  124. - Das Config_Tool von  Manfred  Gillert ist Freely Distributable und nicht
  125.   Shareware. Wer  Shareware für  HDClick bezahlt, bezahlt nicht gleichzei-
  126.   tig noch für das Config_Tool. Der Autor Manfred Gillert ist jedoch dank-
  127.   bar für jede Spende für sein Programm Config_Tool !
  128.  
  129. ---------------------------------------------------------------------------
  130.  
  131.  
  132. Das Config_Tool     ist Copyright (C) by Manfred Gillert.
  133.  
  134. Die Color.library   ist Copyright (C) by Dissidents.
  135.  
  136. Die KD_FReq.library ist Copyright (C) by Khalid Aldoseri
  137. und darf nur mit dem File 'FR_User.DOC' weitergegeben werden.
  138.  
  139.                               Vielen Dank an
  140.                               ==============
  141.  
  142. Josef Egloff für seine vielen Tips, ohne die HDClick um einige Features
  143. ärmer geblieben wäre !
  144.  
  145. Rolf Boehme, ohne den HDClick noch lange keine Hotkeys hätte...
  146.  
  147. Lothar Mai, der HDClick intensiv auf Bugs getestet hat.
  148.  
  149.  
  150. **********!*************!**************!*************!***********!*********
  151.                              V E R T R I E B
  152.                              ---------------
  153.  
  154. Aufgrund Nichtbeachtung meiner Vertriebsbedingungen von einem gewissen Ma-
  155. gazin  mit  Diskette,  steht dieses Kapitel am Anfang der Anleitung. Viel-
  156. leicht wird es dann auch wirklich gelesen.
  157.  
  158.         WER FÜR DIESE DISKETTE MEHR ALS DM5.-/SFR5.- BEZAHLT HAT,
  159.                            IST BETROGEN WORDEN.
  160.  
  161. Wer für  eine  PD-Disk mehr als DM 5.-/ Fr.5.- verlangt, macht  garantiert
  162. PROFIT, und das ist eindeutig gegen die PD/FD-Richtlinien ! So etwas nennt
  163. man KOMMERZIELLEN VERTRIEB, HDClick darf aber NICHT kommerziell vertrieben
  164. werden !
  165.  
  166. --------------------------------------------------------------------------
  167. HDClick darf frei kopiert werden, solange diese Anleitung dabei  und  sie
  168. und das Programm unverändert gelassen werden, jedoch mit folgenden Ausnah-
  169. men:
  170.  
  171. HDClick darf NICHT KOMMERZIELL GENUTZT ODER VERTRIEBEN WERDEN ,dazu  muss
  172. eine SCHRIFTLICHE GENEHMIGUNG DES AUTORS vorliegen.
  173.  
  174. HDClick  darf NICHT OHNE SCHRIFTLICHE GENEHMIGUNG DES AUTORS  in eine PD-
  175. Serie od. ÄHNLICHES aufgenommen werden.
  176.  
  177. HDClick darf NICHT auf einem DISKETTENMAGAZIN oder einer  anderen öffent-
  178. lichen Publikation erscheinen, ohne dass eine schriftliche Genehigung des
  179. Autors vorliegt.
  180.  
  181. Der Autor übernimmt keine Verantwortung von Schäden, die durch die Benutz­
  182. ung HDClick's entstanden sind.
  183.  
  184. HDClick  ist  Shareware. Wem das Programm gefällt und wer es viel benutzt
  185. sollte den Text unter "Copyright" lesen.
  186.  
  187. HDClick ist Copyright by Claude Müller,  der  Autor  behält  alle  Rechte
  188. an HDClick.
  189. -------------------------------------------------------------------------
  190. ********!*************!**************!*************!***********!*********
  191. -------------------------------------------------------------------------
  192.                            A N L E I T U N G
  193. -------------------------------------------------------------------------
  194.  
  195.                          **** Neu an 1.3 ****
  196.  
  197. - Neu an der Version 1.3 gegenüber der Version 1.21 ist der Modus "m", wel­
  198.   cher Untermenüs ermöglicht.
  199. - Ein paar Bugs weniger.
  200.  
  201.  
  202.                          **** Neu an 2.0 ****
  203.  
  204. Neu an der Version 2.0 gegenüber der Version 1.3 ist
  205.  
  206. - Die neue EDIT-Funktion. Aendern des Configfiles direkt aus HDClick, ohne
  207.   Text-Editor.
  208. - Die Small-Funktion. Eine kleine Version HDClicks, in HDClick integriert.
  209. - Iconify ohne (Hotkeys) oder mit Fenster.
  210. - Eigene Farbeinstellungen.
  211. - HDClick Preferences, welche es ermöglichen
  212.                 - HDClick normal, Small oder iconified zu starten
  213.                 - Die Fensterpositionen festzulegen
  214.                 - Die Farbeinstellungen zu ändern
  215. - Speicheranzeige.
  216. - HDClick kann selbst neue Configfiles erzeugen.
  217. - Umlenken  der Ausgaben HDClicks ins NIL:, HDClick kann also mit Runback
  218.   gestartet werden.
  219.  
  220.                        ** Spätere Versionen **
  221.  
  222. Vorgesehene Erweiterung für HDClick 2.X:
  223.  
  224. - OS 2.0-only Version mit den Vorteilen die sich daraus ergeben
  225.    - Verbesserte EDIT/Prefs-Funktionen mit mehr Einstellungsmöglichkeiten
  226.      wie z.B. Text/Gadgetfarbe und Fonts.
  227. - ??? Wer Erweiterungsideen hat, kann sie mir mitteilen
  228.  
  229.                          ********************
  230.  
  231.  
  232.                               I N H A L T
  233.                               -----------
  234.  
  235.    Programmaufruf............................................. ( 1 )
  236.                    Shell......................................   (1.1)
  237.                    Workbench..................................   (1.2)
  238.    Allgemeines................................................ ( 2 )
  239.    Das Small-Fenster.......................................... ( 3 )
  240.    Die Iconify-Funktion....................................... ( 4 )
  241.    Die EDIT-Funktion.......................................... ( 5 )
  242.    Die Spalten-Titel.......................................... ( 6 )
  243.    Die Preferences............................................ ( 7 )
  244.                    HDClick Startmodus.........................   (7.1)
  245.                    Iconify-Modus..............................   (7.2)
  246.                    Fenster-Positionen.........................   (7.3)
  247.                    Farbeinstellungen..........................   (7.4)
  248.    Das Configfile............................................. ( 8 )
  249.    Programmstart-Modus........................................ ( 9 )
  250.                    Launch.....................................   (9.1)
  251.                    Run........................................   (9.2)
  252.                    Execute....................................   (9.3)
  253.                    Menue......................................   (9.4)
  254.                        Ein neues Configfile erzeugen..........   (9.4)
  255.                    Option.....................................   (9.5)
  256.        Anhang 1: Tips, Häufige Fragen, Fehlermeldungen, Beispiele...
  257.  
  258.  
  259.  
  260.                          ********************
  261.  
  262.  
  263.                          (1) Programmaufruf
  264.                              ==============
  265.  
  266. (1.1) Shell                  "HDClick Configdatei"
  267.       -----           oder   "HDClick"
  268.  
  269. "Configfile" = Pfad und Filename der ASCII-Configurations-Datei. Wird kein
  270. File-name angegeben, sucht HDClick nach dem File 'HDCConfig' im  aktuellen
  271. Verzeichnis.
  272.                         Beispiel: "Dh0:c/HDClick Dh0:s/HDCConfig"
  273.  
  274. Wird das spezifizierte Configfile nicht gefunden, erscheint ein  Requester.
  275. Auf Druck des Gadgets "Erzeugen" wird ein neues Configfile  mit  dem  beim
  276. Aufruf spezifizierten Filename. Im Falle des obigen Beispiels würde das Fi­
  277. le "dh0:s/HDCConfig" erzeugt. HDClick muss nun neu gestartet werden.
  278.  
  279. HDClick2.0 kann mit Runback gestartet werden. HDClick2.0 leitet  seine Aus-
  280. gaben ins NIL:. Falls ein Programm welches von HDClick  gestaret wurde Aus-
  281. gaben in ein Fenster versucht zu machen, werden diese nicht sichtbar.
  282.  
  283. (1.2) Workbench
  284.       ---------
  285. Wird  HDClick  von der WB gestartet, sucht es nach dem File 'HDCConfig' im
  286. aktuellen Verzeichnis. Wird "HDCConfig" nicht gefunden, erscheint ein  Re­
  287. quester. Auf Druck des Gadgets "Erzeugen" wird ein Configfile  "HDCConfig"
  288. in der aktuellen Schublade (Drawer)  erzeugt.  Nun muss  HDClick  nochmals
  289. durch Doppelklick auf das Icon gestartet werden.
  290.  
  291.  
  292.                            (2) Allgemeines
  293.                                ===========
  294.  
  295. Wird HDClick gestartet, sucht es nach dem Configfile, falls gefunden öffnet
  296. es einen  Screen mit Gadgets. Der Benutzer kann per Maus ein Gadget anklik­
  297. ken , und ein von ihm im Configfile bestimmtes Programm wird gestartet. Ne­
  298. ben den  normalen  Gadgets gibt's noch ein QUIT-Gadget zum Beenden von HDC­
  299. lick, ein SMALL Gadget für die Small-Version HDClicks, ein PREFS-Gadget für
  300. die Preferences und ein EDIT-Gadget (wird später erklärt).
  301.  
  302. HDClick benötigt den Befehl "run". Falls möglich, sollten sich die
  303. KD_FReq.library und die Color.library im LIBS: Verzeichnis befinden.
  304.  
  305.  
  306.                           (3) Das SMALL-Fenster
  307.                               ================
  308.  
  309. HDClick2.0 kann nicht nur mit normalem Screen, sondern auch in einer Mini-
  310. Version geöffnet werden. Zu diesem "Small"-Fenster gelangt man,  indem man
  311. im HDClick Hauptscreen auf das  "Small"-Gadget klickt,  oder indem  in den
  312. HDClick Prefs beim Programmstart "Small" angegeben wurde (mehr dazu  siehe
  313. Prefs (7) ).
  314.  
  315. Ein kleines Fenster wird auf dem Workbench-Screen geöffnet.  Es ist jeweils
  316. nur eine der vier Gadgetspalten des Hauptscreens sichtbar. Es wird dasselbe
  317. Configfile benutzt.
  318.  
  319. Die Pfeilgadgets:
  320.  
  321.    Mit den PfeilGadgets kann zwischen den vier Gadgetspalten hin und herge­
  322.    scrollt werden.
  323.  
  324. Das Expand-Gadget:
  325.  
  326.    Mit dem Expand-Gadget (befindet sich zwischen den Pfeilgadets) wird das
  327.    Small-Fenster geschlossen und der HDClick-Hauptscreen geöffnet.
  328.  
  329. Wird die rechte Maustaste gedrückt, gelangt man in den Iconify-Status (ent­
  330. weder Iconify-Fenster oder Hotkey - Siehe Prefs (7))
  331.  
  332.  
  333.                       (4) Die Iconify-Funktion
  334.                           ====================
  335.  
  336. Wird die rechte Maustaste gedrückt, schliesst sich der Screen und ein und
  337. kleines Fenster wird geöffnet. Zurück zum Hauptscreen kommt man, indem man
  338. die  rechte Maustaste bei aktiviertem Fenster nochmals drückt. Ist ein Re­
  339. quester oder ein anderes Fenster HDClicks wie z.B. das EDIT-Fenster geöff­
  340. net, funktioniert die Iconify-Funktion NICHT.
  341.  
  342. In den HDClick Preferences kann ausgewählt werden, ob beim Druck der rech­
  343. ten Maustaste - Ein kleines Fenster geöffnet wird, von dem man per rechter
  344.                 Maustaste wieder zum MainScreen od.Smallwindow gelangt.
  345.  
  346.               - Kein  Fenster  geöffnet  wird. Zurück  zum  Mainscreen od.
  347.                 Small-Fenster gelangt man, indem man die HELP-Taste drückt.
  348.                 Auf Wunsch können Sharezahler mir ihren eigenen Hotkey an-
  349.                 geben, falls  die  HELP-Taste schon von anderen Programmen
  350.                 benutzt wird. Mehr  dazu siehe unter "Copyright" am Anfang
  351.                 dieser Anleitung und in "(7) Preferences".
  352.  
  353.                          (5) Die EDIT-Funktion
  354.                              =================
  355.  
  356. Ab der Version 2.0 HDClicks ist es nicht mehr nötig, per Texteditor Config­
  357. files zu ändern. Einzelne Gadgets  sowie  Spaltentitel  können  direkt  aus
  358. HDClick geändert werden. Gadgets können editiert  werden, indem man ein mal
  359. auf das EDIT-Gadget klickt und nun das zu ändernde Gadget anklickt. Es öff­
  360. net sich ein Fenster, in das man seine Gadget-Daten einträgt.
  361.  
  362. Mit dem Gadget "Filerequester" kann der Filename  des  zu  startenden  Pro­
  363. gramms komfortabel per Maus ausgewählt werden.
  364.  
  365. Auf Klick auf die Pfeilgadgets wird jeweils in den  nächsten/vorhergehenden
  366. Gadgeteintrag gewechselt.
  367.  
  368. Nun muss der Programmstart-Modus (siehe unter (9)) per Cycle-Gadget ausge-
  369. wählt werden. Wählt man "None", hat das Gadget (trotz Gadgettitel und/oder
  370. Filename) keine Funktion. Damit können "leere" Gadgets erzeugt werden.
  371.  
  372. Mit Save/Save As kann das aktuelle Configfile mit den Aenderungen  gespei­
  373. chert werden (es wird immer das ganze Configfile gespeichert).  Danach be­
  374. findet man sich immer noch im EDIT-Modus, weitere Gadgets  können geändert
  375. werden. Um den EDIT-Modus zu verlassen, muss noch einmal auf EDIT geklickt
  376. werden.
  377.  
  378.                            (6) Spalten-Titel
  379.                                =============
  380.  
  381. Die Titel über jeder Gadgetspalte können ab V2.0 HDClicks auch aus dem Pro­
  382. gramm direkt geändert werden. Dazu klickt man den zu  ändernden  (oder ein­
  383. fach einen der vier) Spalten-Titel an. Die  Gadgets  sind zwar nicht sicht­
  384. bar, öffnen jedoch ein Fenster, wenn sie angeklickt werden. Für diese Funk­
  385. tion muss man sich nicht unbedingt im EDIT-Modus befinden.
  386.  
  387. In dieses Fenster trägt  man seine Spaltentitel ein (max. 18 Zeichen!)  und
  388. speichert diese mit Save/Save As.
  389.  
  390.  
  391.  
  392.                             (7) Preferences
  393.                                 ===========
  394.  
  395. Durch Anklicken des  "Prefs"-Gadgets wird das  HDClick  Preferences-Fenster
  396. geöffnet.
  397.  
  398. (7.1) Der HDClick-Startmodus
  399.       ----------------------
  400.       Nicht zu  verwechseln mit dem  Programmstartmodus (Launch, Run etc.).
  401.       Hier wird  festgelegt, in was für einer Form HDClick gestartet werden
  402.       werden soll: -  Normal: HDClick öffnet den Hauptscreen
  403.                    -   Small: HDClick öffnet das Small-Fenster
  404.                    - Iconify: HDClick öffnet das Iconify-Fenster
  405.  
  406.      Die Aenderungen  werden  aktiv, sobald HDClick das nächste mal gestar-
  407.      tet wird.
  408.  
  409. (7.2) Der HDClick-Iconifymodus
  410.       ------------------------
  411.  
  412.       Wird die rechte  Maustaste im Hauptscreen oder im  Small-Fenster  ge-
  413.       drückt,  erscheint bekanntlich das "Iconify-Fenster". Es kann nun ge-
  414.       wählt  werden, ob entweder das Iconify-Fenster, oder stattdessen kein
  415.       KEIN Fenster  geöffnet werden soll.
  416.                     - Window: Das Iconify-Fenster öffnet sich.
  417.                     - Hotkey: KEIN  Fenster wird geöffnet. HDClick befindet
  418.       sich jedoch  weiterhin im Speicher. Zurück in den HDClick Hauptscreen
  419.       oder  ins Small-Fenster gelangt man, indem man die Taste HELP  drückt
  420.       Geeignet  für Leute, die zuviele  Iconify-Windows ( inklusive  Uhren,
  421.       Speicheranzeigen usw.) auf ihrem Screen haben.
  422.  
  423. (7.3) Die Fenster-Positionen
  424.       ----------------------
  425.  
  426.       Hier   können  die  X/Y-Koordinaten  des Iconify - und Small-Fensters
  427.       spezifiziert  werden. Da bei jedem User unterschiedliche  Screengrös-
  428.       sen existieren  (z.B. Interlace  od.  Non-Interlace),  fragt  HDClick
  429.       nicht ab,ob zu  hohe Koordinaten eingegeben werden. Ist dies der Fall
  430.       wird beim Klick  auf Small oder bei der Iconify-Funktion kein Fenster
  431.       geöffnet,  HDClick befindet sich aber immer noch im Speicher. In die-
  432.       sem Fall  gelangt man NICHT wieder  zu  HDClick zurück - sorry... Ich
  433.       werde das  so bald wie möglich ändern.
  434.  
  435. (7.4) Die Farbeinstellungen
  436.       ---------------------
  437.       Wird das Gadget  "Farben" angeklickt,  erscheint  ein  Colorrequester
  438.       der Color.library.  Wird in diesem  Requester  auf  "Save"  gedrückt,
  439.       werden die  geänderten Farben benutzt,  sind jedoch nicht ins HDClick
  440.       Configfile  gespeichert worden. Gespeichert wird erst mit  Klick  auf
  441.       Save/Save As im Prefs-Fenster. Jedes Configfile  kann  eigene  Farb-
  442.       einstellungen besitzen.
  443.  
  444.  
  445.                          (8) Das Configfile
  446.                              ==============
  447.  
  448. Dieser Teil muss  nur von dem gelesen werden, der ein  Configfile per Text-
  449. editor ändern möchte. Hier kurz der Aufbau des Configfiles:
  450.  
  451. ---------------------------------------------------------------------------
  452.  
  453. Programm,Gadgettitel,l                  oder
  454. Programm,Gadgettitel,r                  oder
  455. Programm,Gadgettitel,e                  oder
  456. Programm,Gadgettitel,o                  oder
  457. Configfile-Dateiname,Gadgettitel,m      oder
  458.  ,,
  459.  
  460.        ... Insgesamt 55 Einträge
  461.  
  462. n,w,
  463. SpaltenTitel1
  464. SpaltenTitel2
  465. SpaltenTitel3
  466. SpaltenTitel4
  467. Fenster-Positionen
  468.        "
  469.        "
  470.        "
  471. Farben
  472.  
  473.  
  474. ---------------------------------------------------------------------------
  475.  
  476. Da der  Normaluser die Gadgets und Prefs-Einstellungen per  HDClick  selbst
  477. ändert,  beschreibe ich  hier nur, wie  die  Gadgeteinträge aufgebaut sind.
  478. Manchmal ist es  praktisch, per  einem  Texteditor  grosse  Aenderungen  am
  479. Configfile  vorzunehmen. Wer Probleme mit dem Aendern von  Configfiles  hat
  480. hat, soll sich an mich wenden.
  481.  
  482.  
  483.                       Kommas zwischen den drei Einträgen
  484.                                   _____|_____
  485.                                  |           |
  486.                          Programm,Gadgettitel,x
  487.             ________________|         |       |_________________
  488.            |                          |                         |
  489. Genauer Pfad + Filename des    Titel-String des Gad-    Programmstart-
  490. zu startenden Programmes       gets (max. 16 Zeichen)   Modus -> (9).
  491.  
  492.  
  493. Besteht das Configfile aus zuwenig Zeilen  oder  falschen  Einträgen,  kann
  494. es dazu kommen, dass HDClick entweder ein Durcheinander aus den Daten macht
  495. oder im schlimmsten Falle abstürzt.
  496.  
  497.  
  498.                         (9) Programmstart-Modus
  499.                             ===================
  500.  
  501. (9.1) Modus Launch:
  502.       ------=------
  503.             Beim  Modus  Launch  wird das  Programm  normal  gestartet  und
  504.             HDClick beendet.
  505.  
  506. (9.2) Modus Run:
  507.       ------=---
  508.             Beim Modus Run wird das Programm  mit  RUN  gestartet.  HDClick
  509.             schliesst den Screen und öffnet das Iconify-Fenster.
  510.  
  511. (9.3) Modus Execute:
  512.       ------=-------
  513.             Beim Modus Execute wird das Programm  mit  RUN  gestartet.  Der
  514.             HDClick-Screen resp. das  Small-Fenster  bleibt jedoch geöffnet
  515.             und es können weitere Programme durch Anklicken gestartet  wer-
  516.             den.
  517.             Der  Modus  Execute ist nicht zu verwechseln mit dem "Execute"-
  518.             Command vom  CLI.  Dieser  Modus  führt KEINE Batchdateien aus.
  519.             Mehr dazu in Probleme/Häufige Fragen/Tips (Anhang).
  520.  
  521. (9.4) Modus Menue:
  522.       ------=----
  523.  
  524.             Beim Modus Menue wird nach Anklicken  eines solchen Gadgets ein
  525.             neues Configfile geladen und die Gadgeteinträge und  Prefs-Ein-
  526.             stellungen nach dem neu eingeladenen  Configfile  erneuert. Der
  527.             Filename des zu ladenden  Configfiles wird vor dem ersten Komma
  528.             anstelle eines Programmnamens definiert.
  529.  
  530.             Hier ein Beispiel für einen  Eintrag im Gadget im EDIT-Fenster:
  531.  
  532.                  Titel: Grafik
  533.             Configfile: Dh0:s/Graphikconfig
  534.                  Modus: Menü
  535.  
  536.             Und ein Beispiel für einen Eintrag im Configfile:
  537.  
  538.             Dh0:s/GraphikConfig,GRAPHIK,m
  539.                      |             |    \
  540.             Name des Config-    Gadget-  \- Modus "m" für Untermenüs
  541.             files               titel
  542.  
  543.             Nach Anklicken dieses Gadgets wird das Configfile
  544.             "Dh0:s/GraphikConfig" geladen. Die Gadgets werden nun den  Ein-
  545.             trägen des neuen Configfiles ( also "Graphikconfig" )  zugewie-
  546.             sen. Wird das spezifizierte Configfile nicht gefunden,erscheint
  547.             ein Requester. Durch Klick auf das  Gadget  "Erzeugen"  erzeugt
  548.             HDClick ein neues Configfile mit dem im Eintrag  spezifizierten
  549.             Filenamen. Im obigen Beispiel würde das File
  550.             "Dh0:s/GraphikConfig" erzeugt.
  551.  
  552.             Mit dieser  Menü-Funktion  hat  man Zugriff auf unendlich viele
  553.             Configfiles, die Anzahl ist in keiner Weise limitiert. Von  je-
  554.             dem Configfile kann mit dem Entsprechenden Eintrag in jedes an-
  555.             dere Configfile gesprungen werden. Praktisch ist  es,  wenn  in
  556.             jedem Configfile ein Gadget "Main" existiert, welches das Haupt
  557.             Haupt-Configfile lädt.
  558.  
  559. Ein neues Configfile aus HDClick erzeugen
  560. -----------------------------------------
  561.             Man  gehe  in  die  EDIT-Funktion,  wähle ein leeres Gadget und
  562.             trage den Gadgettitel ein. Im unteren  Stringgadget  trägt  man
  563.             einen Pfad+Filenamen eines noch nicht existierenden Configfiles
  564.             ein. Nun den Modus Menü und Save. Jetzt klick man auf  das  neu
  565.             erstellte Gadget. Im nun erscheinenden Requester klickt man auf
  566.             "Neues erzeugen" und das Configfile wird erstellt.
  567.  
  568. (9.5) Modus Option:
  569.       ------=------
  570.  
  571.             Beim Modus Option öffnet  sich  ein  Fenster  mit fünf Gadgets:
  572.  
  573. Das Stringgadget:
  574.  
  575.             Der dort eingetippte Text wird beim Programmaufruf vom zu star-
  576.             tenden Programm als Parameter empfangen. Beispiel:
  577.  
  578.             Eintrag im ConfigFile:               Text im Stringgadget:
  579.                       |                                   |
  580.              "dh0:c/Ed,Editor,o"               "dh0:s/startup-sequence"
  581.                       |___________________________________|
  582.                                         |
  583.                                  Ausgeführt wird:
  584.                                         |
  585.                          "dh0:c/Ed dh0:s/startup-sequence"
  586.  
  587.             Der Editor "ed" lädt also die Textdatei "dh0:s/startup-
  588.             sequence".
  589.  
  590.             Wird eines der Gadgets unter dem Stringgadget angeklickt,  wird
  591.             das Programm mit dem jeweiligen Modus gestartet.
  592.  
  593.  
  594. Das "FileRequester"-Gadget:
  595.  
  596.             Nach Anklicken dieses Gadgets öffnet sich ein Filerequester der
  597.             KD_FReq.library.  Das dort selektierte File wird dem Stringgad-
  598.             get des Option-Requesters übergeben.
  599.  
  600.  
  601.  
  602. ===========================================================================
  603.                   Fehlermeldungen, Häufige Fragen, Tips...
  604.                   ========================================
  605.                                I N H A L T
  606. ===========================================================================
  607.  
  608. Fragen zur Installation:
  609.  
  610.     Die Libraries........................................ 1.1
  611.     Wie ändere ich die startup-sequence ?................ 1.2
  612.  
  613. Fragen zum Start HDClicks:
  614.  
  615.     Configfile nicht gefunden............................ 2.1
  616.     HDClick wird gestartet, nichts passiert.............. 2.2
  617.  
  618. Fragen zu den Programm-Gadgets/Programmstarts:
  619.  
  620.     Mehrere Befehle mit einem Gadget starten (Stack, CD,
  621.     Assign usw., danach das Programm).................... 3.1
  622.     Ein Gadget wird angeklickt, nichts passiert.......... 3.2
  623.     Ein Gadget wird angeklickt, HDClick "verschwindet"
  624.     trotz "Run"-Modus.................................... 3.3
  625.  
  626. Allgemeines und Erklärungen zu Configfile-Fehlern........  4
  627.  
  628. Bekannte Bugs............................................  5
  629.  
  630. Spezial-Beispiele für Configfiles........................  6
  631.  
  632. ===========================================================================
  633.  
  634.                        (1) Fragen zur Installation
  635.                            =======================
  636.  
  637. (1.1) Die Libraries
  638.       -------------
  639.  
  640. Damit  alle Funktionen HDClicks benutzt werden können, müssen sich die "KD_
  641. FReq.library" und die "Color.library" im LIBS:  Verzeichnis  der  Boot-Dis­
  642. kette  (also  in  SYS:)  befinden. Die beiden Libraries werden zusammen mit
  643. HDClick vertrieben. Mit dem beiliegenden Installations-Programm werden  die
  644. beiden  Libs  installiert. Wird eine andere Boot-Diskette oder Harddisk be­
  645. nutzt, müssen die Libs nochmals installiert werden. Werden die  Libs  nicht
  646. gefunden,  sind die Gadgets "Filerequester" und "Color-requester" nicht an­
  647. wählbar, HDClick startet aber dennoch.
  648.  
  649. (1.2) Wie ändere ich eine Startup-Sequence ?
  650.       --------------------------------------
  651.  
  652. Dieses Thema gehört eigentlich nicht in diese  Anleitung,  sondern  in  ein
  653. Amiga-Dos-Hanbuch.  Da  ich manchmal danach gefragt werde, erläutere ich es
  654. hier. Als erstes öffnet man ein CLI oder Shell. Nun  tippt  man  folgendes:
  655. "SYS:c/ed  SYS:s/startup-sequence".  Der Editor ED lädt nun die startup-se-
  656. quence.  Nun  fügt  man  an  gewünschter Stelle folgendes ein: "SYS:HDClick
  657. SYS:s/HDCConfig". Jetzt drückt man die Esc-Taste und X.  ED  speichert  nun
  658. die geänderte Datei. Damit das funktioniert, muss sich das Programm HDClick
  659. auf  SYS: ,also der Bootdisk/HD (z.B. in df0: oder dh0:) und das Configfile
  660. "HDCConfig" im SYS:S befinden. Falls jetzt beim booten was  nicht  funktio­
  661. niert...Keine Panik undmich anrufen/mir schreiben...
  662.  
  663.                      (2) Fragen zum Start HDClicks
  664.                          =========================
  665.  
  666. (2.1) Configfile nicht gefunden
  667.       -------------------------
  668.  
  669. HDClick sucht nicht automatisch im S: nach einem Configfile. Befindet  sich
  670. ein  Configfile  nicht  im  aktuellen Verzeichnis, muss das Configfile-Ver­
  671. zeichnis beim Start HDClicks (oder bei Menüwechseln) angegeben werden. Bei­
  672. spiel: File HDCConfig im  Verzeichnis  dh0:s.  HDClick  muss  mit  "HDClick
  673. dh0:s/HDCConfig"  gestartet  werden, resp. der Menüeintrag muss "dh0:s/HDC­
  674. Config" lauten, nicht nur HDClick HDCConfig resp. "HDConfig".
  675.  
  676. (2.2) HDClick wird gestartet, nichts passiert
  677.       ---------------------------------------
  678.  
  679. Wird HDClick gestartet, jedoch kein Screen/Fenster geöffnet,  kann  das  an
  680. folgendem liegen. HDClick wird laut Configfile Iconified oder Small gestar­
  681. tet. Die Fenster-Koordinaten sind jedoch unkorrekt, also z.B. zu gross. Ist
  682. das der Fall, muss das Configfile (notfalls mit einem Texteditor)  geändert
  683. werden. Es könnte jedoch auch sein, dass ein grosser Configfile-Fehler vor­
  684. liegt. HDClick könnte an dieser Stelle auch abstürzen (sorry).
  685.  
  686. Natürlich öffnet HDClick kein Window, wenn der Starmodus "Iconify" lautet
  687. und der Iconify-Modus auf "Hotkey" gestellt wurde. Mit der HELP-Taste gelangt
  688. man zu HDClick zurück.
  689.  
  690.            (3) Fragen zu den Programm-Gadgets/Programmstarts
  691.                =============================================
  692.  
  693. (3.1) Mehrere Programme mit EINEM Gadget starten
  694.       ------------------------------------------
  695.  
  696. Verlangt ein Programm eine CD, Assign oder Stack-änderung vor dessen Start,
  697. kann  dies einfach mit dem "Config_Tool" von Manfred Gillert bewerkstelligt
  698. werden. Das Config_Tool wird zusammen mit HDClick vertrieben. Müssen andere
  699. Programme statt CD, Assign oder Stack miteinander  gestartet  werden,  ge­
  700. schieht  dies  mithilfe einer Batch-Datei. Wie man eine Batchdatei erzeugt,
  701. steht im AmigaDos-Teil des Amiga Benutzerhandbuchs, ich  beschreibe  es  an
  702. dieser Stelle jedoch auch kurz.
  703.  
  704. Man  öffnet  ein  CLI  oder  Shell und tippt darin folgendes ein: "Sys:c/ED
  705. s:Irgendeinname". Der Editor ED erzeugt das File "Irgendeinname". Nun trägt
  706. man die zu startenden Programme nacheinander ein (pro Programm eine  Zeile)
  707. und  drückt  zuerst  die  Esc, dann die X-Taste zum Speichern. Nun lädt man
  708. HDClick, gehe in den EDIT-Modus und klicke ein leeres Gadget an. Man drückt
  709. auf das Gadget "Filerequester" und selektiert das  File  "s:Irgendeinname".
  710. Jetzt muss man folgendes ergänzen. Vor dem Filenamen gibt man "sys:c/Execu­
  711. te"  ein. Im Stringgadget steht also folgendes: "Sys:c/Execute s:Irgendein­
  712. name". Jetzt noch einen Gadgettitel und einen  Modus  (Launch,Run,  Execute
  713. oder  Option)  und  SAVE.  Nach Anklicken dieses Gadgets werden alle in der
  714. Batchdatei aufgeführten Programme hintereinander gestartet.
  715.  
  716. (3.2) Ein Gadget wird angeklickt, nichts passiert
  717.       -------------------------------------------
  718. Passiert nichts, kann dies verschiedene Gründe haben:
  719. Das Gadget besitz keinen Modus (also den Modus "None"). Mit der  EDIT-Funk­
  720. tion abändern.
  721. Das  zu startende Programm wurde nicht gefunden, oder das zu startende Pro­
  722. gramm wurde  falsch  aufgerufen.  Fehlermeldungen  werden  nicht  sichtbar,
  723. da  HDClick seine Ausgaben ins Nil: macht. Das Programm "SnoopDos" von Eddy
  724. Carroll hilft einem bei der Fehlersuche.
  725.  
  726. (3.3) Ein Gadget wird angeklickt, HDClick "verschwindet" trotz "Run"-Modus
  727.       --------------------------------------------------------------------
  728.  
  729. Hier wurden falsche Fenster-Koordinaten für das  Iconify-Fenster  eingetra­
  730. gen. Sind die Koordinaten zu hoch, wird kein Fenster sichtbar. Zuerst jedoch
  731. kontrollieren, ob in den Prefs nicht "Hotkey" für Iconify angegeben wurde.
  732. Wenn dies der Fall ist, kommt man mit der Help-Taste wieder zu HDClick zu-
  733. rück.
  734.  
  735.  
  736.                           (4) Configfile-Fehler
  737.                               =================
  738.  
  739.   Error:                                   Fehler (-Beseitigung)
  740.   -----                                    --------------------
  741.  
  742. - Titel überschneiden sich               - Einer der Gadgettitel ist
  743.                                            länger als 16 Zeichen.
  744. - Im Gadgettitel steht das, was man      - Es wurde wahrscheinlich ein
  745.   als Programm oder Modus eingetra-        Komma vergessen.
  746.   gen hat. (z.B. als Titel ",r")
  747. - Einer od. mehrere Spalten-Titel        - Zuwenig Einträge im Config-
  748.   erscheinen nicht.                        file.
  749. - Es werden nach Anklicken eines Gad-    - Zuwenig Einträge im Config-
  750.   gets falsche Programme oder sogar        file, oder es wurde ein
  751.   Gadgettitel "ausgeführt".                Komma vergessen.
  752. - Nach Speichern eines Configfiles       - Bei zu langen Einträgen
  753.   sind Titel nicht mehr korrekt            speichert HDClick nicht das
  754.                                            gewünschte. (Kein Programmier-
  755.                                            fehler!)
  756.  
  757. - "Fehler beim Speichern"-Requester      - Das File konnte nicht gespei-
  758.   erscheint.                               chert werden. (DOS-Error).
  759.  
  760. - "Configfile nicht gefunden"            - Das Configfile ist entweder
  761.                                            nicht vorhanden oder der
  762.                                            dazugehörige Eintrag im Config-
  763.                                            file ist falsch. Das Config-
  764.                                            file wurde von DOS nicht
  765.                                            gefunden.
  766.  
  767.  
  768. Es kommt auch zu Fehlern, wenn in einem Programmnamen oder einem Titel Kom­
  769. mas vorkommen. (-> entfernen ).
  770.  
  771.                         (5) Bekannte Bugs
  772.                             -------------
  773. Hier eine "Liste" der mir bekannten (kleinen) Fehler.
  774.  
  775. Dass  kein  Iconify/Small-Fenster  erscheint, wenn zu hohe Daten eingegeben
  776. werden, liegt daran, dass  nicht  alle  mit  der  normal-Auflösung  640*256
  777. arbeiten.  Wer  grössere  Screens geöffnet hat, muss auch höhere Daten ein-
  778. geben, also wäre eine Abfrage nicht möglich (ausser ich könnte die  Screen-
  779. grösse  Feststellen).  Sobald ich die Möglichkeit habe, unter OS2.0 zu pro­
  780. grammieren, wird dieser Bug entfernt.
  781.  
  782. Eine Farbe sollte nie die Werte 000 also schwarz haben, sonst kann es  Pro­
  783. bleme  beim  Speichern  geben.  Anstatt 000 nimmt man einfach 111, ist doch
  784. nicht so tragisch, oder ? Ich versuche schon lange, dieses Problem  zu  lö­
  785. sen, habe es aber noch nicht geschafft...
  786.  
  787. HDClick kann nur 1x im Speicher sein, also es darf nur ein HDClick  gestar-
  788. tet werden. Befindet sich schon eines im Speicher und  wird  versucht,  ein
  789. zweites zu starten, wird das zweite nicht gestartet.
  790.  
  791. Folgender Fehler trat bei mir nicht auf, sah ihn jedoch bei andern. Wird die
  792. KD_FREq und/oder die Color.library nicht installiert und HDClick trotzdem
  793. gestartet, erhält das Prefs-Window ein paar Gadgets mehr, was nicht sehr
  794. schön aussieht. Ein mir bekannter Fehler ist allerdings, dass im selben
  795. Falle das Filereq-Gadgets des Edit-Window nicht geghostet wird und HDClick
  796. nach Anklicken dieses Gadgets abstürzt...Autsch. Mein Kommentar dazu:
  797. INSTALLERT DIESE LIBS !
  798.  
  799.                        (6) Spezial-Beispiele
  800.                            -----------------
  801.  
  802. Hier ein paar Beispiele für Einträge im Configfile.
  803.  
  804. (Programm,Titel,Modus)
  805.  
  806. dh0:c/execute s/WB-Batch,Workbench,l    -> Die Batchdatei s/WB-Batch wird
  807.                                            ausgeführt und HDClick nach
  808.                                            Programmstart beendet.
  809.                                            Gadgettitel "Workbench".
  810.  
  811. graphik/Paint,Photolab,o                -> Zuerst erscheint der Requester
  812.                                            mit Stringgadget. Wird eines
  813.                                            der drei Gadgets gedrückt, wird
  814.                                            das Programm "paint" im Ver-
  815.                                            zeichnis "graphik" gestartet.
  816.                                            Wurde im Stringgadget ein File-
  817.                                            name eingegeben,(z.B.
  818.                                            "Pictures/pic"), lädt das Mal-
  819.                                            programm "Paint" das Bild
  820.                                            "Pictures/pic".
  821.                                            Gadggettitel "Photolab".
  822.  
  823. Dh0:s/GamesConfig,GAMES,m               -> Das Configfile "GamesConfig"
  824.                                            im S-Verzeichnis von dh0: wird
  825.                                            geladen. Alle Gadgets werden
  826.                                            nun nach diesem Configfile
  827.                                            definiert.
  828.  
  829. dh0:s/HDCConfig,Reload Config,m        ->  Lädt das Configfile nochmals,
  830.                                            um eventuell mit einem Editor
  831.                                            geänderte Daten sichtbar zu
  832.                                            machen.
  833.  
  834.  ,Execute Command,o
  835. |                 |
  836. Kein Eintrag !    Requester wird geöffnet
  837.  
  838. ->  Ein  spezielles  ,  aber sehr nützliches Beispiel. Bei Anklicken dieses
  839. Gadgets geschieht folgendes : Der Requester wird geöffnet. Jetzt tippt  man
  840. ins  Stringgadget anstatt einen Parameter einen Programmnamen ein. Nach an­
  841. klicken eines der drei Gadgets (Launch,Run,Execute)wird der Text im String­
  842. gadget ,wie schon erwähnt, an den des  Configfile-Eintrags  ange-hängt.  Da
  843. bei  diesem Beispiel aber kein Eintrag an dieser Stelle gemacht wurde, wird
  844. der im Stringgadget eingetippte Befehl ausgeführt.
  845.  
  846. Am besten man editiert das Beispiels-Configfile (HDCConfig) in diesem  Ver­
  847. zeichnis und trägt seine eigenen Daten ein.
  848.  
  849. -------------------------------------------------------------------------
  850. 27.1.92                                                   Claude Müller
  851.