home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / dired102.arj / DIRED.DOC next >
Text File  |  1991-05-13  |  5KB  |  90 lines
  1. Dired - the file directory editor for the Searchlight BBS System v2.0.
  2.  
  3. Dired (C) Copyright 1991 by Zak Smith all rights reserved.
  4. -------------------------------------------------------------------------------
  5. Send me lots of money!  No, just kidding... Dired is free. (well, so far)
  6. (Although donations will help me keep this "hobby" going)
  7. All I ask is that if you like it and find it useful, drop me a message.
  8. -------------------------------------------------------------------------------
  9.  
  10. I have tried to make the program as self-explanatory as possible.  The only
  11. thing you might need to get started is the optional command line parameters.
  12.  
  13. Command Line Parameters: (optional)
  14.    DIRED /p <path> /l <xx> /b
  15.      <path> - path to CONFIG.SL2 <not needed if CONFIG.SL2 is in current dir>
  16.      <xx>   - number of lines per screen.  used for EGA and 
  17.               VGA systems that are running in one of the
  18.               following modes:
  19.                 25 lines <default>
  20.                 43 lines <ega>
  21.                 50 lines <vga>
  22.      /b     - Use bios calls instead of direct screen writes.  This 
  23.               option makes the screen updates much slower, but it may
  24.               be useful if you are running in DESQview.
  25.      /f     - This does not update the status line when scanning the
  26.               file directories.  I added this so that if you are using
  27.               Dired remotely, it will not take so long to scan, because
  28.               it will not update the screen as much.
  29.  
  30. Directory Screen:
  31.     Use Up, Down, Home, End keys to move through list of directories.
  32.     ESCAPE will exit the program. ENTER (or RETURN) will open the 
  33.     directory that the scroll bar is on, and then it will scan the directory.
  34.  
  35. File Screen:
  36.     Use Up, Down, Page Up, Page Down, Home, and End keys to move around in
  37.     the file listing.  The Enter (or Return) key will edit the current file's
  38.     description.  If you leave the first line of the extended description 
  39.     blank, then you will not get a chance to edit the second line, and
  40.     it will be blanked. Escape will exit to the Directory Screen.  An
  41.     ASCII #249 (a dot in the middle of the character block) means that there
  42.     is an extended description associated with that file.  The * and the +
  43.     after the file names are the same as in Searchlight.  ALT-C will CLEAR
  44.     the password (if any) for the current file..  ALT-E or F2 will show who
  45.     uploaded the file, when, it's size in bytes, and how many times it has
  46.     been downloaded.
  47.  
  48.  
  49. Limitations:
  50.     Dired can handle a maximun of 5,000 files in any directory.  (It does
  51.     not matter if you have more than 5,000 in several direectories added
  52.     together, as Dired only processes one directory at a time.)  Dired 
  53.     can handle a maximum of 100 file directories.  
  54.         These can be expanded in later versions if needed.  I have *NOT* 
  55.     tested Dired on directories which are close to the limit, 5,000.
  56.     The highest number of files I *HAVE* tested is about 1050, which is 
  57.     probably less than the number you have in any single on of your 
  58.     directories. Because of the file handling procedures, it *MAY* run out 
  59.     of stack space when loading VERY large directories, but this should 
  60.     not be a problem.
  61.         I set them to these values (and, in fact designed the whole program) 
  62.     mainly to conserve memory as much as possible.
  63.         
  64. Error Handling (..or not..):
  65.     If Dired encouters an error while trying to open or read any of the
  66.     system files, it should clear the screen and produce a message that
  67.     says something like: 
  68.       ERROR 2: Program Terminated: Error opening/reading CONFIG.SL2
  69.     If a non-file related error occurs, the program should terminate
  70.     and produce an error message like the following:
  71.       Run-Time error nnn at xxxx:yyyy
  72.     If this happens, remember the nnn code, and what you were doing right
  73.     before it crashed.  Somehow, try to get this information to me.  This 
  74.     is the only way I will be able to fix the error.
  75.  
  76. -[ Version History ]-----------------------------------------------------------
  77. 1.02 - 05/13/91 - Added the F2/ALT-E and ALT-C functions.  Also further
  78.                   reduced stack requirements for scanning the file dir
  79.                   to only 12 bytes per level.
  80.  
  81. 1.01 - 05/11/91 - Same Day!  Reduced stack requirements for scanning the
  82.                   file dir by about 600 bytes per level.  (only a 2 line
  83.                   source change.. I might add..)
  84.  
  85. 1.00 - 05/11/91 - First release ..
  86. -------------------------------------------------------------------------------
  87. Zak Smith - Sirius Cybernetics - 414-966-3552 - [fidonet 1:154/736]
  88. w308n7161 Club Ct.
  89. Hartland, Wi, 53029
  90.