home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / 4DOS / 4FILES / 4F.DOC < prev    next >
Text File  |  1993-12-01  |  69KB  |  1,215 lines

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