home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / 4file2s5.arj / 4F.DOC < prev    next >
Encoding:
Text File  |  1992-03-13  |  66.7 KB  |  1,208 lines

  1.                               -------------------
  2.                          =====   4 - F I L E S   =====
  3.                               -------------------
  4.  
  5.                         DOCUMENTATION  --  Version 2S.2
  6.                                  March 7, 1992
  7.  
  8.         -----------------------------------------------------------------
  9.         Shareware by Larry Edwards, Copyright 1990-92 All Rights Reserved
  10.                  REGISTRATION $20   Box 6001   Sitka, Ak   99835
  11.  
  12.                    TECH SUPPORT: (907)-747-8996 (ask for Larry)
  13.                            CompuServ mail to 72037,3607
  14.                             GEnie mail to L.EDWARDS10
  15.                              BIX mail to L.T.Edwards
  16.         _______
  17.    ____|__     |
  18. --|       |    |-------------------   |   ASP wants to make sure the shareware
  19.   |   ____|__  |  Association of      |   principle works for you; its Ombuds-
  20.   |  |       |_|  Shareware           |   man can help resolve any dispute with
  21.   |__|   o   |    Professionals       |   an ASP member on a shareware related
  22. -----|   |   |---------------------   |   problem.  Details on page 3.
  23. (R)  |___|___|       MEMBER
  24.  
  25.  
  26. ================================================================================
  27.  CONTENTS OF MANUAL ...
  28. ========================
  29.  
  30. Overview of 4FILES .. 1    Mouse Use ...... 5-6, 13    EMS & XMS Memory . 13,17
  31.  
  32. About "File Notes"... 2    File & Note Modes .... 7    Video & Screens ..... 14
  33.  
  34. Shareware Notice .... 2    Using File Mode ...... 7    Safety Features ..... 15
  35.  
  36. Quick Start ......... 3    Sorting File Lists ... 8    Hot Tips on 4FILES... 16
  37.  
  38. Special Keys ........ 3    Utility Ports ........ 9    Origin/Evolution .... 18
  39.  
  40. Dir. Tree Navigation  5    Using Note Mode ..... 10    Registration Benefits 19
  41.  
  42. <@-CHAR> File Search  7    Configuring 4FILES .. 12    Agreement for Use ... 19
  43.                            (incl. colors & blink)
  44.                                                        Registration Form ... 21
  45.  
  46. ================================================================================
  47. OVERVIEW OF 4FILES
  48. ==================  4FILES is a multi-purpose file management tool, and
  49. includes a full-featured editor for 4DOS-standard "file notes".  The interface
  50. is clean and convenient, and incorporates what may well be the easiest drive
  51. and directory navigation method you have tried.
  52.  
  53.     4FILES also serves as a well coordinated "front-end" for several of your
  54. favorite utilities, providing rapid-fire, point-and-shoot loading of files into
  55. the utilities.  There is a "utility port" for a file browser, two for editors
  56. or word processsors, three specialized for archive programs or viewers, and
  57. an extra port.  4FILES has a built-in configuration routine, so changes to
  58. these utility ports and other program settings can easily be made on-the-fly.
  59. Changes may be used "session-only" or be saved to a configuration file.
  60.  
  61.                                                                              2.
  62.     The screen shows the current directory with subdirectories at the top
  63. followed by files, each taking a full line.  The list may be sorted any way you
  64. like, both on-the-fly and via command line switches.  Except for sorts by file
  65. name (the default), the key field for the current sort is highlighted on
  66. screen.  Any video mode over 80x25 is supported (see Quick Start on page 3).
  67.  
  68.     File or subdirectory names are displayed on the left half of the screen,
  69. one per line, with full statistics.  The right half is space for descriptive
  70. file notes.  If you are using 4DOS or NDOS (superior COMMAND.COM substitutes),
  71. a file note will remain associated with its file during copy, move and rename
  72. operations.  You may also play with file notes under COMMAND.COM, but the notes
  73. will be lost during the above file operations.  The new 4DOS-4.0 description
  74. "extensions" are detected if present, but no programs are using them yet.
  75.  
  76.       Any program file or batch file may be executed directly from the listing
  77. or be put in an DOS editable command line.  Data files with "executable exten-
  78. sions" may be loaded directly into their applications.  A real DOS command line
  79. (secondary shell) is available too.
  80.  
  81.       International keyboards and character code pages are fully supported.
  82.  
  83.       A printed manual will be available soon.  Version 3.0 is in the works
  84. and will have several new features and improvements to existing features.
  85.  
  86. ================================================================================
  87. ABOUT FILE NOTES & 4DOS
  88. =======================  Ability to annotate your files will revolutionize your
  89. computer use, and this feature alone is _ample_ reason to replace COMMAND.COM
  90. with 4DOS.  But the powers of 4DOS do not end there, and you are really (!)
  91. wasting time and energy if you aren't using it.  It makes the MSDOS command
  92. line EASY and adds many features to MSDOS which should have been included all
  93. along, but aren't even in MSDOS 5.0.  I can't recommend 4DOS highly enough!
  94. It's shareware by JP Software, Box 1470, E. Arlington, Ma 02174, 617-646-3975.
  95.  
  96. ===============================================================================
  97. SHAREWARE NOTICE
  98. ================  4FILES is a commercial, copyrighted program, and is distrib-
  99. uted as shareware.  Shareware is a marketing method which allows you to eval-
  100. uate a fully functional program before deciding whether you want it.  You may
  101. not continue use of 4FILES beyond a period of bona-fide evaluation of not over
  102. 30-days unless the copy you are using has been properly registered for your
  103. use and your use complies with the agreement near the end of this manual.
  104.  
  105.     If you decide *not* to register, your frank critique of 4FILES (or a
  106. trouble report) would be sincerely appreciated.  Use the means most convenient
  107. to you:  collect phone call, E-mail, or a letter.
  108.  
  109.      Your distribution of 4FILES to others is HIGHLY ENCOURAGED, provided that
  110. the distribution complies with the agreement at the end of this manual.
  111. Permission for commercial distribution may be withdrawn at any time for cause.
  112.  
  113.     Larry Edwards is a member of the Association of Shareware Professionals
  114. (ASP).  ASP wants to make sure the shareware principle works for you.  If you
  115. are unable to resolve a shareware-related dispute or problem with an ASP
  116. member, ASP's Ombudsman may be able to help resolve it.  ASP does not however
  117. provide technical support for members' products.  Contact: ASP Ombudsman, 545
  118. Grover Rd, Muskegon, MI 49442 or (via CompuServe Mail) ASP Ombudsman 70007,3536.
  119.  
  120. ============================================================================= 3.
  121. QUICK START:
  122. ===========   Capacity: 470 records per directory.    Requires: 64K and DOS 2+.
  123.               --------                                --------
  124.  
  125.     SYNTAX:       4F [d:][\][subdir] [/+/8] [/D] [/E /S /T /N]
  126.  
  127.     ** Items in brackets are optional.  The current directory is the default.
  128.  
  129.     ** Quitting: <ESC> or <^ESC> = to original dir; <@ESC> = to current dir.
  130.  
  131.     ** Type <@F10> to reconfigure 4FILES.  A wide range of features, including
  132.        colors, can be set here.  Always give an extension for utility configur-
  133.        ations.  A pathspec is not needed if a utility is in the PATH.  If you
  134.        need Blinking enabled for called utilities or after exiting 4FILES, it
  135.        can be forced on here.  Foreign keyboards may require a setting also.
  136.  
  137.     ** REPLACE OLD .CFG FILES:  The configuration file format was changed in
  138.        version 2S.0.  If your .CFG file was written by an earlier version, you
  139.        must delete it and configure the new version from scratch.
  140.  
  141.     ** /D /E /S /T and /N are command line switches for list sorting.  /D may
  142.        be used alone or with any of the other four.  /8 is used to force an
  143.        80x25 display, in case you want to switch automatically, or in case of
  144.        an incompatibility with the video mode detection.  /+ must be used with
  145.        HGC, MDA or CGA if you are displaying MORE than 80x25.
  146.  
  147.     ** 4FILES should either be located in a directory which is in your PATH, or
  148.        be called via an alias (preferably using the full pathspec for speed).
  149.  
  150.     ** OPERATION: Use the menu line for guidance, and go with the flow!  <TAB>
  151.        toggles modes.  Some key strokes will work in both modes, but are shown
  152.        only on the menu of one (limited space on menu line).  Navigate with the
  153.        G+ (Grey-plus), G- and G* keys.  83-key keyboards use <SCL-LK> rather
  154.        than G*.  <F1> displays the above help screen and this manual if 4FILES
  155.        is properly configured.  Many more features are described below.
  156.  
  157.  
  158.                ===================================================
  159.                 D O C U M E N T A T I O N   O F   F E A T U R E S
  160.                ===================================================
  161.  
  162. ===============================================================================
  163. SPECIAL CONTROLS
  164. ================   Most keys act as expected, and the others (below) are laid
  165. out logically.  A special keyboard handler allows nice, normally unavailable
  166. key assignments.  Key symbols:  ^ means the CTRL key, @ means the ALT key.
  167.  
  168.     ("**" means 4FILES must be configured properly for the feature to work.)
  169.      ----------------------------------------------------------------------
  170.     <F1> -- Help. **                 <F2> -- Edit current file. **
  171.     <F3> -- File Finder. **          <F4> -- Unzip current file, if archive. **
  172.     <F5> -- Mark record.             <F6> -- Unmark record.
  173.     <F9> -- Copy selected text.      <F0> -- Paste text (insert).
  174.                                      <^F2> - Second editor or a utility. **
  175.     <^F5> - Mark ALL file records.   <^F6> - Unmark ALL records.
  176.     <^F9> - Cut selected text.
  177.  
  178.     <@F9> - Copy the whole note.     <@F10> - Change 4FILES configuration.
  179.  
  180.                                                                             4.
  181.  
  182.     NOTE:  <G*> is the "grey" star key on the keypad.  <G**> is a double hit of
  183.     ----   this key.  Adjacent keys are <G+> and <G->.
  184.  
  185.     <G*>   -- Change drives.  The change is instantaneous when a drive letter
  186.               is typed.  ON 83-KEY KEYBOARDS, THE <SCL-LCK> KEY SERVES THIS
  187.               FUNCTION; the alternate key choice can be forced by configuration.
  188.  
  189.     <G**>  -- Change drive:directory via a text entry field.  LCD and ACD
  190.               compatible.  On 83-key keyboards, use <SCL-LCK>.
  191.  
  192.     <G***> -- Change back to the previous directory.  Use <SCL-LCK> for 83 keys.
  193.  
  194.     <G->   -- Change to the parent directory (from any record).
  195.  
  196.     <G+>   -- IF RECORD IS:  1) a directory, change to it.
  197.                              2) a file, browse it. **
  198.                              3) an archive, list its constituent files. **
  199.  
  200.     <^G+>  -- Active only for archive files; calls an alternate utility. **
  201.  
  202.     <CR>   -- ENTER may be configured to duplicate <G+> in File Mode only.
  203.  
  204.     <@-F10>  -- Shows the configuration menu.
  205.  
  206.     <TAB>    -- Toggles between FILE MODE and NOTE MODE.
  207.     <NUM-LK> -- Toggles between showing file attributes and file time.
  208.  
  209.     <@-Char> -- Fast scroll to next record starting with the character.
  210.                 <SCL-LK> or <Keypad-5>, depending on KB BIOS, changes direction.
  211.  
  212.  NOTE MODE COMMANDS:
  213.  -------------------
  214.     ^H          -- Destructive backspace.
  215.     ^Y          -- DELETE NOTE.
  216.  
  217.     <Ctrl-PgUp> -- Go to TOP of directory listing.
  218.     <Ctrl-PgDn> --  "  " END  "     "        "
  219.  
  220.     <Ctrl-Up>   -- Go to TOP of page.
  221.     <Ctrl_Dn>   --  "  " END  "   "
  222.  
  223.     <Sh-Up>     -- Scroll display to show record ABOVE TOP of page.
  224.     <Sh-Dn>     --    "      "     "   "    "    BELOW END  "   "
  225.     <Ctrl-Lf>   -- Shift cursor ONE WORD LEFT.
  226.     <Ctrl-Rt>   --   "      "   ONE WORD RIGHT.
  227.  
  228.     <Sh-Rt>     -- 1) Bump any text to the right of the cursor to right margin.
  229.                    2) If no text to the right, enter Flush-Right (FLR) mode.
  230.     <Sh-Lf>     -- Exit FLR mode (or use <ESC>, <CR> or any bar movement keys).
  231.     <Sh-BS>     -- Destructive "Fore-space", available in FLR mode only.
  232.  
  233.     <ESC>       -- Like <^ESC>. Can be disabled with a configuration switch.
  234.  
  235.     <^ESC> or <@ESC> -- Quit to original or current directory, respectively.
  236.                         (If you use NEWKEY, see page 10.)
  237.  
  238.                                                                             5.
  239.  
  240.  FILE MODE COMMANDS:
  241.  ------------------
  242.     <^E> or <^E><^E> -- Presents a DOS command line with or without the current
  243.                  file name.  (See also "configuration".)  Appending "++" to a
  244.                  command freezes the screen temporarily after execution.
  245.  
  246.     <^X>      -- Instantly executes records which are .COM, .EXE, .BAT or .BTM
  247.                  files; also acts on data files with "executable extensions".
  248.  
  249.     F5 /  F6  -- Mark / Unmark A record.
  250.    ^F5 / ^F6  -- Mark / Unmark ALL records.
  251.  
  252.     A / ^A    -- Change attributes of current file or all marked files.
  253.     C         -- Copy file.
  254.     D / ^D    -- Delete current file or all marked files.
  255.     M         -- Move file.
  256.     R         -- Rename a file or directory.  ACD compatible; LCD not updated.
  257.  
  258.     N         -- Create a "New" Directory.  LCD/ACD compatible.
  259.     K         -- "Kill" (remove) the highlighted directory.  LCD/ACD compatible.
  260.  
  261.     S         -- Sort the list with a new type or order of sorting; menu driven.
  262.  
  263.     -----------------------------------------------------------------------
  264.     The Copy, Move, Rename functions are VERY rudimentary, and will be top
  265.     notch in V-3.0.  Internal PKZip and Unzip support will also be included.
  266.  
  267. ================================================================================
  268.  DRIVE & DIRECTORY NAVIGATION
  269. ============================   4FILES has perhaps the most natural key mapping
  270. yet devised for drive and directory navigation.  It employs a group of three
  271. keys operated by your right hand in coordination with the cursor pad keys,
  272. leaving your left hand free for other tasks.  A keyboard with lefthand function
  273. keys will accentuate the efficiency of this layout, and Northgate or Focus key-
  274. board with this layout would be an excellent investment.  Note that on laptop
  275. computers the lack of a separate cursor pad and left function keys negates the
  276. advantage of the right-hand grouping.  The functions of <G+> and <G-> are also
  277. available via mouse buttons.  These are the keyboard and mouse layouts:
  278.  
  279.     KEYS HIT:  |  83 Keys Action           84+ Keys Action        NOTE
  280.     =========  |  ====================     ===================    =============
  281.     <Grey*>    |  (Use <SCL-LK> key) ----> Fast drive change      (Input field)
  282.                |
  283.     <Grey**>   |  (Use <SCL-LK> key) ----> Enter new drive:dir    (Input field)
  284.                |
  285.     <Grey***>  |  (Use <SCL-LK> key) ----> CD to previous dr:dir  (Instant CD)
  286.                |
  287.     <Grey->    |  CD to parent dir         CD to parent dir       (Instant)
  288.                |
  289.     <Grey+>    |  CD to highlighted dir    CD to highlighted dir  (Instant)
  290.                |  or browse if a file.     or browse if a file.
  291.  
  292.     MOUSE BUTTONS: |  L--    M--    R--     L-R     LM-      -MR      LMR
  293.     ===============|========================================================
  294.     3 Button Mouse | <G+>   <G->   <ESC>   <TAB>   <PgUp>   <PgDn>   <F9>
  295.                    |
  296.     2 Button Mouse | <G+>          <ESC>   <G->
  297.  
  298.                                                                             6.
  299.  
  300.    4FILES will automatically detect both the type of mouse and the type of
  301. keyboard BIOS in your computer, but the layout of your keyboard can only be
  302. assumed (based on the BIOS).  If the assumption is incorrect, you may force its
  303. reversal via the configuration menu.  WHAT YOU WANT IS THREE KEYS ADJACENT TO
  304. ONE ANOTHER.  On the 83-key keyboard they should be in a vertical sequence of
  305. <SCRL-LK>, <G-> and <G+>.  On other keyboards they should form a dog-leg at the
  306. upper left corner of the keypad, using <G*> instead of <SCRL-LK>.  Proper
  307. arrangement is essential to maximize your working efficiency.
  308.  
  309.     After hitting <G*> or <Scrl-Lck> you will be prompted to enter a drive
  310. letter.  A valid entry will cause an immediate change to the drive.  A double
  311. hit on <G*>, rather than a drive letter, presents an input field for specifying
  312. the new directory and/or drive.  This <G**> command is compatible with LCD and
  313. ACD (directory changing utilities) if 4FILES has been configured for it,
  314. allowing you to type only part of the path name.  4FILES will update the
  315. database when directories are created or removed.  The database is updated
  316. during directory renaming only if ACD is used.  <G***> makes an immediate
  317. change to the previous directory.
  318.  
  319.    Hitting <G+> while the cursor is on a subdirectory record will cause 4FILES
  320. to change to that subdirectory.  If this is the ".." record, the change will be
  321. to the parent of the current directory.  <G-> will change to the parent direct-
  322. ory from ANY record.
  323.  
  324.    When changing to a parent directory, the cursor will quick-scroll from the
  325. top of the listing down to the record of the subdirectory you just left.  This
  326. is helpful when inspecting a succession of child directories, since you always
  327. return to your last place in the parent, rather than its first record.  The
  328. scrolling action gives a quick impression of your current location in the list.
  329.  
  330.    During a drive change, 4FILES goes to the extra trouble of avoiding the ann-
  331. oyance of the DOS message "Insert Disk for Drive A" overwriting the screen on
  332. systems with only one floppy.  You will be seamlessly given an opportunity to
  333. swap disks without messing up the screen.
  334.  
  335.    FILE FINDER:  Scrolling to files in a directory listing is easy: just hit an
  336. <@-char> key, where "char" is the alpha-numeric first character of the file or
  337. directory name.  You will be delivered to the next occurrence of a record
  338. starting with that character.  <SCL-LK> toggles the search direction at any
  339. time, including in mid-search.  On 83-key keyboards, <Keypad-5> performs this
  340. function instead since <SCL-LK> is used for directory navigation.
  341.  
  342.    If faster cursor bar movement is desired, 4FILES will support rates which
  343. are much faster than "normal".  Faster settings can be made via some keyboard
  344. hardware, or otherwise via keyboard enhancement utilities.
  345.  
  346.  
  347. ===============================================================================
  348. MOUSE USE
  349. =========   See the button map above.  The mouse handler is setup so that no
  350. action is taken until all depressed buttons have been released.  To experiment,
  351. for a 'page-down' hold down the right button -- no rush -- and hit the middle
  352. button at your leisure.  Then lift one finger -- again no rush -- and when the
  353. second finger is lifted the action will be taken.
  354.  
  355.                                                                              7.
  356.  
  357.     There is one known mouse incompatibility: to date, all drivers for the
  358. OptiMouse have a bug which renders them incompatible with 4FILES.  Mechanical
  359. mice by the same manufacturer use other drivers, and work fine.
  360.  
  361. ================================================================================
  362. FILE MODE & NOTE MODE
  363. =====================   4FILES starts in FILE MODE, in which the file
  364. management functions are enabled.  <TAB> toggles between File Mode and Note
  365. Mode.  You will notice that the menu changes with the mode, and you will find
  366. that while every command on each menu will work in its mode, some will also
  367. work in the other mode.  There is not a enough space on the single menu line to
  368. list all commands for each mode, but they are logical and you'll catch on.
  369.  
  370.  
  371. ===============================================================================
  372. USING FILE MODE
  373. ===============    The file mode commands functional in this release are:
  374.  
  375.     (C)opy, (M)ove, (R)ename, (D)elete, and (A)ttributes for single files;
  376.  
  377.     (^D)elete  and (^A)ttributes for operation on marked files; and
  378.  
  379.     (N)ew-directory, (K)ill-directory, (^E)xecute-prompt, and e(^X)ecute-now.
  380.  
  381.     Copy, move and rename rely directly on 4DOS resources, and keep the file
  382. notes with their files.  As implemented here, these commands are very rudiment-
  383. ary stop-gaps which shell to DOS.  They will serve until the truly exceptional
  384. implementations planned for Version 3.0 are ready.  Ability to copy and move
  385. marked files will also be included in V-3.0, as well as both zipping and
  386. unzipping for single files or marked multiple files.
  387.  
  388.     ^E presents a DOS command line loaded with the name of the current record,
  389. and the line editor is forced into insert mode.  The cursor controls are
  390. identical to those for the note editor.  ^E^E will provide a blank command line
  391. in which you may enter any command.  Treat this just like the DOS command line.
  392. ^Y will also delete the command line.
  393.  
  394.     The command typed-in is executed, and when it finishes the return to 4FILES
  395. is automatic.  In many situations this is desirable, but in some cases (the DOS
  396. SET command is an example) the information you want to see flashes off the
  397. screen.  To prevent this there are two ways to cause 4FILES to delay clearing
  398. the screen until a key is hit.  One is to set the configuration switch named
  399. "Pause after DOS Command" to YES (NO is the factory default).  The other is to
  400. append ++ to the ^E command line.  ++ is a 4FILES flag, and is not actually
  401. part of the command.  Either <G+> or <Shift=> may be used to generate +.  If
  402. the switch is set to YES, a "--" appendage will force an immediate return.
  403.  
  404.     If you wish to work directly from the DOS prompt for a while, type ^E^E
  405. <CR>.  Executing the blank command line will load a secondary DOS shell, and
  406. you will remain in the shell until you type EXIT to return to 4FILES.  Back in
  407. 4FILES, you will be returned the same drive and directory you were in before.
  408.  
  409.     The command keys to make and remove directories are (N)ew-directory and
  410. (K)ill-directory.  (R)ename works both for subdirectories and files.  If you
  411. use LCD or ACD, (N) and (K) will update the LCD database, but (R) will do so
  412. only with ACD.
  413.  
  414.                                                                              8.
  415.  
  416.     <NUM-LOCK> toggles between displaying file attributes and file creation
  417. time, and is functional in both File and Note Mode.
  418.  
  419.     "A" & "D" are the mnemonic commands to change file attributes and delete
  420. files.  ^A and ^D act on all marked files.  "D" requires a double-tap of
  421. the "Y" key for confirmation.  <F5> & <F6> mark and unmark records for such
  422. block operations.  <^F5> & <^F6> mark and unmark all records.  A count
  423. of marked files and marked bytes is shown on the second line in the "indicator"
  424. color.  Marking may be done in both File & Note Modes.  Marked file operations
  425. automatically pass over subdirectories, and marking of DESCRIPT.ION is blocked.
  426. Note however that UPON EXIT OR DURING THE NEXT DIRECTORY CHANGE, if no file
  427. notes remain, DESCRIPT.ION will be deleted for you automatically.  An empty
  428. DESCRIPT.ION may also be deleted via the "D" single file command.
  429.  
  430.     If plain "A" is hit, an editable image of the current file's actual attrib-
  431. utes is displayed for modification.  If ^A is hit to operate on marked files,
  432. a template rather than an actual image is shown.  In the template, each attrib-
  433. ute letter is initially preceded by a "?" wildcard, indicating that the exist-
  434. ing attribute will be unchanged.  Repeatedly typing an attribute character (R,
  435. A, S or H) will toggle the action on that attribute through a cycle of, for
  436. example, ?R, +R, -R, and back to ?R.  + and - indicate the attribute will be
  437. forced "ON" or "OFF" for each file.
  438.  
  439.     When the <G+> browse key is hit on an .EXE file, 4FILES checks to see if
  440. it is a self-extracting archive in the PKWare, LHARC or LHA format.  If so, FV
  441. or a utility you have substituted for it will be called to list the contents of
  442. the file.  (Some utilities will not read such files.)  This capability will be
  443. added for other self-extracting archives types as I become aware of them.
  444.  
  445.  
  446. ===============================================================================
  447. SORTING THE LIST OF FILES
  448. =========================  While the subdirectory portion of the list is always
  449. alphabetically sorted, the files-portion may be sorted in various ways either
  450. on-the-fly or via command line switches.  The default sort is alphabetical, in
  451. ascending order.  To change the sort on-the-fly, type "S" while in DOS mode.
  452. After making a selection, which may involve making settings for both type of
  453. sort and for ascending or descending order, a second tap on the last key hit
  454. will exit the sort menu and cause the sort to be made.  <CR> will exit also.
  455.  
  456.     The command line sort switches are described below.  /D may be used by
  457. itself or in combination with other switches, and affects only the primary
  458. sort.  These sort specs also apply to on-the-fly settings.  The sorts are:
  459.  
  460.         SWITCH          PRIMARY SORT          SECONDARY SORT
  461.         -------        -----------------     ------------------
  462.         DEFAULT         FILENAME               .EXT
  463.           /E            .EXT                   FILENAME
  464.           /S            File Size              FILENAME.EXT
  465.           /T            File Time/Date         FILENAME.EXT
  466.           /N            File Note              FILENAME.EXT
  467.           /D            (Descending Order)     (Descending Order)
  468.  
  469.     Except when sorting by filename, the primary sort field is highlighted with
  470. a color that is set on the configuration menu.  International code pages are
  471. used for sorting.  For more about sorts, see the section on "tips".
  472.  
  473. ============================================================================ 9.
  474. UTILITY PORTS -- BROWSING, EDITING, UNZIPPING and FINDING FILES
  475. ===============================================================
  476.  
  477. -- BROWSING FILES --
  478.  
  479.       The <G+> key is overloaded in a sensible way.  Not only will it allow
  480.    you to "see" the contents of a subdirectory, if the highlighted record is a
  481.    file, it will call up your favorite file browser or archive viewer with the
  482.    file loaded.  In File Mode <CR> may be configured to duplicate the function
  483.    of <G+>, although this is not recommended unless you really need it.
  484.  
  485.       4FILES comes configured with the internal 4DOS LIST command as the
  486.    browser, but any browser may be substituted.  Shelling to DOS to run this
  487.    internal command is slow, but if you use a browse utility like TV.COM or
  488.    Vern Buerg's LIST.COM, your file will be displayed in a literal eye-blink.
  489.  
  490.       If the record is a .ZIP, .ARC, .DWC, .LBR, .LZH, .PAK or .ZOO archive, an
  491.    archive inspector such as ZR.COM or Buerg's FV.COM will be called.  FV shows
  492.    a table of what's in any of the above archive types, but ZR actually browses
  493.    files inside the archive (only for the .ZIP files, unfortunately).  Both can
  494.    be easily used since an alternate utility port for archives is mapped to
  495.    <^G+>. Packed .EXE files in the PK, LHARC and SFX formats are handled by FV.
  496.  
  497.       While in these and other utilities, the mouse functions "as initialized"
  498.    by 4FILES, and provides scrolling and a quick return via the right button.
  499.    The combination of <left-button>=<G+> and <right-button>=<ESC>, combined
  500.    with movement of the 4FILES cursor bar by the mouse, allows one handed
  501.    "rapid-fire" inspection of multiple files.
  502.  
  503.       In the midst of your rapid firing though, you will sometimes inadvert-
  504.    ently exit from 4FILES (even without the mouse).  To avoid this, you can
  505.    reconfigure to disable quitting via the <ESC> key.  The <^ESC> and <@ESC>
  506.    keys still function, and allow you to quit to the original or current
  507.    directory respectively.  Improper <ESC> use will then display a menu of the
  508.    proper keys.  If you use NEWKEY, to activate the <^ESC> key in 4FILES run
  509.    NEWKEYSP.EXE, pick "I" on the menu, and make any entry for <^ESC>.
  510.  
  511. -- EDITING FILES --
  512.  
  513.       <F2> calls your editor, loading it with the filename of the current
  514.    record.  As supplied, editor access to .COM .EXE .BIN .OBJ .SYS .LIB .WKS &
  515.    .DB extensions and the seven above archive extensions is denied.  The denied
  516.    extensions may be changed via the configuration screen.  Denials protect the
  517.    integrity of non-text files.  A second editor or word processor (or any
  518.    utility, such as a .GIF viewer) may be mapped to the <^F2> key.  The denied
  519.    extensions apply to this key as well.  If a disk is write-protected, the
  520.    editor will not be called and you will be given an error message.
  521.  
  522.       Note that an "R" switch is provided in the configuration listing for each
  523.    utility port.  It forces reloading the current directory upon return from the
  524.    utility, and should be "ON" for any editor or other utility which can change
  525.    file size or directory contents.  "W" (wait before redisplaying) should be
  526.    off, since you will want to return immediately to 4FILES from the editor.
  527.  
  528.       To create a NEW file, hit F2 while on a NON-FILE RECORD.  This will not
  529.    work if the "R" switch is off.  You will be prompted for names for the new
  530.    files, but may hit <CR> on the blank field blank if you wish.  Some editors
  531.    may not be able to utilize more than one filename from the command line.
  532.  
  533.                                                                             10.
  534.  
  535. -- FINDING DUPLICATE FILES --
  536.  
  537.       <F3> is initially set up to call a file finder utility called WHERE.EXE,
  538.    which will be loaded with the file name of the current record.  Bruce
  539.    Gavin's utility FIND.EXE is a good one to use here.  A utility of any type
  540.    may be mapped to this key.
  541.  
  542. -- UNZIPPING FILES --
  543.  
  544.       <F4> is set up to call 4UNZIP, a shareware utility which in turn calls
  545.    PKUNZIP.  A list of the files archived in a .ZIP file is shown, and individ-
  546.    ual files can be marked and extracted from the archive singly or as a group.
  547.  
  548. ================================================================================
  549. UTILITY PORTS IN USE
  550. ====================   One potential difficulty which 4FILES avoids is that
  551. some utilities and editors you might like to call allow you to delete/rename
  552. files or change drives/directories.  When the utility is exited, 4FILES by
  553. default explicitly changes back to its last drive/directory and rereads the
  554. directory list.  The bar is returned to the last record it was on, or if
  555. deleted, to the nearest record number possible.  This process takes a little
  556. longer than assuming that the directory structure is unchanged, and also
  557. destroys the "+/-" note-modified indicators and any file marks, but is SAFE.
  558.  
  559.     Alternatively, you may command 4FILES not to reload the directory by
  560. setting the "R" switch for the port.  Use the "R" switch ONLY if you are
  561. certain that the subject utility is not capable of the operations mentioned
  562. in the previous paragraph.  Note that the switch for the browser will also be
  563. operative when displaying Help with <F1>, since the file browser is used to
  564. display the help screen.
  565.  
  566. ==============================================================================
  567. NOTE MODE -- ANNOTATING FILES
  568. =============================   A file note (or "description" in 4DOS parlance)
  569. may be up to 40-characters long, and each directory with annotated files will
  570. contain a hidden file named DESCRIPT.ION, containing a list of files and their
  571. notes.
  572.  
  573.     With 4DOS-4.0, the specification has been changed to allow extended
  574. descriptions, with each record being up to 4K in size.  Only part of this space
  575. is intended for basic "file notes", but unfortunately the maximum size of that
  576. partition was not specified.  One competing program now uses 80-character file
  577. notes, but this scheme is presently not safe -- under a couple of circumstances
  578. these notes can be truncated or lost entirely.  In fact some 4DOS functions
  579. will truncate basic notes of over 40-characters.  After JP Software sets a
  580. standard for longer basic notes, 4FILES will be modified to support it.  For
  581. now, 4FILES does detect notes of over 40-characters and warn you.
  582.  
  583.     No programs are using the extended (up to 4K) space yet.  4FILES does
  584. detect an extended record though, and will warn you that editing notes in that
  585. directory will cause the extensions to be lost.  When copying, moving, or
  586. renaming the files, 4DOS and 4FILES _will_ move the basic notes and extensions
  587. with them.  A future version of 4FILES will fully support the extensions.
  588.  
  589.                                                                             11.
  590.  
  591.     To put the "*" character in a note, the SHIFT-8 key must be used since
  592. <G*> has a special function.
  593.  
  594.      Great attention has been devoted to making 4FILES a true power tool for
  595. creating or modifying one or a multitude of notes.  These are the features:
  596.  
  597.     -- CUT & PASTE & LINE DELETE --
  598.        -------------------------
  599.        <F9> initiates the text-copying mode.  Highlight the desired text by
  600.        moving the cursor horizontally, and then hit <CR> to put it in the
  601.        paste buffer.  <^F9> cuts the text to the buffer, and <@F9> copies the
  602.        whole note.
  603.  
  604.        <F10> pastes text in the buffer at the cursor position.  If a PASTE
  605.        causes an overflow of the 40-character note space, the note is moved to
  606.        an 80-character space at the bottom of the screen.  This expanded field
  607.        is fully editable (see following).  Captured text stays in the buffer
  608.        when changing drives or directories.  <F10> is inactive in FLR mode.
  609.  
  610.        ^Y deletes the entire line.  In earlier versions it cut the line to the
  611.        cut-buffer, but now the buffer is loaded only via the various <F9> keys.
  612.        ^Y is functional in notes and all text input fields and command lines.
  613.  
  614.     -- EXPANDED EDIT FIELD --
  615.        -------------------
  616.        Expanded Field Mode is triggered whenever typing or pasting causes the
  617.        length of the current note to exceed 40 characters, and allows editing
  618.        over a full 80-character field.  The note is moved to a highlighted 80-
  619.        character field at the bottom of the screen and the 40-character field
  620.        is blotted out.  Two "eyebrows" of contrasting "blot" characters, each
  621.        40-characters long, are placed above this field, and act as a guide for
  622.        where the over-long note will be truncated when <CR> or <ESC> is hit.
  623.        The effect of the blotted out 40-character field, eyebrows, and high-
  624.        lighted bottom row is to draw your eyes down to the expanded field.
  625.  
  626.        To return to the 40-character field, hit <ESC> or <CR>.  <ESC> will
  627.        return to the current record and <CR> moves the cursor to the next
  628.        record.  In both cases the note is truncated after the 40th character.
  629.  
  630.        4FILES will not accept more than 80 characters under any circumstances,
  631.        and will block pasting or typing which would exceed that size.  A 40-
  632.        character long cut string can be pasted into a full 40-character note.
  633.  
  634.     -- FLUSH RIGHT (FLR) MODE --
  635.        ----------------------
  636.        To create notes which are easy to scan by eye, it is sometimes useful to
  637.        make part of a note left justified and part of it right justified.  Hit-
  638.        ting <Sh-Rt-Arrow> provides right justified text in either of two ways:
  639.  
  640.        1. If there is text to the right of the cursor, it is bumped over to the
  641.        right margin.  The cursor is not moved, and 4FILES remains in its
  642.        normal, left justified editing mode.
  643.  
  644.                                                                             12.
  645.  
  646.        2. If there is no text to the right of the cursor, 4FILES enters Flush-
  647.        Right Mode (FLR).  The cursor is moved to the right margin, and
  648.        highlighted indicators are set-up to show the part of the note field
  649.        which is available for FLR text entry.  Text will grow leftward from the
  650.        cursor, which is initially outside the field.  Editing is forced into
  651.        insert mode.  All horizontal cursor movement keys are active.  ^Left &
  652.        ^Right behave slightly different than in normal mode, putting the cursor
  653.        between words, and Shft-BS is enabled.  Collision of new FLR text with
  654.        any left-justified text is prevented.  Cut and paste are not allowed.
  655.  
  656.        QUITTING FLR MODE -- There are three ways to leave FLR mode, with
  657.        differing effects on the text cursor and the cursor bar.  In all cases,
  658.        the pre-existing insert or overwrite mode will be restored.  The choices:
  659.  
  660.                <ESC>            Leaves the cursor where it is.
  661.                <Sh-Left>        Sends the cursor home.
  662.                <Record-change>  (All vertical cursor keys act normally.)
  663.  
  664.     -- INSERT / OVERWRITE MODES --
  665.        ------------------------
  666.        The INSERT mode default may be changed from the configuration menu.
  667.  
  668.     -- FULL CURSOR CONTROL --
  669.        -------------------
  670.        4FILES has nice cursor control key combinations, several of which are
  671.        not more commonly available in programs because they are available only
  672.        by writing a special keyboard interrupt handler.  The cursor control
  673.        keys are listed above in "Note Mode Commands".
  674.  
  675.  
  676. ================================================================================
  677. INTERNAL CONFIGURATION ROUTINE -- CUSTOMIZING 4FILES
  678. ====================================================
  679.     You can change 4FILES' on-screen appearance, the INSERT/OVERWRITE default,
  680. the characteristics of the "utility ports" used to call your utilities, and a
  681. number of other features.  To bring up the Configuration Screen, hit
  682. <Alt-F10>.  Move between fields with the <TAB> or <CR> key.  The key command
  683. menu on the bottom row is context sensitive, and changes for each section of
  684. the main menu.  Changes may be permanently save in a 4F.CFG configuration file
  685. or be used "session-only" without being saved.  If you have renamed 4FILES,
  686. any .CFG file which is created or saved will have a matching name.
  687.  
  688.     For loading a directory larger than 4FILES' normal 428 record capacity, the
  689. configuration code may be overwritten to increase capacity to 470 records.  A
  690. switch on the configuration menu either allows this to happen automatically
  691. (when needed) or will prompt you to OK an overwrite.  When the code is over-
  692. written, you will not be able to reconfigure until your next 4FILES session.
  693.  
  694.     Data for several "utility ports" is shown at the top of the screen.  The
  695. first field of each line is the "utility field", and is for an alias name,
  696. file name, or complete filespec of a utility or application.  A complete
  697. filespec may speed loading, but is not necessary if the program is in your
  698. PATH.  IN ALL CASES, A FILE EXTENSION MUST BE GIVEN.  Valid extensions include
  699. .BAT, .BTM and .ALS.  ".ALS" must be appended to aliases or internal commands.
  700. It is a flag for 4FILES, and is not included in the actual call.  All commands
  701. without extensions will fail to execute.
  702.  
  703.                                                                             13.
  704.  
  705.     If you wish to swap 4FILES to EMS or XMS memory or a hard disk before
  706. executing a utility or application, SWAPDOS.COM can be used.  Enter SWAPDOS in
  707. the utility field.  The name of the program to be called then goes in the tail
  708. ("T=") field, preceded by any command line switches for SWAPDOS and followed by
  709. any of its own switches.  Another swap program which can be used for this is
  710. SHROOM.  4FILES rather than the utllity is loaded via SHROOM, so SHROOM should
  711. not be placed in a port's configuration.  (With SWAPDOS, swapping only occurs
  712. for the selected utilities, while SHROOM will swap for all utilities.  On the
  713. other hand, SHROOM does fast executions via the DOS EXEC function, while
  714. SWAPDOS makes a slower shell to DOS.)
  715.  
  716.     Errors in calling .COM and .EXE programs from 4FILES (e.g. file not found)
  717. are shown as "configuration incorrect", but execution errors for batch files
  718. and aliases are not trapped.  If execution is a quick flash on the screen,
  719. you need to repeat the operation with a "screen pause" to see what is
  720. happening.  There are two ways to do this; one global and one specific to the
  721. utility.  To pause after execution of any utility, set the "No-pause After
  722. Execution" configuration switch to "Y".  This also affects ^E command line.
  723. To cause a particular utility to pause after execution, set the "W"
  724. (wait) switch to "Y".
  725.  
  726.     <F1> HELP and <^F1> Manual will work only if the <G+> BROWSE key is
  727. configured correctly.
  728.  
  729.     The next field in the utility port block is the command line tail.  This
  730. sends filenames, command line switches or other parameters to the utility. "$F"
  731. inserts the filename of the current record, and may be placed where needed among
  732. the parameters.  No spaces are needed before or after $F, conserving space.
  733.  
  734.     The "W" field is a YES/NO field which determines whether or not 4FILES
  735. waits for a keyhit after the utility has finished executing.  Set it to "Y" for
  736. utilities which run straight through and exit without any user input.
  737.  
  738.    The "R" field is also a YES/NO field which determines whether 4FILES reloads
  739. the directory list and DESCRIPT.ION file after the utility exits.  It must be
  740. set to "Y" if the utility is capable of managing files or changing drives and
  741. directories.  It should for example be "Y" for an editor or word processor.
  742.  
  743. In the next configuration section, switches are provided for the following:
  744.  
  745.    Keyboard Code    -- Two letter DOS keyboard-country-code.  LEAVE THIS BLANK
  746.                        UNLESS YOU HAVE A PROBLEM.  Takes effect next session.
  747.  
  748.    Typing default   -- The INSERT mode default can be changed to OVERTYPE.
  749.  
  750.    Other keyboard   -- Set this to "Y" if 4FILES assumes the non-optimum
  751.                        keyboard layout for your computer.
  752.  
  753.    Disable <ESC>    -- To avoid inadvertent exits with <ESC>, set this to "Y"
  754.                        and exit with <^ESC> or <@ESC>.  If you use NEWKEY, see
  755.                        P.10 for how to make <^ESC> available.
  756.  
  757.    Enable Mouse     -- "N" leaves the mouse set up as-received by 4FILES.
  758.  
  759.    Exit colors      -- Select the previous colors or 4FILES text colors.
  760.  
  761.                                                                             14.
  762.  
  763.    Exit blinking    -- 4FILES disables blinking to allow all color choices.  To
  764.                        restore blinking on exit or during utility calls, set
  765.                        this switch to "Y".
  766.  
  767.    Snow prevention  -- Set to "Y" if your CGA monitor has a snow problem.
  768.  
  769.    Sound on/off     -- The beep is on by default, and may be turned off.
  770.  
  771.    Data Overwriting -- Choses AUTOMATIC data overwrite of configuration code to
  772.                        increase capacity from 428 to 470 records.
  773.  
  774.    Pause after DOS  -- If the result of an (^E)xecute flashes off screen, set
  775.                        this to "Y", or alternatively enter "++" at the end of
  776.                        the command line.  Both await a  keyhit.
  777.  
  778.   Last comes a section for selecting colors or monochrome highlights.  Navigate
  779. this submenu with <TAB>, <G+> and horizontal arrows.  There is separate data for
  780. colors and MGA/HGC highlights; the appropriate set is activated at runtime.
  781.  
  782.   Some color combinations may not work with some "ported utilities".  For
  783. example, if a utility automatically sets up a black on white cursor bar without
  784. clearing the screen to white on black text first, AND if you have 4FILES text
  785. set to black on white, you won't see the cursor bar.   This occurs with 4UNZIP
  786. & VDE.COM.  The only solution is to pick text colors for 4FILES which avoid the
  787. conflict.  Please write to authors of such programs and request a "smarter" set
  788. up of screen attributes in the next version.  Please notify me as well.
  789.  
  790.     On exit from configuration, new and old data are compared, and you are
  791. prompted to save the configuration only if there is a difference.
  792.  
  793.  
  794. ================================================================================
  795. DISPLAY FEATURES
  796. ================   4FILES will work with any video text mode of 80x25 or
  797. higher.  Except for HGC, MDA and CGA video cards, a if a higher mode is
  798. used it will be automatically implemented.  For HGC, MDA and CGA running higher
  799. modes (such as with UltraVision), the /+ command line switch must be used.
  800. The reason is that not all cards in this class are 100% BIOS compatible, in
  801. some cases defeating the automatic detection, and this arrangement assures that
  802. all systems will run "out of the box" in 80x25 mode.  If you are calling 4FILES
  803. from an application running in a higher mode, 80x25 mode may be forced with the
  804. /8 switch.  When calling utilities or shelling to DOS, the screen may have its
  805. best appearance if ANSI.SYS is not installed.
  806.  
  807.     If a CGA video card is detected a no-snow video writing method is used by
  808. default.  A configuration switch is provided to enable faster displaying if
  809. your monitor does not have a snow problem.
  810.  
  811.     "T" and "E" indicators near the top and bottom of the screen indicate that
  812. the top or end of the listing is shown on screen.  Used disk bytes are shown
  813. in File Mode, and the 4FILES version number is shown in Note Mode.  A file
  814. count is displayed at all times.  An "S" indicator with an up arrow symbol
  815. on the top row means the file search direction is upward.  "PROTECTED" and
  816. "ROOT FULL" messages indicate that the full range of file management and note
  817. editing features are not available for the current disk.
  818.  
  819.                                                                             15.
  820.  
  821.     Records with altered notes are flagged with a "+/-" character at mid-line.
  822. A different character is shown for unaltered notes.  A "delta" character next
  823. to a file name indicates that the file is marked for a bulk file management
  824. operation.
  825.  
  826. ===============================================================================
  827. SAFETY FEATURES
  828. ===============
  829.  
  830. -- DISK OVERFLOW PREVENTION --
  831.    ------------------------
  832.        In DOS, a file write which exceeds disk capacity will truncate the file,
  833.     usually with no outward indication of a problem, at least until later.  Any
  834.     automatic protection against such data loss must be provided by the program
  835.     itself, and 4FILES has an excellent overflow prevention system. No
  836.     competing program I have tried checks for disk overflow; some will truncate
  837.     files to the length written to disk at time of overflow, and some will
  838.     truncate them to zero length.  Some give absolutely no warning, and the
  839.     others warn AFTER the damage has already been done.
  840.  
  841.         Whenever you change records or directories, 4FILES checks for an over-
  842.     flow condition.  If your edits exceed disk capacity, you are immediately
  843.     alerted with a message giving the number of excess bytes.  At this point
  844.     the note file is still in memory, and operations which would cause a file
  845.     write are blocked.  These include drive or directory changes, calling
  846.     browse or edit utilities, and quitting.  Meanwhile, you have FULL editing
  847.     freedom, even text insertion and pasting(!).
  848.  
  849.        The overflow bytes message is updated on each record change, and the
  850.     tally can run up as high as necessary.  When the message fails to appear,
  851.     the notes will fit on disk, and blocked-off functions have been re-enabled.
  852.     Entirely deleting a note deducts more than the note size from the overflow;
  853.     the length of the "filename.ext" plus three delimiter bytes are also nixed.
  854.  
  855.        If you delete a file (as opposed to just its note) or subdirectory with
  856.     the "D" or "K" commands, the space freed up from the record and its note
  857.     will be properly accounted for.  Changes during ^E operations are accounted
  858.     for also since the directory is reread afterward.
  859.  
  860.        4FILES pinpoints available disk space down to the last byte.  In one
  861.     unusual circumstance the overflow detection behavior may seem strange,
  862.     although it is still working correctly.  Writing a new file requires at
  863.     least one cluster of disk space (1024, 2048, or 4096 bytes, depending on
  864.     the drive).  Writing the first note in a subdirectory requires one cluster
  865.     of available space, but if the disk is already full, doing so will cause an
  866.     overflow condition.  You might try going to another subdirectory with notes
  867.     and deleting a few notes, but this problem will not work.  You may appear
  868.     to free up enough bytes, but unless this also frees up a cluster 4FILES
  869.     will still indicate an overflow since one does in fact exist.
  870.  
  871. -- READ ONLY "TRAP" AVOIDED --
  872.    ------------------------
  873.        4DOS and 4FILES can move and edit notes only if the "attribute" of the
  874.     DESCRIPT.ION file allows a file write.  Unfortunately, the "READ-ONLY"
  875.     attribute can be inadvertently set by some utilities, especially those
  876.     which can operate on blocks of files (such as XTREE Pro).  When loading a
  877.     directory, 4FILES checks ahead for the READ-ONLY attribute, and will prompt
  878.  
  879.                                                                             16.
  880.  
  881.     you to clear it.  Competing programs aren't so nice.  They let you edit
  882.     notes and *appear* to save your notes to disk -- but ... uh, uh, surprise!
  883.     Your work is gone.  4FILES won't let you waste effort making edits which
  884.     can't be saved, nor will it lose them under any circumstances.
  885.  
  886.        If you say "NO" to clearing the attribute during a directory change, you
  887.     will be returned to the old directory.  During 4FILES startup, picking "NO"
  888.     will terminate the program. "YES" clears the bit, and operations are normal.
  889.  
  890.        NEVER intentionally mark a DESCRIPT.ION file "READ-ONLY" for any reason.
  891.     4FILES catches the error, but versions of 4DOS issued so far don't check
  892.     for it.  The result is that a file moved or copied TO the affected
  893.     directory will lose its note.  A renamed file would also lose its note.
  894.  
  895.        4FILES also will not allow you to use the A or ^A commands to
  896.     change the attributes of DESCRIPT.ION, nor will it allow you to copy or
  897.     rename it.  It may be deleted only if all notes have been erased.  Such
  898.     protections are essential to the safety of the description system.
  899.  
  900. -- TIMELY INACCESSIBLE-DISK DETECTION --
  901.    ----------------------------------
  902.        Files on a write protected disk cannot be altered, or if the root
  903.     directory is full files can't be added to it.  During 4FILES startup and
  904.     all drive or directory changes an immediate check is made to see if one
  905.     of those conditions exists.  If so, you will be alerted with a prominent
  906.     "PROTECTED" or "ROOT FULL" message.  As appropriate, certain 4FILES
  907.     functions are disabled, and you will get an error message if you try to use
  908.     them.  For example, in a full root you will not be able to edit notes
  909.     unless the DESCRIPT.ION file already exists.  You can view files on a
  910.     protected disk, but file management and note editing is impossible.
  911.     No wasted time writing notes you can't save!!
  912.  
  913. -- INTERNAL CRITICAL ERROR HANDLER --
  914.    ------------------------------
  915.        DOS handles some simple, common problems as critical errors, and can
  916.     disrupt execution of a program.  These problems include leaving a drive
  917.     door open or calling a drive with no disk inserted.  4FILES has its own
  918.     INT24 handler to treat such problems seamlessly.  It also goes to extra
  919.     effort to handle use of drives A and B in single floppy systems seamlessly.
  920.  
  921.  
  922. ================================================================================
  923.  4FILES TIPS
  924. ===========  Here are some ideas for making the most of 4FILES in everyday use.
  925.  
  926.   1)  TEAMWORK WITH LARGE APPLICATIONS:  4FILES is a real time saver when used
  927.       in conjunction with some application programs.  For example, you can
  928.       write a 4DOS alias which loads 4FILES whenever you exit your communica-
  929.       tions program.  Using Procom as an example, if you create this alias:
  930.  
  931.               ALIAS COM = C:\COM\PROCOM ^ 4FILES C:\COM\DOWN /T/D
  932.  
  933.       the command "COM" will cause 4FILES to be load when Procom exits.  Your
  934.       download directory will be shown sorted in reverse order by file creation
  935.       time, placing new files at the top.  Using /E/D would puts .ZIPS there.
  936.  
  937.                                                                             17.
  938.  
  939.       Then, using <G+> you may view the contents of a new text or .ZIP file.
  940.       To unzip a file, type F4 to call PKUNZIP or 4UNZIP.  For added flexibil-
  941.       ity in unzipping, you can use the ^E command line.  For example, I
  942.       often send PKUNZIP output to an empty directory, so inconsistently named
  943.       files in the archive don't get lost in a lenghy directory, and so READ.ME
  944.       files don't get overwritten inadvertently.   I maintain several
  945.       directories for this purpose, named \DUMP1, \DUMP2, etc.  To get to one
  946.       of these directories quickly after unzipping, type <G*><G*>, then the
  947.       directory name, or move through your directory tree with <G-> & <G+>.
  948.  
  949.   2)  MORE ROOM FOR BIG APPLICATIONS:  To make more room for big applications,
  950.       you can use SHROOM or SWAPDOS.  SHROOM will swap 4FILES to disk, and
  951.       SWAPDOS will swap it to EMS or XMS memory or to disk.  SHROOM may be
  952.       faster for you since 4FILES is a small swap and the following execution
  953.       is made via the DOS EXEC function.  SWAPDOS shells to DOS to execute the
  954.       program, and this takes considerable time.  The freed-up memory may make
  955.       the difference between you application running or not running.
  956.  
  957.   3)  MULTIPLE 4FILES CONFIGURATIONS: You can write a variety of aliases to
  958.       quickly load 4FILES in specialized, frequently used configurations.  An
  959.       alias called 4FE might call 4FILES with the /E switch set.  Another
  960.       called 4FT, might make the call 4FILES C:\WP\TEXT.  In such aliases,
  961.       giving the full pathspec to 4FILES may speed loading, or you may want to
  962.       have the directory containing 4FILES listed early in your PATH statement.
  963.  
  964.   4)  To speed your return after shelling to DOS, use this alias: ALIAS E EXIT.
  965.       Then "E <CR>" gets you back to into 4FILES (or any other program you
  966.       have shelled out of) without fuss.
  967.  
  968.   5)  Remember the "double tap" keys: ^E^E, G*G*, and the double strokes in the
  969.       Sort menu.  Also G*G*G* to return to the previous directory.
  970.  
  971.   6)  FREEZING THE SCREEN (A): With the ^E command or when using a utility port
  972.       with a batch file or alias, a message might flash off screen too fast to
  973.       read, or it might appear that nothing happens at all.  Appending a "++"
  974.       to the command will freeze the screen after execution until a key is hit,
  975.       allowing you to see what happened.  Also, 4FILES can be configured to
  976.       pause after every execution.
  977.  
  978.   7)  FREEZING THE SCREEN (B): Some utilities you may like to use will scroll
  979.       several pages right off the screen.  The solution is to call an alias,
  980.       as in these examples calling Borland's TDUMP.  They are most conveniently
  981.       placed in an alias file, but can be entered on the command line if the
  982.       alias expansion is enclosed in single quotes (once entered they are in
  983.       memory, ready for use).  "=" is not needed from the command line.
  984.  
  985.                ALIAS  HEX=C:\PROG\TDUMP.EXE %1 -h | MORE
  986.             or
  987.                ALIAS  HEX=C:\PROG\TDUMP.EXE %1 -h | C:\UTIL\LIST.COM /S
  988.  
  989.       The first example uses an MSDOS resource which pauses at the end of each
  990.       page.  The later pipes output into Vern Buerg's LIST program, which
  991.       allows back and forth scrolling through the output.  To put this to heavy
  992.       use, map "HEX.ALS" to the 4FILES F3 key.  This is just an example; it is
  993.       really more efficient to use LIST.COM's ability to do a hex dump directly
  994.       by configuring <G+> or <F3> to call it with $F/h in the command tail.
  995.  
  996.                                                                             18.
  997.  
  998.   8)  OPTIMUM KEYBOARD: We all get set in our ways so it may take some adjust-
  999.       ment, but if your function keys are across the top, a change to a board
  1000.       with them on the left will really speed up your work and make it more
  1001.       accurate, in all programs.  In 4FILES, the close proximity of these keys
  1002.       to <ESC>, <TAB>, <CTRL> and <ALT> is very handy.  This is especially
  1003.       useful when marking/unmarking all files with ^F5 and ^F6.  My own upgrade
  1004.       to such a keyboard was very rewarding.
  1005.  
  1006.   9)  FAST CHANGE TO ROOT DIRECTORY:  ON 101-key keyboards, you can make a
  1007.       quick, one-handed change to the root directory since 4DOS will recognize
  1008.       either "\" or "/" during a directory change.  There is a "/" key next to
  1009.       <G*>.  So ... just hit:  <G*> <G*> / <CR> and you're there.  Of course,
  1010.       repeated hits on <G-> will be faster if you aren't too many levels down.
  1011.  
  1012.  10)  COLOR SUGGESTION FOR COLOR MONITORS:  As supplied, 4FILES displays
  1013.       black/grey/white tones which should work well on any color monitor.
  1014.       After much playing around over the months, I have come up with color
  1015.       schemes which I feel are very easy on the eyes as well as functional.  In
  1016.       particular, they gives a good balance between the color of the cursor bar
  1017.       and the colors of both normal text and sorted fields.  One relies on a
  1018.       dark grey background, the other black.
  1019.  
  1020.                              COLOR SET #1               COLOR SET #2
  1021.                       -------------------------    -----------------------
  1022.       FIELD         || BACKGROUND   CHARACTER   || BACKGROUND   CHARACTER
  1023.       ------------- || ----------   ----------- || ----------   ----------
  1024.       NORMAL TEXT   || Dark  Grey   Dark Green  || Black        Dark Cyan
  1025.       SORTED FIELD  || Dark  Grey   Light Yell  || Black        Light Yell
  1026.       CURSOR BAR    || Light Grey   Black       || Light Grey   Black
  1027.       CUT HI-LIGHT  || Dark  Red    Black       || Dark  Grey   Light Red
  1028.       FUNCTION KEY  || Dark  Grey   Light Grey  || Light Grey   Black
  1029.       MENU TEXT     || Dark  Grey   Dark  Cyan  || Black        Rust
  1030.       INDICATORS    || Dark  Red    Light White || Dark  Red    Light Grey
  1031.  
  1032.  
  1033. ===============================================================================
  1034.  4FILES ... ORIGIN & FUTURE EVOLUTION
  1035. ======================================
  1036.     4FILES is coded entirely in assembly language for high speed and small
  1037. size, and the work involved has been considerable (and the job isn't done).
  1038. The concept arose from the lack in 4DOS of two things.  First, 4DOS has no good
  1039. means to create or edit the file notes it otherwise handles so well.  The 4DOS
  1040. internal note editor is basic and frustrating to use.
  1041.  
  1042.     Second, while 4DOS has its own internal transfer commands (COPY, MOVE and
  1043. RENAME) which automatically assure that notes stay with their files, it does
  1044. not have a good way to perform these operations on marked groups of files.
  1045. 4DOS unaware utilities capable of block operations (such as XTREE-PRO) are
  1046. unsatisfactory since they are oblivious to file notes and will trash them.
  1047.  
  1048.     4FILES has many file management features, but does not yet include
  1049. functions for copying, moving or renaming marked groups of files.  This is
  1050. coming though!  Even for single files, the present implementations of Copy,
  1051. Move and Rename are very rudimentary, but V-3.0 will have ones which are truly
  1052. exceptional.  V-3.0 will also have nice internal facilities to ZIP and UNZIP
  1053. files and browse files within ZIP files.  4DOS extended descriptions and longer
  1054. basic file notes will also be supported.
  1055.  
  1056.                                                                             19.
  1057.  
  1058.  
  1059.     ACKNOWLEDGMENTS:  My deepest thanks go out to John Fox, Tom Schulte, Mike
  1060. Bessy, Pierre Jelenc, Ward Yelverton and Mack Tanner, who have all been of
  1061. great help to me in refining 4FILES, finding bugs, or identifying system
  1062. dependent conflicts.
  1063.  
  1064.  
  1065. ===============================================================================
  1066. WHAT YOU GET FOR REGISTRATION:
  1067. ==============================  Registration is $20 and entitles you to:  1)
  1068. Free technical support; 2) A copy of the latest version, with personalized exit
  1069. message, and a free registered copy of V-3.0 by mail immediately upon release.
  1070. Timely notification of releases beyond V-3.0 will be sent; 3) A printed manual
  1071. will be available soon (this is Feb. 1992) for $3.50 with registration, or
  1072. $5.00 later.  I have also been very liberal about providing free incremental
  1073. upgrades as major features are added on the way to what is promised for V-3.0.
  1074.  
  1075.   4FILES has been a very time consuming project because I have gone to great
  1076. pains both to maximize its convenience and power and to assure protection of
  1077. your data.  I regret that V-3.0 is yet not available, but even so the existing
  1078. power and convenience is, I believe, considerable.  Please recognize this
  1079. effort by registering your copy promptly if you put it to useful work, and by
  1080. passing 4FILES on to others who might enjoy it.
  1081.  
  1082.  
  1083. ===============================================================================
  1084.   AGREEMENT -- USE / REGISTRATION / DISTRIBUTION / & LICENSING OF "4FILES"
  1085. ===============================================================================
  1086.  
  1087. 4FILES and its documentation are copyrighted intellectual property which are
  1088. distributed as shareware, and may be used or distributed only in compliance
  1089. with the terms and conditions which follow.  4FILES is neither free nor in the
  1090. public domain.  All rights are reserved by the author.  Use of 4FILES
  1091. constitutes your agreement to the following.
  1092.  
  1093.  USE & REGISTRATION FOR A SINGLE COMPUTER
  1094.  ----------------------------------------
  1095.     Use of 4FILES is free during your evaluation period.  This period ends when
  1096.     you begin to use 4FILES for any useful work which is not incidental to
  1097.     exploring its capabilities, and may not exceed 30-days beyond your acquis-
  1098.     ition date.  When you use 4FILES for the primary purpose of accomplishing
  1099.     useful work, as contrasted to a genuine evaluation, you are obligated to do
  1100.     your "share" of the shareware arrangement by registering your copy
  1101.     promptly.  Registration is $20, and a form is provided in the file
  1102.     4F_REG.TXT and below for your convenience.
  1103.  
  1104.  MULTIPLE USE & SITE LICENSING
  1105.  -----------------------------
  1106.     A site license is required if 4FILES can potentially be used simultan-
  1107.     eously on more than one computer, terminal or workstation in a business,
  1108.     institution, organization, government agency, etc.   To apply for a license,
  1109.     please fill out the registration form in 4F_REG.TXT or below.  A sample
  1110.     site license and rates are contained in the file 4F-SITE.TXT
  1111.  
  1112.                                                                             20.
  1113.  DISTRIBUTION OF 4FILES
  1114.  ----------------------
  1115.     Distribution by any means is ENCOURAGED, provided that:
  1116.  
  1117.     1) The distribution includes all original files (see Packing List, below)
  1118.        in their unaltered forms and with unaltered filenames.  If the package
  1119.        is incomplete its distribution is prohibited; please contact me for a
  1120.        complete package.  It is preferred that the 4FILES be distributed
  1121.        without a configuration file.  A BBS may add a tag file listing it as
  1122.        the source, and disk vendors may add introductory or installation batch
  1123.        files.
  1124.  
  1125.     2) A distribution fee does not exceed $8 if 4FILES is distributed alone or
  1126.        $12 if it is packed on a disk with other programs (in 1991 dollars),
  1127.        UNLESS another figure has been approved in writing.  Commercial vendors
  1128.        who are not ASP members must have written permission to distribute.
  1129.  
  1130.     3) In any vendor catalogs or other publications, it is clear made that this
  1131.        is shareware and that $20 must be paid to Hand-Crafted Software if the
  1132.        program is useful, in addition to the distribution fee (if any).
  1133.     4) 4FILES may not be included or bundled with other goods or services
  1134.        without express written permission of the author.
  1135.  
  1136.   WARRANTY & DISCLAIMER
  1137.   ----------------------
  1138.     Any use of 4FILES constitutes your agreement that it is provided "as-is"
  1139.     with no express or implied warranty (other than 90-days of free
  1140.     technical support) that you assume full responsibility for assuring that it
  1141.     performs acceptably on your system, and that in no event shall Larry
  1142.     Edwards, Hand-Crafted Software or their successors be held liable for any
  1143.     damages arising from use of the program.
  1144.  
  1145.    I HOPE YOU THINK MY SOFT "WARES" ARE TERRIFIC; MUCH EXTRA EFFORT HAS BEEN
  1146.        EXPENDED TO THAT END.  YOUR REGISTRATION WILL BE MUCH APPRECIATED!
  1147.  
  1148. ===============================================================================
  1149. PACKING LIST   (All files except 4F.COM are readable text files.)
  1150. ============
  1151.     4F      .COM   4FILES Program file.
  1152.     4F      .DOC   Full documentation.
  1153.     4F      .HLP   HELP text file.
  1154.     4F      .VER   Version update details and history.
  1155.     4F-READ .ME    Introductory information, and a word on compatibility.
  1156.     4F-REG  .TXT   Registration form.
  1157.     4F-SITE .TXT   Sample site license & rates.
  1158.     4F-VEND .TXT   Info for SYSOPs & disk vendors.
  1159.     FILE_ID .DIZ   Description for BBSs.
  1160.     TV      .COM   Public domain file browser. (May be omitted for distrib.)
  1161.     TV      .DOC   (May be omitted for distribution)
  1162.  
  1163. =========================================================================== 21.
  1164.  
  1165.                            4FILES REGISTRATION FORM
  1166.                            ========================
  1167.  
  1168.                    Larry Edwards // Hand-Crafted Software
  1169.               Box 6001 // Sitka, Ak 99835 USA // (907)-747-8996
  1170.  
  1171.  
  1172. PLEASE PRINT CLEARLY!                              4FILES VERSION #____
  1173. ====================
  1174.  
  1175. Your name: ______________________________________  Position:_________________
  1176.  
  1177. Company: ________________________________________  Phone: (W) ________________
  1178.  
  1179. Street or Box: ____________________________________       (H) ________________
  1180.  
  1181. City/State/Zip: ___________________________________  Country: ________________
  1182.  
  1183. I got 4FILES from (which BBS/vendor/etc):_________________, ____________ Forum
  1184.  
  1185. E-Mail UIDs:  CIS ___________.   Genie ___________.   BIX ____________.
  1186.  
  1187. CHECK ONE:                       INTERNET addr: ______________________________
  1188. ==========
  1189.  
  1190. __  Our (my) operation cannot possibly use more than one copy of 4FILES simult-
  1191.     aneously, and I am registering one copy via the enclosed $20 payment.
  1192.  
  1193. __  Our (my) operation hereby applies for a site license to install 4FILES for
  1194.     use on up to _____ computers, workstations or terminals.  Payment according
  1195.     to the schedule in the file 4F-SITE.TXT is enclosed (call if file is lost).
  1196.  
  1197. Signature: ________________________________________      Date: _______________
  1198.  
  1199. Send upgrade by US Mail on: __ 5.25" disk  __ 3.5" disk.
  1200.  
  1201. CHECK ONE EACH> Using:  __ MSDOS  __ DRDOS   Version ____
  1202.                 With:   __ 4DOS   __ NDOS    Version ____      __ Neither
  1203.  
  1204.                 CPU: __ 8086  __ 8088  __80286  __80386 __80486
  1205.  
  1206. ================================================================
  1207. COMMENTS / PROBLEMS / CHANGES OR ADDITIONS YOU DESIRE IN 4FILES:
  1208. ================================================================