home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / os2 / fc.arj / README.DOC < prev   
Encoding:
Text File  |  1992-06-11  |  8.1 KB  |  167 lines
  1.                   File Commando - A file utility for OS/2
  2.  
  3. For those familiar with the DOS utility Norton Commander, FC (following the
  4. axiom that imitation is the sincerest form of flattery) attempts to provide
  5. most of the same functionality under OS/2.
  6.  
  7. Using FC you can copy, move, rename, delete, find, view, and edit files in
  8. a multi-window file list.  This list shows two directories, through which
  9. you can navigate using the cursor, page up & down, home and end keys.  The
  10. TAB key switches between the two directory windows.  Pressing the RETURN key
  11. when a directory is highlighted will move into that directory.  Pressing the
  12. SPACE BAR or INS key when a file is highlighted will mark that file for later
  13. copy, move, or delete operations.  Directories cannot be marked.
  14. The + and - keys can be used to select or unselect (respectively), files
  15. matching a specified pattern.
  16.  
  17. Commands are shown at the bottom of the main screen, and most can also be
  18. accessed using mnemonic characters.  The available functions are:
  19.  
  20. F1, g - Goto:    Change the drive or directory of the current panel
  21.  
  22. F2, r - Rename:  Rename a single file
  23.  
  24. F3, v - View:    Launches a viewing program to examine the selected file.
  25.                  The viewing program is specified by in the TOOLS.INI file.
  26.                  See TOOLS.INI below.
  27.  
  28. F4, e - Edit:    Launches an editor in the same way as the viewer, above.
  29.  
  30. F5, c - Copy:    Copies the current file (highlighted by the bounce bar) or
  31.                  the marked files to the other directory.  If you a press
  32.                  Copy while a directory is selected, the whole directory,
  33.                  along with all its files and subdirectories, will be copied
  34.                  to the other directory.
  35.  
  36. F6, m - Move:    Moves the current file (highlighted by the bounce bar) or
  37.                  the marked files to the other directory.
  38.  
  39. F7, k - Mkdir:   Creates a new directory in the current directory
  40.  
  41. F8, d - Delete:  Deletes the current file (highlighted by the bounce bar) or
  42.                  the marked files from the current directory.  If you press
  43.                  Delete while a directory is highlighted, FC will ask you to
  44.                  confirm removing the directory, and will then REMOVE THE
  45.                  ENTIRE SUBDIRECTORY TREE BASED AT THAT POINT.  This can
  46.                  obviously be dangerous, and YOU HAVE BEEN WARNED!
  47.  
  48. F9, f - Menu:    Brings up a menu of other functions:
  49.                  Change Sort Order: Allows you to sort the directory list by
  50.                                    name, extension, file date and time, or size.
  51.                  Compare Directories: Marks all files which do not appear in
  52.                                       both directories, or the newer version
  53.                                       of files which are in both directories.
  54.                  Find File:  Searches the disk for files matching a given
  55.                              pattern.
  56.                  About:  Shows author and copyright info about FC.
  57.  
  58. F10, q - Quit:   Immediately terminates FC.
  59.  
  60. Other commands, not on the menu, are:
  61. /:               Search for a file.  This scans the current list for the first 
  62.                  file or directory name most closely matching the string you 
  63.                  enter at the '/' prompt (which appears under the list windows)
  64.                  
  65. !:               Execute a command in the current directory.  This allows you
  66.                  to type in a command line to execute (at the '!' prompt).  The
  67.                  command is executed in the current session, so you cannot 
  68.                  launch a PM program.  Any '@' character in the command line
  69.                  is replaced with the full path of the current file.  A '^' 
  70.                  character is replaced with the names (but not paths) of all
  71.                  files which are marked in the current directory.  So, for 
  72.                  example, you could mark a bunch of files and then type:
  73.                     !pkzip files.zip ^
  74.                  to archive all the marked files.
  75.  
  76.  
  77. The TOOLS.INI file
  78.   For those unfamiliar with Microsoft products, many are configured using
  79. ASCII text configuration files, one of which is called TOOLS.INI.  This 
  80. file is located in the directory pointed to by the INIT environment variable.
  81.   The TOOLS.INI file is divided into sections, delimited by "[SECTIONNAME]",
  82. and within each section are placed one or more configuration parameters in the
  83. format "parm = value".  Any text following a ';' is ignored.
  84.   Here is an example section from a TOOLS.INI file for FC, along with
  85. explanations of the various parameters.
  86.  
  87.  
  88. ;-------------------Configuration for FILE COMMANDO------------------------
  89. [FC]
  90.   BorderColor = 31          ; White on Blue
  91.   WindowColor = 31          ; Ditto
  92.   HilightColor = 30         ; Blue on Grey
  93.   SelectedColor = 113       ; Yellow on Blue
  94.   Viewer = d:\bin\l.exe @
  95.   Editor = c:\os2\e.exe @
  96.   Extensions = ZIP ZOO LZH ARC TXT
  97.   TXT = d:\bin\l.exe @
  98.   ZIP = c:\os2\cmd.exe /K "pkunzip -v @"
  99.   ZOO = d:\bin\zoo.exe v @
  100.   LZH = d:\bin\unzip.exe -v @
  101.   ARC = d:\bin\unzip.exe -v @
  102. ;-------------------Configuration for FILE COMMANDO------------------------
  103.  
  104.   The first four parameters specify screen attributes used by FC.  All video
  105. attributes are defined as bytes as shown below.
  106.   Calculate a color value by taking the desired background color in the high
  107. nibble and the foreground color in the low nibble and computing the decimal
  108. equivalent.  For example, Bright Cyan letters on a Red background would
  109. correspond to a Hex value of 0x47, or decimal 71.  The color values are
  110. shown in the chart below.
  111.  
  112.  
  113. +---7----+---6----+---5----+---4----+---3----+---2----+---1----+---0----+
  114. |        | Bkgrd  | Bkgrd  | Bkgrd  |        | Forgrd | Forgrd | Forgrd |
  115. | Blink  | Red    | Green  | Blue   |Intense | Red    | Green  | Blue   |
  116. +--------+--------+--------+--------+--------+--------+--------+--------+
  117.  
  118.  BLACK   0x0    BLUE      0x1    GREEN   0x2    CYAN    0x3
  119.  RED     0x4    MAGENTA   0x5    BROWN   0x6    LTGREY  0x7
  120.  DKGREY  0x8    LTBLUE    0x9    LTGREEN 0xA    LTCYAN  0xB
  121.  LTRED   0xC    LTMAGENTA 0xD    YELLOW  0xE    WHITE   0xF
  122.  
  123.                         Table 1.  Screen color values
  124.  
  125.   The VIEWER and EDITOR parameters specify the programs to be launched by the
  126. VIEW and EDIT commands described above.  The full path of the executable file
  127. must be specified, including the extension (.com or .exe).  The '@' character
  128. in the command will be replaced by the full path specification of the selected
  129. file.
  130.  
  131.   The EXTENSIONS paramter allows you to specify commands to be executed when
  132. you press ENTER on a file list entry.  Each extension specified on the
  133. EXTENSIONS line must have a corresponding parameter listing the command (in
  134. the same format as for the VIEWER above) to be executed for files with that
  135. extension.  This command will be started in a new session, separate from FC.
  136.  
  137.  
  138. Note for modem users.
  139.   Since the cursor movement keys do not usually transfer well through most
  140. terminal programs, the numbers on the IBM keypad corresponding to the
  141. cursor keys will also be accepted for movement in most lists.
  142.  
  143.  
  144.   FC was written by Sean Purcell, and is copyright (c) 1991,1992 by 
  145. Sean Purcell, all rights reserved.  FC is provided as FREEWARE, no 
  146. compensation need be provided for it's use, although a six pack of good beer 
  147. is always welcome. :-)
  148.   FC has been tested with OS/2 version 1.21, 1.3, and 2.0
  149.  
  150. Send questions or comments to the author at: 
  151.         CIS: 73650,372
  152.         Internet: 73650.372@compuserve.com
  153.  
  154. Please let me know if you use this program, whether or not you like it, and
  155. what you would like to see added, enhanced, or changed.
  156.  
  157. Revision History
  158. v1.1 - Internal use, testing
  159. v1.2 - Added string editing, file selection count, sort by size, 
  160.        directory stacking.  First release version.
  161.  
  162. Known Problems:
  163. +  The bounce bar sometimes leaves a ghost behind after a '/' operation.
  164. +  Returning to a higher level directory always puts the directory at the top,
  165.    instead of where it was in the list.  Not a bug, but could be better.
  166. +  Screen colors are not preserved when launching external programs
  167.