home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / USCX / DOSUT-16.ZIP / SDIR50.DOC < prev    next >
Text File  |  1985-02-19  |  8KB  |  211 lines
  1. ----------------------------------------------------------------
  2.        SDIR -[SUPER-DIRECTORY] COMMAND, Version 5.0
  3. ----------------------------------------------------------------
  4.  
  5.       An All-purpose Directory Utility and Command Shell for
  6.          the IBM Personal Computer
  7.  
  8.          By W. Lawrence Hatt
  9.  
  10. Copyright (c) 1984 by W. Lawrence Hatt. All rights reserved.
  11.  
  12.  
  13.  
  14. SDIR VERSION 5.0 is currently distributed as User Supported
  15. Software.  With a few restrictions, this allows the
  16. program, although copyrighted, to be freely copied and
  17. distributed.
  18.  
  19. SDIR 5.0 is a major update of the program SDIR 4.0/4.1
  20. previously distributed free.  The update corrects existing
  21. bugs and adds a major new feature: COMMAND MODE.  This mode
  22. allow ready access to usual file actions such as DEL, COPY,
  23. LOOK (list to screen), change attributes and execute
  24. programs.  Since I find the directory a useful base of
  25. normal operation, fast menu-like use of the directory as a
  26. shell for these operations is very convenient.
  27.  
  28. This product must be copied and distributed as a complete
  29. package.  This includes both the SDIR 5.0 program
  30. (SDIR50.COM) and this documentation file (SDIR50.DOC). 
  31. SDIR 5.0 is copyrighted and may not be distributed if
  32. altered or modified in any way.  Finally, no fee is to be
  33. charged for copying or distributing the programs without my
  34. written permission.
  35.  
  36. In short, SDIR 5.0 may be copied and distributed to anyone
  37. who wishes it as long as it is a complete unmodified
  38. package including the program and documentation and no fee
  39. is charged.  In turn, I am requesting a small contribution;
  40. about $10.00 is suggested but please contribute whatever
  41. you feel the program is worth.  Your contributions will
  42. help offset development costs and thus assure future
  43. updates and products.  Also, registered users of SDIR 5.0
  44. will be placed on a mailing list for future modifications. 
  45. Even if you don't feel that the program merits a
  46. contribution, please continue to copy and share this
  47. program with others.
  48.  
  49.  
  50.                               W. Lawrence Hatt
  51.                               76 Melville Drive
  52.                               Nepean, Ontario
  53.                               Canada, K2J 2E1
  54.  
  55.  
  56. REQUIRED CONFIGURATION
  57.  
  58.         * IBM PC or close clone
  59.         * Color Graphic or IBM Mono screen adapter
  60.         * DOS 2.0 or 2.1
  61.         * 128k or more for COMMAND MODE
  62.  
  63. USING SDIR VERSION 5.0
  64.  
  65. SDIR [d:][path][filename[.ext]] [options]                              
  66.      [filespec] same as for DIR command
  67.  
  68.      [options]   /A - List hidden files.
  69.                  /C - Single Column Commented Directory.           
  70.                       (see explanation below)
  71.                  /X - Sort by extension.
  72.                  /S - Sort by size.
  73.                  /D - Sort by date/time.
  74.                  /N - Do not sort, original order.
  75.  
  76. COMMAND [/] - To invoke command actions on selected
  77.     file after the directory is up: LOOK at any ASCII or
  78.     WORDSTAR file; Execute (GO) any COM, EXE or BAS file;
  79.     Set or Reset Archive or Read-only file attribute; Copy
  80.     to drive A:,B:,C:, or D:; Delete any file; Copy any
  81.     complete directory to the default directory on the
  82.     indicated drive.
  83.  
  84. DEFAULT    - *.* sorted by name.ext. 
  85.   
  86. NOTE       - Non conflicting Options may be combined.
  87.        i.e.  sdir/c/a/d is a valid option. 
  88.  
  89.       - It is suggested that SDIR50.COM be renamed D.COM and
  90.       remain on all system diskettes or the default path
  91.       directory of your hard disk.
  92.  
  93. /C  THE COMMENTED DIRECTORY
  94.         
  95. The directory is listed in one column only; use PgUp/ PgDn
  96. to page through any number of pages.  A file SDIR.$$$ is
  97. either created or opened and sorted with comments appearing
  98. beside the appropriate file.  This file is stored on the
  99. default disk/directory no matter where the SDIR command
  100. file resides.  The real directory is not touched of course. 
  101. In fact, although each whole file line is stored, only the
  102. last 40 characters are written to the screen.  Thus,
  103. progressive updates of the same file will keep the same
  104. comments.  The comments for deleted files will
  105. automatically be deleted.  Unfortunately, if you change the
  106. filename the comments are lost for that file.
  107.  
  108. Primitive edit control is available to write new comments:
  109.             - normal upper and lower case characters
  110.             - RTN: jump to beginning of next line
  111.             - DEL and BKSP: distructive cursor left
  112.             - CURSOR: control keys work normally
  113.             - PgUp and PgDn: normal
  114.     
  115. SDIR50 is compatible with comment files from SDIR40,
  116. SDIR401, SDIR41 AND SDIR411.
  117.  
  118. ESC: must use this key to return to DOS or return to normal
  119. mode from the COMMAND mode.
  120.  
  121. [/]  THE COMMAND MODE
  122.  
  123. Command Mode is available at any time after invoking the
  124. SDIR program by keying "/" (like 123).  When this is done a
  125. double command line appears at the top of the screen and
  126. individual commands are invoked by placing the cursor on
  127. the desired action file.  The desired action is invoked by
  128. striking the highlighted key for the desired action. 
  129. Available actions include the following:
  130.  
  131. CHANGE ATTRIBUTE
  132.     
  133.     R - change file to Read-Only, or if already
  134.         Read-only to Read-write
  135.     A - change the Archive bit
  136.  
  137. In either case the state of all attributes are displayed
  138. for the file regardless of whether the /A mode was
  139. initially selected.
  140.  
  141. GO
  142.  
  143. This is the program execute key.  Selected file must be
  144. .COM, .EXE, or .BAS.  Your machine should have extra memory
  145. since the SDIR program and buffers stay resident using up
  146. about 64k of memory.
  147.  
  148. There are two other important requirements for full
  149. function of this mode.  A copy of COMMAND.COM and
  150. BASICA.COM must be resident on the ROOT DIRECTORY of the
  151. default drive.  The COMMAND.COM version must be the same
  152. as the one used at boot-up time or the system will
  153. `hang'.  For hard disk users you probably already keep
  154. COMMAND.COM and BASICA.COM on the `\' directory of C:; 
  155. for floppy diskette use, I'm afraid you'll need compatible
  156. COMMAND.COM on each diskette you are copying from---this
  157. problem arises because the program must know exactly where
  158. to find COMMAND.COM as we load a secondary copy to use in
  159. the EXEC function call and the COPY command.
  160.  
  161. If you want to have some fun try repeated re-execution of
  162. the SDIR program using GO.
  163.  
  164. DELETE
  165.  
  166. The selected file is deleted.  Be careful, there's no going
  167. back.  An X is indicated on the right side of the file to
  168. remind of action taken.
  169.  
  170. LOOK
  171.  
  172. This is a quick, screen-oriented, file lister.  Paging
  173. control is provided but no editing.  Files are expected
  174. to be ASCII but WordStar and other similar wordprocessing
  175. files are handled by interpreting only the lower 7 bits of
  176. the code and a few other extraneous WordStar characters are
  177. removed.  "Looking" at other files may produce "junk" on
  178. the screen.  The listing ends with the encounter of ASCII
  179. 254.  The file size is limited to the balance of the 64 k
  180. segment occupied by SDIR; this usually amounts to about 20k
  181. character files.
  182.  
  183. COPY
  184.  
  185. Hitting the appropriate number copies the selected file to
  186. the indicated drive.  Appropriate error messages will
  187. indicate any problems.  Placing the cursor on a directory
  188. entry copies the whole directory.  As for the GO command
  189. you must have a copy of COMMAND.COM on the ROOT DIRECTORY
  190. of the default drive to use COPY.  The version must be the
  191. same as the version used to boot the system.
  192.  
  193. IMPORTANT NOTE: THE OBJECT FILES POINTED TO BY THE CURSOR
  194. MUST BE ON THE DEFAULT DRIVE/DIRECTORY.  AN ERROR NOTICE
  195. WILL BE GIVEN FOR OTHER FILES.  THIS MEANS,FOR INSTANCE,
  196. THAT YOU CANNOT INVOKE COMMAND ACTIONS AFTER INVOKING "SDIR
  197. A:" FROM THE DEFAULT B: DRIVE.
  198.  
  199. Direct comments or problems to Larry Hatt on PCANADA PC1269
  200.  
  201.  
  202.  
  203.         This disk copy was originally provided by "The Public Library",
  204.         the software library of the Houston Area League of PC Users.
  205.  
  206.         Programs are available from the Public Library at $2 per disk
  207.         on user-provided disks.  To get a listing of the disks in the
  208.         Public Library, send a self-addressed, stamped envelope to
  209.  
  210.              Nelson Ford,  P.O.Box 61565,  Houston, TX 77208.
  211.