home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / xbase / library / clipper / debug / prg_help / prg_hlp.doc < prev    next >
Encoding:
Text File  |  1987-06-02  |  4.8 KB  |  96 lines
  1. ************************************************************************
  2. *                          PRG_HLP.PRG   version 1.2                   *
  3. *                          S. ROBERT DAVIDOFF, D.M.D.                  *
  4. *                               APRIL 1987                             *
  5. ************************************************************************
  6.     This program will allow you to make modifications in your .PRG
  7.     files and your database files from within your CLIPPER program.
  8.     It is a debugging tool that I designed to help me write my programs
  9.      more efficiently. I got tired of "jumping out" of my Clipper programs
  10.     to edit files and edit databases and make new databases, and use dflow
  11.     and Documentor to help me debug.
  12.  
  13.     In order to take maximum use of the program, you should have (AS IN 
  14.     PURCHASE!!!) the following programs:
  15.  
  16.                    THE NORTON EDITOR                (NE)
  17.                     NORTON UTILITIES DIRECTORY SORT  (DS.COM)
  18.                    DFLOW                         (WALLSOFT)
  19.                    THE DOCUMENTOR   (DOC)           (WALLSOFT)
  20.  
  21.     You may, of course, substitute another editor for the Norton Editor and
  22.     you may choose to not use one or more of the other programs that I have
  23.     incorporated here, BUT to get maximum effect, I would suggest that you 
  24.     purchase and use all of the programs... They were all designed as 
  25.      serious adjuncts to serious programming. 
  26.     
  27.     I also make use of a program called WHATKEY by Kevin Shepherd of
  28.      Nantucket Corporation.  I have also used various assembly language 
  29.      routines from Nantucket, and The SOURCE (from the CLIPPER sig and the
  30.      DBFSIG). These programs are all Public Domain and I thank those who 
  31.      contributed them.
  32.     
  33.     You can also link in DOT.PRG which comes on the Clipper Autumn disk. 
  34.      DOT is supposed to do some of these things, but I found my program 
  35.      to be more reliable and easier to operate.
  36.  
  37.     The beauty of this program is that you merely have to hit the F2 key 
  38.      from any "Wait" state in your running Clipper program and you can 
  39.      Tinker with all the .prg files and databases without leaving Clipper.
  40.     Make as many changes as you would like and then continue running your
  41.     Clipper program.  When your through debugging, simply recompile and 
  42.      you're in business!  You can also make new databases as well as 
  43.      modifying old ones from inside your Clipper program.
  44. *********************************************************************
  45.  
  46.                CREDIT WHERE CREDIT IS DUE!!!!
  47.  
  48. *********************************************************************
  49.     I wish to thank the DATABASED ADVISOR magazine from which some of my 
  50.     better ideas eminate. This program is based on information from 
  51.     DataBased Advisor, particularly J. Ari Kornfeld's article in the 
  52.     December 1986 issue. I have consistently found this magazine to be 
  53.     the best source of useful information for my programming needs!!!
  54. *********************************************************************
  55. *********************************************************************
  56.  
  57.                    BEFORE YOU BEGIN....
  58.  
  59. *********************************************************************
  60. Compile a demo program called HLP_TEST.EXE which will show how 
  61. I use the functions of PRG_HLP. I am including the Source code for the
  62. entire program.  Note that all the Utility programs such as the Norton 
  63. editor must be in the current directory in order to use them.  (See 
  64. the README.1ST file.)
  65.  
  66. I am pretty sure that you can link PRG_HLP to your program with no 
  67. particular problem.  The calling program has to set the F2 key as 
  68. follows:
  69.  
  70.                       SET KEY -1 TO PRG_HLP
  71.  
  72. This will activate this program from any "wait" state when the F2 key
  73. is pressed.
  74.  
  75. The variable "REPEAT", must be initialized by the calling program as
  76. a PUBLIC  variable (which is automatically set to .F.). This will prevent
  77. a recurrsive call of this program. The parameters passed are the same as
  78. the normal Clipper HELP program.
  79.  
  80. The PROCEDURES INDEX_H and REINDEX_ are set up for your specific programs.
  81. I have included them here as demonsration modules. You have to set
  82. them up for your own programs and you have to change them as you add or
  83. subtract databases and/or indexes
  84. **********************************************************************
  85.  
  86.   PLEASE BE AWARE THAT THERE ARE STILL SOME BUGS IN THIS PROGRAM!!!!
  87.   I will release updates as they come along.  This is the first update.
  88.   You are encouraged to make any modifications that you wish. I would 
  89.   hope that any improvements generated will be thrown back into the 
  90.   public domain area so that others may use them.....
  91.   If you like the program or if you have any comments, please leave me a 
  92.   message on the Source.
  93.  
  94.       Bob Davidoff
  95.      SOURCE ID:  NA2066
  96.