home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d4xx / d497 / newshellcx / newshellcx_d.dok < prev    next >
Text File  |  1991-06-06  |  9KB  |  221 lines
  1.  
  2.                              NewShellCX_D
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. -----------------------------
  20. Mit  NewShellCX_D  (das  _D  für  die  deutsch Version) können Sie per
  21. Tastendruck  eine neue Shell öffnen oder ein anderes Programm starten.
  22. Die  Tastenkombination  und das zu startende Programm können Sie fest-
  23. legen.
  24.  
  25. Systemanforderungen:
  26. --------------------
  27. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  28. 37.*.   Bitte prüfen Sie dies, indem Sie in der Shell Version eingeben
  29. oder  im  Workbench  Menü  About  aufrufen.   Außerdem  muß  sich  die
  30. commodities.library  in Ihrem Verzeichnis libs:  befinden.  Überprüfen
  31. Sie  dies  bitte,  indem  Sie  in  der  Shell  den  Befehl "dir libs:"
  32. eingeben.
  33.  
  34. Und so startet man ein Commodity:
  35. ---------------------------------
  36. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  37. starten:  von der Workbench oder von der Shell aus.
  38.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  39. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  40. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  41. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  42. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  43. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  44. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  45. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  46. Commodity ändern können, wird später beschrieben.
  47.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  48. Commoditys,  während es bereits läuft, bewirkt, daß das Commodity 
  49. beendet  wird.   Da  es  nicht  sinnvoll wäre NewShellCX_D zweimal zur
  50. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.
  51.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  52. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  53. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  54. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  55. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  56. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  57. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  58. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  59. ein ?  als ersten Parameter angeben:
  60.  
  61.                             NewShellCX_D ?
  62.  
  63. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  64. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  65. erreicht man wiederum, daß es beendet wird.
  66.  
  67.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  68. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  69. einfügen:
  70.  
  71.                Run >NIL: <Pfad>NewShellCX_D <Optionen>
  72.  
  73. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  74. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  75. anzugeben.   Folgendes  Beispiel startet NewShellCX_D, wenn es sich
  76. im  Schubladen  Tools  der  Boot-Diskette  befindet:
  77.  
  78.                      Run >NIL: Tools/NewShellCX_D
  79.  
  80.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  81. starten,  ist,  das  Icon von NewShellCX_D in den Schubladen WBStartup
  82. der Boot-Diskette (Workbench) zu verschieben.  Das Commodity wird dann
  83. bei jedem Boot-Vorgang gestartet, als hätten Sie einen Doppelklick auf
  84. das  Icon  durchgeführt.   Allerdings müssen Sie im Icon das Tool-Type
  85. DONOTWAIT ergänzen.
  86.  
  87. Das  war  die  allgemeine Beschreibung, wie man ein Commodity started.
  88. Will  man  aber mit NewShellCX_D eine neue Shell öffnen, ist ein Start
  89. über  die  Workbench (oder über WBStartup) generell nicht praktikabel.
  90. Denn  dann wird der Pfad, der in der startup-sequence und eventuell in
  91. Ihrer  User-Startup Datei eingestellt wird, nicht an die neu geöffnete
  92. Shell vererbt.  Wenn Sie nicht in der Datei Shell-Startup den Pfad mit
  93. Path neu einstellen wollen, ist die einzige Lösung NewShellCX_D in der
  94. User-Startup  zu  starten.   Wenn  Sie in Ihrer User-Startup Datei den
  95. Pfad  mittels  Path  verändern,  so  müssen  Sie  dies  tun, bevor Sie
  96. NewShellCX starten.
  97.  
  98. Benutzung von Exchange:
  99. -----------------------
  100. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  101. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  102. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  103. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  104. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  105. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  106. Titel, Beschreibung und Status angezeigt.
  107.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  108. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  109. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  110. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  111. "Show"  öffnen  lassen  und mit "Hide" schließen lassen.  NewShellCX_D
  112. hat kein Fenster.
  113.  
  114.  
  115.                        Veränderbare Parameter:
  116.                        -----------------------
  117.  
  118. CX_Priority:
  119. ------------
  120. Mit  dem  Tool-Type  oder der Befehlsoption CX_PRIORITY=<p> können Sie
  121. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  122. bestimmen.   Setzen  Sie  für <p> bitte einen positiven dezimalen Wert
  123. ein. Die voreingestellte Priorität ist 0.
  124.  
  125. TASTE:
  126. ------
  127. Mit  dem  Tool-Type  oder der Befehlsoption TASTE=<Eingabe> können Sie
  128. die  Tastenkombination  bestimmen,  die  das  Kommando ausführen soll.
  129. <Eingabe>  ist  eine  Eingabebeschreibung, wie sie unten erklärt wird.
  130. Voreingestellt ist "TASTE=lcommand esc" (linke Amiga-Taste und ESC).
  131.  
  132. Beispiele:
  133.  
  134.     NewShellCX_D "taste=ralt help"
  135.     NewShellCX_D "taste=lcommand m"
  136.     NewShellCX_D "taste=f1"
  137.  
  138.  
  139. KOMMANDO:
  140. ---------
  141. Mit  dem  Tool-Type oder der Befehlsoption Kommando=<Datei> können Sie
  142. die  Datei  spezifizieren,  die  mit  der Tastenkombination ausgeführt
  143. werden  soll.   <Datei>  ist  der  Pfad  und  der  Name  zu der Datei,
  144. eventuell  mit  Parametern,  genauso  wie Sie es in der Shell eingeben
  145. würden.   Voreingestellt  ist  KOMMANDO=NewShell,  was eine neue Shell
  146. öffnet.
  147.  
  148. Beispiele:
  149. NewShellCX_D "Kommando=NewShell CON:0/0/640/200/MyShell/CLOSE FROM s:Shell-Startup"
  150. NewShellCX_D "kommando=c:NewWSH"
  151. NewShellCX_D "kommando=Tools:ClickDOS_II"
  152.  
  153.  
  154.  
  155.                         Eingabebeschreibungen
  156.                         ---------------------
  157.                      (input description strings)
  158.  
  159. Mit   Eingabebeschreibungen   können   Sie   fast  jede  Eingabeaktion
  160. beschreiben,  z.B.   die Aktion lshift f1.  Dies heißt, daß die Aktion
  161. das drücken der Taste F1 zusammen mit der linken Shift-Taste ist.  Bei
  162. diesem Commodity öffnet die Aktion das Fenster des Commoditys.
  163.  
  164. Eingabebeschreibungen haben folgendes Muster:
  165.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  166.  
  167. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  168.  
  169. class   ("Klasse") ist einer der folgenden Ausdrücke:
  170.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  171.         diskremoved, diskinserted.
  172.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  173.  
  174. qual    (qualifier, "Qualifizierer") ist einer der folgenden Ausdrücke:
  175.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  176.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  177.         relativemouse
  178.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  179.         als irrelevant angenommen werden soll.
  180.  
  181. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  182.         shift bedeutet linke oder rechte Shift-Taste
  183.         caps bedeutet Shift oder Caps-Lock
  184.         alt bedeutet linke oder rechte Alt-Taste
  185.  
  186. upstroke (wörtlich "upstroke")
  187.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  188.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  189.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  190.         voran, so zählt beides.
  191.  
  192. highmap ist einer der folgenden Ausdrücke:
  193.         comma, space, backspace, tab, enter, return, esc, del, up, down,
  194.         right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10,
  195.         0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  196.  
  197. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  198.         Taste
  199.  
  200.  
  201.  
  202.  
  203.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  204.      -----------------------------------------------------------
  205.                            Geschenke(!) an:
  206.                            ----------------
  207.  
  208.                             Stefan Sticht
  209.                           Bibereckerweg 40a
  210.                            D-8390 Passau 18
  211.                                  FRG
  212.  
  213. oder (besser) an eine der folgenden EMail-Adressen:
  214. Internet: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht@rutgers.EDU
  215.       or: IWSTICHT@ibm.rz.uni-passau.de
  216. Fido-Net: Stefan Sticht (2:242/16)
  217.  
  218. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  219. Diese erhalten Sie z.B. mit dem Befehl "Version":
  220.                      Version [<path>]<commodity>
  221.