Phoenix CD 2.0

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

/ Phoenix CD 2.0 / Phoenix_CD.cdr / 15a / eddy.zip / EDDY.DOC < prev next >

Wrap

Text File | 1987-03-15 | 54KB | 1,271 lines

@ GEDDYH GUSER'S MANUALH G --------------------------------- I EDDY (TM) version 1.06 I I File and Directory Editor I I Copyright (C) 1987 I I by John Scofield I I All rights reserved I I ■ User Supported Software ■ I --------------------------------- H This program is supplied as-is. The author disclaims all warranties, expressed or im- plied, including, without limitation, the warranties of merchantability and the war- ranties of fitness for any purpose. Copies of this program may not be sold for more than the cost of the medium on which they are copied, plus reasonable handling char- ges. The total price may not exceed $10. GTABLE OF CONTENTSH 1.0 What Does EDDY Do? 1.1 EDDY is Ready if You Are 1.2 EDDY's Display 1.3 An Overview 1.4 What EDDY Doesn't Do 2.0 Keyboard Usage Summary 2.1 Moving the Cursor 2.2 Commands 3.0 EDDY's DOS Command Line 3.1 Path Specifications 3.2 Options 4.0 Editing Directory Entries 4.1 Renaming Files 4.2 Changing Date and Time - <Ins> 4.3 Changing File Attributes 5.0 Moving to a New Directory 5.1 Working Directory - <Alt-x> 5.2 Target Directory - <Alt-t> 6.0 COPY Command - <F5> 7.0 MOVE Command - <F6> 8.0 DELETE Command - <F7> 9.0 DESTROY Command - <F8> 10.0 UNDO Commands - <F9> and <F10> 11.0 UPDATE Mode - <Enter> 11.1 UPDATE Processing Overview 11.2 An UPDATE Example, Including Error Handling 12.0 LOOK Command - <F3> 12.1 LOOK at Subdirectory 12.2 LOOK at File Contents 13.0 PATCH Command - <F4> 14.0 Do You Like EDDY's Colors? 14.1 Changing EDDY's Screen Attributes 14.2 I Can't Even Read the Screen! 15.0 Distribution and Support 15.1 GEDDY is NOT Free!H 15.2 Technical Support 15.3 Future Enhancements G1.0 -1What Does EDDY Do?-0H GEDDYH (for GEDHit GDHirectorGYH) provides the following services: ■ EDIT directory entries, including name, date, time and attributes of files ■ COPY, MOVE, DELETE and/or DESTROY files ■ LOOK at or PATCH data in files EDDY is offered as a tool which is felt to be easier and more convenient to use than other programs which provide similar capabilities. EDDY is also cheaper. EDDY is not in the public domain - EDDY is "user-supported" software. Distribu- tion and use of EDDY is subject to the conditions given in Section 15.1. G1.1 -1EDDY is Ready if You Are-0H EDDY needs the following hardware and software: IBM PC, XT, AT or close compatible A monitor that can accommodate 25x80 text mode display At least 52K of available memory PC- or MS-DOS level 2.0 or later If you have those, EDDY is ready to go to work for you. If you have more memory, EDDY can handle more files and use bigger buffers for faster file I/O. EDDY will use as much memory as possible, up to 128K maximum. EDDY has extensive HELP facilities, which may be called on at any time by press- ing <F1>. HELP includes all of the basic information needed to use EDDY. The simplest way to get familiar with EDDY is to just type "EDDY" and <Enter>. There is no danger of damage to your disk data, because no changes will be made to any of your directories or files unless you explicitly tell EDDY to do so. If you see the message G"Need video in 80 column text mode"H, you must use the DOS MODE command to change to text mode by entering G"mode co80"H or G"mode bw80"H. GNOTE: If EDDY's display is blurred or unreadable, try running EDDY with option /M (i.e., "EDDY/M"). If the display is now OK, follow the steps given in Section 14.2 to modify EDDY to work better with your monitor.H G1.2 -1EDDY's Display-0H EDDY's basic display is similar to that of the MS-DOS "DIR" command. This is a sample of a typical EDDY display: ================================================================================ GEDDY (TM) version 1.06 ■Copyright (C) 1987 by John Scofield ■All rights reserved filename.ext size date time RO HD SY VL SD AR -- -- changes:NAM D/T ATTH Directory of A:\*.* Volume in drive A is EDDY 42 files +++ 88064 bytes free GAUTOEXEC BAT 788 10/21/86 11:30a 0 0 0 0 0 1 0 0H BAT <DIR> 2/04/87 9:15p 0 0 0 0 1 0 0 0 CMDSUB ASM 12856 9/17/86 7:45p 0 0 0 0 0 0 0 0 CMDSUB OBJ 1246 9/17/86 7:52p 0 0 0 0 0 0 0 0 COMMAND COM 22885 11/26/85 10:22p 0 0 0 0 0 0 0 0 CONFIG SYS 79 10/18/86 7:31p 0 0 0 0 0 0 0 0 CONVRT ASM 5927 9/06/86 11:15a 0 0 0 0 0 0 0 0 CONVRT OBJ 499 9/06/86 11:20a 0 0 0 0 0 0 0 0 EDDY <DIR> 1/25/87 12:52p 0 0 0 0 1 0 0 0 ERROUT ASM 5663 9/15/86 8:15p 0 0 0 0 0 0 0 0 ERROUT OBJ 2127 9/15/86 8:16p 0 0 0 0 0 0 0 0 MIO SYS 9054 11/18/85 12:00p 1 1 1 0 0 1 0 0 MSDOS SYS 27856 11/18/85 12:00p 1 1 1 0 0 1 0 0 PRINT COM 8339 11/18/85 12:00p 0 0 0 0 0 0 0 0 PSP DEF 1195 1/29/87 7:21p 0 0 0 0 0 1 0 0 UTLSUB ASM 10649 2/09/87 1:49a 0 0 0 0 0 1 0 0 UTLSUB OBJ 965 2/09/87 1:50a 0 0 0 0 0 1 0 0 VDISK SYS 2721 11/18/85 12:00p 0 0 0 0 0 0 0 0 G«EDIT» <Enter> to UPDATE. F1:HELP F2:QUIT F3:LOOK F5:COPY F7:DEL F9:UNDOH ================================================================================ GFigure 1-1H The major differences between EDDY's display and DIR's display are: 1) EDDY displays directory information for all files, including hidden files; 2) file attribute bit settings are included in the display; 3) the display is normally sorted by file name and extension; and 4) only a page at a time is shown, and you may scroll forward and backward in the display as desired. With displays containing more than one page, "arrows", pointing up and/or down will appear in the corners of the screen to show that there is more data to be viewed by scrolling in that direction. These arrows don't print on all printers, so you may or may not see them in Figure 1-1, above. In one respect, Figure 1-1 is not typical: you shouldn't normally see the three plus signs (+++) shown on the fourth line - certainly not with a display that contains only 42 files. These plusses appear only when the directory contains more files to be displayed than EDDY can handle - the current limit is between 112 (max. allowed by DOS in a root directory) and around 375, depending on how much usable memory is available. Note that this is a limit on the display only - not on the size of directories. If you had, say, 1500 files in directory "\BIGDIR", and you wanted to work with all assembler source files in that directory, the command "EDDY \BIGDIR\*.ASM" would yield a display of all .ASM files, up to the limit mentioned above. G1.3 -1An Overview-0H The directory displayed by EDDY is referred to as the "working directory". If any files are copied or moved, they will be placed in the "target directory". The working and target directories, as well as some other parameters, may be given on the DOS command line. The directories may be changed during execution of EDDY. If the command line does not include any directory specification, the current directory in the default drive will be the initial working directory. Details on use of the DOS command line with EDDY are given in the Section 3.0. EDDY begins execution in EDIT mode. In EDIT mode, the entries in the working directory are displayed. You may edit information in those directory entries, including filename, extension, date, time and attribute bit settings. You may also select files to be copied, moved, deleted or destroyed. All changes you make, or selections for copying, etc., will be shown on the screen, but no changes will be made on disk until you tell EDDY to do so. EDDY applies the requested changes to disk when you enter UPDATE mode. This is done by pressing <Enter> at any time. EDDY will then ask you to confirm that you want to write to disk (by pressing <Enter> again), and you will also be given the choice of returning to EDIT without making any changes. At any time before writing changes to disk (in UPDATE mode), you may change your mind and UNDO the changes. You may UNDO changes to the current file - <F9> - or you may UNDO all changes to all files - <F10>. G1.4 -1What EDDY Doesn't Do-0H EDDY does all file and directory manipulations by use of various functions of DOS's service interrupt, INT 21h - no direct access is made to directories or other parts of the disk. Thus, EDDY does not currently offer file "undelete" capabilities, sector- oriented patching, or directory sorting (except in the display). On the other hand, since EDDY does no absolute sector reads or writes (BIOS INT 13h), the chances of accidentally trashing your disk are minimized. Additional functionality is planned for EDDY, depending on market response. For more information on future plans, see Section 15.2. G2.0 -1Keyboard Usage Summary-0H This summary is provided as a "quick reference" guide. The same information is available on-line with HELP mode. Further details of use of the various keys may be found in the later sections of this document. Throughout this document, key names are enclosed between "<" and ">" delimiters. As the "arrow" characters are not printable in general, the cursor control keys are indicated by the word for the direction of the arrow printed on the key cap. In key names, these prefixes are also used to indicate shifted key combinations: "s-" = Shift, "c-" = Ctrl, and "Alt-" = Alt G2.1 -1Moving the Cursor-0H EDDY's cursor is moved around in the display as follows: <Up> - move up 1 line <PgUp> - up 1 page <Down> - move down 1 line <PgDn> - down 1 page <Home> - move to top of page <End> - move to end of page <c-Home> - display first page <c-End> - display last page <Left> - left 1 column <Right> - right 1 column <s-Tab> - left 1 field <Tab> - right 1 field <c-Left> - left edge (col. 1) <c-Right> - right edge Some fields on the screen are 'protected' so that the cursor can't be moved to that position. Instead, it will move to the next unprotected position. G2.2 -1Commands-0H Commands tell EDDY what to do to the files that are displayed. Generally, they affect the current file, as selected by the cursor. Most common commands are assigned to function keys. Other commands generally are assigned to an <Alt-letter> combination. An attempt has also been made to "pair" the function keys logically, so that the right (even numbered) key command in a row is in some sense similar to the left (odd) key command. The right key command is an extension of or a more "drastic" command than the left key command. As there is not enough room on one line of the screen to display all the command choices, this "pairing" approach is intended as an aid to remembering the sec- ond key of a pair when you see the first displayed. Here's hoping the "logic" of this fits your way of thinking! The paired commands are: <F1> - HELP <F2> - QUIT <F3> - LOOK at data in file or LOOK at files in directory <F4> - PATCH data in file <F5> - COPY file <F6> - MOVE file <F7> - DELETE file <F8> - DESTROY file <F9> - UNDO changes on this file <F10> - UNDO all changes on all files The other command keys are: <Ins> - G-1INS-0HERT current date & time in file's directory entry <Alt-b> - toggle G-1b-0Hit-stripping (WordStar-like files) in LOOK's TEXT format <Alt-h> - toggle LOOK or PATCH mode format to G-1H-0HEX from TEXT, or vice versa <Alt-t> - change G-1T-0HARGET directory for COPY/MOVE <Alt-x> - eG-1x-0Hchange current working and target directories The underlined letters are emphasized here as an attempt to help you to remember the corresponding commands. G3.0 -1EDDY's DOS Command Line-0H When EDDY is executed without any parameters (options) or filenames given on the command line, the current default drive and directory information are displayed. The command line format is: EDDY [options] [<path1>] [<path2>] G3.1 -1Path Specifications-0H <path1> defines the working directory, in normal DOS format, just as used with the DIR command (d:\path\filename.ext). Wild card characters are supported. If no filename is given, *.* is assumed. For example, "EDDY c:\testdir\abc" would display all files in subdirectory "abc" or, if there is no such subdirectory, display all files with name "abc" in the "testdir" subdirectory. <path2> defines the target directory, to receive any files copied or moved. No filenames are allowed in the <path2> specification, as the filenames will come from the files in the working directory. The target directory need not be on the same drive as the working directory. If you want to use the current directory as the working directory, <path1> may be abbreviated to '.' "EDDY . c:" would display all files in the current default directory, and any files copied or moved would go to the current directory of drive "c:". Both the working and target directories may be changed during execution of EDDY. This is explained further in Section 5.0. Note that the working directory and target directory may not be the same. EDDY will give an error message if this occurs. G3.2 -1Options-0H Options are parameters given to EDDY on the command line, as with normal DOS commands, e.g., "EDDY/S/C" tells EDDY to use options "S" and "C". Options must be placed at the beginning of the command line, before any path specifications. The available options and their meanings are: /C - Normally, EDDY checks whether the file to be copied is already in the the target directory, displays the date/time of that file, and asks if you want to proceed with copying. With option /C, no check is made. /M - EDDY assumes that if you are using a Color Graphics Adapter, you are using a color monitor. In some cases where this is not true, the dis- play may be blurred or illegible. If option /M is used, EDDY assumes you are using a monochrome monitor. See also Section 14.2. /S - EDDY displays the directory in sorted order, by filename & extension, unless option /S is used. /T - EDDY normally does not change the timestamp when it makes a copy of a file. If option /T is used, the copy will be given the current date. Unlike the path specifications, options can't be changed during execution. G4.0 -1Editing Directory Entries-0H To edit a file's directory entry, move the cursor to the line of the display for that file. The line with the cursor will be highlighted, and the corresponding file becomes the "current file". The cursor will skip over fields which can't be edited, such as file size. If you try to enter data which is not valid for the field under the cursor (e.g., a letter in a date or time field), EDDY will "beep" at you and ignore the entry. It is possible to enter combinations of characters which result in invalid data in a field. For example, "02" is a valid month and "31" is a valid day, but to- gether they are an invalid date. EDDY catches errors of this type whenever you try to move the cursor off of the current file. EDDY "beeps" and puts the cursor on the field where the error was detected. G4.1 -1Renaming Files-0H Renaming a file is done by just typing the new name over the old on the screen. An asterisk - "*" - will appear on that file's line under the heading "NAM" to remind you that a change has been made. The file will be renamed on disk when you enter UPDATE mode. Any valid characters for filenames may be entered, including spaces (except the first character may not be a space). Valid characters are any in the range 20h through 7Eh, except for the following:G . " / \ [ ] : | < > + = ; ,H A filename may not have a space as its first character, and any lowercase let- ters are converted to uppercase by DOS. Note that it is possible to rename files with EDDY such that they can't be used with normal DOS commands, by using names containing embedded blanks. G4.2 -1Changing Date and Time - <Ins>-0H Dates are displayed in month/day/year format, and times are displayed based on a 12-hour clock with an "a" or "p" to show a.m. or p.m. EDDY allows only valid month/day combinations to be entered, with one exception: no leap year check is made, so Feb. 29th is always accepted. Hours in the range 01 to 12 are accepted, and minutes must be 00 to 59. EDDY also provides a simple means of stamping a file's directory entry with the current system date and time, as maintained by DOS. To use the system timestamp, press <Ins>. The current file entry will be set to the system value. Note that once <Ins> has been used, all subsequent presses of <Ins> will yield the same timestamp as the first one. This is intended for use in timestamping a series of files for identification purposes, as when preparing files for distribution. When a change has been made to the date or time, an asterisk will appear in the line under the heading "D/T". If both date and time have been changed, two as- terisks will appear. The changes will be written to disk when you enter UPDATE mode. G4.3 -1Changing File Attributes-0H Attribute bit settings are displayed under the headings: "GRO HD SY VL SD AR -- --H" which stand for, respectively: Gread-only, hidden, system, volume label, subdirectory, archiveH and GunusedH file attributes. A "1" indicates the attribute is on for this file; "0" means it is off. The attribute bit settings may be changed by typing the new value over the old. The attributes which may be changed are: RO, HD, SY and AR. When a change has been made to one or more attribute bits, an asterisk will ap- pear under the heading "ATT". The changes will be written to disk when you enter UPDATE mode. G5.0 -1Moving to a New Directory-0H EDDY can change working directories and/or target directories at any time. These may be on the same or different disks, without restriction. G5.1 -1Working Directory - <Alt-x>-0H The current working directory is displayed in the third line of the first screen of EDDY's EDIT display, as shown in Figure 1-1. You may move to a new working directory by use of the LOOK command, as explained in Section 12.1. Another way to change to a new working directory is to exchange the current wor- king and target directories, by pressing <Alt-x>. This provides a way to work on directories on different drives. This can be useful, for example, if you have done many moves or copies and want to review the results. G5.2 -1Target Directory - <Alt-t>-0H The target directory will receive all copies or moves. It may be specified on the command line when EDDY is started, or at any time during execution. To check the target directory setting, press <Alt-t>. EDDY will display the cur- rent drive and path (or tell you that there is no current target) and allow you to change the target directory if you wish. If you do not want to enter a new target directory path after pressing <Alt-t>, just press <Esc> to return to EDIT. The current target directory assignment will remain unchanged. The target directory cannot be the set to the same as the working directory. Since it is a directory that is being specified, no filename should be included in the specification; only a drive and path are allowed. Note that changing the target directory while there are files selected for copy- ing or moving will result in the new target being used when you enter UPDATE mode. EDDY will warn you when this situation occurs. If you change your working directory (as discussed in Section 12.1) to the same value as your target directory, the target directory will be set to "no target". If you then enter a "copy" or "move" command, EDDY will ask you for a new target directory. G6.0 -1COPY Command - <F5>-0H Press <F5> to copy the current file. If there is no target directory, EDDY will ask you for one. Entering target directories is explained in Section 5.2. EDDY normally checks the target directory to see whether a file of the same name is already present. If so, the directory entry for that file is displayed, which allows you to compare sizes and timestamps to decide whether to proceed with the copy or not. If the file is not in the target, EDDY informs you of that. In ei- ther case, you confirm that you want to copy by pressing <F5> again; if you de- cide not to copy, <Esc> continues with editing. The word "Copy" will appear in the display to show that the file has been selec- ted. The actual copy will be done when you enter UPDATE mode. After the copy has been made, the word "copied" will appear in the EDIT mode display for that file. If you want to skip the confirmation step (i.e., you don't want to check the target directory), execute EDDY with option /C on the command line. If you have specified other changes to be made to the directory entry (renaming, timestamping or attribute settings), these changes will be made -1after-0 the copy, so the new copy will have the original values in its directory entry. An excep- tion to this is the Archive attribute bit. This attribute is always set "on" in the new copy's directory entry, so that the file will be backed up the next time a backup is done for the target directory. Normally, copies receive the same date and time as the original; if you want to put the current timestamp on copies, use option /T on the command line. G7.0 -1MOVE Command - <F6>-0H Moving a file means that its directory entry is placed in the target directory and deleted from the working directory. The working and target directories may be on the same or different disks. Press <F6> to select the current file to be moved. If there is no target direc- tory specified, EDDY will ask you for one. Entering target directories is ex- plained further in Section 5.2. You may not "move" a file to a target directory containing a file of the same name. If this is what you need to do, the same effect may be achieved by first doing a "copy", entering UPDATE mode, and then "delete" the file. The word "Move" will appear in the display to show that the file has been selec- ted. The actual move will be done when you enter UPDATE mode. After the move has been done, the word "moved" will appear in the display for that file, and all directory information (size, date, etc.) will be blanked out. The heading information showing the number of files in the display and the num- ber of free bytes on the disk will be updated. If the target and working direc- tories are on the same disk, of course the number of free bytes will not change. No other changes may be made to a file that is selected for moving. The Archive attribute is always set "on" in the moved file's directory entry, so that the file will be backed up the next time a backup is done for the target directory. G8.0 -1DELETE Command - <F7>-0H To select the current file for deletion from the working directory, press <F7>. The word "Delete" will appear in the display to show that the file has been se- lected. The actual deletion will be done when you enter UPDATE mode. After the deletion has been done, the word "deleted" will appear in the EDIT mode display for that file, and all directory information (size, date, etc.) will be removed from the display. The heading information showing the number of files in the display and the num- ber of free bytes on the disk will be updated to reflect the deletion. Only one other change may be made to a file that is selected for deletion. Since DOS won't allow deletion of a file which has its Read-only attribute on, EDDY allows you to turn that attribute off for files to be deleted. No other changes are allowed. G9.0 -1DESTROY Command - <F8>-0H Destroying a file means to overwrite the file, thus destroying the data within it, and then delete the file from the working directory. This can be used to protect sensitive data from snoopers who might try to use one of the "undelete" utilities to get at the data. The current file will be marked for destruction if you press <F8>. The word "Destroy" will appear in the display to show that the file has been se- lected. The actual overwrite and deletion will be done when you enter UPDATE mode. EDDY overwrites the entire file with question marks. After destruction, the word "destroyed" will appear in the EDIT mode display for that file, and all directory information will be removed from the display. The heading information showing the number of files in the display and the num- ber of free bytes on the disk will be updated to reflect the deletion. G10.0 -1UNDO Commands - <F9> and <F10>-0H Any changes which have been requested may be "Undone" as long as they have not yet been written to disk by entering UPDATE mode. To undo changes on the current file, press <F9>. To undo all changes requested for all files, press <F10>. G11.0 -1UPDATE Mode - <Enter>-0H When you want to apply the changes you have made in EDIT mode to disk, press <Enter> to go to UPDATE mode. EDDY will ask you to confirm that you want to go to UPDATE, by pressing <Enter> again. This is to avoid accidentally writing to disk before you are ready because of touching a key by mistake. G11.1 -1UPDATE Processing Overview-0H As each file for which you requested changes is being processed, its EDIT mode display line appears on the screen, allowing you to monitor progress through the directory. If a file's display line is not yet shown, nothing has been done to that file. After each file has been processed, EDDY checks to see if you have asked for the updating to be suspended, by pressing <Esc>. All processing requested for the file being worked on will be completed, but no work will start on the next file if you have pressed <Esc>. When UPDATE has been suspended, it may be resumed by pressing <Enter>. If you press <Esc>, EDDY returns to EDIT mode, leaving intact any requests for changes not yet processed by UPDATE; these changes may be undone if desired. If any errors are encountered during UPDATE processing, such as read or write problems, EDDY reports the error as indicated by DOS and suspends the UPDATE at that point. You may resume the UPDATE or return to EDIT, as you choose. After UPDATE, if you return to EDIT, you may make further changes, copies, etc., just as when you first started EDDY. These changes will be processed when you enter UPDATE again. UPDATE adjusts the heading display of number of files and number of free bytes according to the changes it has made. G11.2 -1An UPDATE Example, Including Error Handling-0H Figure 11-1, below, is an example of a screen which could have been created from the screen in Figure 1-1. In Figure 11-1, the following changes have been requested, but no changes have yet been made on disk: 1. Delete the BAT subdirectory 2. Move CMDSUB.ASM and CMDSUB.OBJ to the target directory 3. Delete CONFIG.SYS from the working directory 4. Copy CONVRT.ASM, CONVRT.OBJ, UTLSUB.ASM, UTLSUB.OBJ to target directory 5. Rename the EDDY subdirectory to EDDY.BAK 6. Change MIO.SYS and MSDOS.SYS so they are no longer "hidden" files 7. Change the date and time on the file PSP.DEF ================================================================================ GEDDY (TM) version 1.06 ■Copyright (C) 1987 by John Scofield ■All rights reserved filename.ext size date time RO HD SY VL SD AR -- -- changes:NAM D/T ATTH Directory of A:\*.* Volume in drive A is EDDY 42 files 88064 bytes free AUTOEXEC BAT 788 10/21/86 11:30a 0 0 0 0 0 1 0 0 BAT <DIR> 2/04/87 9:15p 0 0 0 0 0 1 0 0 Delete CMDSUB ASM 12856 9/17/86 7:45p 0 0 0 0 0 0 0 0 Move CMDSUB OBJ 1246 9/17/86 7:52p 0 0 0 0 0 0 0 0 Move COMMAND COM 22885 11/26/85 10:22p 0 0 0 0 0 0 0 0 CONFIG SYS 79 10/18/86 7:31p 0 0 0 0 0 0 0 0 Delete CONVRT ASM 5927 9/06/86 11:15a 0 0 0 0 0 0 0 0 Copy CONVRT OBJ 499 9/06/86 11:20a 0 0 0 0 0 0 0 0 Copy EDDY BAK <DIR> 1/25/87 12:52p 0 0 0 0 1 0 0 0 * ERROUT ASM 5663 9/15/86 8:15p 0 0 0 0 0 0 0 0 ERROUT OBJ 2127 9/15/86 8:16p 0 0 0 0 0 0 0 0 MIO SYS 9054 11/18/85 12:00p 1 0 1 0 0 1 0 0 * MSDOS SYS 27856 11/18/85 12:00p 1 0 1 0 0 1 0 0 * PRINT COM 8339 11/18/85 12:00p 0 0 0 0 0 0 0 0 PSP DEF 1195 12/25/86 1:00p 0 0 0 0 0 1 0 0 * * UTLSUB ASM 10649 2/09/87 1:49a 0 0 0 0 0 1 0 0 Copy UTLSUB OBJ 965 2/09/87 1:50a 0 0 0 0 0 1 0 0 Copy GVDISK SYS 2721 11/18/85 12:00p 0 0 0 0 0 0 0 0H G«EDIT» <Enter> to UPDATE. F1:HELP F2:QUIT F3:LOOK F5:COPY F7:DEL F9:UNDOH ================================================================================ GFigure 11-1H Suppose that after reaching the point illustrated in Figure 11-1, you decide to make all these changes on disk, by pressing <Enter> twice. To illustrate the way EDDY handles errors during UPDATE, let's assume that the "BAT" subdirectory in this example still contains some files. In this case, DOS would refuse to delete the subdirectory, EDDY would suspend processing, and a display like the one in Figure 11-2 would appear. ================================================================================ Gfilename.ext size date time RO HD SY VL SD AR -- -- changes:NAM D/T ATTH BAT <DIR> 2/04/87 9:15p 0 0 0 0 1 0 0 0 Delete DOS func:3Ah, err:05, Access denied G«UPDATE» suspended. <Esc> returns to EDIT. <Enter> resumes UPDATE. F2:QUITH ================================================================================ GFigure 11-2H The error message tells you the DOS (Int 21h) function that encountered the err- or, the value of the error code returned by DOS, and the standard DOS message for that error code. In the example, the function was 3Ah - Remove Directory - and the error code was 05, which is what DOS returns in this situation. To continue with our example, let's assume that you decide to ignore the failure to delete the BAT subdirectory, because it doesn't really affect what you want to do to the other files. Therefore, you press <Enter>, to resume the UPDATE. Now suppose that the target directory in this example has room for only about 24K of new files - i.e., not enough room for all the files you want to move or copy to it. In this case, EDDY would suspend the processing when it is unable to satisfy the copy request, and you would see the display below: ================================================================================ Gfilename.ext size date time RO HD SY VL SD AR -- -- changes:NAM D/T ATTH BAT <DIR> 2/04/87 9:15p 0 0 0 0 1 0 0 0 Delete DOS func:3Ah, err:05, Access denied CMDSUB ASM 12856 9/17/86 7:45p 0 0 0 0 0 0 0 0 Move CMDSUB OBJ 1246 9/17/86 7:52p 0 0 0 0 0 0 0 0 Move CONFIG SYS 79 10/18/86 7:31p 0 0 0 0 0 0 0 0 Delete CONVRT ASM 5927 9/06/86 11:15a 0 0 0 0 0 0 0 0 Copy CONVRT OBJ 499 9/06/86 11:20a 0 0 0 0 0 0 0 0 Copy EDDY BAK <DIR> 1/25/87 12:52p 0 0 0 0 1 0 0 0 * MIO SYS 9054 11/18/85 12:00p 1 0 1 0 0 1 0 0 * MSDOS SYS 27856 11/18/85 12:00p 1 0 1 0 0 1 0 0 * PSP DEF 1195 12/25/86 1:00p 0 0 0 0 0 1 0 0 * * UTLSUB ASM 10649 2/09/87 1:49a 0 0 0 0 0 1 0 0 Copy DOS func:40h, err:29, Write error G«UPDATE» suspended. <Esc> returns to EDIT. <Enter> resumes UPDATE. F2:QUITH ================================================================================ GFigure 11-3H The error message tells you that during execution of DOS function 40h - Write to File or Device - an error 29 was encountered. This is what DOS returns to signal that it was not able to write successfully - in our case, because there was not enough room. At this point, if you press <Esc> to return to EDIT, you will see this screen: ================================================================================ GEDDY (TM) version 1.06 ■Copyright (C) 1987 by John Scofield ■All rights reserved filename.ext size date time RO HD SY VL SD AR -- -- changes:NAM D/T ATTH Directory of A:\*.* Volume in drive A is EDDY 39 files 104448 bytes free AUTOEXEC BAT 788 10/21/86 11:30a 0 0 0 0 0 1 0 0 BAT <DIR> 2/04/87 9:15p 0 0 0 0 1 0 0 0 Delete CMDSUB ASM moved CMDSUB OBJ moved COMMAND COM 22885 11/26/85 10:22p 0 0 0 0 0 0 0 0 CONFIG SYS deleted CONVRT ASM 5927 9/06/86 11:15a 0 0 0 0 0 0 0 0 copied CONVRT OBJ 499 9/06/86 11:20a 0 0 0 0 0 0 0 0 copied EDDY BAK <DIR> 1/25/87 12:52p 0 0 0 0 1 0 0 0 ERROUT ASM 5663 9/15/86 8:15p 0 0 0 0 0 0 0 0 ERROUT OBJ 2127 9/15/86 8:16p 0 0 0 0 0 0 0 0 MIO SYS 9054 11/18/85 12:00p 1 0 1 0 0 1 0 0 MSDOS SYS 27856 11/18/85 12:00p 1 0 1 0 0 1 0 0 PRINT COM 8339 11/18/85 12:00p 0 0 0 0 0 0 0 0 PSP DEF 1195 12/25/86 1:00p 0 0 0 0 0 1 0 0 UTLSUB ASM 10649 2/09/87 1:49a 0 0 0 0 0 1 0 0 Copy UTLSUB OBJ 965 2/09/87 1:50a 0 0 0 0 0 1 0 0 Copy GVDISK SYS 2721 11/18/85 12:00p 0 0 0 0 0 0 0 0H G«EDIT» <Enter> to UPDATE. F1:HELP F2:QUIT F3:LOOK F5:COPY F7:DEL F9:UNDOH ================================================================================ GFigure 11-4H You may now continue with normal EDIT processing, making changes to the other files or to the same files, except of course you cannot make any changes to the files which have been deleted or moved. To avoid encountering the same errors in later UPDATEs, you would probably want to do an "Undo All", by pressing <F10>, in order to undo the pending delete (of BAT) and copies (of UTLSUB.ASM & .OBJ) which failed. The same effect could be achieved by doing an "Undo" - <F9> - on the individual files. G12.0 -1LOOK Command - <F3>-0H LOOK has two distinct functions, depending upon the current file when LOOK is requested. If the current file is actually a subdirectory, then the request is interpreted as "display the contents of this subdirectory". For normal files, LOOK means "examine the contents of this file". G12.1 -1LOOK at Subdirectory-0H When you LOOK at a subdirectory, you change EDDY's working directory. This is done by moving the cursor to the display line of the directory you want to LOOK at and pressing <F3>. For an alternative way to change the working directory, refer to Section 5.1. The new display will include all files in the directory - *.* - regardless of any file specification which may have been used on the command line. Even if you later return to the original directory, all files will be displayed. Figure 12-1 is an example of a display which might have been reached from the display shown in Figure 1-1, by the following steps: 1) move the cursor to the line containing the subdirectory "EDDY", and press <F3>; 2) in the resulting display (not shown), move the cursor to the line containing "MACROS" and press <F3> again. ================================================================================ GEDDY (TM) version 1.06 ■Copyright (C) 1987 by John Scofield ■All rights reserved filename.ext size date time RO HD SY VL SD AR -- -- changes:NAM D/T ATTH Directory of A:\EDDY\MACROS\*.* Volume in drive A is EDDY 7 files 88064 bytes free G. <DIR> 11/16/86 8:45a 0 0 0 0 1 0 0 0H .. <DIR> 1/25/87 12:52p 0 0 0 0 1 0 0 0 DOS MAC 319 8/25/86 8:43p 0 0 0 0 0 1 0 0 KEYBD MAC 621 1/21/87 1:15a 0 0 0 0 0 1 0 0 MISC MAC 1607 1/21/87 3:49p 0 0 0 0 0 1 0 0 OPCODES MAC 1448 2/04/87 7:54p 0 0 0 0 0 1 0 0 VIDEO MAC 711 1/21/87 1:38a 0 0 0 0 0 1 0 0 G«EDIT» <Enter> to UPDATE. F1:HELP F2:QUIT F3:LOOK F5:COPY F7:DEL F9:UNDOH ================================================================================ GFigure 12-1H To go to the parent directory of the working directory, move the cursor to the line containing ".." and press <F3>. In our example, this would get the display of "A:\EDDY\*.*". To return to the display of Figure 1-1, use <F3> on the ".." line again. <F3> does not operate on the "." subdirectory, nor do any of the other commands. If you move to a new working directory with changes pending (renames, copies, etc., which have not been through an UPDATE), the changes will be discarded - in effect, Undone. If there are pending changes, EDDY will warn you and ask for confirmation (press <F3> again) before moving to the new directory. G12.2 -1LOOK at File Contents-0H To LOOK at the data contained in the current file, press <F3>. EDDY will display the contents in either text or hex format, depending on the data in the file. To make this decision, EDDY examines the first 2000 characters in the file. G12.2.1 -1Text Format-0H A file will be displayed in text format if EDDY finds that at least 80% of the first 2000 (or fewer, if the file is not that large) characters are printable (in the range 20h to 7Eh) or common control characters such as CR, LF, FF or TAB -1and-0 there is at least one LF per 256 characters. In text format, TABs are expanded to 8-character boundaries, and a new line is initiated when a LF is encountered. If you have a WordStar-type file, with lots of high-order bits set to obscure the real meanings of the characters, you may wish to use the bit-stripping com- mand <Alt-b>. Pressing <Alt-b> causes EDDY to zero the high-order bit before the characters are displayed. Pressing <Alt-b> again toggles the bit-stripping ac- tion, so you can experiment to see which way gives the best result. The keys used in LOOK mode to move around in the text-format display are: <Up> - move up 1 line <PgUp> - up 1 page <Down> - move down 1 line <PgDn> - down 1 page <c-Home> - display first page <c-End> - display last page <Left> - left 1 column <Right> - right 1 column <s-Tab> - left 8 columns <Tab> - right 8 columns <c-Left> - left edge (col. 1) <c-Right> - right 80 columns If you want to see the file in hex format, press <Alt-h>. This yields the dis- play format described in the next section. <Alt-h> toggles between formats, and may be used as often as desired. G12.2.2 -1Hex Format-0H If EDDY's analysis of the first 2000 characters does not qualify the file for display in text format, hex format is used. The keys used in LOOK mode to move around in the hex-format display are: <Up> - move up 1 line <PgUp> - up 1 page <Down> - move down 1 line <PgDn> - down 1 page <c-Home> - display first page <c-End> - display last page If you want to see the file in text format, press <Alt-h>. This yields the dis- play format described in the previous section. <Alt-h> toggles between formats, and may be used as often as desired. Here is an example of EDDY's hex format display: ================================================================================ G Offset 00 01 02 03 04 05 06 07-08 09 0A 0B 0C 0D 0E 0F ASCIIH 00000000 E9 AF 00 40 40 40 56 45 52 53 49 4F 4E 40 40 40 Θ»■@@@VERSION@@@ 00000010 00 45 44 44 59 5F 70 72 6F 2C 32 2F 30 36 2F 38 ■EDDY_pro,2/06/8 00000020 37 2C 31 33 30 30 40 40 40 00 00 00 00 00 00 00 7,1300@@@■■■■■■■ 00000030 1B 0B 1E 1E 01 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ■■■■■??????????? 00000040 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 00000050 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 00000060 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 00000070 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 00000080 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 00000090 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 000000A0 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F ???????????????? 000000B0 3F 3F C6 06 4D 01 63 E8 D5 4F E8 C9 69 E9 1F 50 ??╞■M■cΦ╒OΦ╔iΦ■P 000000C0 FB 50 E4 A0 5B 50 55 53 51 57 1E 52 06 56 9C 2E √PΣáXPUSQW■R■V■. 000000D0 FF 1E 43 01 B4 02 CD 16 24 0F 2E 3A 06 42 01 74 ■C■┤■═■$■.:■B■t 000000E0 03 EB 45 90 2E FE 06 39 01 8C C8 8E D8 8E C0 8C ■δE■.■■9■■╚■╪■└■ 000000F0 16 4B 01 89 26 49 01 8E D0 8B 26 47 01 C6 06 4D ■K■■&I■■╨■&G■╞■M 00000100 01 70 FC E8 89 4F E8 CF 47 BA 17 03 E8 5B 00 B9 ■pⁿΦ■OΦ╧G║■■Φ╞■╣ 00000110 E8 03 E8 90 43 E9 C7 4F 2E C6 06 39 01 00 2E 8E Φ■Φ■CΘ╟O.╞■9■■.■ 00000120 16 4B 01 2E 8B 26 49 01 5E 07 5A 1F 5F 59 5B 5D ■K■.■&I■^■Z■_Y[] 00000130 58 CF F9 C3 89 26 47 01 FF 06 47 01 C6 06 39 01 X╧∙├■&G■ ■G■╞■9■ 00000140 00 B4 34 CD 21 8C 06 37 01 89 1E 35 01 B0 09 B4 ■┤4═!■■7■■■5■░■┤ G«LOOK» <Esc> returns to EDIT. F1:HELP F2:QUIT F4:PATCHH ================================================================================ GFigure 12-2H The number under the heading "Offset" is the number of bytes from the start of the file, in hex. Characters under the "ASCII" heading correspond to the hex values unless the hex values are in the ranges 00h - 1Fh and 7Fh - 9Fh. These values are represented by a "■". This is done because many of the characters in those ranges are interpreted as printer commands, and it is often useful to be able to do a <Shift-PrtSc> to get printed copy of data displayed. G13.0 -1PATCH Command - <F4>-0H Normally, you will use LOOK before using PATCH, in order to find the place in the file you want to PATCH. Once you have found it, press <F4>. The PATCH mode display is identical to the LOOK mode hex format display (Figure 12-2), except that it also has two cursors - one in the hex part of the display and one in the text (ASCII) part. These cursors move in unison, so that you can easily match corresponding data in the two parts of the display. One of the cursors will be blinking, the other not. The blinking cursor shows where you may enter changes to the data. Initially, the cursor in the hex part of the display blinks, and you may enter your changes as hexadecimal digits (two per corresponding ASCII character). If you want to enter data as ASCII text, press <Alt-h> to toggle the data entry format from hex to text. In text format, the cursor in the text part of the display blinks and the hex cursor does not. The hex cursor also expands to cover two hex digits, since en- tering a single text character affects both digits. In either format, as you enter data in one part of the display the corresponding data in the other part is updated accordingly. Also, any data changed remains highlighted in the display. You can move the cursors to the place in the display where you want to change data by using the "arrow" keys - <Left>, <Right>, <Up> and <Down>. Changes can be made to only one screen at a time. PATCH mode does not have pag- ing capability. When you have made your changes, they may be written to disk by going to UPDATE mode (two successive <Enter> key presses). PATCH accepts the UNDO command - <F9> - just as in EDIT mode. Similarly, once you have made changes on disk via UPDATE, those changes cannot be undone - even if you continue patching the same file. After UPDATE, EDDY will automatically go to LOOK mode. In LOOK mode you may pos- ition the display to other parts of the file where you want to make changes, and then press <F4> to go back to PATCH. This cycle of PATCH-UPDATE-LOOK-PATCH may be repeated as often as necessary. A practical example of PATCHing with EDDY is presented in the next Section. G14.0 -1Do You Like EDDY's Colors?-0H If you have a color monitor, but you don't like the colors EDDY uses, why not change them to something you do like? For monochrome monitors, the options are more limited, but there are still changes you can make. G14.1 -1Changing EDDY's Screen Attributes-0H EDDY's PATCH command can be used to change EDDY's colors. This also serves as a simple but practical illustration of some of EDDY's capabilities. To change the colors, use the following steps (you might want to make a backup copy of EDDY, "just in case"): 1. Put the disk containing EDDY in the default drive. 2. Type "EDDY ." and press <Enter> 3. Move the cursor to the line containing EDDY.COM 4. Press <F4> - you will see a display similar to Figure 12-2. 5. Move the cursor to the byte at offset 00000030 - the character there (1Bh if your copy has not been previously modified) is the screen attribute used for heading and footing lines, as well as any error messages. 6. Enter the new screen attribute of your choice. 7. Repeat as desired for the next three bytes. These are, respectively, the attributes for the main body of the display, for highlighting the current file line, and for use with EDDY's "signature" line at the top of the first screen. 8. Press <Enter> twice, followed by <F2>. 9. Repeat step 2, and see how you like the new colors. If you don't, repeat the other steps as well, until you are satisfied. On monochrome monitors, the "current file" line is indicated by an underline. If you'd like to see the effect of other possible screen attributes, follow the procedure outlined above to change the byte at offset 00000034. In an unmodified copy of EDDY, this byte will contain "01". Note that the underline is only used with the monochrome display adapter (or Hercules board). If you are using a mono monitor with a Color Graphics Adapter, see the following section. G14.2 -1I Can't Even Read the Screen!-0H If your monitor gets blurred or unreadable when you run EDDY, try using option /M - i.e., enter "EDDY/M". If the display is now OK, you probably have a compos- ite monochrome monitor running with a Color Graphics Adapter. You have 3 choices when using EDDY with this hardware: - Use the DOS command "mode bw80" before running EDDY. - Use option /M every time you run EDDY. - Patch EDDY to work with your hardware, as follows: 1. Do steps 1 through 5 as described above, in Section 14.1 (using option /M in step 2). 2. Enter G70 07 70 70H 3. Do step 8, above. EDDY should now be compatible with your monitor. G15.0 -1Distribution and Support-0H EDDY is distributed as "user supported" software, without charge. EDDY and this User's Manual may be copied ad lib provided the author's copyright notice and disclaimers of warranty are reproduced in full. The program is supplied as-is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and the warranties of fitness for any purpose. Copies of the program may not be sold for more than the cost of the medium they are copied on, plus reason- able handling charges. The total charge may not exceed $10. G15.1 -1EDDY is NOT Free!-0H Although EDDY is distributed in this way, it is not free. After a reasonable trial period, if you find EDDY to be useful and satisfactory to you, and you continue to use EDDY, then a usage and registration fee of G$15.00H is due. It should be mailed to the author at one of the addresses shown below. The low usage fee entitles you to technical support as described below, to re- ceive updates at cost of distribution, and to the satisfaction of knowing you have done "the right thing". Please send all correspondence to John Scofield, at one of these addresses: Box 47136 1522 W. 5th St. Morrison Hill P.O. -OR- San Pedro,CA 90732 Hong Kong USA When registering, please provide the following information: 1. Your name, address and phone number 2. Version and serial numbers of your copy of EDDY (as shown on the logo which is displayed when you exit from EDDY) 3. Where did you get your copy of EDDY? 4. Type of hardware you use - computer, monitor and display adapter 5. Any comments or suggestions G15.2 -1Technical Support-0H In the unlikely event you (as a registered user) have a problem with EDDY (not a bug, surely!), if you take the trouble to report it, I'll try to solve it. And I'll get back to you with a fix, if possible. EDDY's PATCH command, using an area within EDDY reserved for this purpose, makes it reasonably easy to fix minor bugs without having to wait for a whole new ver- sion of the program. With any problem report, please include the following information: 1. Version and serial numbers of your copy of EDDY (as shown on the logo which is displayed when you exit from EDDY) 2. Type of hardware - computer, monitor and display adapter 3. Level of MS- or PC-DOS you are using 4. Any resident programs being used 5. As complete a description of the problem as possible - - what did you enter on the command line? - <PrtSc> listings of the screen before and after the problem - how was EDDY's output different from what you expected? - any other information that seems relevant 6. Your name, address and phone number G15.3 -1Future Enhancements-0H If you (as a registered user) suggest an enhancement not already under consider- ation which is later implemented, you will be sent a free update of EDDY with that enhancement. Some enhancements already suggested and under consideration are: 1. Make EDDY memory-resident (TSR) 2. Find file: search all directories for the specified file 3. Search for string: scan a file in LOOK mode for a given string, to make positioning for patching easier; also, scan disk (or directory) for string and display files having that string 4. Remove limit on number of files that can be handled 5. Allow display to be sorted in other sequences, such as date 6. Provide sector-oriented patching 7. Volume labelling 8. Make EDDY run on any MS-DOS machine - not only IBM compatibles Comments on these enhancements, and suggestions for any others, are welcome.