home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / util / appcon-38.73.lha / AppCon / AppCon.dok < prev    next >
Text File  |  1994-05-14  |  5KB  |  143 lines
  1. $VER: AppCon v38.73 (14.5.1994)
  2. -------------------------------
  3.  
  4. PUBLIC DOMAIN
  5.  
  6. geschrieben 1993/1994 von Stephan Fuhrmann
  7.  
  8. Geschichte
  9. ~~~~~~~~~~
  10. v37.101: erste Veröffentlichung
  11. v37.105: Verbesserung - wenn Pfadnamen Leerzeichen enthalten, werden
  12.                         sie Ordnungsgemäß von Hochkommata umschlossen
  13. v37.129: Korrektur - es wurde vergessen, einige Speicherbereiche freizugeben
  14.          Verbesserung - benutzt EXEC Speicher-Funktionen
  15.          Verbesserung - wartet nun bis das Fenster wirklich aktiv ist
  16.          Verbesserung - benutzt input.device anstelle des console.device's,
  17.             um Ereignisse zu verschicken - wie's CBM empfielt
  18. v37.160: große Verbesserung - AppCon erkennt automatisch das Schließen
  19.             einer Shell und beendet sich still. AppCon ist
  20.                         jetzt 100% benutzerfreundlich!
  21.  
  22.      Korrektur - ein Problem verursachte Speicherverlust
  23. v37.177: Verbesserung - Code aufgeräumt & optimiert
  24. v38.16:  gefährlichen Fehler in OS 3.0 (OS 2.0?) entdeckt, wird jetzt
  25.                       geschickt umgangen
  26. v38.18:    Namen mit einem '+' am Ende werden nun auch von Hochkommata umschlossen
  27. v38.19:    Neu mit dem SAS/C 6.51 kompiliert
  28. v38.46:    StdIO durch DosIO ersetzt (kürzerer Code), automatisches Entfernen
  29.             eines bereits laufenden AppCon Prozesses
  30. v38.47:    einige Code-Optimierungen (danke Teijo!)
  31. v38.71:    C-Startupcode entfernt und durch eigenen kürzeren ersetzt
  32. v38.73:    aus versehen das Hochkomma-Feature umgedreht - behoben
  33.  
  34. Systemvoraussetzungen
  35. ~~~~~~~~~~~~~~~~~~~~~
  36. Release 2 des Betriebssystems oder höher
  37.  
  38. Einleitung
  39. ~~~~~~~~~~
  40. Der Amiga verfügt über zwei Benutzerschnittstellen: die Workbench und die
  41. Shell. Der professionelle Anwender muß zwischen diesen beiden Benutzer-
  42. schnittstellen oft wechseln, da jede ihre Vor- und Nachteil besitzt.
  43.  
  44. Als ich mal wieder von der Workbench zur Shell wechselte, bekam ich die
  45. Idee, daß meine Arbeit sehr viel einfacher sein könnte, wenn ich nur die
  46. Piktogramme von der Workbench in mein Shellfenster zöge und dann deren
  47. Pfadangabe in der Eingabezeile der Shell hätte. Genau das ist, was AppCon
  48. macht.
  49.  
  50. Es deklariert das aktuelle CON:-Fenster als AppWindow und ermöglicht es
  51. Ihnen so, Piktogramme mit der Maus in das Shellfenster fallen zu lassen.
  52. Der Name und Pfad des Piktogrammes werden in die aktuelle Kommandozeile
  53. eingefügt - so als hätten Sie ihn selbst eingegeben, nur sehr viel schneller!
  54.  
  55. Benutzung
  56. ~~~~~~~~~
  57. AppCon muß von der Shell geRUNt werden. Der beste Platz für den Aufruf
  58. von AppCon ist in Ihrer Shell-Startup, da Sie AppCon für *JEDES* Shellfenster
  59. separat aufrufen müssen.
  60.  
  61. Wenn Sie mehrere Piktogramme auf einmal in Ihre CON:-Fenster werfen, werden
  62. ihre Namen mit Leerzeichen getrennt. Namen, die Leerzeichen enthalten, werden
  63. von Hochkommata umschlossen, wie es der CBM-Standard vorsieht.
  64.  
  65. Wenn die Shell beendet wird und AppCon das letzte Programm ist, das auf
  66. dem CON:-Fenster läuft, bemerkt AppCon dies und beendet sich selbst ebenfalls.
  67. Sie müssen AppCon daher mit RUN starten, da es ansonsten das einzige mit
  68. dem CON:-Fenster laufende Programm wäre und sofort aussteigen würde.
  69.  
  70. AppCon überprüft periodisch, ob sein Shellfenster noch von anderen Programmen
  71. benutzt wird. Sie können die Zeit zwischen zwei Überprüfungen einstellen, indem
  72. Sie die TIMEOUT-Option in dem Argument von AppCon auf einen Wert setzen (Einheit
  73. sind Zehntelsekunden). Je größer der TIMEOUT-Wert ist, desto langsamer reagiert
  74. AppCon auf die Schließung der Shell, und mit geringeren TIMEOUT-Werten benötigt
  75. AppCon mehr CPU-Zeit. Der TIMEOUT-Wert wird in Zehntelsekunden angegeben,
  76. voreingestellt sind 10 Zehntelsekunden (also jede volle Sekunde).
  77.  
  78. Um AppCon wieder aus der aktuellen Shell zu entfernen genügt es, AppCon
  79. nochmal aufzurufen.
  80.  
  81. Beispielnutzung:
  82.  
  83. 1> Run AppCon TIMEOUT=12
  84.  
  85. ACHTUNG: Nochmals, Sie *MÜSSEN* den AmigaDOS 'Run'-Befehl benutzen, um
  86. AppCon zu starten, ansonsten steigt AppCon sofort aus.
  87.  
  88. Danksagung
  89. ~~~~~~~~~~
  90. Danksagungen fliegen zu Andy Finkel und Robert "Kodiak" Burns, die Ihren
  91. 'ConsoleWindow'-Quelltext vor einigen Jahrhunderten auf der Fish #35
  92. veröffentlichten. Ich benutze ihren Code, um den Zeiger auf mein
  93. CON:-Fenster zu erhalten.
  94.  
  95. Ein anderes Dankeschön bekommt das SAS Institute für die Entwicklung ihres
  96. tollen Compilers (kaufen!).
  97.  
  98. Spezielle Dank'-Dir's gehen an Chris, Jorrit & Stefan, die mir geholfen haben,
  99. die Lösung für das Fensterblockierproblem zu finden.
  100.  
  101. Ein Danke geht an Teijo für seine tollen Optimierungsvorschläge, die wirklich
  102. funktionierten!
  103.  
  104. Im Notfall
  105. ~~~~~~~~~~
  106. Wenn Ihr Rechner abstürtzt oder wenn dieses Programm nicht arbeitet,
  107. benachrichtigen Sie bitte den Autor mit einer exakten Erklärung über
  108. die Art der Benutzung des Programmes und einer präzisen Liste der
  109. Hardware/Software, die Sie benutzen.
  110.  
  111. Spenden
  112. ~~~~~~~
  113. ... sind immer willkommen.
  114.  
  115. Jokes
  116. ~~~~~
  117. Jetzt aber Shell!
  118.  
  119. Grüße
  120. ~~~~~
  121. Grüße gehen an:
  122.  
  123. Alex, Arto, Bernhard, Bjørn, Christian, Fred, Jehan-Yves, Jorrit, Kevin,
  124. Martin, Matze, Otti, Philipp, René, Stefan, Teijo, Thomas, Volker.
  125.  
  126. Technische Daten
  127. ~~~~~~~~~~~~~~~~
  128. Compiliert mit SAS/C v6.51, dem *BESTEN* Compiler für den Amiga.
  129. Hardware: A4000/040, 12 MByte Memory.
  130. Compilier-Zeit: ~27 Sekunden.
  131. Quelltextlänge:  702 Zeilen (ohne Includes).
  132. Programmlänge: 3864 bytes.
  133. Konsumierter Kaffee:  >10 cups.
  134.  
  135. Addresse des Autors
  136. ~~~~~~~~~~~~~~~~~~~
  137. Stephan Fuhrmann
  138. Erikstrasse 30
  139. 24837 Schleswig
  140. GERMANY
  141.  
  142. email: fury@doomsday.sh.sub.de
  143.