home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / appcon-38.73.lha / AppCon-38.73 / AppCon.doc < prev    next >
Encoding:
Text File  |  1994-05-14  |  4.7 KB  |  135 lines
  1. $VER: AppCon v38.73 (14.5.1994)
  2. -------------------------------
  3.  
  4. PUBLIC DOMAIN
  5.  
  6. written 1993/1994 by Stephan Fuhrmann
  7.  
  8. History
  9. ~~~~~~~
  10. v37.101: first release
  11. v37.105: improvement - when pathnames contain spaces
  12.                        they are enclosed with quotation marks
  13. v37.129: bug fix - forgot to free some memory
  14.          improvement - using exec memory functions
  15.          improvement - now waiting until the window is really activated
  16.          improvement - using input.device rather than console.device to send
  17.                        events following the recommendation of CBM
  18. v37.160:    major improvement - AppCon detects now automatically the closing of
  19.                        the shell and exits quietly - AppCon now is 100%
  20.                        user friendly!
  21.             bug fix - a problem caused memory loss, fixed
  22. v37.177:    improvement - cleaned & optimized up the code
  23. v38.16:  found a dangerous bug in OS 3.0, included a nice bypass
  24. v38.18:    names with a trailing '+' are enclosed with quotation marks, too
  25. v38.19:    recompiled with SAS/C 6.51
  26. v38.46:    replaced StdIO with DosIO (smaller code), autoremove existing AppCon
  27. v38.47:    some code optimizations (thx Teijo!)
  28. v38.71:    removed C-startupcode and replaced by my own, shorter code
  29. v38.73:    inverted the quotation mark feature by fault - fixed
  30.  
  31. System Requirements
  32. ~~~~~~~~~~~~~~~~~~~
  33. Release 2 of the OS or higher
  34.  
  35. Introduction
  36. ~~~~~~~~~~~~
  37. The Amiga has got two user interfaces:  the Workbench and the Shell.  The
  38. professional user has got to switch between these user interfaces very
  39. often because each one has got its advantages and disadvantages.
  40.  
  41. When I switched from Workbench to Shell once again I had the idea that my
  42. work could be much simpler when I could drag icons into the CON:-window and
  43. have their names displayed in the command line.  This is exactly what
  44. AppCon does.
  45.  
  46. It declares the actual CON:-window as an AppWindow and lets you drop your
  47. icons in this window.  Then the name and path of the icon are inserted
  48. into the current command line exactly as if you typed them with your
  49. keyboard, but slightly faster!
  50.  
  51. Usage
  52. ~~~~~
  53. AppCon must be RUNned from the Shell.  The best place to call AppCon is
  54. your shell-startup.  You've got to run AppCon for *EVERY* Shell-Window
  55. seperately.
  56.  
  57. If you drop multiple icons at once into your CON:-window the names will be
  58. seperated with spaces, names containing spaces are enclosed with quotation
  59. marks.
  60.  
  61. When the shell exits and AppCon is the only program that's using the
  62. CON-window, AppCon will detect this and exit nicely, too.  You must RUN
  63. AppCon, otherwise it would exit at once because it would be the only
  64. program that's using the CON-window.
  65.  
  66. AppCon periodically checks whether its Shell window is still being used.
  67. You can modify the time between two checks by setting the TIMEOUT-option in
  68. the command line of AppCon.  When using AppCon, you'll see that with a
  69. higher TIMEOUT the Shell window will react slower on closing commands, and
  70. with a lower TIMEOUT AppCon will consume more CPU ticks.  The TIMEOUT is in
  71. tenths of a second, this means that a timeout of 10 (default) will force
  72. AppCon to check every second whether the shell is still in use.
  73.  
  74. Simply start AppCon again to remove it from the current shell.
  75.  
  76. Example Use:
  77.  
  78. 1> Run AppCon TIMEOUT=12
  79.  
  80. NOTE:  Again, you *MUST* use the AmigaDOS 'Run' to start AppCon, otherwise
  81. it will exit immediately!
  82.  
  83. Thanks
  84. ~~~~~~
  85. Thank-you's fly to Andy Finkel and Robert "Kodiak" Burns who have released
  86. their 'ConsoleWindow' some centuries ago on Fish #35 with the source code.
  87. I'm using their code to find out the window pointer for my CON:-window.
  88.  
  89. Another big thank-you flies to the SAS Institute for developing their great
  90. compiler (buy it!).
  91.  
  92. Special thanks go to Chris, Jorrit & Stefan who helped me to find the
  93. sollution for the window-blocking-problem.
  94.  
  95. Thanks to Teijo for some great optimization proposals that really worked!
  96.  
  97. In Case Of Trouble
  98. ~~~~~~~~~~~~~~~~~~
  99. If your machine crashes or when this program doesn't work please contact
  100. the author with an exact explanation of the way you used the program and a
  101. precise listing of the hardware/software you're using.
  102.  
  103. Donations
  104. ~~~~~~~~~
  105. ... are always welcome!
  106.  
  107. Jokes
  108. ~~~~~
  109. Jetzt aber Shell!
  110.  
  111. Greetings
  112. ~~~~~~~~~
  113. Greetings go to:
  114.  
  115. Alex, Arto, Bernhard, Bjørn, Christian, Fred, Jehan-Yves, Jorrit, Kevin,
  116. Martin, Matze, Otti, Philipp, René, Stefan, Teijo, Thomas, Volker.
  117.  
  118. Technical Data
  119. ~~~~~~~~~~~~~~
  120. Compiled using SAS/C v6.51, the *BEST* compiler for the Amiga.
  121. Hardware: A4000/040, 12 MByte Memory.
  122. Compilation time: ~27 seconds.
  123. Source length:  702 lines (without includes).
  124. Executable length: 3864 bytes.
  125. Coffee consumed:  >10 cups.
  126.  
  127. Author's Address
  128. ~~~~~~~~~~~~~~~~
  129. Stephan Fuhrmann
  130. Erikstrasse 30
  131. 24837 Schleswig
  132. GERMANY
  133.  
  134. email: fury@doomsday.sh.sub.de
  135.