DF.EXE version 1.95 from JB Utilities released as shareware Copyright 1991, 95 Jules Brenner BRT71EFR.EXE copyright Microsoft, Inc ------------------------------------------------------------------------------ WHAT ON EARTH IS DF? DF (Directory Find) is a DOS utility that helps you find files on your drives in an extraordinary number of ways beyond DOS' DIR command. But it will do more than find files. It will show you disk space and usage for up to 5 drives on one report; it'll show you which files you changed or created today or within the last x number of days; it will list only new files of a certain type; it will list your subdirectories and show you the space used in each. It will aid your housecleaning by showing you all files on all directories of your hard drive that have been changed on the current day. DF identifies file parameters without the "*" wild card, eliminating all but one shifted character; it will list as many as four different file parameters on one command; it will filter out specified file parameters; it will list files by size and with embedded strings and within an alphabetical range. Files listed are color coded for easy identification by type. Files are listed in two columns to put as much information on the screen at one time as possible. Enough? Believe it or not there's more it can do! Important: the value of this kind of program depends on the user's committment to learn its capabilities and use them as often as possible. By relying on DF to the exclusion of DIR and other ingrained habits, you'll learn it best and implant its great advantages into your patterns of use. Is DF the most powerful directory program? YOU tell US! ~~~ We now refer you to the manual which follows the registration info below. ------------------------------------------------------------------------------ Important note: for the fullest possible understanding and use of DF, it is necessary to refer to this document file for each update. The syntax screen does not have enough space to list all the possible functions and command possibilities. The details and the expanding power of DF are found here. Please refer to the WHATSNEW.DOC file which describes the changes and/or improvements for the current version. UPDATES (in this file) contains the changes for all versions. Before using DF, we also ask you to read the Limitations of Responsibility statement in section X. Registration fee is a mere $15. If you find something that doesn't seem to work right, or if you wish DF did something it doesn't now do, use your registration to make requests. In any case, if you find yourself using DF regularly, registering is the right thing to do. If you can't afford the fifteen at one time, installment payments will be accepted and appreciated. Mail fee to: Jules Brenner JB Utilities P.O. Box 46116 Los Angeles, CA 90046-0116 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - - - ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Note to those using credit cards: Please include the following with your order: your name (printed) as it appears on the card (include middle initial), the card number, the expiration date and your signature. (See the registration form included in the DF library (zip) file). ------------------------------------------------------------------------------ DF.EXE is self-documenting. Just type DF / on the command line. (It should be noted that because DF has grown so many capabilities, the syntax screen is incomplete. It has the basics, but for all the possibilities, the following is must reading. ~~~ ~~~~ ------------------------------------------------------------------------------ Table of Contents (More detailed documentation of DF's command possibilities) PREAMBLE ......... ALL ABOVE A ................ DF WITH NO PARAMETERS B ................ FULL LISTING OF SPECIFIED SUBDIRECTORIES C ................ LOOKING FOR A FILENAME a. Part Alfa capability D ................ LOOKING FOR AN EXTENSION E ................ LOOKING FOR FILES WITH NO EXTENSION E-1 .............. LISTING SUBDIRECTORIES F ................ LOOKING FOR A STRING WITHIN A FILENAME G ................ LOOKING FOR MORE THAN ONE PARAMETER H ................ LOOKING FOR FILES ON ANOTHER DRIVE I ................ LOOKING FOR FILES ON A SPECIFIC SUBDIRECTORY J ................ COMBINED COMMANDS K ................ LOOKING FOR FILES WITHIN A SIZE RANGE L ................ LOOKING FOR FILES BY DATE a. New, specific files b. Housecleaner option M ................ DISK SPACE & USAGE N ................ DOS's WIDE (/w) LISTING O ................ DOS's SORTED LISTINGS P ................ FILTER FUNCTION Q ................ LOOKING FOR FILES ON ALL DIRECTORIES R ................ COLOR LISTINGS S ................ Additional notes T ................ Printing this file U ................ Updates V ................ ACKNOWLEDGEMENTS W ................ BUG REPORTS X ................ DISTRIBUTION Y ................ REGISTRATION INFORMATION Z ................ CAVEATS, LIMITATIONS OF RESPONSIBILITY, ETC. ------------------------------------------------------------------------------ A. DF WITH NO PARAMETERS Typing DF (cr) is similar to typing DIR without parameters. The result is a listing of the entire directory. Of course, DF does it differently. It lists in two columns and thereby shows twice as many files per screen. Further, it automatically pauses when the screen is full and there are more files. This is similar to 'DIR /P' except that you don't have to type all that out. Any keystroke except 'x' will continue the listing for the next screenful, and so on until the entire directory has been listed. The listing may be aborted by pressing the 'x' key at any pause. B. FULL LISTING OF SPECIFIED SUBDIRECTORIES DF can also list the entire directory contents for 2 to 4 directories in one command. To do this, the directories must be specified and surrounded by backslashes. Each DF parameter must be separated by a space: DF \DOS\ \ASM\ lists the contents of the DOS and the ASM directories. You can also ask for a listing of nested subdirectories up to the 3rd nesting level. Just be sure to end the terminal sub-directory name with the backslash, as above, else DF will see the last directory name as a filename. When listing more than one directory in one command, or when combining commands, this syntax is required for the default directory, as well. The following is also possible: DF \DOS\.EXE .COM for the .EXE and .COM files on the DOS directory. A variant of this (though less desirable) is: DF \DOS\.EXE \DOS\.COM It's also possible to do: DF \DOS\.EXE \WP\.TXT \UTIL\.COM \SW\.DOC Remembering that up to 4 parameters are allowed. C. LOOKING FOR A FILENAME All files on a directory may be listed by specifying the beginning of the filename(s) in question. For example, DF A lists all files beginning with 'A' on the default directory. The main advantage in this over the DIR command is that the shifted character '*' is unnecessary, making something that is so often used a bit less cumbersome and more efficient. a. PART ALFA capability This allows you to list files within an alphabetical range. The syntax is strict: DF E-L lists all files which begin with the alphabetical range between E and L, inclusive. Moreover, DF CA-CL is also legal, listing all files which begin with 'C' but with the 2nd letter between A and L. Any variance from this structure will produce unwanted results. Notes: Even though this produces a listing of files which fall into the range specified, the listing is not alphabetized. The listing will be in directory order. This order may give an indication of which files are older and which newer (though not infallibly) and is one possible preference. For those who want an alphabetical listing, we suggest the use of a directory sorting program, such as Norton's DIRSORT. If the directory itself is alphabetized, the file listing under this option will be alphabetized. As this is the first incarnation of this capability, it's not fully implemented. Which means that you cannot specify a non-default drive with the Part Alfa function (yet). D. LOOKING FOR AN EXTENSION Similarly, the command DF .EXE lists all .EXE files. The dot tells DF to look only for extension strings. 1, 2 or 3 letters may be used after the dot: DF .E will also list all .EXE files, but will also list .EXX, .EST and any files with extensions that begin with the 'E' which may be on the specified directory. If you want to list out all the .ZIP files on a directory, for instance, just type: DF .Z No more is needed if you don't have other extensions beginning with 'z'. If you want to list only those files ending in a one or two character extension, such as .B or .BI, for example, then type a forward slash after the characters. This usage limits the search field. Thus: DF .B/ will list only files with a 'B' extension. It will not list files with .BAS or .BI. In other words, the slash tells DF not to assume a wild card in the extension field. E. LOOKING FOR FILES WITH NO EXTENSION AND/OR SUBDIRECTORIES To specify a listing of files with no extension, type DF . The lone dot will tell DF what you're after. This is not exactly the equivalent of DIR *. since subdirectories are not included in the listing. Subdirectories, under DF are handled separately: E-1. LISTING SUBDIRECTORIES Should you want subdirectories, type DF ] or DF [ This command applies to the default directory only. However: DF \] or DF \[ will list the subdirectories on the root directory, and DF a:\] or DF a:\[ will list the subdirectories on the root directory of drive a: (or any other drive specified). The \ is usually optional in this application. There IS a difference between ] and [ (right bracket, left bracket). With DF [ the listing of subdirectories will include the disk space being used in each one. DF may be the only directory utility that offers this powerful feature and it is a tool to help you quickly analyze and houseclean your drive. An example of housecleaning is when a subdirectory is revealed by DF to have zero bytes in use, it may be a candidate for removal. Sometimes we create subdirectories for temporary use and forget to remove them. The bytes in use may be converted to megabytes above a certain size. If you see a decimal point, figure that to be a usage amount in megabytes. One the other hand, with DF ] the listing of subdirectories does not include space used. Instead, it shows a to specify that it is a subdirectory as opposed to a file. This listing is much faster. The [ switch takes longer since each subdirectory must be measured individually. We therefore recommend the use of ] most of the time, reserving ] for those times you need Subdirectory size. It should be noted that listing subs with DF is far superior to doing it with DIR. DF will list ONLY subs (and not include files with no extensions). It will also pause when the listing fills the screen without requiring a special command switch. There is one more advantage to DF over DIR for listing Subs. Most Subdirectory names do not have an extension, but you CAN name one WITH an extension and many applications do this. These will not show up with DIR *. but will with DIR *.*. But, then directories with extensions will be listed among ALL the FILES present. The DF Subdirectory commands will, however, list all subs, and only subs--whether they have an extension or not! Unfortunately for non-registered users, the [ option is not enabled in evaluation versions. We hate to do this but we need to do something to encourage registrations. Disabling unique and/or special capabilities is, we believe, better than begging. It does not make this evaluation copy "crippled". It is, after all, quite powerful, allowing you to get a very good idea of how essential it is to you. If you find yourself agreeing with that concept, and using DF, please do the right thing and register it. You'll then be able to list your subdirectories AND their space usage! Don't be part of a culture that considers shareware FREE. Only the evaluation is free. Unlimited free usage is freeLOADING. F. LOOKING FOR A STRING WITHIN A FILENAME When you know that the file you're after has a certain string sequence in the filename, but may not be the beginning of the filename, the single quote character (') tells DF to look for the specified string anywhere within all filenames. DF 'CLON or A:'CLON will list all files containing the string CLON on the default or specified drive. The resulting listout may include PBCLONE.EXE, CYCLONIC.TXT, CLONE44.ZIP, for example. This capability is not only not possible with DIR but may not be possible with any other directory utility. We THINK it's an exclusive! (Or, WAS, when it was written). ~~~ G. LOOKING FOR MORE THAN ONE PARAMETER DF allows a search for up to 4 different file specifications at one time. Thus, DF .COM BR 'CLON . will list all .COM files, all files beginning with 'BR', all files which include the string 'CLON' within the filename AND all files with no extension. Mix and match. H. LOOKING FOR FILES ON ANOTHER DRIVE Again, DF makes it as simple as possible. Just start your file specification with the drive specification. This consists of a drive letter and the colon. It's the colon that tells DF it's to look at that other drive: DF A:.COM will list all the .COM files on the root directory of A drive. Note there should be no space after the colon and no path. Note also: this is the only exception to our rule to avoid shifted characters in DF. Our excuse for it in this instance is that the use of the colon for a drive specification is too universal to ignore. Also, it adds emphasis to the intention, avoiding ambiguity and/or error. (Convincing?) As of version 1.6, the command parameters available for non- default drives are almost as complete as those for the default drive. One exception is subdirectories. If there are subdirectories on a floppy drive, it's probably better to go to that drive for directory listings. DF should not be directed to a non-formatted disk. The probable outcome is a system freeze. If you encounter any other parameters that do not work for the non-default drive, we would welcome your feedback. It's important to remember when listing a non-default directory that there is no space after the colon -- but for multiple parameters, a space is used as a separator. That is: DF A:.COM .EXE .BAT DF A:/S 50 150 DF B:/F .TXT .DOC are correct. I. LOOKING FOR FILES ON A SPECIFIC (NESTED) SUBDIRECTORY The backslash (\) is the key to telling DF that it's to look for files on a specific subdirectory. We've discussed above how to specify all files for 2 or more specific directories. The principle is the same for specified filenames. DF \DOS\.COM lists all .COM files on the DOS subdirectory as specified from any other directory. DF \DOS\ASM\.ASM lists all .ASM files on the ASM subdirectory of the DOS sub- directory. The limit for nested subdirectories is 3. When that limit is reached DF will so note and will abort. DF B:\DOS\.EXE lists all .EXE files on the DOS subdirectory of B drive. J. COMBINED COMMANDS All parameters above, with the exception of the ']' spec may be combined on one DF command line. Multiple commands are limited to 4 on any one execution. The commands below are also limited to one parameter per each execution of DF. K. LOOKING FOR FILES WITHIN A SIZE RANGE DF allows you to list files which fall within a specified range of size. This may be helpful when you can't remember filenames but know the approximate size of the file (in kilobytes) you're searching for. Hence, DF /S 45 900 will list all files on a directory that are greater than 45 kb and up to 900 kb in size. Actually, strictly speaking, you don't get exact kilobytes. The number you enter is multiplied by 1000 rather than by 1024. This is because most of us think in those terms. If this disturbs your sense of perfection, however, we will welcome your disagreement so that we can judge whether to change it. "/S" or "/s" is the switch that puts DF into size search mode. It is ordinarily followed by two numbers, the second greater than the first. The first number may be zero. This parameter has two shortcuts: DF /S 45 will list all files of 45k or larger (up to 99 mb), and DF /S 45- will list all files below 45k. Note there is no space between the number and the minus sign. A space there will produce the same effect as the first shortcut. This usage cannot be combined with other DF commands. L. LOOKING FOR FILES BY DATE DF will list only those files that are dated within a specified number of days counting back from the current date. DF - will list only those files that bear the current date. DF -11 will list those files that bear a date within the most recent 11 days (including today). Note that the current date is the one your computer knows about. If the date is set incorrectly, or set to a date other than the current date by intention, it is that date that DF will consider current. a. NEW & recent SPECIFIC files: Sometimes it's very desirable to limit the new files listing for specific parameters only. Consequently: DF - .DOC will list only .DOC files for the current date. DF -10 ABA will list only files beginning with ABA for the past 10 days. b. HOUSECLEANER option (DOS 5.0 and above) (Registered version only) With the advent of version 1.8 it is now possible to get a report of all changed files on the current day on your hard drive. It checks ALL your sub- directories down to the 2nd nested level for files with the current date and shows them to you. The syntax for this little gem of a routine is a combi- nation of the '-' param and the '/A' switch. The '-', as discussed above, reports on new files while the '/A' switch means, to DF, ALL directories. The combination: DF - /A means: check all my directories for files I changed today. We call this the 'Housecleaner' option because of how it helps to make you aware of files you meant to delete but forgot to, extraneous debris that may have been created that you don't really need, files created by an application that you weren't even aware of much less need, etc. Please note that this option is not yet capable of going back to previous days. To check any specific previous day, just change the date with DOS's DATE command. (Don't forget to change it back). This option of DF is also available as a separate utility. We call it WORKCHEK. Request it when you register DF. M. DISK SPACE & USAGE As a convenience, DF will give you a report on disk space and usage. This includes amount of space available. The syntax for the current drive is: DF = For this report, which is independent of the directory listing. For the report on a non-default drive, use: DF A:= Note that any drive spec up to (and including) E: may be used and that there should be no space after the colon. This option may be combined with other parameters so long as it's for the current drive. It cannot be combined if you're dealing with non-default drives. The "=" should be the last parameter. If it isn't, it's likely to be disregarded or misinterpreted. Example: DF .BAS = will list all files with the extension '.BAS' and report disk space and usage under the listing. Note: if more than 16 files are listed under this usage, there will be a pause before the return to DOS in order that the first files will not scroll out of sight. It is also possible to get a multiple drive space report. The syntax for this is slightly different, since the "=" must be the first parameter, followed by the desired drives. Example: DF = B D A C Note that the order of drives is up to you. Up to 5 drives may be reported on with this function. Unclosed drives and drives without disks may cause system freezing or timeout error messages. In the above example, if B drive had no disk, the reading would have been totally unsuccessful. Expect a delay when reading floppy drives. This syntax is the reason that when the drive space report is asked for as one of several parameters, the '=' should be last. It should definitely not be first, since the first letter following the '=' will be interpreted as a drive designation. On the other hand, this syntax provides an alternate to DF B:= You can as well use: DF = b Note: this single feature is one which individual utilities characteristically perform as their sole function. (Pat, pat). Since there are times (perhaps many times) when you might want a listing of files AND the drive report, the following options are available: DF == for the default drive, and DF A:== for a non-default drive. These commands will list the drive space usage and amount available below the files listing. It is not possible to combine this with other commands. For that, use the single '=' parameter as described above. Caution: this parameter may cause some files to scroll out of view because of the additional lines for the drive report. It depends on how many files are on the directory. We'll probably soon fix this. It wasn't done this time around because it requires fairly extensive coding (read 'RE-coding') and I didn't have the time. I felt that there's a benefit in just having it even if not perfected--so long as this effect is a known one. At the time of this writing, the '==' options are not documented on the syntax screen, which has become quite full. A redesign of that screen to allow for abbreviations might be forthcoming, but only if requests are received by users. To convey the general usage of DF, we feel abbreviations are less good, but will consider other views. All you need do is express your own. One final note about the disk space report as it relates particularly to large hard drives. The total disk space and the available disk space are rounded off to the nearest 100, while the used amount is only rounded off to the nearest 10. We hope this virtually insignificant discre- pancy doesn't bother anyone. This is only true for large hard drives. N. DOS's WIDE (/w) LISTING A DIR /W lists files without size (in k) nor time and date stamp. The advantage is to see more filenames on screen. DF's 2 column listing may obviate this command for most purposes, but it would not be complete without the capability. Hence, DF /W is the equivalent of DIR /W. DF BR/W lists all files beginning with 'BR' listed in DOS's wide format. Note that there must be no space between the file specification and the /. This usage cannot be combined with other DF commands. O. SORTED LISTINGS You can have a sorted directory listing on any of four para- meters. Typing DF ; or DF /N produces a listing sorted by FILENAME; DF /E sorts by EXTENSION; DF /Y sorts by YEAR (don't confuse this with 'date'); and... DF /Z sorts by SIZE. (Since /S is taken). These commands are limited to the default directory. A file is created on that directory. If there is not enough disk space for that file, an 'out of space' error will occur. The created file is deleted as part of the process. A delay for the sorting procedure is noticeable on large directories and on floppy drives. It may be worth noting that we provided two choices for the name sort because (1) some users may like to have just a one- key parameter for this oft-used option and (2) to remain consistent with the other 'switch' commands. Sortings depend on the presence of DOS' SORT.EXE file. This program must be in your path or an error message will be generated. This usage cannot be combined with other DF commands but drive specification may be used: "a:;" or "B:/E" P. FILTER FUNCTION DF may be used to filter out specified filename parameters. The most common usage of this would be for groups of files where the extension is specified. Accordingly: DF /F .EXE .COM will list all files EXCEPT those with .EXE and .COM extensions. This function is available only in registered copies. It is an incentive to be fair to the author. If you have a quarrel with this approach, please voice your objection. The limita- tion may be removed under sufficient objection. ------------------------------------------------------------------------------ Q. LOOKING FOR FILES ON ALL DIRECTORIES The '/A' switch may be used to search for files of a particular spec on all directories of the default drive. Only one file spec is allowed under this param, and it is likely to work as designed only with DOS 5.0 and above. Accordingly: DF .COM /A DF /a ven will, in the first instance, list all .COM files in every directory on your drive. In the 2nd instance, you'll get a listing of every file on your drive which begins with the string 'VEN'. Each listing will include the entire path as well as the name of the file and it will pause when necessary. Other capabilities of DF are not supported under the /A (All) switch. Non-default drives cannot be specified. ------------------------------------------------------------------------------ R. COLOR CAPABILITIES DF will list files in color on any monitor capable of color text. The color coding is not alterable by the user but requests can be made when registering. The color code is as follows: GREEN for ".INI" files CYAN for ".BAT" files RED for ".OBJ" files PURPLE for ".DOC", ".TXT" ".PRN", ".MSG", ".LST" files BROWN for ".BAS", ".ASM" files BRIGHT BLUE for ".SYS" files BRIGHT GREEN (chartreuse?) for ".DRV" files ORANGE for ".ZIP" files LIGHT PURPLE for ".PCX", ".TIF", ".GIF", ".IMG", ".PIC", ".BMP", ".FON" & ".EPS" files BRIGHT YELLOW for ".EXE", ".COM" files Color listings can be turned off (and back on) with the color argument: DF COLOR This command is a toggle. When color is turned off all files are listed in default white. S. Additional notes: DF is not case sensitive. The non-standalone version of DF must have BRT71EFR.EXE in the default directory or in the path. This version is best if you are running more than one program requiring BRT71EFR.EXE since each individual program file will be smaller. To make DF as useful as possible, it, too, should be on a directory that is in your path. If you run it from another drive, best results are achieved with the standalone version, which doesn't require the presence of BRT71EFR.EXE but which is larger in terms of disk space. DF does not contain much in the way of error-checking, beyond what DOS might or might not offer. Where this may be a problem is if you do a DF on a drive which doesn't exist, where the floppy drive door is open, something like that. Rare, and we leave it to the user to avoid such mistakes. An opened drive door could hang up your computer (a warm or cold boot will cure the temporary situation). More often than not, however, you'll be able to insert the disk and close the door and then enter an 'R' for Retry. ------------------------------------------------------------------------------ T. Printing this file The first thing you may notice if you send this file to your printer, is that there are no embedded form feeds. My thinking on this is that your printer is likely to furnish its own form feed when a certain number of lines are reached. Mine does this, but perhaps that's because it's a cut-page printer rather than traction-feed. To furnish your own form feeds, place a Control-L character every 60 lines or so. The biggest advantage to having no form feeds is that this document can be imported into a desktop publishing program or word precessor without have to "clean it up". If you'd like our desktop-published version, just add $10 to your order (see registration form). ------------------------------------------------------------------------------ U. UPDATES: ~~~~~~~~ Future versions: Depends on response. Version 1.95a No changes in the program. The alternate fee arrangement is dropped. Also, my Compuserve address is new and email contacts are added and updated. Version 1.95 DF can now list subdirectories AND how much disk space is being used in each one. The listing of subs withOUT space used is improved from prior versions. The sub- directory space option is available only in registered versions. The directory listing can now be used as a multiple parameter. Version 1.92 When doing a file search with the size parameter, the maximum allowable size default was increased to 99 mb. This will include humungous swap files, scanned images at high resolution, etc. This refers only to usage when the maximum upward limit is NOT specified on the command line. Version 1.91 Couple very minor adjustments. Version 1.9 New, bigger, improved syntax screen. Finally caught up to this. It now lists most if not all arguments & capabilities. Housecleaner option made available only in registered version. Improvement in filter function. Version 1.83 Bug fix for files with less than 3-letter extensions, as in: INCLUDE.BI. See section D. Version 1.82 Recompiled with Basic 7.1 (PDS). BRUN45.EXE replaced with BRT71EFR.EXE. Color capability added. New files of specific parameters capability. Version 1.81 Updated syntax screen. A few minor changes. Version 1.8 Search for files on all directories of current drive. DOS 5.0 or above required. Small bug fix. Under certain circumstances (too complex to detail here), when the '=' was used as a 2nd param, it caused an unwanted pause. Housecleaner option to check for all files on your entire hard drive that have today's date. See Section L, subsection a. DOS 5.0 required. Version 1.7 Added "Part Alfa" capability to list files within a limited alphabetical range. See Section C, subsection a. Version 1.62: Corrects disk space report for large hard drives. Version 1.61: Corrections in '==' parameter. Disk drive report was printed across center of file listing. Corrected to print below. Note that with the use of this option, the printing of the report causes one extra carriage return and scrolls the topmost line of files off the screen if there are more than 22 files listed for the last screen of listings. The plea to register is removed from registered copies. Version 1.6: Reports disk space for up to 5 drives at one time. As promised, most commands are now implemented for non-default drives (such as floppies when executing DF from your hard drive). Filter function added for registered copies. "==" option for files AND drive capacity report. This gives you all that DIR gives you (for those who may have missed it). Version 1.51: Bug fix. Somehow, a bug crept in concerning the multiple directory parameters. BRUN45.EXE now included in library. It makes downloading a bit longer, but it may be more convenient to new users. Version 1.5: Sorted listings. Improvements in the ']' commands. Several small program improvements. Table of contents in this file. Addition of registration form, packing list and feedback form included in library. Drive report (= option) combined with other options. IMPORTANT NOTE: with the addition of new features, a couple of bugs were created in previously existing features. The bane of programmers. I apologize for any inconvenience and hope you won't abandon the use of DF because of the oversight. Most of the bugs were in the use of multiple parameters. Version 1.4: Lists subdirectories and files with no extensions for root directory on default drive or other drives. File listing by n days prior to current date. Small bug concerning files with no extensions under certain conditions. Report on disk space and usage added. Improved syntax screen for high speed display. File listing of one- or two-character extensions corrected. Version 1.3: Improvements and shortcuts in the size parameter. Numbers are now entered in approximate kilobytes. Version 1.2: Bug fix. DF was not finding 1 and 2 letter extensions properly. Bug found by Shel Talmy. Thanks Shel. Version 1.1: Internal string search enabled for non-default drive. Sorted directory enabled. Equivalent of DIR | SORT. This is a stopgap capability. In a future version a sorted directory will be listed in 2 columns with automatic pauses as all other DF listings. This version requires you to have a hand on your pause key to do your own pausing for long directories. Version 1.0: DF is the new name for the program that started out as DS. The new name was adopted because of a possible conflict with Norton's DS and because the original purpose of calling it DS (Dir Star- dot-star) was superseded by many other capabilities than merely avoiding shifted characters. DF, version 1.0 adds the file size switch to the list of updates since DS, version 1.8, which it replaces. ------------------------------------------------------------------------------ V. ACKNOWLEDGEMENTS: My thanks to Daniel Maxwell, from Idaho, for his advanced coding guidance. To Jake Angelin for his BBS & WWW posting duties. To Shel and Steve for their Beta testing and excellent ideas, all of which were adopted. ------------------------------------------------------------------------------ W. BUG REPORTS: Users are encouraged to report all bugs to the author. One of the most common way for bugs to creep into any program is when new features are added and all the previous capabilities which were working flawlessly are not thoroughly tested. Since the author uses this utility, even obscure bugs will eventually come to his notice, but in the spirit of partnership, all users are encouraged to report a bug they encounter. The file, FEEDBACK.DOC, is included with the program to facilitate such reports. (Of course, feel free to send us the form merely to report good things, too). In the event of a bug appearing in a commonly used option, we advise you go back to the previous version you were using until the bug(s) is(are) corrected. ------------------------------------------------------------------------------ X. DISTRIBUTION DF may be distributed freely so long as no alterations are made to the program nor to the archive nor to this documentation. Shareware distributors may charge up to $5 for the DF utility without specific permission so long as they inform us of their distribution with a copy of the ad or catalog in which it is offered. For any greater charge, distributors must first write us to seek permission and to explain the reason for the higher charge. ------------------------------------------------------------------------------ Y. REGISTRATION INFORMATION Registration fee to the end user is a mere $15. A standalone version is available on request when registering. Encourage me to write more utilities by registering. If you find yourself using DF regularly, it's the right thing to do. ------------------------------------------------------------------------------ Z. CAVEATS, LIMITATIONS OF RESPONSIBILITY, ETC. While JB Utilities exercises maximum effort to ensure that none of its utilities pose any danger or threat to a user's computer and/or files, and while we are not aware of any such risk, prudence demands that we state that we take no responsibility for your use of our programs. In using one or more of them, you assume any risk and that by your use you assume full responsibility. One more note: if this kind of language ("risk", "responsibility", etc.) scares some folk, it should be added that this program is not written just for ~~~~~~ distribution. We actually wrote it for our own and associates' use and use it on a daily basis, almost NEVER using DIR any more. - - - - - - - This program may not be used in a business, corporation, organization, government or agency environment without a negotiated site license. Suggestions, bug reports, etc. appreciated and encouraged -- even by non- registered users. Mail the modest registration fee to JBUTILS, P.O. Box 46116, Los Angeles, CA 90046-0116. Use REGISTER.FRM, included in the archive, for easy registration. I realize that using shareware as though it's freeware has become the general computer culture. Those who have a conscience about it go on using shareware without paying for it and feel guilty. The worst among us don't even feel guilt about it. But, that's wrong. I strongly appeal to your sense of justice: if you install it for the long haul; if you're using a program regularly, remember that it came to you for trial purposes and, since you've decided to make use of it, pay the registration fee. Most such fees are very modest. You know you'll be getting your money's worth because you've had an opportunity to test it out. Often, when fees are higher it's because of a well-produced manual or something else that makes it a good value. In fact, is there a better value in our entire economy than a shareware program you've been using? Messages may be addressed to me on CompuServe 72202,657, via the Internet at 72202.657@compuserve.com or at variagate@loop.com. There is a further description of DF and other utilities on our web page at http://www.loop.com/~variagate/jbutils.htm -- J.B., for JBUTILS