NOTE: This is a copyrighted program released for private, non-commercial use ONLY. Please read copyright statement starting on line number 58 for details. Program: VREN (Visual RENamer) Author: Bruce Morgen (contact via DHN* @ 215-623-4040 or Version: 1.0 Lillipute Z-Node @ 312-649-1730) Date: August 8, 1988 Purpose: Interactive renaming of files with format checking. VREN takes a single wildcard filespec from the command (if none given, "*.*" assumed). It then allows the user to step through the file names and change them using the WordStar(tm) diamond and/or the TCAP-defined arrow keys for cursor movement. This includes the WS control-A/control-F end-of-line commands. VREN always operates in an overwrite mode - there is no control-V mode toggle. Typing a period (.) moves the cursor to the first character of the file extension, wiping out any remaining filename characters to properly attributed blanks, unless the cursor is over the first character of the extension, in which case it moves to the last character of the filename. Otherwise editing behavior is quite predictable. There is a rubout function closely resembling WS response and the WS control-G (gobble) also works, although both treat the filename and extension as distinct fields. A carriage return initiates the actual renaming of the file. VREN toggles file attributes using control-T as the trigger, but, as with a rename, nothing changes until a RET. Any attributed characters are shown in alternate video or lower case if possible. Unless VREN is "quieted" there is a "12345678|rsa" header for clarity. There is protection against setting attribute #2, the home of the Plu*Perfect-style "PUBlic" tag, if more than one file of the name in question exist on the same drive. To disable this feature for non-PUBlic BDOS or vanilla ZRDOS, see "Patching" below. _______________________________________________________________ Patching: VREN obeys the ZCPR3 Quiet Flag unless the low (0) bit of the byte at origin+2 (102h in DDT) is patched to a non-zero value - in that case VREN is always "quiet." The high (7) bit of this byte controls the attribute #2 protection scheme for Plu*Perfect-compatible DOSs described above. Set this bit if you know what you're doing and want to be able to set attribute #2 at will. Value at origin+2 Results in: ----------------- ----------- 00h "loud" & PUBlic protected 01h "quiet" & PUBlic protected 80h "loud" & PUBlic unprotected 81h "quiet" & PUBlic unprotected _______________________________________________________________ [ N O T I C E O F P R O G R A M O W N E R S H I P ] VREN is copyright 1988 by the author. It is released to the user community in source and/or object form for non- commercial use only. Permission is hereby given to use and/or modify it in any way that you see fit. The author retains exclusive rights to public release of VREN and asks that any improvements to the program or adaptations for other operating environments not be distributed in any way without his consent. Furthermore, any commercial use of VREN, including its internal algorithms and screen presentation, without the express written agreement of the author is specifically prohibited. This prohibition includes sale of the program in any form except as part a user group library disk selling for not more than $20 copying and handling fee or as a download offering on remote access systems with no fee charged beyond normal subscription and/or access rates. VREN may not be sold or licensed by any person other than the author or his authorized agent(s). As of August 8, 1988, there have been no such agents appointed. The author warrants that VREN comprises his original work and as such is protected by the copyright laws of The United States of America and applicable international copyright regulations. No other warranty is expressed or implied. (signed) Bruce Morgen August 8, 1988 _______________________________________________________________