home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / discutils / menus / dirctrl / !DirCtrl / !Help < prev    next >
Encoding:
Text File  |  1994-10-30  |  12.7 KB  |  252 lines
  1. Dir Control     version 1.04 by Chris Coe of Norsoft Productions 1994
  2. ===========
  3.  
  4. The ultimate aim of Dir Control is to provide the user with all the little
  5. utilities and add ons that he/she uses with regards to disk management in one
  6. program. This first release version contains the system plus five utilities;
  7. I want to know what sort of gadgets people find useful so I can make a really
  8. useful organizer (see below for contanct address). The program has three main
  9. functions:
  10.  
  11. 1) Directory on the icon bar
  12.    -------------------------
  13.    
  14.    You can put any directory of your choice onto the icon bar for quick and
  15.    easy access. The directory can be somewhere on your hard disk, or the
  16.    "Dirs" directory which is hidden in !DirCtrl itself. This is useful for
  17.    hiding files from other users so that the only way to get to it is
  18.    through Dir Control.
  19.    The directory display options can also be set to anything you want. This
  20.    can be useful for cataloguing many similar files. For example, if you
  21.    normally have the directory showing large icons sorted by name (as most
  22.    people do), but you have a Letters directory with 60 files in it, you
  23.    might want to show the directory with small icons and sorted by date.
  24.    
  25. 2) Password protection
  26.    -------------------
  27.    
  28.    To keep prying eyes out, there is a (fairly) flexible password system in
  29.    Dir Control. You can configure it to request the password when you first
  30.    load the program, every time you access the directory, or both. You can
  31.    either set the program to quit or the computer to crash if the user
  32.    enters the wrong password. In this version you are only allowed one
  33.    attempt, but this may be changed in later versions.
  34.    The actual password can be upto 10 characters long, and case is important
  35.    so you need to make sure the Caps Lock light is in the correct
  36.    configuration before you enter it.
  37.    
  38. 3) Useful utilities
  39.    ----------------
  40.    
  41.    The icon bar menu provides a Utils sub-menu which lists all the utilities
  42.    included with the current version, plus an option to open the directory
  43.    (see above). In this version, they are:
  44.    
  45.         Dir scan  -  produce text output of contents of a disk or directory
  46.     Auto archive  -  turns files/directories into archives of the same name
  47.     Smart rename  -  neatens up filenames
  48.      Empty RamFs  -  provides a quick and easy way of emptying the RAM disk
  49.    
  50.    In addition, you can set the CSD (Current Selected Directory) by dragging
  51.    files/directories to the icon bar.
  52.    These utilities are described in more detail below.
  53.    
  54. Configuration
  55. -------------
  56.  
  57. When you first load Dir Control, an icon will install itself onto the icon
  58. bar. Bring up the menu and choose the "Preferences" option; this will open up
  59. a window containing a myriad of settings for your personal preference. These
  60. are permanently stored inside !DirCtrl in the !Choices text file. The file is
  61. layed out in pure English, so it is easy to edit even without the preferences
  62. window (the only exception to this is the password, which is encrypted to
  63. prevent sneaky users discovering it!). The options available are:
  64.  
  65.   Access:            Password   -  Toggles password protection on/off
  66.            Request:  On startup -  When selected, the user will be prompted
  67.                                    to enter the password when the program is
  68.                                    first loaded.
  69.                      On access  -  When selected, the user will be prompted
  70.                                    to enter the password when he or she
  71.                                    attempts to access the directory.
  72.            Failure:  Crash      -  If the user enters the wrong password,
  73.                                    this will cause the computer to freeze,
  74.                                    the only way out being to reset it.
  75.                                    CAUTION: Use with care, you only get one
  76.                                    chance!
  77.                      Quit       -  If the user enters the wrong password,
  78.                                    this will cause Dir Control to quit
  79.                                    immediately.
  80.            Password:               Enter your password here. You can use
  81.                                    any characters you like, but the maxiumum
  82.                                    limit is ten characters.
  83.   Behaviour:         Open at
  84.                           start -  When selected, the directory window will
  85.                                    open as soon as the program is loaded
  86.                                    (but after the password is entered
  87.                                    correctly, if this option is set).
  88.                      Dir icon   -  When selected, a directory of your choice
  89.                                    will reside on the left-hand side of the
  90.                                    icon bar. When unselected, the usual
  91.                                    !DirCtrl icon will appear on the
  92.                                    right-hand side of the icon bar. All
  93.                                    options relating to the directory will be
  94.                                    disabled, and then the program will just
  95.                                    act as a utility bank.
  96.                      Search path-  This is the location where Dir Control
  97.                                    looks for the directory to display and
  98.                                    protect. If you type in ..Internal -
  99.                                    exactly as shown, including case - then
  100.                                    Dir Control will look inside its own
  101.                                    'Dirs' directory found inside the
  102.                                    program. You can thus hide files in
  103.                                    !DirCtrl and put a password on them.
  104.   Sorting:           By name    -  This will cause files to be listed in
  105.                                    alphabetical order.
  106.                      By size    -  This will cause files to be listed in
  107.                                    reverse size order (largest first).
  108.                      By type    -  This will cause files to be listed in
  109.                                    reverse filetype order (&FFF - &000).
  110.                      By date    -  This will cause files to be listed in
  111.                                    reverse date order (newest first).
  112.   Display:           Large icons-  This will cause large icons to be used
  113.                                    to represent files.
  114.                      Small icons-  This will cause small icons to be used
  115.                                    to represent files.
  116.                      Full info  -  This will cause full information about
  117.                                    files to be shown (filetype, datestamp
  118.                                    etc). Small icons will be used.
  119.   Mouse action:      Directory  -  This will cause the directory to be
  120.   (duplicated for                  opened upon a mouse click on the icon
  121.   each mouse button)               bar.
  122.                      Dir scan   -  This will cause the dir scan window
  123.                                    to be opened upon a mouse click on the
  124.                                    icon bar.
  125.                      Auto arc   -  This will cause the auto archive window
  126.                                    to be opened upon a mouse click on the
  127.                                    icon bar.
  128.                      Smart name -  This will cause the smart rename window
  129.                                    to be opened upon a mouse click on the
  130.                                    icon bar.
  131.                      Empty RamFs-  This will cause the empty RAM warning
  132.                                    box to be opened uppn a mouse click on
  133.                                    the icon bar.
  134.  
  135. When you have set the system up to your satisfaction, click on OK to enforce
  136. the options for the current session or Save to make any changes permanent.
  137. Click on Cancel if you decide you don't want to make any changes after all,
  138. and Default to set everything to its normal configuration.                   
  139.  
  140. Utilities
  141. ---------
  142.  
  143. DIR SCAN
  144. The purpose of dir scan is to produce a textual "analysis" of a disk or
  145. directory. This information includes a dump of every file found in the
  146. specified search area, plus the number of files, ordinary directories and
  147. application directories found.
  148. The dir scan window contains three items. The first is a writable field which
  149. specifies the scan directory, in which you can drop a directory or type in
  150. your own. As before you can use ..Internal to specify !DirCtrl.Dirs. The
  151. second and third items are radio icons. If "Look inside applications" is
  152. selected, then dir scan will examine files inside directories. If "Count
  153. files" is selected, a summary of the number of objects found will be appended
  154. to the end of the text output.
  155. Click on Scan and drag the save box to a directory display to begin the
  156. search. The hourglass will be displayed and eventually a file will be created
  157. which you can examine with !Edit or something similar.
  158.  
  159. AUTO ARCHIVE
  160. This utility could be very useful indeed. Simply ensure that a read/write
  161. version of ArcFS is loaded (I have only tested auto archive with ArcFS 1.09,
  162. so I cannot guarantee it will work with the second release), and drag a file
  163. or directory to the auto archive window. After a short delay, the object will
  164. have been turned into an archive of the same name. If you dragged a
  165. directory, its contents will be at the root of the archive, ie. there will
  166. not be a directory of the same name there, so the archive effectively
  167. replaces the directory.
  168. Objects are copied to !Scrap, so if anything goes wrong you can always find
  169. your data there.
  170.  
  171. SMART RENAME
  172. Best used on large groups of files, smart rename will neaten up the
  173. appearance of filenames. First, drag your file/directory to the writable
  174. field in the smart rename window, or type your own in. You can then choose
  175. whether you want the filenames to be in upper or lower case, and whether the
  176. first letter should be capital or small. Click on Rename to start the
  177. process.
  178.  
  179. EMPTY RAMFS
  180. While RISC OS 3 now allows you to quit the RAM filing system without deleting
  181. all the files, if you wish to just empty the RAM disk and leave it the same
  182. size, it is rather annoying to keep reconfiguring it in the task manager.
  183. Thus, empty RamFs allows you to quickly delete all files regardless of
  184. whether they're locked or not, but still retain the RAM disk itself. In RISC
  185. OS 2, this is also useful if you DO want to quit RAMFS, because there is no
  186. quit option in the old RAMFS menu.
  187. When you invoke empty RamFs, a warning window will appear asking you to
  188. confirm your action. Click on OK to proceed or Cancel to abort the operation.
  189. If you have no RAM disk configured and you click on OK, nothing will happen.
  190.  
  191. SETTING THE CURRENT DIRECTORY
  192. This utility is always active. It works in two ways. If you drag a directory
  193. to the icon bar, then the CSD will be set to that directory. However, if you
  194. drag a file or application to the icon bar, the CSD will be set to the
  195. directory containing that file or application. So, dragging the directory:
  196.  
  197. adfs::FRED.$.Letters.Accounts     will set the CSD to that directory
  198.  
  199. But dragging the file:
  200.  
  201. adfs::FRED.$.Letters.WaterBill    will set the CSD to
  202. adfs::FRED.$.Letters              (its parent directory)
  203.  
  204. Known bugs
  205. ----------
  206.  
  207. 1) When you change the directory name for display on the icon bar, there is a
  208. problem if you enter a name that is longer than the previous one, in that it
  209. won't be completely displayed. This problem disappears when you reload the
  210. program. The problem is, I don't know how to change the size of the sprite so
  211. that the whole thing is displayed, so if anyone can help me, I'd be grateful!
  212.  
  213. 2) If you invoke a dir scan that becomes many directories deep, the program
  214. may fail with an error. Currently the only easy way around this is to
  215. increase the WimpSlot setting in the !Run file. Increase both numbers in
  216. steps of 32k until the problem vanishes.
  217.  
  218. Contact
  219. -------
  220.  
  221. Bug reports, suggestions for improvement, comments, donations or indeed
  222. anything should be sent to:
  223.  
  224.                          Norsoft Productions,
  225.                          19 Seton Road,
  226.                          Taverham,
  227.                          Norwich,
  228.                          Norfolk,
  229.                          NR8 6QE.
  230.  
  231. Nasty Warning!
  232. --------------
  233.  
  234. This program is Public Domain. You may copy it if you wish (please do!), but
  235. DON'T make any profit out of it, or I'll send a nasty man round with designer
  236. stubble and a large chain saw!
  237.  
  238.  
  239.  
  240.  
  241.  
  242. History
  243. -------
  244.  
  245. 1.00    - First release version
  246. 1.01    - Auto archive rename bug fixed
  247. 1.02    - CSD utility added
  248. 1.03    - Archives are now closed automatically after Auto archive finishes
  249.           DirCtrl$Dir system variable added - this removes the problem caused
  250.           when the user tries to quit after loading another application.
  251. 1.04    - Smart rename directory filename changing bug fixed
  252.