home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / tvision / tvgrep / tvgrep.doc < prev    next >
Text File  |  1993-01-13  |  16KB  |  347 lines
  1. January 13, 1993                                  Hamburg, Germany
  2.  
  3. DEFINITION OF SHAREWARE
  4. -----------------------
  5. Shareware distribution gives users a chance to try software
  6. before buying it. If you try a Shareware program and continue
  7. using it, you are expected to register. Individual programs
  8. differ on details -- some request registration while others
  9. require it, some specify a maximum trial period. With
  10. registration, you get anything from the simple right to continue
  11. using the software to an updated program.
  12.  
  13. Copyright laws apply to both Shareware and commercial software,
  14. and the copyright holder retains all rights, with a few specific
  15. exceptions as stated below. Shareware authors are accomplished
  16. programmers, just like commercial authors, and the programs are
  17. of comparable quality. (In both cases, there are good programs
  18. and bad ones!) The main difference is in the method of
  19. distribution. The author specifically grants the right to copy
  20. and distribute the software, either to all and sundry or to a
  21. specific group. For example, some authors require written
  22. permission before a commercial disk vendor may copy their
  23. Shareware.
  24.  
  25. Shareware is a distribution method, not a type of software. You
  26. should find software that suits your needs and pocketbook,
  27. whether it's commercial or Shareware. The Shareware system makes
  28. fitting your needs easier, because you can try before you buy.
  29. And because the overhead is low, prices are low also.
  30.  
  31. DISCLAIMER - AGREEMENT
  32. ----------------------
  33. Users of TVGREP must accept this disclaimer of warranty:
  34. "TVGREP is supplied as is.  The author disclaims all
  35. warranties, expressed or implied, including, without limitation,
  36. the warranties of merchantability and of fitness for any purpose.
  37. The author assumes no liability for damages, direct or conse-
  38. quential, which may result from the use of TVGREP."
  39.  
  40. TVGREP is a "shareware program" and is provided at no charge
  41. to the user for evaluation.  Feel free to share it with your
  42. friends, but please do not give it away altered or as part of
  43. another system.  The essence of "user-supported" software is to
  44. provide personal computer users with quality software without
  45. high prices, and yet to provide incentive for programmers to
  46. continue to develop new products.  If you find this program
  47. useful and find that you are using TVGREP and continue to use
  48. TVGREP after a reasonable trial period, you must make a reg-
  49. istration payment of $15 to me.  The $15 registration fee will
  50. license one copy for use on any one computer at any one time.
  51. You must treat this software just like a book.  An example is
  52. that this software may be used by any number of people and may
  53. be freely moved from one computer location to another, so long
  54. as there is no possibility of it being used at one location while
  55. it's being used at another. Just as a book cannot be read by two
  56. different persons at the same time.
  57.  
  58. Commercial users of TVGREP must register and pay for their
  59. copies of TVGREP within 30 days of first use or their license
  60. is withdrawn.  Site-License arrangements may be made by con-
  61. tacting me.
  62.  
  63. Anyone distributing TVGREP for any kind of remuneration must
  64. first contact me at the address below for authorization.
  65.  
  66. You are encouraged to pass a copy of TVGREP along to your
  67. friends for evaluation.  Please encourage them to register their
  68. copy if they find that they can use it.  All registered users
  69. will receive a copy of the latest version of the TVGREP system.
  70.  
  71. OVERVIEW OF TVGREP
  72. --------------------
  73. Along with the Borland compiler there came a tool named as GREP.
  74. With it you can search for text-phrases in your sources. For that
  75. surpose you have a lot of command-line parameters to use the program.
  76. And also the output must be redirected etc. If you want an easier
  77. use of the GREP tool TVGREP helps you on that. It's a shell lay
  78. around the GREP tool with an Turbo-Vision environment, but behind
  79. it the normal GREP tool work as before. All you can do with the
  80. grep tool you now can do with mouse and SAA ! You can store the
  81. items you changed directly in the GREP.COM program, also you can
  82. store the output in a text-file. etc. If you want to have a more
  83. inside look for the grep commands, please read the chapter in
  84. the manuals with the name "Additional programs" or look in the
  85. index for "GREP". The information there is fully complete.
  86.  
  87. INSTALLATION/CNODITIONS
  88. -----------------------
  89. 1) You must have set a correct COMSPEC environment variable
  90. 2) The grep tool (GREP.COM) must be stored at a location where a
  91.    PATH variable lays on
  92. 3) The program GREPPIPE must stored at the same location as TVGREP
  93. 4) on networks you must have write access to the current directory
  94.    because TVGREP use temporaily files.
  95. 5) You must have a RTM.EXE and DPMI16BI.OVL aviable in your PATH
  96.    statement. You can get these file from other applications
  97.    which support  Borland's DPMI extender !
  98. 6) The GREP.COM shouldn't be the 1.0 version
  99.  
  100. FUNCTIONS OF TVGREP
  101. -------------------
  102. The Programm have a some menues for acting with it. Here the
  103. most of them should be declare or known from the Turbo IDE's.
  104.  
  105. System-Menu:
  106. ~~~~~~~~~~~~
  107.   About         : Displays a window that display some info about the program.
  108.                   The name, a copyright and a version number. This window
  109.                   will be moved on the desktop if you use a not registered
  110.                   version.
  111.  
  112.   Clear-Desktop : Close all opend windows and clears the historylists
  113.                   on the file-dialogs.
  114.  
  115.   Information   : Display a information screen how you can contact me.
  116.                   And some more info about the programm.
  117.  
  118.   Registration  : Here you can enter your name and a code that I send you.
  119.                   If the code is correct your programm will be registrate
  120.                   and the flicker About window will closed and a messages
  121.                   appears that this programm is registrated to you. If
  122.                   you have an unregistrated version there will be display
  123.                   in the first line of the screen.
  124.  
  125.   History/Fixes : Here a list will display with the changes made to the
  126.                   program. It includes a date, a descrition and a
  127.                   versionnumber.
  128.  
  129. File-Menu:
  130. ~~~~~~~~~~
  131.   File-Open : Opens a dialog in which you can edit all the params
  132.   [F3]        are neccesarry for GREP.
  133.  
  134.   Save as   : After you started a grep-search operation the
  135.               result will be show in a scrollable window. The
  136.               contents of the windows you can save to a ascii-file
  137.               with this item.
  138.  
  139.   Dos-Shell   : You can think over it by yourself.
  140.  
  141.   Exit        : If you have enough of the (unregistrated) program
  142.                 you can leave it here.
  143.  
  144.   Change-Dir  : You can changed your working directory with this call.
  145.                 This can be neccessary if you use the sub-directory
  146.                 option on grep.
  147.  
  148. Options:
  149. ~~~~~~~~
  150.   Line        : Here you can toggle the display size on an EGA/VGA card
  151.                 between 25 and 43/50 lines.
  152.  
  153.   Mouse       : A dialog to control the mouse parameters like.
  154.                 Click-Speed and left-hand users.
  155.  
  156.   Colors      : Here you can change the colors for the application
  157.  
  158.   Heap-View   : To ever have an overview of the memory that are
  159.                 can be used by the program I show it in the right-bottom
  160.                 corner of the desktop aera. With this item you can
  161.                 toggle between showing and hiding that view.
  162.  
  163.   Store       : The options you have previous made can be save
  164.                 hereby to a RESMOVER.DSK file. If that file exists
  165.                 on programstart it will be automatically load from
  166.                 the current directory.
  167.  
  168.   Retrieve    : Looks for a RESMOVER.DSK file in the current directory
  169.                 and load it if exists. This can be neccessary if you
  170.                 changed the current directory while working with the
  171.                 program.
  172.  
  173. Windows:
  174. ~~~~~~~~
  175.   Exactly the same as within the Turbo IDE, excluding the special
  176.   Windows like Watch, etc. !
  177.  
  178. Help:
  179. ~~~~~
  180.   Only a placeholder at this moment. Please write me if you need a
  181.   context-sensitive helpsystem for this program.
  182.  
  183. Others:
  184. ~~~~~~~
  185.  If you know of the Turbo 6.0 IDE you will easy get in my programm
  186.  because it looks like it ( I hope ). I think eachone who will use
  187.  it, is a Developer for TV programms and exactly know how to use
  188.  this program.
  189.  
  190.  I have included a screen-saver module with the 1.03 version. It
  191.  will be activate after ca. 5 minutes or if you move the mouse
  192.  cursor to the upper-right corner of the desktop. It looks and
  193.  acts like the one of the Norton-Commander.
  194.  
  195.  Note that the Help menu doesn't work at this moment, but I'll work
  196.  on that. Only put this first version out of my computer
  197.  to see how you find it. Suggestions ever welcome by me !
  198.  
  199. REGISTRATION:
  200. -------------
  201. If you want to registrate this program ( why not if you like it ? )
  202. send me the fee via mail and give me some info how I can reach you so
  203. that I can send you a invoice over the money, a disk ( only 3.5" ) and
  204. the registration code ( I need only your First, Last name for it ). If
  205. you will get updates via E-Mail let me know because it's easier to me.
  206.  
  207. IF you'll send the fee with a bank-transfer here's my bank account
  208. in Germany ( but don't know how to transfer money on it from foreign
  209. countrys, let me know if you know how ! ) :
  210.  
  211.                                         Stefan Boether
  212.                                         Postgiroamt Hamburg
  213.                                         BLZ 200 100 20
  214.                                         Ktnr.# 2784 47-205
  215.  
  216. You see that this is a short documentation and my English is bad
  217. I know that ( hope that you understand me <g> ) but each mail
  218. with a problem that reached me will be included in this docu.
  219. So that the docu will grow with the users of the programm.
  220. If some sentences not so good to read please correct them and
  221. send it to me, only so I learn to write good English documentations.
  222.  
  223. If you have some additional questions or suggestions about the program
  224. you can reach me under following addresses ( I prefer E-Mail ). Also
  225. I ever search for new ideas for tools I can be develop. If you need
  226. any tool which can be useable for more that one users send me that
  227. idea and I'll see if I realize it.
  228.  
  229.  Stefan Boether          E-Mail:  CompuServe   100023,275
  230.  Methfesselstr. 38                FidoNet      2:243/91.331
  231.  W-2000 Hamburg 20                Internet     100023.275@CompuServe.COM
  232.  = West-Germany =
  233.  
  234. And last not but least my sign. If you see it anywhere you know that
  235. I was there.
  236.  
  237.  - Mfg Stefc -
  238.  
  239. P.S.  Many thanks to the people at the CompuServe BPROGA Forum. Without
  240.       their help this programm doesn't exists at this time !
  241.  
  242. ------------------------------------------------------------------------
  243.  
  244. Some additions to the program itself such as technical info, bug-fixes,
  245. wishes from users, etc.
  246.  
  247. I begin develop the program in early august '92 because not ever want to
  248. remember the commandline options of grep which I known as a very good
  249. tool. So I deceided to build a TV shell around the tool. The most of the
  250. work on this tool I've made previous with other TV-apps like RESMOVER and
  251. HLPEDIT, so I only put together some resources and source and make the
  252. interface to grep. After a day the frame stay and I look more to the
  253. details of the program. As machine I have a 386SX 20Mhz with 8Mb RAM
  254. and MS-DOS 5.0 installed on it.
  255.  
  256. The program is able to use EMS or XMS installed on your computer. If you
  257. have neither of them on your machine the disk is used as virtual memory,
  258. but this decrease the performance of the program. I hope that this
  259. limitation isn't so bad for the most developers !
  260.  
  261.  
  262. Here are some enhancements and bug fixes made to the program.
  263.  
  264. Date      Version  Comments
  265. ~~~~      ~~~~~~~  ~~~~~~~~
  266. 7.8.92    1.00     Programmed the first release that can be but out
  267.                    to networks and ShareWare distributer.
  268.  
  269. 11.9.92   1.03     Look for a bug in resource handling and use
  270.                    TDosStream instead of TBufStream ! Also
  271.                    more information was shown on errors.
  272.  
  273. 11.9.92   1.04     Don't open overlay with fmDenyWrite on
  274.                    networks where no ems was supported
  275.  
  276. 12.9.92   1.05     Show a waiting window on running grep.com
  277.  
  278. 20.10.92  1.07     Added the Mouse toggle idea to my programs.
  279.                    There can be some problems with this on
  280.                    Save & Restore desktop if you use older
  281.                    *.DSK files came from versions before 1.07 !!!
  282.  
  283. 09.11.92  1.08     Fix a bug on loading resourcefile on networks
  284.  
  285. 04.01.93  1.50     Use BP 7.0 and DPMI for this program. Also
  286.                    make minor changes and enhancement in the program
  287.                    itself.
  288.  
  289.  
  290. --------------------------------------------------------------------
  291. Special thanks to:
  292.  
  293.  Blake Watson        for his TRAMStream and give me the idea to
  294.                      develop a similar TXMSStream
  295.  
  296.  DJ Murdoch          for his Stream-Collection and his engagement on
  297.                      streams and his collection of known bugs to
  298.                      the compiler
  299.  
  300.  Neil J. Rubenking   for his excellent book wich covers TP 6.0 and his
  301.                      help on TV-problems
  302.  
  303.  Steve B. Schafer    for the many answers to my many questions
  304.                      to inside TV problems I have
  305.  
  306.  Hans B. Schleichert for the exploaration into the deep of
  307.                      Runtime errors and catching them, still
  308.                      in Overlays. Don't use here but never
  309.                      know when be neccessary to use it.
  310.  
  311.  Richard R. Sands    for his delay and beep routine without the use
  312.                      of CRT
  313.  
  314.  Danny Thorpe        For give me some very good hints and I think he's
  315.                      the TV developer with the most experience at this
  316.                      time.
  317.  
  318.  Steve Agnew         For help me to find some bug in resource handling
  319.  
  320.  Other TeamB members for the support in the BPROGA forum
  321.  
  322.  Blaise              for their Resource-Editor which spare me
  323.                      a lot of time on design at the needed dialogs
  324.  
  325.  Borland             for their excellent TV class libary and the
  326.                      Pascal Compiler wich is so fast and popular
  327.  
  328.  CompuServe          to give me the link from my desk to pascal
  329.                      developers on the whole world
  330.  
  331.  grep Users          How also enjoy the use of such tools as grep and
  332.                      and need such programs as TvGrep for better use.
  333.  
  334. --------------------------------------------------------------------
  335.  
  336. Some advertising for myself:
  337.  
  338. If you need a Pascal programer for projects that can be give away to
  339. third-party developers. And you need also a programer how know much
  340. about OOP-Programing in Pascal and the libarys behinds them like OWL
  341. and Turbo-Vision ask me for a offer. If you want programs that should
  342. have similar user interfaces as this TvGrep program or only need a little
  343. object for example a screen-blanker, a windows list, etc. ask me
  344. also. And remember that the question don't cost anything ! And
  345. you can be sure to get an answer from me.
  346.  
  347.