home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 199 / 4F-2MD.ZIP / 4F.DOC < prev    next >
Encoding:
Text File  |  1991-09-25  |  66.3 KB  |  1,184 lines

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