home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d953 / appcon.lha / AppCon / AppCon.doc < prev    next >
Text File  |  1993-10-13  |  4KB  |  124 lines
  1. $VER: AppCon v37.177 (13.10.1993)
  2. ---------------------------------
  3.  
  4. PUBLIC DOMAIN
  5.  
  6. written 1993 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.  
  24. System Requirements
  25. ~~~~~~~~~~~~~~~~~~~
  26. Release 2 of the OS or higher
  27.  
  28. Introduction
  29. ~~~~~~~~~~~~
  30. The Amiga has got two user interfaces:  the Workbench and the Shell.  The
  31. professional user has got to switch between these user interfaces very
  32. often because each one has got its advantages and disadvantages.
  33.  
  34. When I switched from Workbench to Shell once again I had the idea that my
  35. work could be much simpler when I could drag icons into the CON:-window and
  36. have their names displayed in the command line.  This is exactly what
  37. AppCon does.
  38.  
  39. It declares the actual CON:-window as an AppWindow and lets you drop your
  40. icons in this window.  Then the name and path of the icon are inserted
  41. into the current command line exactly as if you typed them with your
  42. keyboard, but slightly faster!
  43.  
  44. Usage
  45. ~~~~~
  46. AppCon must be RUNned from the Shell.  The best place to call AppCon is
  47. your shell-startup.  You've got to run AppCon for *EVERY* Shell-Window
  48. seperately.
  49.  
  50. If you drop multiple icons at once into your CON:-window the names will be
  51. seperated with spaces, names containing spaces are enclosed with quotation
  52. marks.
  53.  
  54. When the shell exits and AppCon is the only program that's using the
  55. CON-window, AppCon will detect this and exit nicely, too.  You must RUN
  56. AppCon, otherwise it would exit at once because it would be the only
  57. program that's using the CON-window.
  58.  
  59. AppCon periodically checks whether its Shell window is still being used.
  60. You can modify the time between two checks by setting the TIMEOUT-option in
  61. the command line of AppCon.  When using AppCon, you'll see that with a
  62. higher TIMEOUT the Shell window will react slower on closing commands, and
  63. with a lower TIMEOUT AppCon will consume more CPU ticks.  The TIMEOUT is in
  64. tenths of a second, this means that a timeout of 10 (default) will force
  65. AppCon to check every second whether the shell is still in use.
  66.  
  67. Example Use:
  68.  
  69. 1> Run AppCon TIMEOUT=12
  70.  
  71. NOTE:  Again, you *MUST* use the AmigaDOS 'Run' to start AppCon, otherwise
  72. it will exit immediately!
  73.  
  74. Thanks
  75. ~~~~~~
  76. Thank-you's fly to Andy Finkel and Robert "Kodiak" Burns who have released
  77. their 'ConsoleWindow' some centuries ago on Fish #35 with the source code.
  78. I'm using their code to find out the window pointer for my CON:-window.
  79.  
  80. Another big thank-you flies to the SAS Institute for developing their great
  81. compiler (buy it!).
  82.  
  83. Special thanks go to Chris, Jorrit & Stefan who helped me to find the
  84. sollution for the window-blocking-problem.  I finally found the sollution
  85. myself:  I check whether there are other processes that are using 'my'
  86. ConsoleTask - if there's just me I'll exit.
  87.  
  88. In Case Of Trouble
  89. ~~~~~~~~~~~~~~~~~~
  90. If your machine crashes or when this program doesn't work please contact
  91. the author with an exact explanation of the way you used the program and a
  92. precise listing of the hardware/software you're using.
  93.  
  94. Donations
  95. ~~~~~~~~~
  96. ... are always welcome!
  97.  
  98. Jokes
  99. ~~~~~
  100. Jetzt aber Shell!
  101.  
  102. Greetings
  103. ~~~~~~~~~
  104. Greetings go to:
  105.  
  106. Alex, Arto, Bernhard, Bjørn, Christian, Jehan-Yves, Jorrit, Kevin, Martin,
  107. Matze, Otti, Philipp, René, Stefan, Teijo, Thomas, Volker.
  108.  
  109. Technical Data
  110. ~~~~~~~~~~~~~~
  111. Compiled using SAS/C v6.3, the *BEST* compiler for the Amiga.
  112. Hardware: A4000/040, 10 MByte Memory.
  113. Compilation time: ~24 seconds.
  114. Source length:  509 lines (without includes).
  115. Executable length: 9968 bytes.
  116. Coffee consumed:  >5 cups.
  117.  
  118. Author's Address
  119. ~~~~~~~~~~~~~~~~
  120. Stephan Fuhrmann
  121. Erikstrasse 30
  122. 24837 Schleswig
  123. GERMANY
  124.