home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / LA / LA016.ZIP / TRH4FOX.EXE / FOX2TRH.DOC next >
Text File  |  1989-12-20  |  8KB  |  181 lines
  1.                _____________________________________
  2.  
  3.                     Tom Rettig's HELP for FoxPro
  4.  
  5.                           *** FREEWARE ***
  6.  
  7.      Copyright (c) 1989 Tom Rettig Associates, All Rights Reserved
  8.                _____________________________________
  9.  
  10.                        Tom Rettig Associates
  11.                  9300 Wilshire Boulevard, Suite 470
  12.                 Beverly Hills, California  90212-3237
  13.  
  14.                      Telephone: (213) 272-3784
  15.                            MCI Mail: TRA
  16.                        CompuServe: 75066,352
  17.                        Telex: 4996426 RETTIG
  18.                _____________________________________
  19.  
  20.         FOX2TRH.PRG converts the FOXHELP on-line reference
  21.         to Tom Rettig's HELP format, so you can read it no
  22.         matter which editor you use to write FoxPro programs.
  23.  
  24. ************************** DESCRIPTION *****************************
  25.  
  26. Tom Rettig's HELP works with your editor or word-processor, at the
  27. command prompt in interpreters, and even over data-entry screens in
  28. compiled applications.  Touch a key and a window instantly pops up
  29. with everything you want to know about any software command,
  30. function, operator, keyword, or symbol.
  31.  
  32. Three components make up the TRHELP system: "Data Files" contain
  33. compressed information about a programming language or software.
  34. You use the "Reader" to quickly access Data Files no matter what
  35. software you are using.  The "Data File Maker" lets you create your
  36. own Data Files or modify existing ones.
  37.  
  38. Intuitive menus make everyone an instant expert, and speedy hot-keys
  39. let the power-user bypass all menus.  The Reader never gets in your
  40. way: it works the way you think instead of making you think about
  41. how it works.
  42.  
  43. Powerful five-way search lets you find any entry by its name,
  44. functional category, grammatical type, see-also pointer, or detail
  45. text fragment.  Functional and grammatical groupings let you view at
  46. a glance all language features belonging to a group, and quickly
  47. select the one right for your immediate needs.
  48.  
  49. Four versatile output options let you write syntax structures and
  50. valuable source code examples directly into your editor while you're
  51. programming.  Or leave a temporary image on your screen and
  52. return to using your editor.  Or make a hard copy on any printer.
  53.  
  54. This pop-up Reader, TRHFOX.EXE, is "tied" specifically to the Data
  55. File produced by FOX2TRH from FOXHELP.  It is a completely full
  56. implementation of our commercial Reader, TRHELP.EXE, except that
  57. it reads ONLY this FOXHELP Data File and we give it away as
  58. "freeware."  Our commercial Reader reads all Data Files including
  59. FOXHELP plus those that we write and publish for the latest versions
  60. of FoxPro, FoxBASE+, dBASE IV, dBASE III PLUS, Clipper, Quicksilver,
  61. and dBXL.
  62.  
  63. We also publish a Data File Maker that allows you to make your own
  64. TRHELP Data Files and modify existing ones.  The Data File Maker is
  65. available from your software dealer or directly from Tom Rettig
  66. Associates.
  67.  
  68. ************************* INSTALLATION *****************************
  69.  
  70. The complete TRHELP system is contained in one file, TRH4FOX.EXE.
  71. It is a self-decompressing file that contains this FOX2TRH.DOC plus
  72. three TRHELP files.
  73.  
  74. Make the directory in which you keep FoxPro the active default
  75. directory.  Insert the TRHELP diskette in drive A:, and type
  76. A:TRH4FOX at the DOS prompt.  For example:
  77.  
  78.    C:\FOXPRO> a:trh4fox
  79.  
  80. The three TRHELP files require 160K of disk space when decompressed.
  81.  
  82.    - TRHFOX.EXE is the pop-up Reader file that reads the
  83.                  FOXHELP.TRH Data File.
  84.    - FOX2TRH.PRG is the FoxPro program that makes the Data File
  85.                  from FoxPro's FOXHELP.DBF.
  86.    - FOX2TRH.EXE is called by FOX2TRH.PRG for the final low-level
  87.                  compile of the FOXHELP Data File.
  88.  
  89. ***************************** USAGE ********************************
  90.  
  91. Before you can use the TRHFOX Reader, you must create the FOXHELP
  92. Data File that the Reader uses by DOing FOX2TRH.PRG from within
  93. FoxPro.  This program handles long strings and requires that
  94. your CONFIG.FP file set MVARSIZ to 45 or more.  If your CONFIG.FP
  95. file does not set MVARSIZ, add this line before you start FoxPro:
  96.  
  97.    MVARSIZ = 45
  98.  
  99. After adding this line, start FoxPro and DO FOX2TRH from the command
  100. window.  You only need run this program once, or anytime the FOXHELP
  101. database or memo file changes.
  102.  
  103. Note that FOX2TRH.PRG requires available disk space about 2.2 times
  104. the size of FOXHELP.FPT for temporary and final output files.  The
  105. resulting FOXHELP.TRH file will be about 10% bigger than FOXHELP.FPT
  106. because we add a great deal of information.  For example, if
  107. FOXHELP.FPT is 500,000 bytes, you need about 1,100,000 bytes free,
  108. half of which is used to store the output FOXHELP.TRH Data File, and
  109. half of which is used for temporary working space and then released.
  110.  
  111. You can set a DOS environmental variable "TMP" to use another drive
  112. for temporary files.  For example, to put all temporary files in the
  113. root directory on drive D:, type this at the DOS prompt before
  114. entering FoxPro:
  115.  
  116.    SET TMP=D:\
  117.  
  118. Once the FOXHELP.TRH Data File is made, it and TRHFOX.EXE are the
  119. only two files you need in order to use Tom Rettig's HELP.  Before
  120. you blow away FOX2TRH.PRG though, you might want to take a look
  121. through it because it demonstrates many new FoxPro features
  122. including low-level file handling and long strings that you can
  123. use in your FoxPro applications.
  124.  
  125. To start the Reader, type TRHFOX at the DOS prompt before starting
  126. FoxPro or your editor.  If you use no options, TRHFOX will be memory
  127. resident.
  128.  
  129. All documentation, including what you are reading now, is available
  130. from the Reader's Help menu.  Once activated, press F1 and read the
  131. entries on the Help menu.  The Reader does quite a lot, and you will
  132. find everything fully described in the Help entries.  For example,
  133. the entry called "Start" has complete information on starting up,
  134. optional parameters, and memory usage.
  135.  
  136. ************************* NOTICE & LICENSE *************************
  137.  
  138. Tom Rettig's HELP software is protected by United States copyright
  139. law and international treaties.  Your use of this software means
  140. that you agree to abide by the terms of this software license.
  141.  
  142. You may install the individual files from TRH4FOX on any number of
  143. computers and make any number of copies for your own use.  You may
  144. modify and use the source code in FOX2TRH.PRG for your own
  145. application programs, provided that your programs do not compete
  146. with, or otherwise damage, Tom Rettig's HELP software products.
  147.  
  148. You may freely distribute TRHFOX.EXE, FOX2TRH.EXE, and FOX2TRH.PRG
  149. to friends, associates, and computer bulletin board systems (BBS),
  150. provided that you distribute unmodified the entire self-unzipping
  151. file TRH4FOX.EXE rather than the individual files it contains.  You
  152. may charge no more than a nominal fee (not to exceed $10) for such
  153. distribution.
  154.  
  155. If you upload TRH4FOX to a BBS, please use the following description.
  156.  
  157.    Title   : Tom Rettig's HELP conversion for FoxPro
  158.    Keywords: HELP TRHELP FOXPRO POPUP REFERENCE DOCUMENTATION
  159.     
  160.    TRHELP is pop-up quick reference software that lets you look up
  161.    reference information while you are programming in any editor
  162.    like Brief, Q-Edit, etc.  This utility program converts the
  163.    FoxPro FOXHELP file to TRHELP format, so you can reference it
  164.    outside of FoxPro.  Includes the TRHELP Reader for reading the
  165.    converted file.  Self-extracting, just run.  Version 1.02,
  166.    December, 1989.
  167.  
  168. The contents of FOXHELP.DBF and FOXHELP.FPT are the exclusive
  169. property of Fox Software, and are subject to the terms of the
  170. license agreement under which they are acquired.  Changing the
  171. format does not change the license and you must treat converted
  172. files the same as the originals.  Consult your FoxPro license to
  173. determine your rights thereunder.
  174.  
  175. ***************************** SUPPORT ******************************
  176.  
  177. If you have any problems, please call or E-mail TRA for assistance.
  178.  
  179. ********************************************************************
  180.  
  181.