home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / diredit.zip / DIREDIT.HLP < prev    next >
Text File  |  1990-03-15  |  7KB  |  124 lines
  1. ***************** DIREDIT V3.04 ******************
  2.  
  3. This document outlines the functioning of DIREDIT, a program which allows the 
  4. restructuring of DOS directories, It is also used by the program itself as a 
  5. "Help File" and should be kept either in the current directory or in one 
  6. previously specified in a "PATH" command. The text may be edited, but the 
  7. lines which commence with a "$" sign should be preserved intact, since they 
  8. are used as index markers by the program. The lines which consist of single 
  9. "%" signs are used as page breaks when the file is displayed by the program 
  10. but have no other special significance.
  11.  
  12. $Command Line
  13. The program is invoked with the command:
  14.  
  15.                                DIREDIT [pathname]
  16.  
  17. If a pathname is not specified on the command line, the program will default 
  18. to the current directory. Any valid DOS path specification will be accepted 
  19. (e.g.  A:\; A:\SUB1\SUB2; \SUB1\SUB2 {referred to the root directory of the 
  20. current device}; SUB3\SUB4 {starting from the current directory}), but note 
  21. that the specification "d:" (where "d" represents any valid device name) will 
  22. be interpreted as indicating the ROOT directory of the specified device, NOT 
  23. the current default directory on that device. If the first file(s) in the 
  24. directory has(have) the "System" attribute, as is normally the case for the 
  25. first two files in the root directory of a bootable disk (IBMBIOS.COM and 
  26. IBMDOS.COM on IBM systems), you will be asked whether you wish to exclude them 
  27. from directory sorts - do not override the default (affirmative) answer to 
  28. this question unless you are absolutely sure you know what you are doing! 
  29.  
  30. $Spreadsheet
  31. The upper 20 lines of the terminal screen display "identifier blocks", 
  32. comprising a number (which initially corresponds (approximately) to the 
  33. position of the directory entry in the directory) and the file name, for 80 
  34. entries, in two semi-independently controllable windows, each of which 
  35. contains 40 blocks. If the directory happens to contain more than 80 entries, 
  36. the two windows can be positioned (using the <PgUp>, <PgDn>, <Home>, and <End> 
  37. keys) anywhere within it, except that they cannot overlap and that the left 
  38. hand window will always remain "below" the right hand one.
  39. %
  40.  
  41.  <PgUp> (or <F3>) moves the current window up by twenty entries.
  42.  
  43.  <PgDn> (or <F4>) moves the current window down by the same amount.
  44.  
  45.  <Home> moves the current window as far towards the file top as possible.
  46.  
  47.  <End> moves the current window as far towards the file bottom as possible.
  48.  
  49. If a window move would otherwise cause the two windows to overlap (i.e. the 
  50. other window is immediately adjacent in the direction of the attempted move) 
  51. OR the windows have been [L]ocked together, both windows are moved. If a 
  52. window move would cause either window to go beyond the top or bottom of the 
  53. file, the command is ignored.
  54. %
  55. The cursor can be moved to any identifier block by using the cursor keys, and 
  56. the "Cursor->" display at the bottom of the screen then shows the full 
  57. description of the file whose identifier is under the cursor. An entry is 
  58. moved by positioning the cursor on its identifier block, "picking it up" by 
  59. pressing the <Del> key, positioning the cursor at the point to which it is to 
  60. be moved, and "inserting" it there by pressing the <Ins> key. The full 
  61. description of an entry that is in the process of being moved is shown on the 
  62. "Moving->" display at the bottom of the screen. You may not exit (which 
  63. normally causes the disk directory to be updated) while an entry is being 
  64. moved - you must replace it somewhere first. If you attempt to move an entry 
  65. which has the "System" or "Hidden" attribute, you will be asked to confirm the 
  66. <Del> entry before the program acts on it. A number of other single-key 
  67. commands are available - see the next screen for details.
  68. % 
  69. Additional single-key commands: 
  70.  
  71. "D" - change the date stamp on the current file.
  72.  
  73. "L" - toggle the "lock" which forces both windows to move together.
  74.  
  75. "M" - display the next line of the single-line "aide-memoire" list of commands 
  76. which appears on the 23rd line of the screen.  
  77.  
  78. "N" - edit a new directory (you are given the option of updating the current
  79. one first).  
  80.  
  81. "Q" - quit the program without updating the current directory. 
  82.  
  83. "R" - rename the current file.
  84.  
  85. "S" - sort the directory (see next help screen).
  86.  
  87. "X" - exit and write the output file.
  88.  
  89. "?" or <F1> - display this help text again.
  90. %
  91. The directory display (and, ultimately, the directory on disk) may be sorted 
  92. by date, filename, extension, or file size, in ascending or descending order. 
  93. It may also be rearranged in any other order you care to specify. By default, 
  94. files with the "System" attribute at the beginning of the directory are 
  95. excluded from ALL sort operations. In fact, if you have moved one of these 
  96. files "by hand", performing a sort will result in its being returned to its 
  97. initial position.
  98.  
  99. After entering "S", you may also enter a second character to indicate how you 
  100. want the directory to be sorted - the options are detailed in the documen-
  101. tation. If you enter an invalid character (or if you do not enter anything 
  102. within 2 seconds) the program will prompt you to specify the type of sort by 
  103. presenting the possibilities one by one.
  104. (continued...) 
  105. %
  106. All the sort options presented after the first two ("Optimal Order?" and 
  107. "User-Specified Order?") are intended to be self-explanatory - the first sorts 
  108. the directory in the order which generally gives the best combination of 
  109. efficiency and convenience, while the second is the one that allows you to 
  110. rearrange the file entries in an arbitrary order. If you respond to the second 
  111. prompt with a "Y", you will be further prompted to enter two lists of file 
  112. numbers (the numbers displayed next to the filenames on the upper part of the 
  113. screen). The first list should contain the numbers of files which you would 
  114. like to move to the top of the directory (in the order in which you want them 
  115. to appear there) - the second should contain the numbers of files which you 
  116. want to move to the bottom, also in the order in which they are to appear. 
  117. Either list may be blank (just press <CR>). The lists should contain only the 
  118. file numbers, as decimal integers, separated by one or more spaces and/or 
  119. tabs. Like all other sort operations, this will, by default, leave system 
  120. files from the beginning of the directory untouched (or move them back, if 
  121. they were previously disturbed), EVEN if you specify their numbers in one of 
  122. the lists you enter. 
  123.  
  124.