Power-Programmierung

home *** CD-ROM | disk | FTP | other *** search

/ Power-Programmierung / CD1.mdf / pascal / library / dos / tvision / tvgrep / tvgrep.doc < prev next >

Wrap

Text File | 1993-01-13 | 15.1 KB | 347 lines

January 13, 1993 Hamburg, Germany DEFINITION OF SHAREWARE ----------------------- Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. DISCLAIMER - AGREEMENT ---------------------- Users of TVGREP must accept this disclaimer of warranty: "TVGREP is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or conse- quential, which may result from the use of TVGREP." TVGREP is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using TVGREP and continue to use TVGREP after a reasonable trial period, you must make a reg- istration payment of $15 to me. The $15 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Commercial users of TVGREP must register and pay for their copies of TVGREP within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by con- tacting me. Anyone distributing TVGREP for any kind of remuneration must first contact me at the address below for authorization. You are encouraged to pass a copy of TVGREP along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of the TVGREP system. OVERVIEW OF TVGREP -------------------- Along with the Borland compiler there came a tool named as GREP. With it you can search for text-phrases in your sources. For that surpose you have a lot of command-line parameters to use the program. And also the output must be redirected etc. If you want an easier use of the GREP tool TVGREP helps you on that. It's a shell lay around the GREP tool with an Turbo-Vision environment, but behind it the normal GREP tool work as before. All you can do with the grep tool you now can do with mouse and SAA ! You can store the items you changed directly in the GREP.COM program, also you can store the output in a text-file. etc. If you want to have a more inside look for the grep commands, please read the chapter in the manuals with the name "Additional programs" or look in the index for "GREP". The information there is fully complete. INSTALLATION/CNODITIONS ----------------------- 1) You must have set a correct COMSPEC environment variable 2) The grep tool (GREP.COM) must be stored at a location where a PATH variable lays on 3) The program GREPPIPE must stored at the same location as TVGREP 4) on networks you must have write access to the current directory because TVGREP use temporaily files. 5) You must have a RTM.EXE and DPMI16BI.OVL aviable in your PATH statement. You can get these file from other applications which support Borland's DPMI extender ! 6) The GREP.COM shouldn't be the 1.0 version FUNCTIONS OF TVGREP ------------------- The Programm have a some menues for acting with it. Here the most of them should be declare or known from the Turbo IDE's. System-Menu: ~~~~~~~~~~~~ About : Displays a window that display some info about the program. The name, a copyright and a version number. This window will be moved on the desktop if you use a not registered version. Clear-Desktop : Close all opend windows and clears the historylists on the file-dialogs. Information : Display a information screen how you can contact me. And some more info about the programm. Registration : Here you can enter your name and a code that I send you. If the code is correct your programm will be registrate and the flicker About window will closed and a messages appears that this programm is registrated to you. If you have an unregistrated version there will be display in the first line of the screen. History/Fixes : Here a list will display with the changes made to the program. It includes a date, a descrition and a versionnumber. File-Menu: ~~~~~~~~~~ File-Open : Opens a dialog in which you can edit all the params [F3] are neccesarry for GREP. Save as : After you started a grep-search operation the result will be show in a scrollable window. The contents of the windows you can save to a ascii-file with this item. Dos-Shell : You can think over it by yourself. Exit : If you have enough of the (unregistrated) program you can leave it here. Change-Dir : You can changed your working directory with this call. This can be neccessary if you use the sub-directory option on grep. Options: ~~~~~~~~ Line : Here you can toggle the display size on an EGA/VGA card between 25 and 43/50 lines. Mouse : A dialog to control the mouse parameters like. Click-Speed and left-hand users. Colors : Here you can change the colors for the application Heap-View : To ever have an overview of the memory that are can be used by the program I show it in the right-bottom corner of the desktop aera. With this item you can toggle between showing and hiding that view. Store : The options you have previous made can be save hereby to a RESMOVER.DSK file. If that file exists on programstart it will be automatically load from the current directory. Retrieve : Looks for a RESMOVER.DSK file in the current directory and load it if exists. This can be neccessary if you changed the current directory while working with the program. Windows: ~~~~~~~~ Exactly the same as within the Turbo IDE, excluding the special Windows like Watch, etc. ! Help: ~~~~~ Only a placeholder at this moment. Please write me if you need a context-sensitive helpsystem for this program. Others: ~~~~~~~ If you know of the Turbo 6.0 IDE you will easy get in my programm because it looks like it ( I hope ). I think eachone who will use it, is a Developer for TV programms and exactly know how to use this program. I have included a screen-saver module with the 1.03 version. It will be activate after ca. 5 minutes or if you move the mouse cursor to the upper-right corner of the desktop. It looks and acts like the one of the Norton-Commander. Note that the Help menu doesn't work at this moment, but I'll work on that. Only put this first version out of my computer to see how you find it. Suggestions ever welcome by me ! REGISTRATION: ------------- If you want to registrate this program ( why not if you like it ? ) send me the fee via mail and give me some info how I can reach you so that I can send you a invoice over the money, a disk ( only 3.5" ) and the registration code ( I need only your First, Last name for it ). If you will get updates via E-Mail let me know because it's easier to me. IF you'll send the fee with a bank-transfer here's my bank account in Germany ( but don't know how to transfer money on it from foreign countrys, let me know if you know how ! ) : Stefan Boether Postgiroamt Hamburg BLZ 200 100 20 Ktnr.# 2784 47-205 You see that this is a short documentation and my English is bad I know that ( hope that you understand me <g> ) but each mail with a problem that reached me will be included in this docu. So that the docu will grow with the users of the programm. If some sentences not so good to read please correct them and send it to me, only so I learn to write good English documentations. If you have some additional questions or suggestions about the program you can reach me under following addresses ( I prefer E-Mail ). Also I ever search for new ideas for tools I can be develop. If you need any tool which can be useable for more that one users send me that idea and I'll see if I realize it. Stefan Boether E-Mail: CompuServe 100023,275 Methfesselstr. 38 FidoNet 2:243/91.331 W-2000 Hamburg 20 Internet 100023.275@CompuServe.COM = West-Germany = And last not but least my sign. If you see it anywhere you know that I was there. - Mfg Stefc - P.S. Many thanks to the people at the CompuServe BPROGA Forum. Without their help this programm doesn't exists at this time ! ------------------------------------------------------------------------ Some additions to the program itself such as technical info, bug-fixes, wishes from users, etc. I begin develop the program in early august '92 because not ever want to remember the commandline options of grep which I known as a very good tool. So I deceided to build a TV shell around the tool. The most of the work on this tool I've made previous with other TV-apps like RESMOVER and HLPEDIT, so I only put together some resources and source and make the interface to grep. After a day the frame stay and I look more to the details of the program. As machine I have a 386SX 20Mhz with 8Mb RAM and MS-DOS 5.0 installed on it. The program is able to use EMS or XMS installed on your computer. If you have neither of them on your machine the disk is used as virtual memory, but this decrease the performance of the program. I hope that this limitation isn't so bad for the most developers ! Here are some enhancements and bug fixes made to the program. Date Version Comments ~~~~ ~~~~~~~ ~~~~~~~~ 7.8.92 1.00 Programmed the first release that can be but out to networks and ShareWare distributer. 11.9.92 1.03 Look for a bug in resource handling and use TDosStream instead of TBufStream ! Also more information was shown on errors. 11.9.92 1.04 Don't open overlay with fmDenyWrite on networks where no ems was supported 12.9.92 1.05 Show a waiting window on running grep.com 20.10.92 1.07 Added the Mouse toggle idea to my programs. There can be some problems with this on Save & Restore desktop if you use older *.DSK files came from versions before 1.07 !!! 09.11.92 1.08 Fix a bug on loading resourcefile on networks 04.01.93 1.50 Use BP 7.0 and DPMI for this program. Also make minor changes and enhancement in the program itself. -------------------------------------------------------------------- Special thanks to: Blake Watson for his TRAMStream and give me the idea to develop a similar TXMSStream DJ Murdoch for his Stream-Collection and his engagement on streams and his collection of known bugs to the compiler Neil J. Rubenking for his excellent book wich covers TP 6.0 and his help on TV-problems Steve B. Schafer for the many answers to my many questions to inside TV problems I have Hans B. Schleichert for the exploaration into the deep of Runtime errors and catching them, still in Overlays. Don't use here but never know when be neccessary to use it. Richard R. Sands for his delay and beep routine without the use of CRT Danny Thorpe For give me some very good hints and I think he's the TV developer with the most experience at this time. Steve Agnew For help me to find some bug in resource handling Other TeamB members for the support in the BPROGA forum Blaise for their Resource-Editor which spare me a lot of time on design at the needed dialogs Borland for their excellent TV class libary and the Pascal Compiler wich is so fast and popular CompuServe to give me the link from my desk to pascal developers on the whole world grep Users How also enjoy the use of such tools as grep and and need such programs as TvGrep for better use. -------------------------------------------------------------------- Some advertising for myself: If you need a Pascal programer for projects that can be give away to third-party developers. And you need also a programer how know much about OOP-Programing in Pascal and the libarys behinds them like OWL and Turbo-Vision ask me for a offer. If you want programs that should have similar user interfaces as this TvGrep program or only need a little object for example a screen-blanker, a windows list, etc. ask me also. And remember that the question don't cost anything ! And you can be sure to get an answer from me.