home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dirutl / rn_dr22.arc / RN-DR.DOC < prev    next >
Encoding:
Text File  |  1988-01-18  |  11.2 KB  |  283 lines
  1.  
  2.                        Version 2.2 of RN.COM and DR.COM
  3.  
  4.      
  5.                                 Original DR.COM 
  6.                                 ---------------
  7.      "Our best free utility ever" was how PC Magazine described Michael 
  8.      Mefford's DR.COM program.  It was published in the August, 1987 
  9.      (Volume 6, Number 14) issue.  DR will list the files in a directory 
  10.      sorted by time, date, filename, or file extension (it will even 
  11.      list them in the order that DOS does!).  If the list includes more 
  12.      than 21 filenames, you can scroll through them using the cursor 
  13.      keys.  
  14.  
  15.      Once the files are listed, DR will rename, move, delete, or list 
  16.      any selected file.  You select a file by moving a 'bouncing bar' 
  17.      (inverse video filename display) with the cursor keys.  A file can 
  18.      also be selected by typing the first character of the file's name.  
  19.      The first time an 'A' is typed, for example, the bar moves to the 
  20.      first filename that begins with the letter 'A'.  Successively 
  21.      pressing the 'A' key will take you forward through all the 
  22.      filenames that begin with the letter 'A'.  When the last file 
  23.      starting with 'A' has been reached, DR will beep at you when you 
  24.      press the 'A' key. 
  25.  
  26.  
  27.      Original RN.COM
  28.      ---------------
  29.      Two issues later, PC Magazine published Mr. Mefford's companion 
  30.      program RN.COM.  RN is a directory manager in the same sense that 
  31.      DR is a file manager.  RN displays your hard disk directories in a 
  32.      tree list, sorted alphabetically.  The 'bouncing bar' technique 
  33.      seen in DR is used to make selections, only this time you are 
  34.      selecting directories.  Again, you can use the cursor keys or 
  35.      'first letter' Search to make your selections.
  36.  
  37.      RN lets you rename, create, and delete directories.  You can also 
  38.      change the file attributes of all files in a particular directory.  
  39.      By calling up RN with a '/I' option, RN's directory information is 
  40.      kept resident in memory, making invocation almost immediate.
  41.  
  42.      The nicest feature of RN is that you can highlight a directory name 
  43.      and then by pressing the Return key (or F10), call DR to list the 
  44.      files in that directory.  Together, the utilities make a GREAT directory 
  45.      management tool.
  46.  
  47.  
  48.      Modifications
  49.      -------------
  50.      The original programs worked with both monochrome and color 
  51.      systems.  The screen attributes were simply reversed to produce the 
  52.      highlighting 'bouncing bar'.  On my color system (I use bright 
  53.      green on black for text entry), the filename in the highlighted 
  54.      area was difficult to read.  I found that using a red bar with 
  55.      bright white letters made it much easier to read the filenames.  
  56.  
  57.      
  58.      
  59.      
  60.      The files RN12_C.COM and DR22_C.COM will display the red bar on 
  61.      color-equipped systems.  For monochrome systems, Mr. Mefford's 
  62.      original attribute handling works best; use the programs RN11_M.COM 
  63.      and DR22_M.COM.  Before using the programs, rename RN12_x.COM to 
  64.      RN.COM and DR22_x.COM program to DR.COM.  
  65.      
  66.      After getting used to the power and speed of Vernon Beurg's LIST 
  67.      program, I was disappointed with the scrolling speed of DR's built-
  68.      in View feature.  Being a born tinkerer and hacker, I modified DR 
  69.      so that it ran a copy of COMMAND.COM and called LIST.COM to list 
  70.      the highlighted file.  
  71.  
  72.      Once that feature was working, I found myself using RN/DR often to 
  73.      clean up my hard disk, getting rid of unwanted files.  Because I 
  74.      tend to archive a lot of my files, it seemed like every time I used 
  75.      RN/DR, I was dropping back to DOS so that I could run PKARC and 
  76.      PKXARC.  Clearly what was needed was a way to call PKARC and PKXARC 
  77.      without dropping back to DOS.  
  78.  
  79.      After making the call to LIST.COM work, it turned out to be fairly 
  80.      easy to modify DR once more, adding calls to PKARC and PKXARC.  You 
  81.      can list all the files in an archive by pressing F6.  To unARC all 
  82.      the files in a selected archive, press F5.  
  83.  
  84.      DR.COM, LIST.COM, PKARC.COM, and PKXARC.COM must all be in a 
  85.      PATH'ed directory (or directories) in order to be found when 
  86.      called. 
  87.  
  88.      PKWARE's PKARC and PKXARC programs were used because they work so 
  89.      much faster than SEA's original ARC program.  If you are currently 
  90.      using ARC, I would suggest changing to the PK programs. 
  91.  
  92.      Ziff-Davis and Michael Mefford retain the copyrights to the original 
  93.      source code for both RN and DR.  The author releases the 
  94.      modifications to the public domain.
  95.  
  96.      If you have any comments or suggestions, feel free to leave me a 
  97.      message via FIDO mail at Net 120, Node 27 (Bill Deblase's OPUS BBS, 
  98.      Grand Rapids, MI) or on Compuserve, ID 71620,1035.  I'd be happy to 
  99.      supply the source code for anyone who may be interested.
  100.  
  101.      A list of modifications to RN and DR appears at the end of this
  102.      document.
  103.  
  104.      The following is a complete command list for each program.  For a 
  105.      complete description of the original programs, see the PC Magazine 
  106.      Volume 6, Numbers 14 and 16. 
  107.  
  108.  
  109.  
  110.  
  111.           Invocation:  DR [d:][directory][/E][/S][/D][/T][/O]
  112.  
  113.              options:  d:        = drive other than currently logged drive
  114.                        directory = specific directory name
  115.                        /x        = Sort switches
  116.                                      E = by file extension
  117.                                      S = by file size
  118.                                      D = by file date
  119.                                      T = by file date
  120.                                      O = original DOS ordering (default)
  121.  
  122.  
  123.              KEY                           ACTION
  124.             -----                         --------
  125.      Cursor keys, A-Z, 0-9        Move highlight bar, selecting files
  126.  
  127.             HOME                  Moves bar to top of list
  128.  
  129.             END                   Moves bar to bottom of list
  130.  
  131.          Ctrl-PgUp                Moves bar to top of list on screen
  132.  
  133.          Ctrl-PgDn                Moves bar to bottom of list on screen
  134.  
  135.       F1, Retrn, Ctrl-L           Spawn LIST.COM to list selected file
  136.  
  137.         F2, Ctrl-D                Delete selected file
  138.  
  139.         F3, Ctrl-R                Rename selected file
  140.  
  141.         F4, Ctrl-M                Move selected file
  142.  
  143.         F5, Ctrl-X                Spawn PKXARC.EXE to unarc all files in 
  144.                                   selected archive
  145.  
  146.         F6, Ctrl-V                Spawn PKARC.EXE for Verbose list of 
  147.                                   files in selected archive
  148.  
  149.         F7, Ctrl-N                Sort file list by filename
  150.         
  151.         F8, Ctrl-E                Sort file list by file extension
  152.         
  153.         F9, Ctrl-S                Sort file list by file size
  154.         
  155.         F10, Ctrl-T               Sort file list by file date 
  156.                
  157.          Ctrl-C                   Toggle confirming prompt for Delete
  158.                                   and Rename
  159.  
  160.           ESC                     Quit DR
  161.                
  162.  
  163.  
  164.  
  165.           Invocation:  RN [d:][/I]
  166.  
  167.              options:  d: = drive other than currently logged drive
  168.                        /I = Keep disk data installed in memory 
  169.  
  170.  
  171.              KEY                           ACTION
  172.             -----                         --------
  173.      Cursor keys, A-Z, 0-9        Move highlight bar, selecting directories
  174.  
  175.             HOME                  Moves bar to top of list
  176.  
  177.             END                   Moves bar to bottom of list
  178.  
  179.          Ctrl-PgUp                Moves bar to top of list on screen
  180.  
  181.          Ctrl-PgDn                Moves bar to bottom of list on screen
  182.  
  183.             F1                    ChDir to selected directory
  184.  
  185.             F2                    Rename selected directory
  186.  
  187.             F3                    MkDir (under selected directory)
  188.  
  189.             F4                    RmDir - remove selected directory (if
  190.                                   files exist in it, you are warned.  If
  191.                                   you elect to continue, all files and then
  192.                                   the directory will be deleted).
  193.  
  194.             F5                    Hide/Unhide directory                  
  195.  
  196.             F6                    Toggle Read-only attribute for all files
  197.                                   in selected directory
  198.  
  199.             F7                    Toggle Archive attribute for all files in
  200.                                   selected directory
  201.  
  202.             F8                    Re-read Directory information (updates /I
  203.                                   information)
  204.         
  205.             F9                    Number of files and storage space taken
  206.                                   by files in selected directory
  207.         
  208.         F10, Retrn                Spawn DR - it will show files in selected
  209.                                   directory
  210.                
  211.             ESC                   Quit RN
  212.  
  213.  
  214.                             MODIFICATIONS TO DR.COM     
  215.  
  216.  
  217.     VERSION 1.0 - 9/30/87
  218.  
  219.      Source modified to display BRIGHT WHITE on RED bouncing bar (DR_C.COM).
  220.  
  221.  
  222.     VERSION 2.0 - 10/19/87
  223.  
  224.      Multiple modifications
  225.  
  226.        1. Removed VIEW function (replaced with EXEC to LIST.COM)
  227.        2. Removed Wordstar toggle
  228.            - Removed W command
  229.        3. Added EXEC to PKXARC to unarc all files in an .ARC 
  230.        4. Added EXEC to PKARC to perform a Verbose list of files in an .ARC
  231.        5. Modified menu to reflect changes
  232.        6. Un-allocated all but 64K upon entry to program.
  233.        7. Added support for 3 new commands:
  234.            1. Ctrl-C         -> toggles Confirm mode
  235.            2. Ctrl-X (or F5) -> pkXarc all files in highlighted ARChive
  236.            3. Ctrl-V (or F6) -> Verbose list of files in highlighted ARChive
  237.        8. Added BEEP call for invalid command entry.
  238.  
  239.  
  240.     VERSION 2.1 - 10/27/87
  241.  
  242.      Multiple corrections 
  243.  
  244.        1. Corrected insufficient memory return when calling DR
  245.        2. Added call to check available memory before each EXEC
  246.            - for LIST, checking for 68K additional RAM
  247.            - for XARC, checking for 105K additional RAM
  248.            - for ARCV, checking for 115K additional RAM
  249.        3. Corrected incorrect file count on return from EXEC to PKXARC
  250.        4. No longer re-displays modif. author's name on return from PKXARC
  251.        5. Removed redundant memory allocation calls
  252.        6. Corrected problem of no menu update if insuff. memory for PKXARC
  253.  
  254.  
  255.     VERSION 2.2 - 1/18/88
  256.  
  257.      Source modifications 
  258.  
  259.        1.  Changed default file sort order to /O (DOS original order)
  260.        2.  Added support for VERSION.EXE (internal utility used by Diebold,
  261.            Incorporated for source & object modification tracking).
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                             MODIFICATIONS TO RN.COM 
  268.  
  269.  
  270.     VERSION 1.0 - 9/30/87
  271.  
  272.      Source changed to display Bright White on Red bouncing bar (RN_C.COM).
  273.  
  274.     VERSION 1.1 - 10/27/87
  275.     
  276.      Source changed to use Retrn as call to DR, not a CHDIR. 
  277.  
  278.     VERSION 1.2 - 1/18/88
  279.  
  280.      Source changed to support VERSION.EXE (see explanation in DR.COM 
  281.      modification list).
  282.  
  283.