home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / k / procfunc / !ProcFunc / !Help next >
Encoding:
Text File  |  1993-03-09  |  3.6 KB  |  67 lines
  1. !Help file for !ProcFunc
  2.  
  3. Have you ever found yourself looking through BASIC programs and saying to
  4. yourself "Now where did I put that procedure?". If so, then this application
  5. simplifies the process because all you have to do is to drop a BASIC program
  6. on to the icon and the main window will open up with two scrollable windows
  7. which show all the procedures and functions within that BASIC program. The
  8. programs filename is given at the top of this window so you know what
  9. program you are looking at.
  10.                          
  11. Note that is a procedure or function takes parameters, then these are NOT
  12. shown, instead the procedure or function name is given and this is followed
  13. by () which indicates that the procedure or function takes parameters.
  14.  
  15. Once this window is open, clicking on any of the procedure or function
  16. names, a window will open from which you will be able to save that procedure
  17. or function after clicking on the Save Proc/Fn icon. This will then open up
  18. a menu from which you will be able to save the procedure or function ready
  19. to be incorporated into your own programs as either a BASIC program or as a
  20. text file.
  21.  
  22. Clicking on 'Show listing' will open up a window after a period of time (the
  23. period of time dependent upon the size of the procedure or function) so that
  24. you can see whether it is actually the procedure or function you are looking
  25. for.
  26.  
  27. It is also possible to search through the list of procedure and function
  28. names by clicking with Menu anywhere on the main window and selecting
  29. Search... from the menu. This then opens a dialogue box, in which you set
  30. the string you wish to search for, whether the search string is contained
  31. within a string, it begins with the search string, it ends with the search
  32. string or the search string given is the full name of the procedure or
  33. function that you wish to search for. You may also set whether the program
  34. is to look only for procedures, functions or for both of them. After
  35. clicking on Search the application will tell you how many it has found by
  36. displaying the result in the bottom left hand corner of the window. If the
  37. search has been successful then clicking on Show results will open up the
  38. window described earlier from which you will be able to save the procedures
  39. or functions. If you now look at this window you will notice that the two
  40. arrow icons on the right hand side of the window will be unshaded. This will
  41. allow you to cycle through the list of procedure and/or functions that the
  42. application has found which mathced your search criteria. Each of the
  43. procedures and functions found will be able to be saved as before.
  44.  
  45. The iconbar menu is a standard menu with one extra option - Dragging - this
  46. will be shaded for users of RISC OS 2 unless you have a copy of the Drag A
  47. Sprite module present in your machine. If this is not shaded then it will
  48. lead to a submenu from which you will be able to decide whether to drag
  49. either a sprite or a bounding box during the save operation. Initially this
  50. is set to Sprites.
  51.  
  52. I hope you have some use for this application, I have found it invaluable
  53. when I have been generating desktop applications as it has allowed me to cut
  54. down my program development time as I now simply extract the procedures and
  55. functions that I require a lot quicker that I did before
  56.  
  57.  
  58. Paul Adams 1993.
  59.  
  60.  
  61. Known problems that are currently being worked on....
  62.  
  63. The only known problem to date is in showing the listings for long (?)
  64. procedures and functions that occur at the end of VERY long programs (130K
  65. plus at least), the last few lines do not appear. However, these lines are
  66. not lost when you save the procedures or functions to disc so there is no
  67. need to panic. I hope to have this slight problem corrected soon....