home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / dirutils / visualshell / readme.german < prev    next >
Text File  |  1992-10-28  |  14KB  |  293 lines
  1.         Visual Shell (VSh) v1.17
  2.         ========================
  3.  
  4. Copyright:
  5. ----------
  6.  
  7.       © Copyright 1992, Freeware, All rights reserved
  8.  
  9.    Dieses Programm darf AUSSCHLIESSLICH über die PD-Bibliothek von Fred Fish
  10.    verbreitet werden. Eine Verbreitung via FTP ist jedoch erlaubt und auch
  11.    erwünscht. Jede andere Vertriebsform bedarf der schriftlichen Genehmigung
  12.    des Autors.
  13.    Die Benutzung des Programms erfolgt auf eigene Gefahr. Für Schäden,
  14.    welche aufgrund der Verwendung dieses Programms entstehen, wird keinerlei
  15.    Haftung übernommen.
  16.  
  17.  
  18. Vorwort:
  19. --------
  20.  
  21. Mit VSh soll versucht werden, dem Amiga-User ein Hilfsprogramm in die Hand zu
  22. geben, welches ihm die Arbeit im CLI bzw. unter einer Shell erleichtert.
  23. Hierfür vereint es die Vorzüge von verschiedenen Directory-Utilities, wie
  24. z.B. DiskMaster, und die Flexibilität des CLI in einem Programm. Da es
  25. Directory-Tools auf dem Amiga, insbesondere in der PD-Szene, schon reichlich
  26. gibt, wurde für VSh ein anderer Weg gewählt, denn VSh sollte nicht ein
  27. Abklatsch dieser 'Klick-Hier-Klick-Da-Programme' werden. Während die
  28. Directory-Utilities meist einen eigenen Screen bzw. ein neues Window auf dem
  29. Workbench-Screen eröffnen und darauf jegliche Aktivität mit der Maus
  30. erfolgt, so benutzt VSh das aktuelle CLI-Window und wird ausschließlich
  31. durch Tastaturkommandos gesteuert. Als großes Vorbild diente hierfür das
  32. bekannte Hilfsprogramm Norton Commander unter MS-Dos.
  33.  
  34.  
  35. Informationen zu VSh:
  36. ---------------------
  37.  
  38. VSh kann von jedem beliebigen CLI bzw. Shell gestartet werden.  Hierbei ist
  39. es völlig egal, ob es sich dabei um WShell, AShell, NewShell oder das
  40. normale CLI handelt, Voraussetzung ist lediglich, daß für das entsprechende
  41. Console-Window der Shareware-Console-Device-Handler ConMan von William S.
  42. Hawes benutzt wird und in LIBS: sich die ARP-Library befindet. VSh teilt
  43. sich für seine Ausgabe das Window mit dem CLI bzw. der Shell, von der es
  44. gestartet wurde. Hierbei verhält es sich so transparent, daß mit diesem CLI
  45. genauso wie bisher weitergearbeitet werden kann. Außerdem ist VSh voll
  46. multitasking-fähig, so daß es auch in verschiedenen CLI-Windows gleichzeitig
  47. installiert werden kann. Der durch die VSh-Ausgaben verkleinerte
  48. CLI-Ausgabebereich lässt sich durch Tastendruck wieder auf (fast) die
  49. Normalhöhe vergrößern. Zur Befehlseingabe nutzt VSh lediglich die
  50. Funktionstasten, ESC, HELP und vom Zehnerblock die Tasten die bei allen drei
  51. Amiga-Modellen gleich sind. Falls andere CLI-Programme, wie z.B. FComp,
  52. ebenso diese Tasten benötigen, so sollte man, insofern wie bei FComp möglich,
  53. deren Kommandotasten ändern oder man kann in Verbindung mit der Control-Taste
  54. die Kommandotasten am Input-Event-Handler von VSh vorbeileiten und somit
  55. wieder deren normale Belegung erhalten. Zusätzlich lassen sich mit der
  56. NumLock-Funktion von VSh die umfunktionierten Tasten des Zehnerblocks wieder
  57. zur Zahleneingabe benutzen. Weiterhin kann man jederzeit mit Hilfe des
  58. durch <SHIFT+ALT+HELP> abrufbaren Konfigurationsmenüs VSh weitgehend in
  59. seiner Darstellung bzw. Funktion beeinflußen, so sind z.B. die Position und
  60. die Größe des CLI-Windows, die Anzahl der CLI-Zeilen, sowie die Belegung der
  61. frei definierbaren Funktionstasten änderbar. Das veränderte CLI-Window wird
  62. nach Verlassen von VSh natürlich wieder in seinen Originalzustand
  63. zurückversetzt. Wird im aktiven Filerequester der Pfadname geändert, so
  64. ändert man damit auch gleich das aktuelle Verzeichnis (current directory)
  65. des CLI's von dem VSh gestartet wurde, als ob man den CD-Befehl eingesetzt
  66. hätte (implicit CD). Umgekehrt wird aber auch der Pfadname im aktuellen
  67. Filerequester geändert, falls man mit dem CD-Befehl das aktuelle Verzeichnis
  68. wechselt. VSh macht im übrigen extensiven Gebrauch von der Arp-Library des
  69. AmigaDos-Resource-Projects, welches von verschiedenen Amiga-Programmierern
  70. zusammen gestartet wurde. Es wird die Arp-Library mindestens in der Version
  71. 39.1 benötigt! Im übrigen unterstützt VSh auch CommandLine-Argumente und das
  72. Standard-AmigaDOS-Keyword '?' (Aufruf: vsh ?), mit welchem man nähere Infos
  73. zu den erlaubten Argumenten erhält (command line template). Beispielsweise
  74. kann mit der Option HIDE VSh aus einer Batchdatei derart aufgerufen werden,
  75. daß VSh sich sofort im 'Hide'-Modus, wo beide Filerequester nicht sichtbar
  76. sind, befindet.
  77.  
  78. Vsh besteht im übrigen aus zwei Teilen. Der erste Teil sollte sich im
  79. Verzeichnis c: befinden und trägt den Name 'VSh'. Der zweite Teil, das
  80. eigentliche Hauptprogramm, sollte sich im Verzeichnis l: befinden und trägt
  81. den Namen 'VShSegment'. Der residente Teil kann mit der Option REMOVE wieder
  82. aus dem Speicher entfernt werden.
  83.  
  84.  
  85. Funktionstastenbelegung:
  86. ------------------------
  87.  
  88. F1  = Ein- bzw. Ausschalten der beiden Filerequester
  89. F2  = Angezeigemodus, CursorPosition und kompletten Pfadnamen vom
  90.       aktiven Filerequesters in den nicht aktiven Filerequester
  91.       duplizieren
  92. F3  = die Datei unter dem Cursor wird als Hex- bzw. ASCII-Dump angezeigt
  93. F4  = die Datei unter dem Cursor wird editiert
  94. F5  = das Objekt unter dem Cursor bzw. die markierten Objekte werden
  95.       kopiert; wird nur das Objekt unter dem Cursor kopiert, so kann
  96.       diesem auch gleichzeitig noch ein neuer Namen gegeben werden
  97. F6  = das Objekt unter dem Cursor bzw. die markierten Objekte werden in
  98.       ein anderes Verzeichnis, welches sich auch auf einer anderen Disk
  99.       befinden kann (dann Move, sonst Rename), bewegt; wird nur das
  100.       Objekt unter dem Cursor bewegt, so kann diesem auch gleichzeitig
  101.       noch ein neuer Namen gegeben werden
  102. F7  = neues Directory erzeugen
  103. F8  = das Object unter dem Cursor bzw. alle markierten Objekte löschen
  104. F9  = den Kommandozeilenspeicher von ConMan anzeigen
  105. F10 = VSh verlassen
  106. F11 = alle sektororientierten Devices, Volume-Namen und Assigns im
  107.       aktiven Filerequester anzeigen
  108. F12 = Informationen über das Verzeichnis vom nicht aktiven
  109.       Filerequester im aktiven Filerequester anzeigen
  110. F13 = Inhalt des Objektes unter dem Cursor im nicht aktiven
  111.       Filerequester als Hex-ASCII-Dump im aktiven Filerequester anzeigen
  112. F14 = Suchen von Objekten, für welche die eingegebene Pattern zutrifft,
  113.       ab dem aktuellen Verzeichnis des aktiven Filerequesters
  114. F15 = Pattern angeben, nach der im aktiven Filerequester die Objekte des
  115.       Verzeichnisses angezeigt werden sollen
  116. F16 = ab dem Root-Directory des Verzeichnisses im aktiven Filrequester
  117.       wird der komplette Verzeichnisbaum aufgebaut; im Verzeichnisbaum
  118.       kann man dann mit ALT <Taste> zu bestimmten Einträgen springen und
  119.       mit ENTER kann ein neues Verzeichnis für den aktiven
  120.       Filerequester gewählt werden
  121. F17 = Vergleich der Inhalte beider Filerequester miteinander; im aktiven
  122.       Filerequester werden die zum nicht aktiven Filerequester
  123.       unterschiedlichen Files markiert
  124.  
  125. ALT F1
  126.  :      = frei definierbare Funktionstasten
  127. ALT F10
  128.  
  129. SHIFT ALT F1 = Ändern des Kommandos der frei definierbaren Funktionstasten,
  130.  :             hierbei gibt es folgende Sonderzeichen:
  131.  :                [] -> an dieser Stelle wird beim Aufruf der Pfadname der
  132.  :                      Datei unter dem Cursor eingesetzt
  133.  :                ;  -> die ersten 6 Zeichen nach dem Semikolon werden als
  134.  :                      neuer Name für die entsprechende Funktionstaste
  135.  :                      verwendet
  136.  :             Beispiel: run copy [] prt:;Print
  137. SHIFT ALT F10
  138.  
  139.  
  140. Funktionstastenbelegung bei View:
  141. ---------------------------------
  142.  
  143. F1  = zur eingegebenen Zeile im Text springen
  144. F2  = Zeichenkette im Text suchen; wenn das erste Zeichen der eingegebenen
  145.       Zeichenkette das Dollarsymbol $ ist, so wird die Zeichenkette als
  146.       Hex-Zahl interpretiert und danach gesucht (Texte sind case sensitive)
  147. F3  = mit gleicher Zeichenkette Suche fortsetzen
  148. F4  = Umschalten von Hex- nach ASCI-Dump bzw. umgekehrt
  149. F5  = angezeigte Seite im aktuellen Modus (Hex- bzw. ASCI-Dump) auf dem
  150.       Drucker ausgeben
  151. F6  = gesamten Text im aktuellen Modus (Hex- bzw. ASCI-Dump) auf dem Drucker
  152.       ausgeben
  153. F10 = View verlassen
  154.  
  155.  
  156. Funktionstastenbelegung bei History:
  157. ------------------------------------
  158.  
  159. F1  = zur eingegebenen Zeile im Kommandozeilenspeicher springen
  160. F2  = Zeichenkette im Kommandozeilenspeicher ab Cursorposition suchen
  161. F3  = mit gleicher Zeichenkette Suche ab Cursorposition fortsetzen
  162. F4  = angezeigte Seite des Kommandozeilenspeichers auf dem Drucker ausgeben
  163. F5  = gesamten Kommandozeilenspeicher auf dem Drucker ausgeben
  164. F10 = History verlassen
  165.  
  166.  
  167. Funktionstastenbelegung bei Configuration:
  168. ------------------------------------------
  169.  
  170. F1  = alte Konfigurationsdatei 's:VSh.Config' laden
  171. F2  = neue Konfigurationsdatei 's:VSh.Config' anlegen
  172. F3  = Standardkonfiguration einschalten
  173. F4  = eingestellte Konfiguration benutzen
  174. F10 = Configuration verlassen
  175.  
  176.  
  177. Belegung des Zehnerblocks:
  178. --------------------------
  179.  
  180. 1       = Cursor im aktiven Filerequester zum Ende der Liste bewegen
  181. 2       = Cursor im aktiven Filerequester um ein Object nach unten bewegen
  182. 3       = Cursor im aktiven Filerequester um eine Seite nach unten bewegen
  183. 4       = Parent-Directory des Verzeichnisses im aktiven Filrequester
  184.           anzeigen
  185. 5       = aktuelles Verzeichnis im aktiven Filrequester neu einlesen
  186. 6       = Verzeichnis unter dem Cursor im aktiven Filerequester einlesen
  187. 7       = Cursor im aktiven Filerequester zum Anfang der Liste bewegen
  188. 8       = Cursor im aktiven Filerequester um ein Object nach oben bewegen
  189. 9       = Cursor im aktiven Filerequester um eine Seite nach oben bewegen
  190. 0       = Markierung des Objektes unter dem Cursor im aktiven Filerequester
  191.           ändern
  192. .       = Namen des Objektes unter dem Cursor im aktiven Filerequester in
  193.           die Kommandozeile einsetzen (funktioniert nur in Verbindung mit
  194.           ConMan ab der Version 1.3)
  195. -       = Objekte im aktiven Filerequester durch Pattern markieren
  196.           (* markiert alle Objekte)
  197. ENTER   = Objekt unter dem Cursor im aktiven Filerequester einlesen
  198.       (Verzeichnis), starten (ausführbares Programm, anzeigen (kein
  199.       ausführbares Programm) oder an c:Execute übergeben (Skript-Datei)
  200. SHIFT 4 = Root-Directory des Verzeichnisses im aktiven Filrequester anzeigen
  201. SHIFT 6 = Verzeichnis unter dem Cursor in den nichtaktiven Filerequester
  202.           einlesen
  203. SHIFT 0 = Markierung aller Objekte im aktiven Filerequester löschen
  204. SHIFT . = kompletten Pfadnamen des Objektes unter dem Cursor im aktiven
  205.           Filerequester in die Kommandozeile einsetzen (funktioniert nur in
  206.           Verbindung mit ConMan ab der Version 1.3)
  207. SHIFT - = Markierung von Objekten im aktiven Filerequester durch Pattern
  208.           ausschalten (* schaltet Markierung von allen Objekten aus)
  209. ALT -   = Ein- bzw. Ausschalten des Zehnerblocks zur Zahleneingabe (NumLock)
  210.  
  211.  
  212. Weitere Tasten:
  213. ---------------
  214.  
  215. TAB            = Umschalten zwischen beiden Filerequestern, der gerade
  216.                  aktive Filerequester wird durch den umgefärbten Rahmen um
  217.                  den Pfadnamen angezeigt
  218. HELP           = Ausgabe eines Hilfstextes
  219. SHIFT HELP     = Ausgabe einer Copyright-Meldung
  220. SHIFT ALT HELP = Änderung der Konfiguration von VSh
  221. ALT <Taste>    = die Alt-Taste in Verbindung mit einer Buchstaben- bzw.
  222.                  Zahlentaste bewirkt, daß im aktiven Filerequester mit dem
  223.                  Cursor zu dem Objekt gesprungen wird, das mit diesem
  224.                  Buchstaben bzw. dieser Zahl beginnt; werden weitere Zeichen
  225.                  eingegeben, so wird der Cursor immer zu dem ersten Objekt
  226.                  bewegt auf den die gesamte Zeichenkette zutrifft; mit SHIFT
  227.                  RETURN bzw. SHIFT ENTER kann zum nächsten Objekt in der
  228.                  Liste gesprungen werden, auf den die Zeichenkette ebenfalls
  229.                  zutrifft
  230. ESC            = mit der ESC-Taste kann jede Funktion bzw. Eingabezeile,
  231.                  z.B. ALT <Taste>, verlassen werden und bewirkt das die
  232.                  entsprechende Funktion nicht ausgeführt wird (Cancel)
  233.  
  234.  
  235. Konfiguration von VSh:
  236. ----------------------
  237.  
  238. Left edge                = X-Position der linke oberen Ecke des VSh-Windows
  239. Top Edge                 = Y-Position der linke oberen Ecke des VSh-Windows
  240. Width                    = Breite des VSh-Windows
  241. Height                   = Höhe des VSh-Windows
  242. Number of CLI lines      = Anzahl der Zeilen für das CLI, dadurch wird die
  243.                            Höhe der beiden Filerequester, welche 14 Zeilen
  244.                            (Einträge) nicht unterschreiten darf, einge-
  245.                            schränkt
  246. Scroll speed             = Scroll-Geschwindigkeit (1 = langsam, 2 = normal,
  247.                            3 = schnell)
  248. Keyboard type            = verwendete Tastatur (1 = A1000, 2 = A500, A2000
  249.                            oder A2500)
  250. Dump mode                = dargestellte Zeichen bei View bzw. Quick View
  251.                            (1 = alle Zeichen, 2 = keine Kontroll-Zeichen
  252.                            [0-31 und 128-159], 3 = nur ASCII-Zeichen
  253.                            [32-126])
  254. Path for editor          = kompletter Pfadname des verwendeten Texteditors
  255. Options for editor       = Optionen für den verwendeten Texteditor
  256.  
  257.  
  258. Patterns unter VSh:
  259. -------------------
  260.  
  261. Es können unter VSh sowohl die AmigaDos- als auch die Unix-Wildcards (auch
  262. gemischt) benutzt werden, da hierfür die Pattern-Matching-Funktionen der
  263. Arp-Library verwendet werden (Patterns sind 'case sensitive' !!!).
  264.  
  265.    AmigaDos: # ? ( | )
  266.    Unix    : * ? ( | ) [ ] ~
  267.  
  268.    Beispiele: ~(*.info|*.INFO) = alle Dateien, welche NICHT die Endung
  269.                                   '.info' UND '*.INFO' besitzen, werden
  270.                                   angezeigt
  271.                *.[cC]            = alle Dateien mit der Endung '.c' ODER '.C'
  272.                                   werden angezeigt
  273.  
  274. Voraussetzungen:
  275. ----------------
  276.  
  277. - Shareware-Console-Handler `ConMan' v1.3+ von William S. Hawes
  278. - arp.library v39+
  279.  
  280.  
  281. Autor:
  282. ------
  283.  
  284.    Torsten Jürgeleit
  285.    Am Sandberg 4
  286.    W-5270 Gummersbach
  287.    Germany
  288.    Tel.: 02261/27400
  289.  
  290.    Per eMail erreichbar über: mike@miba.obb.sub.org
  291.    (Hierbei handelt es sich um den Account eines Kommilitonen, dadurch kann
  292.    es mit der Antwort einige Zeit dauern ;-)
  293.