Black Box 4

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

/ Black Box 4 / BlackBox.cdr / editors / edit11a.arj / EDIT11.DOC next >

Wrap

Text File | 1991-07-25 | 16KB | 419 lines

┌───────────────────────────────────────────────────┐ │ │ │ ▄▄▄ ▄ ▄ ▄ ▄▄▄ ▄ ▄ │ │ █ █ █ █ █ █ ▀ █▄▀ │ │ █ ▄█ █ █ █ █ ▄ █ ▀▄ │ │ ▀▀ ▀▀ ▀▀▀ ▀ ▀▀▀ ▀ ▀▀ │ │ │ │ █▀▀▀█ █▀▀ █ █▀▀█▀▀█ │ │ █▄▄ █ █ █ █ │ │ █ ▄ █ █ █ █ VERSION 1.1a │ │ ▀▀▀▀▀ ▀▀▀ ▀ ▀ │ │ by : PERSAD Software Inc. │ └───────────────────────────────────────────────────┘ -1- ┌─────────┐ │ PURPOSE │ └─────────┘ Quick Edit is a small editor written in Borland's Turbo Pascal 6.0 that replaces strings automatically in your CONFIG.SYS or AUTOEXEC.BAT files. It was created for quick and easy update of those pesky CONFIG.SYS and AUTOEXEC.BAT files that needed to be updated on more than two machines on a network. ┌────────────┐ │ DISCLAIMER │ └────────────┘ This product is provided "as is" without warranty of any kind. The entire risk and responsibility of the use of this product, as to the results and/or performance of this product is assumed by you. PERSAD Software Inc. makes no warranty as to the use of, results of, merchantability or fitness for purpose. Should the product prove to be defective, you exclusively assume the entire cost of all necessary servicing, repair, or correction. PERSAD Software Inc. shall not be liable for any damages, including but not limited to system damage, service, repair, correction, loss of profit, lost savings or any other incidental, consequential, or special damages of any nature whatsoever resulting from the use or inability to use this product. ┌──────────────┐ │ REGISTRATION │ └──────────────┘ This version is SHAREWARE, but none of it's features have been crippled nor is there any expiration date coded into the KEY enclosed with this release. If you find this product useful after trying it out for 30 days you MUST register it or discontinue using it. Registration enables this author to write more programs and being a college student will help to defray the high cost of tuition. You will receive a "KEY" which will get rid of all the annoying NON-REGISTERED delays and code your name into the program. To register, send a check or money order for $10 payable to: RISHI PERSAD, at the following address: PERSAD Software Inc. 87-82 160th St 2nd Fl Jamaica, NY 11432. -2- ┌──────────────────┐ │ REVISION HISTORY │ └──────────────────┘ V1.0 ß released 7/13/91. This was the first release of the software. It was released as FREEWARE for testing purposes. V1.10 never released. This is the first shareware release which contained major changes outlined below: 1> Error handling was greatly improved in the MAKEDAT.EXE program. Introduced several tightly controlled procedures to eliminate "garbage" responses to questions which would cause the EDIT program to crash. 2> MAKEDAT.EXE now supports AUTOEXEC.BAT in addition to the CONFIG.SYS file. It can now modify up to 30 strings in each file and files may now contain up to 50 strings. This number was selected to minimize memory usage. 3> Any drive from A to Z can now be selected instead of the previous 'C' only. 4> Graphics were modified for optimum performance and aesthetic values. 5> MAKEDAT.EXE now creates five editable configuration files for on the fly editing with your favorite editor should you decide not to use the MAKEDAT.EXE program. Note: The EDIT.CNF file must always contain "CAPS" or "UPPERCASE CHARACTERS". 6> The EDIT11.EXE code has been revised for efficiency and tighter control of errors. 7> Anti-Hack and Viral Protection has been added to EDIT11.EXE to provide the user with some sort of security control (albeit basic). 8> Procedures which I used only for de-bugging purposes were removed from the code . No more "string found!" appearing as program is run. 9> EDIT11.EXE will now backup the original files with the .OLD extension and the new files will have the regular extension. This will eliminate the need to rename files as required in the beta release. 10> A new compilation unit was used which caused an increase in execution speed by as much as 800 % (WOW!). -3- V1.1a released 7/25/91. This is the second public release of Quick Edit. It contains some minor enhancements which was not in V1.10 and are outlined below: 1> NEW and IMPROVED input/output error checking added for tighter control of errors. System will no longer "hang" or terminate with runtime errors (I hope). Now an error message with a possible reason for termination will be displayed. 2> Registration KEYS are now active (Arrrgh!). If you do not have the EDIT11A.KEY the program will delay for a few micro-seconds and display a "register me" message. Registration eliminates this message and codes your name into the program with the KEY. 3> Graphics were re-done to get rid of that annoying "flicker" at the start of the menus. 4> EDIT11a will now search for the existence of the *.OLD files (whose presence caused the system to hang in earlier versions) If found, the program will halt and alert you of the exact location (including drive) of those files. This can be avoided if you use the batch file included or something similar. 5> The date and time has been added at the bottom of the display screen. ┌─────────────────┐ │ GETTING STARTED │ └─────────────────┘ The following files should be found after uncompressing the archive: EDIT11.EXE - The editor that does the quick search/replace MAKEDAT.EXE - The program used to create data files needed EDIT11.DOC - This file that you're reading RUN.BAT - Sample batch file to use program EDIT11A.KEY - Key file for registered versions only After running MAKEDAT.EXE, the following files will be created: EDIT.CNF - The EDIT11.EXE configuration file A-STR.OLD - List of old strings in autoexec A-STR.NEW - List of replacement strings for autoexec C-STR.OLD - List of old strings in config C-STR.NEW - List of replacement strings for config First run the MAKEDAT.EXE program which will store the old and new strings that you will need later for the EDIT11 program. These files can also be created with any text editor but it is recommended that you use the MAKEDAT.EXE program instead. -4- Here's the format for the configuration files: EDIT.CNF: Y {Line 1 in Uppercase toggles update of CONFIG.SYS} Y {Line 2 in Uppercase toggles update of AUTOEXEC.BAT} B {Line 3 in Uppercase indicates drive location of CONFIG.SYS and AUTOEXEC.BAT files} A-STR.OLD: First Old String {First String to search for and replace} Second Old String {Second String to search for and replace} Etc {Can continue up to 30 strings} A-STR.NEW: First New String {String to replace first old string} Second New String {String to replace second old string} Etc {May list up to 30 strings} C-STR.OLD and C-STR.NEW are the CONFIG.SYS equivalent of the above. When you run the EDIT11.EXE program next, it will search for an EXACT match for each string listed in the *.OLD file. This program *IS* case sensitive so if an exact match (including spaces) is not found you will hear a "warning beep" and then a list of the strings in the file it is processing will be displayed. You will see on the top of the screen the name of the file being processed (CONFIG or AUTOEXEC) as well as the OLD string being searched for and the NEW replacement string. Simply enter the line number of the string to be deleted and the program will take care of the rest! Your original file is backed up with the .OLD extension, so make sure that there is no duplicate file existing before the program is run. If there is, then the program will quit with an error code. Take a look at the sample batch file included with this release for ways to handle this possible problem. ┌──────────────────┐ │ TROUBLE-SHOOTING │ └──────────────────┘ EDIT11 has undergone intensive testing under the following equipment/software: IBM PS/2 Model 20z Registered Trademark of IBM Corp. PACKARD BELL 386sx Registered by Packard Bell Electronics MS-DOS V3.3 - V5.0 Registered Trademark of Microsoft Corp. PC-DOS V3.3 Trademark of IBM Corp. Windows 3.0 Registered Trademark of Microsoft Corp. Novell Netware Registered Trademark of Novell, Inc. If you encounter any problems please leave the author a message on any one of the following BBSs: Email: Rishi Persad at Beginners BBS [212] 397-1576 Computron I [718] 478-6065 (Here most often!) Omni BBS [718] 274-5469 WiseByte BBS [212] 962-1920 -5- [Q] EDIT11 terminates with a runtime error after being called up. [A] The program could not find the files in the drive specified. Make sure that the files are NOT hidden and that any write protection on the drive has been temporarily disabled. You must also have the configuration files that the makedat.exe created in the SAME directory as the EDIT11 program. [Q] MAKEDAT terminates with a runtime error. [A] This will only happen in versions earlier than 1.1a. Be sure that you have overwritten the old version. If you still get the same problem, after re-booting the machine, then contact this author at once with the error code generated and the exact circumstance when it occured. [Q] MAKEDAT will not let you abort an entry and stays at the prompt. [A] You are trying to enter a value outside the valid entry range. MAKEDAT has been designed to accept values which are considered valid for the EDIT11 program only. The prompt will usually give you the valid range in square brackets. If you enter anything else, it will refuse to accept it. [Q] The configuration files created are ZERO bytes (empty). [A] The MAKEDAT program was aborted by user . ┌────────────────┐ │ ERROR MESSAGES │ └────────────────┘ Here is a list of error messages and possible reasons for generation : 1> NEW DATA SAME AS OLD DATA ! The data entered as the OLD string is exactly the same as that entered for the NEW string. For example, if you enter the foll: OLD STRING : BUFFERS=20 NEW STRING : BUFFERS=20 You will get that message with a prompt to abort or continue. Hit the ESC key to abort the program or any other key to continue. 2> ABORTED BY USER ! You requested to abort the program. 3> ABORTED...NOTHING TO DO ! The request to update CONFIG.SYS and AUTOEXEC.BAT were both replied with a negative (N) response. -6- 4> CONTACT AUTHOR : I/O ERROR DURING SELF CHECK ! The self check procedure failed to work. Possible bug. Please leave a message to the author (Rishi Persad) at any of the previously listed Bulletin Boards. 5> WARNING : CODE CHANGED! FILE MAY BE INFECTED!! The EDIT11 file has detected a change in it's code after compilation. This may be due to a corrupted file, hacking, or a possible virus has attached itself to the file. The program will NOT run and MUST be deleted. You will need to get a fresh/new copy from your backup or archive file. 6> EXACT MATCH NOT FOUND IN .... EDIT11 is case sensitive and may report the above message if it could not find the string being searched for or if the match was not complete. 7> NEW AND OLD STRINGS NOT EQUAL ! There must be a NEW string for every OLD string and vice versa. If there is a conflict in the line numbers of the .OLD and .NEW configuration files then the program will abort rather than risk putting 'garbage' in order to pad and correct the balance. Note: If you wish to delete a string, simply indicate a blank line as the NEW string. 8> INVALID KEY ! The KEY file has been tampered with or is corrupted. ┌────────┐ │ THANKS │ └────────┘ I wish to thank the following : * Varouj Oghali - For the incentive and idea to start this program. * James Javier - For his support and suggestions. * Andreas Kantounas - For teaching me how to draw windows. * Michael Durkin - For the self check unit V1.0 used here. * Scott Davis - For rKey V1.6 used to annoy users <GRIN>. * Eagle Performance Software - For use of their SYS60 V6.0A, which replaced the SYSTEM.TPU and increased speed 800 % !! -7- ┌────────┐ │ FUTURE │ └────────┘ Plans are in the works for : 1. Even faster performance. 2. Non-case sensitive search and replace. 3. Ability to update any file. 4. More error control/protection. 5. Less memory usage and disk space. 6. Program controlled by ONE editable ascii file. 7. Improved graphic display (yes, there is room).