home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / jw.zip / SS.DOC < prev   
Text File  |  1992-04-01  |  6KB  |  115 lines
  1. PROGRAM: SS.COM
  2. PURPOSE: versatile replacment for DIR command of DOS
  3. AUTHOR: Jim Wygant, Feb., 1990
  4. FORMAT: SS [/4opxds?] [file spec] [file spec] ...
  5.  
  6.     [4/1/92 NOTE: Former users of SS, please note that /a and /p have 
  7.     been eliminated as options and have been set as defaults. Macros 
  8.     that contain those options will continue to work as before (/a and 
  9.     /p will be ignored). The /o option has been added to reproduce the 
  10.     old default of no hidden files, no subdirectory entries. The /c 
  11.     option reproduces the old default of non-paused display.]
  12.  
  13. EXAMPLES: 
  14.  SS         [for alpha sorted, 2-col display of current directory]
  15.  SS /4oxc                     [for current directory with options]
  16.  SS c:\txt\a*.* d:\util     [files from 2 directories, no options]
  17.  SS /?                              [brief explanation of program]
  18.  
  19. EXPLANATION: SS (for SEARCH & SORT) is a directory program. It defaults to 
  20. an alphabetically sorted 2 column display that includes attributes, file 
  21. size, and date and time of last change. The default includes hidden files 
  22. and subdirectory names; and the display will pause when the screen fills, 
  23. recognizing the current display mode (25, 43, or 50 lines). The default file 
  24. specification is "*.*", so "SS" by itself produces a list of all files and 
  25. subdirectory names in the current directory, sorted by name. Total number of 
  26. entries, total bytes for those entries, and total bytes remaining free on 
  27. the drive are shown at the end of the listing.
  28.  
  29. Individual files with a size too big to fit the display have "*" added to 
  30. their file length, like 123456*. Those will be files with a length greater 
  31. than 9,999,999 bytes in the 2 col. display, or 999,999 bytes in the 4 col. 
  32. display. Substitute "00" for the "*" in a 2 col. display, or "000" in a 4 
  33. col. display. A message at the end of the display will remind you of the 
  34. correct multiple. To avoid confusion, file lengths are always calculated in 
  35. bytes, not kilobytes or megabytes.
  36.  
  37. Attributes are indicated by "rha" for read only, hidden, and archive, if any 
  38. of those attributes are set. Attributes not set are indicated by a dash. For 
  39. example, "-ha" refers to a file that is NOT read only, that is hidden, and 
  40. that has changed since the last backup.
  41.  
  42. SS defaults to the same file specifications as the DIR command of DOS.
  43.   YOU ENTER       SS INTERPRETS IT AS
  44.   =========       =================
  45.     SS D:           SS D:*.*
  46.     SS D:\          SS D:\*.*
  47.     SS D:\WP        SS D:\WP\*.*  (if WP is a directory)
  48.     SS D:\WP        SS D:\WP      (if WP is a file in the root directory)
  49.  
  50. Options are entered as the first parameter after SS and must be preceded by 
  51. the '/' character. The options are:
  52.   /4  -- 4 column display;
  53.   /o  -- omit hidden files and subdirectory entries from display;
  54.   /c  -- continuous display without pause when screen fills;
  55.   /x  -- sort files by extension and name;
  56.   /d  -- sort files by date and time;
  57.   /s  -- sort files by size;
  58.   /?  -- give brief explanation of options & file attribute display.
  59.  
  60. Several options may be combined, as in "SS /4odc." This produces a 4 col. 
  61. display of non-hidden files and non-directory entries, sorted by date, and 
  62. scrolled continuously (no pause when screen fills). Any invalid characters 
  63. in a list of options are ignored. Capital letters may be used instead of 
  64. lower case. Including '?' in options will cause any other options to be 
  65. ignored. Options may be entered in any sequence. However, if you include 
  66. more than one sort (the 'x', 'd', and 's' options), only the sort specified 
  67. last will be used.
  68.  
  69. If no file specification is included after options, the default is "*.*".
  70.  
  71. Multiple file specifications may be included in one command, separated by a 
  72. blank space. Examples:
  73.  
  74.           SS /4o c:\util\*.doc d:\db\*.dbf
  75.               |          |         |
  76.             options   1st  and  2nd file specs 
  77.  
  78.  
  79.           SS *.doc *.bak *.dbf c:\db\junk*.* d:\lo\*.wk1
  80.             |   |     |    |      |             |
  81.    no options   1st  2nd  3rd    4th    and    5th file specs
  82.  
  83. When there are multiple file specifications, total files and bytes for all 
  84. file specifications are shown at the end of the display. If there is only 
  85. one file specification, those totals would be redundant and are therefore 
  86. omitted.
  87.  
  88. Except when using the "/o" option, which omits subdirectory entries, all 
  89. subdirectories are always listed before any files, regardless of what kind 
  90. of sort is specified. With a date sort, directories will be arranged in 
  91. their proper date order before files are listed in their own date order.
  92.  
  93. SS can also be used to determine the size of device drivers (which do  not 
  94. show up in the DOS DIR command). For instance, SS CON or SS PRN or  SS AUX 
  95. or SS BRNDEV (if you happen to have installed that screen saver) will show 
  96. how much RAM space those drivers occupy. Keep in mind, though, that those 
  97. are not actual disk files and therefore can not be edited or deleted.
  98.  
  99. To abort SS while it is running, press ^C (hold down CTRL and press C).
  100.  
  101. As usual, there are no guarantees of suitability for any task. Use at your 
  102. own risk.
  103.  
  104.    -- Jim Wygant, Feb., 1990
  105.       (CompuServe #73627,2043)
  106. =========
  107. Updated June, 1991 with addition of size sort and expansion of help screen.
  108. Updated Oct., 1991 by changing pause command from a fixed 24 lines per 
  109.   screen to automatically recognize and adjust to other screen sizes.
  110. Updated Nov., 1991 so final totals have commas for easier reading; and disk 
  111.   space available is in bytes instead of kilobytes (bytes / 1024).
  112. Updated April, 1992 by changing default to all files and pause; and by 
  113.   eliminating system attribute from display to allow more room for long file 
  114.   lengths.
  115.