home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / cli / help034.lzh / JBPHelp.doc < prev    next >
Encoding:
Text File  |  1992-11-11  |  7.0 KB  |  148 lines
  1. Make a drawer and copy the .CFG and the .HELP files into it.
  2.  
  3. Assign HELP: to that drawer in your startup-sequence.
  4.  
  5. Add the following line to your startup-sequence:
  6.  
  7. run < nil: > nil: help:JBPHelp < nil: > nil:
  8.  
  9.  
  10. Reboot your computer and when you get to workbench try running something
  11. like preferences programs such as Time or IControl or the Commodities
  12. Exchange program.  Press the HELP key.  If the help screen does not 
  13. pop up, then re-check your installation.
  14.  
  15. Later, JBP
  16.      **************************************************************
  17.      *                                                            *
  18.      *   ***** ****** *******  *      * *******  ***     *******  *
  19.      *     *   *     * *     * *      *  *        *       *     * *
  20.      *     *   *     * *     * *      *  *        *       *     * *
  21.      *     *   ******  ******  ********  ****     *       ******  *
  22.      *     *   *     * *       *      *  *        *       *       *
  23.      * *   *   *     * *       *      *  *        *    *  *       *
  24.      *  ***    ****** ***      *      * ******** ******* ***      *
  25.      *                                                            *
  26.      **************************************************************
  27.  
  28.                            HERE IT IS!
  29.  
  30. JBPHelp version 0.4 is an intellegent HELP key utility designed to work
  31. with MOST Amiga programs.  This program is not FREE but distributed in
  32. good faith that if you really like the program that you will send the
  33. $25.oo registration fee to me.  JBPHelp is a 1992 copyrighted product 
  34. by John Preston.  Registration fees can be sent to this address:
  35.  
  36. John Preston
  37. JBPHELP REGISTRATION
  38. 508 E. Warren St.
  39. Mt. Pleasant, IA 52641
  40.  
  41.                WHAT BEING A REGISTERED USER GIVES YOU
  42.  
  43. Registered users will receive via 880K Amiga format disk the latest version
  44. of JBPHELP as well as mailing list updates and notices.  Non-registered
  45. users may find the latest release on internet (if I can get it there) when 
  46. all registered users have received their new versions and I feel like 
  47. uploading it to internet.  Registered users with modems can talk to me VIA 
  48. Amiga Depot BBS which is a FIDO-NET system with two highspeed lines.
  49. Registered users will also have exclusive access to the directory where 
  50. the latest version of JBPHelp will be kept until all registered users have 
  51. aquired the program and I feel like moving it to the PUBLIC download area.
  52.  
  53.                    ELECTRONIC MEDIA ACCESS TO JBPHELP
  54.  
  55. Amiga DEPOT BBS is a 24 hr FIDO-NET system with a large store of public
  56. domain files for AmigaDOS, UNIX and MINIX.  The public is free to access
  57. Amiga DEPOT BBS at anytime via 1200 to 9600 HST or V32/V42 modems by
  58. calling the following numbers:
  59.  
  60. (319)-3857412  Line 1 is a USR-DS capable of HST, v32, v32bis, v42, v42bis
  61. (319)-3857413  Line 2 is a SUPRA 9600 v32/v42/v42bis
  62.  
  63.                            DESCRIPTION
  64.  
  65. After reading Rick Manasa's article in Amazing Amiga Computing magazine
  66. (see Vol 7 No. 1 Jan 1992 ppg 28-29), I decided to write a program that
  67. would make the help key more useful.  Rick wanted to use the help key to
  68. pop-up little text files of info that he had keyed in but could not 
  69. consult to memory.  The biggest obstacle he was facing is that he had to
  70. use differnt programs to attempt to bring up the help screens.  And while
  71. one of the programs he used reads the window name, this cannot always work
  72. because some programs do not have text in their windows.
  73.  
  74. I decided to tackle the problem and write a program that would snoop out 
  75. which program you were trying to use and display the propper help file.
  76. I discovered some of the problems and have implemented three levels of 
  77. searching to find those stubborn tasks.
  78.  
  79. JBPHelp places itself infront of intuition and finding out which window 
  80. was the active window and then tracking which task the window belonged to.
  81. Unfortunatly there are some windows that I cannt track down to the running
  82. program.  These are the CON: style and are created by AmigaDOS and thus
  83. more difficult to figure which application is using the window.  For these
  84. windows I have default to two other techniques, one of which is the WINDOW
  85. TITLE check that one of Rick's programs uses.  The other case is if the
  86. program does not place a title in the window and it uses a console window
  87. and it was not launced from CLI, I can use PATH stored in the CLI to trace
  88. down this task.  This takes care of all types of window situations.
  89.  
  90. A config file 'Help.CFG' contains names of applications (preceeded by 
  91. a control sign) and followed by a filename of the textfile to be displayed.
  92. The reson for using the @ symbol is there are future plans to inform JBPHelp about the
  93. other applications it cannot detect as I get further along in the coding.
  94.  
  95. The values of the control sign is defined in the commented 'Help.CFG'.
  96.  
  97.  
  98.                            INSTALLATION
  99.  
  100. Installation is simple.  Copy all the files to the place where you want to
  101. keep JBPHelp and assign HELP: to that location.  Run JBPHelp.  Easy.
  102.  
  103. You may want to add these lines to your startup-sequence
  104.  
  105. Assign HELP: drive:dirwhereiputit
  106. run < nil: > nil: HELP:JBPHelp < nil: > nil:
  107.  
  108.                            BEGGING
  109.  
  110. I have provided JBPHelp with many help files and will collect more of them
  111. as I create them (or you send them to me :).  This program was designed
  112. to increase your enjoyment of the Amiga.
  113.  
  114. While I realize that all computer science majors AND Amiga owners are poor,
  115. I cannot emphaize that the only way I can keep adding features to this
  116. program is for you, the user, to give me some reason to keep going.  If 
  117. you would like to see JBPHelp grow and mature into the best Help utilitiy
  118. available for the Amiga Computer then please do so by becomming a 
  119. registered owner.
  120.  
  121.                           DISCLAMER AND COPYRIGHT
  122.  
  123. I John Preston do not make any warrantes either expressed or implied that
  124. this program or even it's presence will make life simple or that the 
  125. program will even work.  I John Preston will also not be held liable for
  126. any direct, indirect, incidental, or consecuential damages resulting from
  127. using this product.
  128.  
  129. This program is copyrighted by John Preston 1992 and is distributable
  130. if the executable, this document file and all the help and config files are
  131. accompaning the program.  This program cannot be used for commercial use
  132. without written consent of the author.
  133.  
  134.  
  135. *************************** HISTORY ********************************
  136.  
  137. 0.25 Released Jan 9, 1992.
  138. 0.31 Released Jan 24,1992.  Made control of help display like UNIX more
  139.      command.  Added better control over error handling.  More informative
  140.      when it cannot find help.  Can be completely detached from CLI and/or
  141.      initiated from workbench with supplied icon.
  142. 0.32 Beginning to implement scroll back options, but it's buggy.
  143. 0.33 Can be purged from memory by selecting the menu option 'REMOVE'.
  144. 0.34 Released Feb 22, 1992.
  145.      Added gadgets along the bottom so user can use MORE like commands or
  146.      can use these gadgets.  Scroll up/down and TOP work.  Others are there
  147.      but are non-functional.  Also several help files are provided.
  148.