home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / 4DOS / 4FILES2P.ZIP / 4F.DOC < prev    next >
Encoding:
Text File  |  1991-10-26  |  66.5 KB  |  1,186 lines

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