home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / dirs / jpdirutil_412.lzh / JPDirUtil / JPDirUtil.doc < prev    next >
Text File  |  1990-12-14  |  11KB  |  321 lines
  1. *****************************************************************************
  2.  
  3.                                 JPDirUtil v1.2
  4.  
  5.                     (c) Copyright 1989 by Jonathan Potter                    
  6.  
  7. *****************************************************************************
  8.  
  9.  
  10.                                  INTRODUCTION
  11.                                  ------------
  12.  
  13.     JPDirUtil lets you access the more frequently used CLI commands from an
  14. Intuition environment.
  15.     To choose file(s) or directory to operate upon, click on the name in
  16. the file window. You may scroll up and down the file window using the
  17. slider gadget. The three string gadgets are
  18.  
  19.     S - Source directory. To choose files from a new directory,
  20.            you may enter that directory's name here. DO NOT enter
  21.            any filenames here.
  22.     D - Destination directory. This contains the complete pathname
  23.            of the destination. DO NOT enter any filenames here either.
  24.     E - Execute string. This string is passed to any file you RUN.
  25.         This also contains the destination filename for CLONE, RENAME, etc.
  26.  
  27.     To open a new directory, double-click on the directory name.
  28.  
  29.  
  30.  
  31.                                    GADGETS
  32.                                    -------
  33.  
  34. ** Note : Any operation involving more than one file may be aborted
  35.           when in process by pressing the right mouse button.
  36. ** Note : "destination" below refers to the destination directory as
  37.           that entered in the D gadget, and the destination filename
  38.           as that entered in the E gadget.
  39. ** Note : If "Are you sure?" checking is enabled, you are asked for
  40.           confirmation before most operations are carried out.
  41.  
  42.  
  43.     DF0:, DF1:, DF2:, DF3:, DH0:, DH1:, RAM:, RAD:, VD0:, VDK:, SYS:, C:
  44.  
  45.     These gadgets provide an easy way to set the source directory to one
  46.     of the more commonly used devices. Any device names not appearing here
  47.     will have to be entered by hand in the S gadget.
  48.     Clicking on the D string gadget and then one of these enters the
  49.     device name as the destination directory. These gadgets may be
  50.     customised in the Setup file (see below).
  51.  
  52.     SWAP
  53.  
  54.     This gadget swaps the source and destination directories around.
  55.  
  56.     ALL
  57.  
  58.     This gadget either selects or unselects every file in the list.
  59.  
  60.     PARENT
  61.  
  62.     This gadget moves the source directory back to the parent of the current
  63.     source directory.
  64.  
  65.     ROOT
  66.  
  67.     This gadget moves the source directory back to the root of the current
  68.     source directory.
  69.  
  70.     SBYTE
  71.  
  72.     Shows the number of bytes available, free and used on the source device.
  73.  
  74.     DBYTE
  75.  
  76.     Shows the number of bytes available, free and used on the destination
  77.     device.
  78.  
  79.     BYTE
  80.  
  81.     Displays the sum of the lengths of all the selected files, in bytes.
  82.  
  83.     BLOCK
  84.  
  85.     Displays the sum of the lengths of all the selected files, in blocks.
  86.  
  87.     DELDIR
  88.  
  89.     This gadget allows you to delete the currently selected directory, and
  90.     all files/subdirectories that it contains.
  91.  
  92.     MAKEDIR
  93.  
  94.     Allows you to create a directory. When selected, a string requester
  95.     will open. To cancel the operation, press return to a blank string,
  96.     or enter the name of the directory to wish to create.
  97.  
  98.     DELETE
  99.  
  100.     Attempts to delete the selected file(s).
  101.  
  102.     RUN
  103.  
  104.     Attempts to run the FIRST selected file in the list. Parameters may
  105.     be passed by entering them in the E gadget.
  106.  
  107.     RENAME
  108.  
  109.     Attempts to rename the FIRST selected file as the name entered in the E
  110.     string gadget. The destination directory is the same as the source, ie
  111.     the string in the D gadget is ignored.
  112.  
  113.     MOVE
  114.  
  115.     Attempts to move all selected files into the destination directory in
  116.     the D string gadget. MOVE will not move from one disk to another. The
  117.     string in the E gadget is ignored.
  118.  
  119.     CLONE
  120.  
  121.     Attempts to clone the FIRST selected file, renaming the clone as the
  122.     name entered in the E string gadget. The destination directory is the
  123.     same as the source, ie the string in the D gadget is ignored.
  124.  
  125.     COPY
  126.  
  127.     Attempts to copy all selected file(s) to the destination directory.
  128.     You cannot copy whole directories. The string in the E gadget is
  129.     ignored.
  130.  
  131.     TYPE
  132.  
  133.     This gadget allows you to view the selected files in the list as
  134.     standard ASCII.
  135.  
  136.     HTYPE
  137.  
  138.     This gadget allows you to view the selected files in the list as
  139.     hex dumps.
  140.  
  141.     PRINT
  142.  
  143.     The same as TYPE, except that the file will be sent to PRT: (printer)
  144.     as well as the screen.
  145.  
  146.     HPRINT
  147.  
  148.     The same as HTYPE, except that the file will be sent to PRT: (printer)
  149.     as well as the screen.
  150.  
  151.     SHOW
  152.  
  153.     Attempt to show all selected files as IFF pictures. Will display all
  154.     types of IFF pictures. To close the picture once it is displayed, click
  155.     the left mouse button. To close and abort any further picture showing,
  156.     click the right mouse button.
  157.  
  158.     EDIT
  159.  
  160.     Attempt to edit the FIRST selected file with a text editor. The name
  161.     of the text editor defaults to "c:editor" but you may change this in
  162.     the SetUp file (see below).
  163.  
  164.     ICON
  165.  
  166.     Allows you to attach an icon to ALL selected entries. When selected,
  167.     a requester appears prompting you for the type of icon, either
  168.     DRAWER (for a directory), TOOL (for an executable program), or
  169.     PROJECT (for a text file, picture, etc..). Choose the type of icon,
  170.     or CANCEL to cancel.
  171.  
  172.     NEWCLI
  173.  
  174.     Open a new interactive CLI window on the Workbench screen.
  175.  
  176.     COMMENT
  177.  
  178.     Attach a comment to the FIRST selected entry. When selected, a string
  179.     requester appears. To cancel, press return on a blank string, or enter
  180.     the comment desired.
  181.  
  182.     PROTECT
  183.  
  184.     This gadget allows you to set the protection bits on the selected
  185.     file(s) and directory. When selected, a string requester appears.
  186.     Enter the desired protection bits, and press return. The bits allowed
  187.     are "sparwed".
  188.  
  189.     SEECOMM
  190.  
  191.     Allows you to see the comment attached to the FIRST selected entry.
  192.  
  193.     SEEPROT
  194.  
  195.     Allows you to see the protection bits of the FIRST selected entry.
  196.  
  197.     CUSTOM GADGETS
  198.  
  199.     The last 16 gadgets are available for customisation. See the SETUP section
  200.     below for information on how to do this.
  201.     When a customised gadget is chosen, the command sent is built from the
  202.     gadget text, the string (if any) in the execute buffer, and the names of
  203.     any selected files, in that order.
  204.     For example, if the gadget text was "ZOO a", and you wished to zoo
  205.     together some files, you would select the files you wish to zoo (by
  206.     clicking on their names), enter the name of the .zoo file in the execute
  207.     buffer, and choose "ZOO a".
  208.  
  209.  
  210.                                    ICONIFY
  211.                                    -------
  212.  
  213.     You may iconify JPDirUtil to a small window on the Workbench screen,
  214. and then recall it when you desire. This window can also be a title-bar clock
  215. (see below).
  216. To iconify JPDirUtil, click on the ICON gadget in the title bar of the
  217. JPDirUtil screen. To start JPDirUtil up in the iconified mode, enter from
  218. the CLI
  219.  
  220.              [RUN] JPDirUtil -i
  221.  
  222.  
  223.                                     SETUP
  224.                                     -----
  225.  
  226.     JPDirUtil allows you to configure the SetUp of the program in a small way.
  227. To do this, the file "JPDirUtil.SetUp" must be present in either the current
  228. directory or the S: directory. The SetUp file looks like this :
  229.  
  230. Command                                       Default
  231. -------                                       -------
  232.  
  233. SORT = <bool>                                 1
  234. EDITOR = <string>                             c:Editor
  235. CLOCK = <bool>                                1
  236. SDIR = <string>                               RAM:
  237. DDIR = <string>                               SYS:
  238. EXEC = <string>
  239. COL0 = <hex>                                  00E
  240. COL1 = <hex>                                  FFF
  241. COL2 = <hex>                                  002
  242. COL3 = <hex>                                  F00
  243. ICONX = <dec>                                 100
  244. ICONY = <dec>                                 0
  245. CHECK = <bool>                                0
  246. GADGET <dec> = <string>
  247. DRIVE <dec> = <string>
  248.  
  249. All of these items are optional, and may appear in any order. Case is not
  250. important, but the " = " must be as it is above.
  251. All <bool> values are either 1 or 0. 1 is on and 0 is off.
  252. <string> values may not contain any spaces.
  253. <hex> refers to a hexadecimal number, with no leading 0x or $, etc..
  254. <dec> refers to a decimal number.
  255.  
  256.     SORT   allows you to turn sorting of directories on or off.
  257.     EDITOR allows you to select the name of the editor you wish to use with
  258.            the EDIT gadget.
  259.     CLOCK  allows you to select whether the iconified window is a title
  260.            bar clock or not.
  261.     SDIR   allows you to select the initial Source directory.
  262.     DDIR   allows you to select the initial Destination directory.
  263.     EXEC   allows you to select the initial Execute string.
  264.     COL0 \
  265.     COL1 \
  266.     COL2 \
  267.     COL3   allows you to select the colour in that colour register.
  268.     ICONX  allows you to select the X position of the iconified window.
  269.     ICONY  allows you to select the Y position of the iconified window.
  270.     CHECK  allows you to turn the "Are you sure?" requester on or off.
  271.     GADGET allows you to specify the text for a custom gadget; <dec> is a value
  272.            from one to sixteen, and <string> is the gadget text.
  273.            The <string> value in this instance MAY contain spaces, but may not
  274.            be more than 80 characters long.
  275.     DRIVE  allows you to specify the text for the 12 drive gadgets; <dec> is a
  276.            value from one to twelve, and <string> is the drive text.
  277.  
  278.  
  279. An example SetUp file is:
  280.  
  281.  
  282. SORT = 1
  283. EDITOR = c:CygnusEd
  284. CLOCK = 0
  285. SDIR = RAM:
  286. DDIR = SYS:
  287. COL0 = f00
  288. COL1 = 0f0
  289. COL2 = 00f
  290. COL3 = 000
  291. ICONX = 0
  292. ICONY = 0
  293. CHECK = 1
  294. GADGET 1 = ARC a
  295. GADGET 2 = ZOO a
  296. GADGET 3 = ARC x
  297. GADGET 4 = ZOO x
  298. DRIVE 5 = JH0:
  299.  
  300.  
  301.                                    THE END
  302.                                    -------
  303.  
  304.     JPDirUtil is freely redistributable, but it is NOT public domain. The
  305. author retains all rights. It may NOT be sold for profit, or included on
  306. any commercial product without prior permission from the author.
  307.     I hope JPDirUtil becomes a useful addition to your software library.
  308.  
  309.     Send any bug reports, praise, criticism, **Job Offers**, and spare cash
  310. to:
  311.  
  312.  
  313.                              Jonathan Potter
  314.                              P.O. Box 289
  315.                              Goodwood, 5034
  316.                              South Australia
  317.                              Australia
  318.  
  319.                      phone : (08) 2932788
  320.  
  321.