home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 24 DOS / 24-DOS.zip / 4files.zip / 4F.TXT < prev    next >
Text File  |  1995-12-06  |  100KB  |  2,069 lines
  1.                           -------------------
  2.                      =====   4 - F I L E S   =====
  3.                           -------------------
  4.  
  5.                      DOCUMENTATION  -  Version 3.30
  6.  
  7.   --------------------------------------------------------------------
  8.   Shareware by Larry T. Edwards, Copyright 1990-93 All Rights Reserved.
  9.      Hand-Crafted Software   Box 6001   Sitka, Alaska   99835   USA
  10.              CompuServe:72037,3607  INTERNET:edwards@execpc.com
  11.                        907-747-8996   FAX-747-4801
  12.  
  13.  This copy of 4FILES is fully functional "shareware." You may evaluate it
  14.  for free for up to 30 days from your first use. If you continue using it
  15.  beyond that time, you must pay for your copy.  The price is $30 (US) for
  16.  a single installation, and includes a printed manual, the latest version,
  17.  free upgrades, and related public domain utilities (free) and shareware
  18.  (also for evaluation) by others.  Discounted prices are offered for mult-
  19.  iple installations of 4FILES.  To pay for your single or multiple copies,
  20.  see the Order Form included at the end of this manual or in the separate
  21.  file on the disk.  Payment may be made by mail, phone, or CompuServe.
  22.  
  23.  Your copy of 4FILES can be branded as paid-for with a serial number that
  24.  you will be given by phone or e-mail when your order is received.
  25.  Branding will remove both the payment reminder screen and the
  26.  "unregistered" label that appears at log off.  If you order through PsL
  27.  or CompuServe, your serial number will be provided by Hand-Crafted
  28.  Software as soon as your order is forwarded (usually the same day).
  29.  
  30.  TECH SUPPORT: (Available even during your evaluation period.)
  31.  <1> Call or fax the author at the numbers above.
  32.  <2> E-mail: INTERNET:72037.3607@compuserve.com, or CompuServe 72037,3607
  33.  <3> MAS-BBS, 718-444-5089 (8,N,1, 2400-14400).  IMPORTANT: Select the
  34.      Support Area, then the 4FILES Area.  Use message area, plus download
  35.      the latest version and related utilities on your first call.
  36.         _______
  37.    ____|__     |
  38. --|       |    |-------------------  ASP wants to make sure the shareware
  39.   |   ____|__  |  Association of     principle works for you; its Ombuds-
  40.   |  |       |_|  Shareware          man can help resolve any dispute with
  41.   |__|   o   |    Professionals      an ASP member on a shareware related
  42. -----|   |   |---------------------  problem.  Details on page 3.
  43. (R)  |___|___|       MEMBER
  44.  
  45.  
  46.  YOU CAN OBTAIN THE LATEST VERSION FROM THESE SITES:
  47.  
  48.     1) Call MAS-BBS (see above) and look in Directory 1 in the 4FILES area.
  49.     2) On CompuServe: get 4FILES.ZIP from PCUTIL Forum, Library-1.
  50.     3) Via INTERNET: ftp://ftp.coast.net/SimTel/mdos/4dos.
  51.     4) Write/call PsL (a disk vendor -- see numbers on registration form).
  52.     5) or ... mail $4 to Hand-Crafted Software at the above address.
  53.  
  54.  (Pages are formatted for printing 59 lines by 75 columns; 12 Cpi, 6 Lpi)
  55.  
  56. (Page 2.)
  57.  
  58. ===========================================================================
  59.  CONTENTS OF MANUAL ...
  60. =======================   File & Note Modes .. 13   MS-Windows ......... 28
  61.  
  62. Overview of 4FILES .. 3   File Execution ..... 15   OS/2 & DESQview .... 30
  63.  
  64. About 4DOS & NDOS ... 4   File Management . 13-17   Safety Features..... 31
  65.  
  66. Shareware Notice .... 4   Sorting File Lists . 16   Tips on 4FILES use . 32
  67.  
  68. QUICK START ......... 5   Utility Ports ... 17-19   Origin/Evolution ... 35
  69.  
  70. Special Keys ........ 7   Using NOTE MODE .... 20   Agreement for Use .. 35
  71.  
  72. Disk Navigation .. 8,12   Configuration ... 21-26   Benefits of Ordering 35
  73.  
  74. Mouse .. 12,22-24,28-30   EMS & XMS .... 22,24,33   Packing List ....... 37
  75.  
  76. Seeking a file ..... 13   Video & Screens .... 27   Order Form  ........ 38
  77.  
  78. ===========================================================================
  79.  
  80. (Page 3.)
  81.  
  82. AN OVERVIEW OF 4FILES
  83. =====================  4FILES is a multi-purpose file manager that also
  84. includes a full-featured editor for 4DOS & NDOS "file notes" and the
  85. ability to act as a "front-end" for your favorite utilities and applica-
  86. tions programs.  Command keystrokes are simple, to the point, and easy to
  87. remember.  A very efficient method of directory navigation is provided. A
  88. built-in configuration routine makes on-the-fly changes of 4FILES'
  89. settings a simple matter, including changes to the "utility ports" (which
  90. are used to call your utilities and other programs), colors, and many
  91. custom setup choices.  International keyboards and character code pages
  92. are fully supported.  4FILES runs under DOS, Windows, OS/2 and Desqview,
  93. and was recommended by PC-Computing magazine in its 9/94 issue.
  94.  
  95. The 4FILES screen lists contents of the current directory with subdir-
  96. ectories at the top followed by files, each taking a full line.  The list
  97. may be sorted any way you like, either on-the-fly or via command line
  98. switches. Except for sorts by file name (the default), the key field for
  99. the current sort is highlighted on-screen.  All video modes 80x25 or
  100. higher are supported.  For EGA/VGA, the number of rows is easily changed.
  101.  
  102. File and subdirectory names are displayed on the left half of the screen,
  103. one per line, with full statistics.  The right half is space for
  104. descriptive file notes.  If you are using 4DOS or NDOS (superior
  105. COMMAND.COM substitutes), a file note will remain associated with its
  106. file during copy, move and rename operations.  4FILES works fine with
  107. COMMAND.COM too, except that your notes will be lost during the above
  108. file operations.
  109.  
  110. Full file management facilities are provided via mnemonic single-key
  111. commands for use on single files and marked groups of files.  These
  112. include file copy, move, rename, and delete; and directory create, remove,
  113. or rename.  There is also support for ZIP, ARJ, LHA and other types of
  114. file archives.
  115.  
  116. Any program file or batch file may be executed directly from the 4FILES
  117. screen, and any file or directory name can be quickly dropped into an
  118. editable DOS command line.  Also, "executable extensions" are supported,
  119. allowing you to load a data file into its associated application (such as
  120. Word Perfect or dBase) based on its file extension.  You can also drop
  121. back to DOS while leaving 4FILES loaded; your place in 4FILES is saved.
  122.  
  123. There is an internal routine for branding this copy of 4FILES (or later
  124. copies you might obtain from bulletin boards or your vendor) with the
  125. serial number you will be given when you place your order.  When you brand
  126. the program, the payment reminder screen will no longer appear.
  127.  
  128.  
  129. 4FILES-PRO
  130. ==========  4FILES has been joined by an enhanced non-shareware version
  131. called 4FILES-PRO, available as an inexpensiive upgrade when you pay for
  132. your copy of 4FILES.  It has added features allowing it to excell as a
  133. file selector and file manager when called from within other programs.
  134.  
  135. (Page 4.)
  136.  
  137. For example, 4FILES-PRO can replace the built-in file selector/manager
  138. provided with the Multi-Edit text editor.  This allows you to use your
  139. file descriptions when deciding which files to load, and gives you the
  140.  
  141. same familiar file management interface you use from the command line.
  142. With 4FILES-PRO it is easy to select one file to load or mulitiple files
  143. from multiple directories.  A macro in the calling program then loads the
  144. files into windows.  4FILES-PRO comes with a macro for the Multi-Edit
  145. text editor, and includes instructions for making your own macros for
  146. other compatible programs.
  147.  
  148.  
  149. AN ASIDE ABOUT 4DOS & NDOS
  150. ==========================  4FILES is at its best when 4DOS or NDOS is used
  151. instead of COMMAND.COM; however, 4FILES is only one small reason to select
  152. one of these excellent command interpreters.  The ability they provide to
  153. annotate your files will revolutionize your computer use, but their powers
  154. go far beyond that, providing many time and frustration saving features
  155. which are missing in MSDOS.  I cannot recommend these award winning
  156. products highly enough.  4DOS is shareware (NDOS is not), so it will cost
  157. you nothing more than download time or a handling charge to try it.  Since
  158. 4DOS is a very long download, the shareware version is available from Hand-
  159. Crafted Software (maker of 4FILES), along with other shareware and public
  160. domain programs mentioned in this manual (see the Order Form).
  161.  
  162. For brevity, all following references to 4DOS refer to NDOS as well.
  163.  
  164.  
  165. SHAREWARE NOTICE
  166. ================  4FILES is commercial, copyrighted software and is
  167. distributed as shareware.  Shareware is a marketing method that allows you
  168. to evaluate a fully functional program before deciding whether you want to
  169. keep it.  If you decide to keep 4FILES beyond 30-days, you must purchase
  170. it by sending in the Order Form with full payment, or by ordering through
  171. PsL or CompuServe.  You may not continue use of 4FILES beyond the 30-day
  172. period unless the copy you are using has been paid-for and your and your
  173. use complies with the agreement near the end of this manual.
  174.  
  175. If you decide not to order, a frank critique or trouble report would
  176. be sincerely appreciated, via a collect phone call, E-mail, or a letter.
  177.  
  178. Your distribution of 4FILES to others is highly encouraged, provided that
  179. the distribution complies with the agreement at the end of this manual.
  180. Permission for commercial distribution may be withdrawn at any time.
  181.  
  182. The author, Larry T. Edwards, is a member of the Association of Shareware
  183. Professionals (ASP).  ASP wants to make sure the shareware principle works
  184. for you.  If you are unable to resolve a shareware-related dispute or
  185. problem with a member, ASP's Ombudsman may be able to help resolve it.
  186. ASP does not however provide technical support for members' products.  ASP
  187. Ombudsman: 545  Grover Rd, Muskegon, MI USA 49442-9427; FAX=616-788-2765;
  188. CIS Mail=ASP Ombudsman 70007,3536.
  189.  
  190. (Page 5.)
  191.  
  192.  
  193. QUICK START  Capacity: 798 records per directory.
  194. ===========
  195.              Requires: DOS 3.0+ and 46-110K (depending on directory size).
  196.  
  197.    SYNTAX:   4F [d:][\][subdir] [/+ /8 /L /M ] [/D] [/E /S /C /N /U]
  198.  
  199.              Items in brackets are optional.  The current directory is
  200.              loaded by default.
  201.  
  202.              MANY FEATURES WILL NOT WORK UNTIL 4FILES IS CONFIGURED.
  203.              <ALT-F10> BRINGS UP THE CONFIGURATION SCREEN.
  204.  
  205. ** INSTALLATION: If you don't understand these these brief instructions,
  206. see the detailed instructions in the file 4F-INSTL.TXT.  Either copy all
  207. files into a subdirectory listed in your PATH, or write a 4DOS alias to
  208. load 4FILES (it is best to specify the full pathspec to speed loading).
  209. Either method allows you to start 4FILES by typing just its name or alias,
  210. regardless of which drive or directory you are logged onto at any time.
  211.  
  212. Also, you need to create a TEMP environment variable pointing to a
  213. directory or RAMdisk where it OK for programs to store temporary files.
  214. In AUTOEXEC.BAT you can put a statement like:  SET TEMP=d:\ where "d" is a
  215. RAMDISK or hard drive.  A directory may be added if desired.  4FILES
  216. deletes its temporary files when done with them.
  217.  
  218. ** 4FILES may also be installed under Windows, OS/2 or DESQview, and icons
  219. are provided for the first two.  See detailed instructions on pages 25-27.
  220.  
  221.  
  222. ** Symbols used in program menus and this manual:  "@" means the ALT key,
  223.    "^" means the CTRL key, and "$" means the shift key.
  224.  
  225.  
  226. ** Quitting: Under DOS, <@ESC> quits to the current directory, and <ESC> or
  227. <^ESC> quit to the original (startup) directory.  You may disable plain
  228. <ESC> via the configuration menu, and there are advantages to doing so.
  229. Under Windows and OS/2, <Left-Shift-ESC> and <Right-Shift-ESC> terminate
  230. 4FILES, and <@ESC> and <^ESC> have their normal Windows functions.  Under
  231. OS/2, these keys will have their 4FILES functions only when 4FILES is run
  232. full-screen.
  233.  
  234.  
  235. ** Configure 4FILES by typing <@F10>.  Screen colors & blinking, "utility
  236. ports," many options, and branding as paid-for are on this menu.  Your
  237. utilities, especially a browse utility such as LIST or TV, must be
  238. configured here for some 4FILES features (including help) to work.
  239. Providing a pathspec for a utility is unneeded if the utility is in the
  240. PATH, but will give best performance.  An extension MUST be given with
  241. the filename; if the "utility" is a 4DOS alias, use the .ALS extension.
  242.  
  243. (Page 6.)
  244.  
  245.  
  246. ** Laptop computers:  On the Configuration Options screen, select keyboard
  247. type "3".  This will substitute easier-to-use keys for several important
  248. functions.  The normal keys will not even work on some laptops.  See key
  249. mappings in the next section.
  250.  
  251. ** Modify or Replace your Old .CFG File:  At a minimum, you will need
  252. to set the three "At Exit" switches on the Configuration Options menu.
  253. If you are upgrading from a version prior to 2S.0, delete your 4F.CFG
  254. file and do a new configuration.
  255.  
  256.  
  257. ** Switches: /R /E /S /C /N and /U are command line switches for list
  258. sorting (see P.9): respectively, for sorts by Reverse order, Extension,
  259. Size, Chronology, Note characters, and actual DOS order.  Alphabetical
  260. sorting is the default.  /R may be used alone or with any of the other
  261. four.  If you are upgrading, note that the old /D switch is now /R, and /T
  262. is now /C.
  263.  
  264. /8 is used to force an 80x25 display, in case you want to switch
  265. automatically while loading or in case of an incompatibility with the
  266. video mode  detection.  /+ must be used with HGC, MDA or CGA for over
  267. 80x25.
  268.  
  269. The /L (Lock) switch causes NumLock to be restored to "numeric" when
  270. 4FILES exits, and is useful when using 4FILES with CAD and other number
  271. intensive programs.
  272.  
  273. /M causes file marks from a previous session be to used again rather than
  274. be discarded.  Marks are normally retained only for the current session.
  275. This may also be permanently set from the Configuration Options screen.
  276.  
  277. You may automatically run 4FILES with any of the above switches you desire
  278. by calling it via a batch file or 4DOS alias.
  279.  
  280.  
  281. ** Operation: Use the menu line for guidance, and go with the flow!
  282. Mnemonic keys are used for file management functions, and are shown on
  283. the following pages and the help screen.  <TAB> toggles between File & Note
  284. Modes.  Some keys work in both modes, but are shown only on the menu of
  285. one due to line length limits.  Navigate with the <G+> key (Grey-plus),
  286. <G-> and <G*> if you have an AT keyboard.  Other keys will need to be used
  287. for PC and laptop keyboards (see below).  If 4FILES is properly
  288. configured, <F1> shows help and <^F1> shows this manual.  For a tour of a
  289. few features see 4F-INSTL.TXT.
  290.  
  291.  
  292. ** 4FILES may be fully evaluated under COMMAND.COM, except the MOVE command
  293. works only with 4DOS, DRDOS, or MSDOS 6+.  For proper handling of file
  294. notes during file copy, move, rename and delete (either from within 4FILES or
  295. from the DOS command line), your COMSPEC environment variable must specify
  296. 4DOS.COM or NDOS.COM as the secondary (if not also the primary) command
  297. interpreter, instead of COMMAND.COM.  Also, it is important that the
  298. ".COM" extension be included in the COMSPEC listing for any of the above
  299. command interpreters.
  300.  
  301. (Page 7.)
  302.  
  303.  
  304. =========================
  305. DOCUMENTATION OF FEATURES
  306. =========================
  307.  
  308. SPECIAL CONTROLS
  309. ================  Most keys act as expected for text editing, and the
  310. others (below) are laid out logically.
  311.  
  312. NOTE:  Symbols:  ^ is the CTRL key, @ is the ALT key, $ is the shift key.
  313. ----
  314.  
  315. Important Keys
  316. --------------
  317.  
  318.               <@-F10>  -- Shows the configuration menu.
  319.               <TAB>    -- Toggles between FILE MODE and NOTE MODE.
  320.  
  321. Function Keys
  322. -------------
  323.                                 NORMAL
  324.                              ┌────┬────┐
  325.                 Help *       │ F1 │ F2 │  Edit Current File *
  326.                              ├────┼────┤
  327.                 File Finder* │ F3 │ F4 │  Archive utility *
  328.                              ├────┼────┤
  329.                 Mark File    │ F5 │ F6 │  Unmark File
  330.                              ├────┼────┤
  331.          Toggle Time/Attrib  │ F7 │ F8 │  (Utility of your choice)*
  332.                              ├────┼────┤
  333.        Execute Program, or   │ F9 │ F0 │  Paste Text
  334.        Copy Text (note mode) └────┴────┘
  335.  
  336.  
  337.                                 CTRL +
  338.                              ┌────┬────┐
  339.            View this manual* │ F1 │ F2 │  2nd Editor or Word Processor *
  340.                              ├────┼────┤
  341.                              │ F3 │ F4 │
  342.                              ├────┼────┤
  343.            Mark All Files    │ F5 │ F6 │  Unmark All Files
  344.                              ├────┼────┤
  345.           Switch video mode  │ F7 │ F8 │
  346.                              ├────┼────┤
  347.           Cut Selected Text  │ F9 │ F0 │
  348.                              └────┴────┘
  349.  
  350.                                 ALT +
  351.                              ┌────┬────┐
  352.           Copy a Whole Note  │ F9 │ F0 │  Reconfigure 4FILES.
  353.                              └────┴────┘
  354.  
  355.           "*" means 4FILES Utility Ports must be configured properly for
  356.           the feature to work.
  357.  
  358. (Page 8.)
  359.  
  360.  
  361.   NOTE:
  362.  
  363.   1.  As adjuncts to <F5/F6>, <Space> toggles the current file mark and
  364.       <^Space> toggles all marks.  <^/> and <^\> duplicate <^F5> and <^F6>.
  365.  
  366.   2.  ^X duplicates the function of <F9>.
  367.  
  368.  
  369.   Here is the same key mapping shown for the horizontal function key layout:
  370.  
  371.       F1     F2     F3     F4     F5     F6     F7     F8    F9      F0
  372.    ┌──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┐
  373. Nrm│Show  │Editor│ Any  │Unzip │ Mark │UnMark│Show *│ Any  │EXEC/ │Paste │
  374. ---│Help  │#1    │ Util │      │ File │File  │Attrib│ Util │COPY**│Text  │
  375.    ├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
  376. Ctl│Show  │ ***  │      │      │ Mark │Unmark│Video │      │Cut   │      │
  377. ---│Manual│      │      │      │ All  │All   │ Mode │      │Text  │      │
  378.    └──────┼──────┼──────┴──────┴──────┴──────┴──────┴──────┼──────┼──────┤
  379. Alt       │Editor│     * Show file attributes.             │Copy  │CONFIG│
  380. ---       │#2    │    ** F9 = Execute in File-Mode;        │Whole │4FILES│
  381.           └──────┘    ** F9 = Copy-text in Note-Mode.      └──────┴──────┘
  382.                      *** Ctrl-F2, used in 4FILES-PRO (See 21.)
  383.  
  384.  
  385. NAVIGATION KEYS FOR DRIVES, DIRECTORIES & LISTS
  386. -----------------------------------------------
  387.  
  388.  One of 4FILES' strengths is its efficient and flexible mapping of
  389.  system  navigation features to the keyboard.  Three keys control
  390.  drive-changes and several ways of changing directories.  One of the keys
  391.  controls three features through a logical progression of single, double
  392.  or triple taps.  Another key has a dual function -- if the highlighted
  393.  record is a  directory it changes to the directory; if the record is a
  394.  file or archive, its contents are viewed. The mapping and functions are
  395.  simple and easy to remember -- and the keys are handily close to the arrow and
  396.  page keys.
  397.  
  398.  The navigation keymapping depends on the type of keyboard you are using.
  399.  4FILES attempts to choose an AT or PC keyboard for you based on a test
  400.  of the keyboard BIOS, but this is not foolproof and may be overridden
  401.  from the Configuration Options screen.  The laptop keyboard cannot be
  402.  automatically detected, and must always be explicitly selected.  Here are
  403.  the active navigation keys:
  404.  
  405. (Page 9.)
  406.  
  407.           AT KEYBOARD                                  PC KEYBOARD
  408.   ════════════════════════╗             ═════════════════════════════╗
  409.      ────┐ ┌────┐ ┌────┐  ║                           ┌───────────┐  ║
  410.          │ │ G* │ │ G- │  ║                           │ Scl Lock  │  ║
  411.         ─┘ └────┘ └────┘  ║                           └───────────┘  ║
  412.        ──┐ ┌────┐ ┌────┐  ║                           ┌────┐ ┌────┐  ║
  413.          │ │    │ │    │  ║     ("G" means            │    │ │ G- │  ║
  414.        ──┘ └────┘ │ G+ │  ║       grey key.)          └────┘ └────┘  ║
  415.         ─┐ ┌────┐ │    │  ║                           ┌────┐ ┌────┐  ║
  416.          │ │    │ │    │  ║                           │    │ │    │  ║
  417.        ──┘ └────┘ └────┘  ║                           └────┘ │ G+ │  ║
  418.         ─┐ ┌────┐ ┌────┐  ║                           ┌────┐ │    │  ║
  419.                                                       │    │ │    │  ║
  420.                                                       └────┘ └────┘  ║
  421.           (Choose your keyboard on the Config Menu.)
  422.  
  423.                           ┌────┐ ┌────┐┌─────┐   ║
  424.          Laptop Keyboard  │ [  │ │  ] ││     │   ║
  425.                           └────┘ └────┘│     │   ║
  426.                                  ┌─────┘     │   ║
  427.                                  │   Enter   │   ║
  428.                                  └───────────┘   ║
  429.                                                  ║
  430.  
  431. The <Scroll-Lock> and <[> keys have the same function as <G*> depending on
  432. the choice of keyboard type, and will always be referred to as <G*> in
  433. this manual.  Similarly, <]> will be included in all references to <G->
  434. and <Enter> as <G+>.
  435.  
  436. AT KEYBOARDS (KB=1):
  437.  
  438.  <G*>     Drive change via a single key.
  439.  <G**>    Directory change via an input field.
  440.  <G***>   Goto PREVIOUS drive\directory.
  441.  
  442.  <G->     Goto PARENT directory.
  443.  
  444.  <G+>     Goto HIGHLIGHTED directory.  <ENTER> may be configured as a
  445.           substitution in File Mode only.  (On a highlighted FILE, <G+>
  446.           will view the file or archive.)
  447.  
  448.  
  449. PC KEYBOARDS (KB=2):
  450.  
  451.  <Scrl-Lock>                        Drive change via a single key.
  452.  <Scrl-Lock><Scrl-Lock>             Directory change via an input field.
  453.  <Scrl-Lock><Scrl-Lock><Scrl-Lock>  Goto PREVIOUS drive\directory.
  454.  
  455.  <G-> Goto PARENT directory.
  456.  <G+> Goto HIGHLIGHTED directory.  <ENTER> may be configured as a
  457.       substitution in File Mode only.  (On a highlighted FILE, <G+> will
  458.       view the file or archive.)
  459.  
  460. (Page 10.)
  461.  
  462.  
  463. LAPTOP KEYBOARDS (KB=3):
  464.  
  465.  <[>      Drive change via a single key.
  466.  <[[>     Directory change via an input field.
  467.  <[[[>    Goto PREVIOUS drive\directory.
  468.  
  469.  <]>      Goto PARENT directory.
  470.  
  471.  <ENTER>  Goto HIGHLIGHTED directory. <ENTER> may be configured as a
  472.           substitution in File Mode only. (On a highlighted FILE, <G+>
  473.           will view the file or archive.)
  474.  
  475.  <@-Char> -- Fast scroll to next record starting with the character.
  476.              <SCL-LK> or <Keypad-5> changes search direction (the former
  477.              for AT and laptop keyboards, the later for PC keyboards).
  478.  
  479.  
  480. NOTE MODE KEY COMMANDS:
  481. -----------------------
  482.  
  483.   ^H          -- Destructive backspace (see also File Mode).
  484.  
  485.   ^W          -- Write note edits to disk?  Choices given are (S)ave or
  486.                  (A)bandon unsaved edits.  This also works in File Mode.
  487.  
  488.   ^Y          -- DELETE NOTE.
  489.   @^Y         -- Delete tail of note (from cursor to end).
  490.  
  491.   <Ctrl-PgUp> -- Go to TOP of directory listing.
  492.   <Ctrl-PgDn> --  "  " END  "     "        "
  493.  
  494.   <Ctrl-Up>   -- Go to TOP of page.
  495.   <Ctrl_Dn>   --  "  " END  "   "
  496.  
  497.   <Sh-Up>     -- Scroll display to show record ABOVE TOP of page.
  498.   <Sh-Dn>     --    "      "     "   "    "    BELOW END  "   "
  499.   <Ctrl-Lf>   -- Shift cursor ONE WORD LEFT.
  500.   <Ctrl-Rt>   --   "      "   ONE WORD RIGHT.
  501.  
  502.   <Sh-Rt>     -- 1) Bump text to the right of the cursor to right margin.
  503.                  2) If no text to the right, enter Flush-Right (FLR) mode.
  504.   <Sh-Lf>     -- Exit FLR mode (or use <ESC>, <CR> or any bar movements).
  505.   <Sh-BS>     -- Destructive "Fore-space", available in FLR mode only.
  506.  
  507.   <ESC>       -- Like <^ESC>. Can be disabled with a configuration switch.
  508.  
  509.   <^ESC> or <@ESC> -- Quit to original or current directory, respectively,
  510.                       DOS only. (If you use NEWKEY, see page 18.)  Under
  511.                       Windows & OS/2 these keys have their normal meanings.
  512.  
  513.   <Lft-Sh-ESC>    -- Terminate 4FILES, stay in current directory.
  514.   <Rht-Sh-ESC>    -- Terminate 4FILES, go to original directory.
  515.  
  516. (Page 11.)
  517.  
  518.  
  519. FILE MODE KEYCOMMANDS:
  520. ----------------------
  521.  
  522.   <^E> or
  523.   <^E><^E> -- Presents a DOS command line with or without the current
  524.                file name.  Appending "++" to a command freezes the screen
  525.                temporarily after execution, or freezing can be permanently
  526.                set via the Configuration Options screen.  Executing a
  527.                blank command line shells to a secondary "real" DOS session.
  528.  
  529.   <^H>      -- Shell to 4DOS & show the selectable command history window.
  530.                KEYSTACK.COM (a 4DOS TSR) must be loaded before 4FILES.
  531.  
  532.   <^X>      -- Instantly executes records that are .COM, .EXE, .BAT or .BTM
  533.                files; also acts on data files with "executable extensions".
  534.  
  535.   <F7>      -- Toggles between showing file attributes and file time.  The
  536.                works only on non-laptop keyboards; <F7> works on all.
  537.  
  538.  
  539.   FOR FILES
  540.   ---------
  541.   A / ^A  -- Change attributes of current file or all marked files.
  542.   C / ^C  -- Copy current file or all marked files.
  543.   D / ^D  -- Delete current file or all marked files.
  544.   M / ^M  -- Move file or all marked files.
  545.  
  546.   R / ^R  -- Rename current or marked files.  (LCD 4.0B+ & ACD compatible.)
  547.   S       -- Resort the listed files with a new sort type or order.
  548.  
  549.   FOR DIRECTORIES
  550.   ---------------
  551.   N       -- Create a "New" Directory.  LCD/ACD/NCD compatible.
  552.   K       -- "Kill" (remove) highlighted directory. LCD/ACD/NCD compatible.
  553.   R       -- Rename current directory.  Descriptive note, if any, will be
  554.              lost.  (LCD 4.0B+ and ACD compatible.)
  555.   <G**>   -- Change directory.  (See above for KB=2 or 3 substitutions.)
  556.  
  557.  
  558.   FOR DISKS
  559.   ---------
  560.   V       -- Shows volume data, including bytes free and an editable
  561.              Volume Label.
  562.  
  563.  
  564.   FILE MARKING
  565.   ------------
  566.   <F5>  / <F6>   --  Mark and Unmark the CURRENT file.
  567.   <^F5> / <^F6>  --  Mark and Unmark ALL files.
  568.   <^/>  / <^\>   --    "   "    "     "    "
  569.   <Space>        --  Toggle mark on CURRENT file.
  570.   <^Space>       --  Toggle marks on ALL files.
  571.  
  572. (Page 12.)
  573.  
  574.  
  575. ====================================
  576. DRIVE & DIRECTORY NAVIGATION DETAILS
  577. ====================================
  578.  
  579. After hitting <G*> (or one of the substitute keys for other keyboards) you
  580. will be prompted to enter a drive letter. A valid entry will cause an
  581. immediate change to the drive.  A second hit on <G*> (instead of typing a
  582. drive letter) presents an input field for specifying a new directory
  583. and/or drive.  <G***> makes an immediate change to the previous directory.
  584.  
  585. The <G**> command is compatible with LCD, ACD or NCD (directory changing
  586. utilities) if 4FILES has been configured to use one of them, allowing you
  587. to enter fragmentary path names for directory changes.  This REALLY saves
  588. time.  The databases used by these programs are updated by 4FILES when
  589. directories are created, deleted or renamed.
  590.  
  591. Hitting <G+> while the cursor is on a subdirectory record will cause 4FILES
  592. to change to that subdirectory.  If this is the ".." record, the change
  593. will be to the parent of the current directory.  <G-> is preferable
  594. though, since it will change to the parent directory from ANY record.
  595.  
  596. When changing to a parent directory, the cursor will quick-scroll from the
  597. top of the listing down to the record of the subdirectory you just left.
  598. This is helpful when inspecting a succession of child directories, since
  599. you always return to your last place in the parent, rather than its first
  600. record.  The scrolling action gives a quick impression of your current
  601. location in the list.
  602.  
  603.  
  604. MOUSE NAVIGATION & OTHER USES
  605. =============================  The navigation key commands are mirrored
  606. in the mouse commands.  For three button mice you will see that commands
  607. for navigating the listing are also included.  Navigation functions are
  608. denoted here with AT-keyboard key representations.
  609.  
  610.  
  611.    MOUSE BUTTONS: |  L--    M--    R--     L-R     LM-      -MR      LMR
  612.    ===============|========================================================
  613.    3 Button Mouse | <G+>   <G->   <ESC>   <TAB>   <PgUp>   <PgDn>   <F9>
  614.                   |
  615.    2 Button Mouse | <G+>          <ESC>   <G->
  616.  
  617.    NOTE: (1) Mouse type is automatically detected.
  618.          (2) OS/2's Presentation Manager disables the middle mouse button!
  619.          (3) See the Mouse Use section for more information.
  620.  
  621. The mouse handler is setup so that no action is taken until all depressed
  622. buttons have been released.  To experiment, for a 'page-down' hold down
  623. the right button -- no rush -- and hit the middle button at your leisure.
  624. Then lift one finger -- again no rush -- and when the second finger is
  625. lifted the action is taken.
  626.  
  627. (Page 13.)
  628.  
  629. To use the mouse when running under MS-Windows, the mouse driver must be
  630. loaded before loading Windows, otherwise the mouse will not function in
  631. Windows DOS sessions.
  632.  
  633. The handler remains active in called utilities, giving mouse capability
  634. to utilities which have none.  The right-button (<ESC>) will quit the
  635. utility, but the hair-trigger may also terminate 4FILES accidentally.
  636. For this reason, <ESC> may be disabled as a means of terminating 4FILES.
  637.  
  638.  
  639. SEEKING A FILE ON THE LIST
  640. ==========================  To scroll to a file in a directory listing
  641. press <ALT><char>, where "char" is the alpha or numeric first character
  642. of the file or directory name.  You will be delivered to the next
  643. occurrence of a record starting with that character.  On AT and laptop
  644. keyboards <SCL-LK> toggles the search direction at any time, including in
  645. mid-search.  On PC keyboards, <Keypad-5> performs this function instead
  646. since <SCL-LK> is used for directory navigation.
  647.  
  648.  
  649. FILE MODE & NOTE MODE
  650. =====================  The default is for 4FILES to start in FILE MODE,
  651. with the file management functions are enabled.  <TAB> toggles between
  652. File Mode and Note Mode.  The menu changes with the mode, and you will
  653. find that, due to limited length of the menu line, some commands shown on
  654. only one line actually work in both.
  655.  
  656.  
  657. ===============
  658. USING FILE MODE
  659. ===============
  660.  
  661.     The file mode commands are mnemonic keys:
  662.  
  663.     <C>opy, <M>ove, <R>ename, <D>elete, and <A>ttributes for single files.
  664.  
  665.     <^C>opy, <^M>ove, <^R>ename, <^D>elete, <^A>ttributes and <^Z>ip for
  666.     marked files.
  667.  
  668.     <N>ew-directory, <K>ill-directory, <R>ename-directory for directories.
  669.  
  670.     <^E>xecute-field, <^E^E>xecute DOS shell, e<^X>ecute-now, and
  671.     <^H>istory list execution.
  672.  
  673.     <V>olume information.
  674.  
  675. File Management
  676. ---------------
  677. Copy, move and rename rely directly on 4DOS resources, and keep the file
  678. notes with their files.  Any errors (i.e. disk full, etc.) are trapped,
  679. flagged on the 4FILES screen, and stored in the file 0-4F-DOS.ERR.  This
  680. is so named to always be found at or near the top of an alphabetical
  681. directory listing.  Ctrl-L will cause this file to be displayed using your
  682. file browser, and when exiting the display you be prompted whether to
  683.  
  684. (Page 14.)
  685.  
  686. delete the error file.  For disks which are full, write protected or
  687. read-only, 4FILES will store 0-4F-DOS.ERR in your TEMP directory, if one
  688. is specified in your system environment.
  689.  
  690. Under COMMAND.COM (but not under 4DOS), some simple errors such as 'drive
  691. door open' will neither be trapped by 4FILES nor be displayed on-screen by
  692. DOS.  The DOS operation will seem 'stalled,' but typing Ctrl-Break will
  693. correctly break this lock and return you to the 4FILES screen.
  694.  
  695. The Z and ^Z (Zip) commands are for archiving files, and support ARJ and
  696. LHA  archivers as well as PKZIP.  The archiver is selected based on the
  697. extension  given for the target file, and .ZIP is the default if none is
  698. given.  File notes remain associated with their files in ZIP archives,
  699. and this feature will also be added for ARJ files as soon as possible.
  700. To unzip a file with its comments you can port the hareware program 4UNZIP
  701. to the <F4> key.  (4FILES will soon have an internal function to
  702. ompletely replace the need for 4UNZIP, and will be able to provide the
  703. same service for ARJ files.)
  704.  
  705. History lists are maintained separately for target file names for copy,
  706. move, archive (Z/^Z) and rename commands.  A common target-path history
  707. list is maintained for those commands that use a target-path.  The list
  708. capacities are all ten strings.  The input field is initially blank, but
  709. pressing the DownArrow key will display the current filename for editing.
  710. The oldest filename is next in line.  UpArrow accesses (from blank input
  711. fields) the most recent list addition.
  712.  
  713. A and ^A are mnemonic commands to change file attributes.  "A" presents an
  714. editable image of the current file's actual attributes is displayed for
  715. modification.  If some files are marked, ^A shows an attribute template
  716. instead of the actual image. In the template, each attribute letter is
  717. initially preceded by a "?" wildcard, indicating that the existing
  718. attribute will be unchanged.  Repeatedly typing an attribute character (R,
  719. A, S or H) toggles the action on that attribute through a cycle of, for
  720. example, ?R, +R, -R, and back to ?R.  + and - indicate the attribute will
  721. be forced "ON" or "OFF" for each file.
  722.  
  723. Especially with the ^A command it is useful to be able to see the current
  724. attributes for all files at once, but the default is to not display them.
  725.  
  726. The file creation time field may be toggled between showing time and file
  727. attributes via the <F7> key, which functions in both File and Note Modes.
  728. 4FILES may be configured for attribute display as the startup default.
  729.  
  730. "D" deletes the current file, and requires a double-tap of the "Y" key for
  731. confirmation.  This double tap is a safety feature, so that typing a word
  732.  
  733. such as "dynamic" while inadvertently in File Mode will not delete the
  734. current file.  ^D acts on marked files, and uses a simpler confirmation.
  735.  
  736. (Page 15.)
  737.  
  738. Note that for the marked file and archiving operations to work as fast as
  739. possible you should have a temporary directory, named TEMP, set up.
  740.  
  741. The "V" key displays volume information for the current disk, including the
  742. number of free bytes and an editable Volume Label.
  743.  
  744.  
  745. File Execution
  746. --------------
  747. ^E presents a editable DOS command line loaded with the name of the
  748. current record name.  ^E^E provides a blank command line in which you may
  749. enter any command; just like the DOS command line.  ^Y deletes the command.
  750. A history list with a capacity of ten strings is maintained for the ^E
  751. and ^E^E commands.
  752.  
  753. The typed-in command is executed, and when it finishes the return to 4FILES
  754. is automatic.  In many situations this is desirable, but in some cases (the
  755. DOS SET command is an example) the information you want to see flashes off
  756. the screen.  To prevent this there are two ways to cause 4FILES to delay
  757. clearing the screen until a key is hit.  One is to set the configuration
  758. switch named "Pause after ^E" to Yes (NO is the factory default).  The
  759. other is to append ++ to the ^E command line.  ++ is a 4FILES flag, and is
  760. not actually part of the command.  If the switch is set to YES, a "- -"
  761. appendage will force an immediate return after execution.
  762.  
  763. If you wish to work directly from the real DOS prompt for a while, type
  764. ^E^E <CR>.  Executing the blank command line will load a secondary DOS
  765. shell, and you will remain in the shell until you type EXIT to return to
  766. 4FILES (see 4FILES Tip #5, below).  Back in 4FILES, you will be returned
  767. to the same drive:directory you were in before.
  768.  
  769. The ^X or <F9> command will execute the current file immediately with no
  770. prompting.  This works for both executable files and data files for which
  771. you have set up an executable extension.  This command may be forced to
  772. pause after execution with the "Pause after ^X" configuration switch.  An
  773. executable extension may be set up with a statement such as this in your
  774. AUTOEXEC.BAT file:
  775.  
  776.                        SET .DOC=C:\WP\WP.EXE
  777.  
  778. Then, if you press ^X or <F9> on a file with a .DOC extension, 4FILES will
  779. load it into Word Perfect for you.  This will not work with COMMAND.COM.
  780.  
  781.  
  782. Directory Management
  783. --------------------
  784. <N>ew-directory and <K>ill-directory are commands to make and remove
  785. directories.  <R>ename works both for subdirectories and files.  These
  786. commands update ACD, LCD, and NCD databases, if 4FILES is configured to
  787. use one of these utilities.
  788.  
  789. (Page 16.)
  790.  
  791. MARKING FILES
  792. -------------
  793. There are several ways to mark files.  <F5> & <F6> respectively mark and
  794. unmark the current file, and <SPACE> toggles the mark of the current
  795. file.  <^F5> & <^F6> explicitly mark and unmark all records, and <^SPACE>
  796. toggles the marks of all files.  <^/> and <^\> duplicate the <^F5> and
  797. <^F6> keys for Windows compatibility.
  798.  
  799. Marking may be done in both File & Note Modes, and a count of marked files
  800. and bytes marked is shown on the second line in a configurable color.
  801. Marked file operations automatically pass over subdirectories and hidden
  802. files, and marking of DESCRIPT.ION is expressly blocked.  Note however
  803. that during the next directory change or when exiting 4FILES, if no file
  804. notes remain, DESCRIPT.ION will be deleted for you automatically.  A "0"
  805. length DESCRIPT.ION file may be deleted with the "D" single file command.
  806.  
  807. When changing directories or calling a utility, any file marks are saved in
  808. a file named DEMARCAT.ION, kept in the current directory.  When entering or
  809. returning to a directory, if this file is found the marks are restored.
  810. The exception is that if the file was written during a previous 4FILES
  811. session it is instead deleted.  So, within a session all marks remain
  812. until they are unmarked, but they are usually not "sticky" between
  813. sessions.
  814.  
  815. There are two ways to have "sticky" marks, if you wish.  One is via a
  816. Configuration Menu switch.  The other is the /M command line switch.  The
  817. later is particularly useful to reuse marks on the spur of the moment, if
  818. the menu switch is "off."  The marks in the current directory would
  819. otherwise be lost when 4FILES loads, before you have a chance to change
  820. the menu switch.
  821.  
  822.  
  823. SORTING THE LIST OF FILES
  824. -------------------------
  825. While the subdirectory portion of the list is always alphabetically
  826. sorted, the files-portion may be sorted in various ways either on-the-fly
  827. or via command line switches.  The default sort is alphabetical, in
  828. ascending order.  For an on-the-fly change to the order, type S while in
  829. File Mode.  After making a selection, which may involve making settings
  830. for both the type of sort and its ascendancy, a second tap on the last
  831. key hit will exit the sort menu and cause the sort to be made.  <CR> will
  832. exit also.
  833.  
  834.     Sort type and ascendancy may be also be set from the command line, as
  835. shown below.  /D may be used by itself or in combination with other
  836. switches, and affects only the primary sort.
  837.  
  838. (Page 17.)
  839.  
  840.         Cmd Line
  841.         SWITCH          PRIMARY SORT          SECONDARY SORT
  842.         --------       -----------------     ------------------
  843.         DEFAULT    =    FILENAME               .EXT
  844.           /E            .EXT                   FILENAME
  845.           /S            File Size              FILENAME.EXT
  846.           /C            Chronological          FILENAME.EXT
  847.           /N            File Note              FILENAME.EXT
  848.  
  849.           /U            Unsorted, DOS order    --
  850.           /D            Descending Order       Descending Order
  851.  
  852. Except when sorting by filename, the primary sort field is highlighted
  853. with a color that is set on the configuration menu.  For (U)nsorted, the
  854. filename field is highlighted.  International code pages are used for
  855. sorting when appropriate.  The "tips" section has more on sorting.
  856.  
  857.  
  858. =============
  859. UTILITY PORTS    FILE BROWSING, EDITING, UNZIPPING, DUPLICATES, etc.
  860. =============    ---------------------------------------------------
  861.  
  862. Some of 4FILES' most useful functions are performed by automatically
  863. loading programs of your choice with the current file at the stroke of a
  864. key.  "Utility Ports" are the software mechanisms by which you associate
  865.  
  866. your chosen programs with various 4FILES control keys.  They also allow
  867. needed command line information (switches, filenames, etc.) to be fed to
  868. the utility.  These ports may be customized via the Configuration Utility
  869. Ports screen, accessed with the <ALT><F10> key.
  870.  
  871. Several programs are recommended below for use in various ports.  If you
  872. don't have these utilities or equivalents, they may be downloaded free on
  873. your first call to my BBS, which is a subsystem of MAS-BBS in New York
  874. (see page 1 of this manual).  The latest version of 4FILES and a
  875. collection of pertinent utilities are found there in separate directories.
  876. See page 1 for log-on instructions.  Also, I can mail you a full set of
  877. useful shareware and public domain utilities (including 4DOS, which is not
  878. available on the BBS) -- see the Order Form for details.
  879.  
  880.  
  881. BROWSING FILES
  882. --------------
  883. The <G+> key (or its substitute) is overloaded in a sensible way.  Not
  884. only will it allow you to "see" the contents of a subdirectory, if the
  885. highlighted record is a file, it will call up your favorite file browser
  886. or archive viewer to see the file.  In File Mode, <CR> may be configured
  887. to duplicate the function of <G+>, although this is not recommended unless
  888. you really need it.
  889.  
  890. 4FILES comes configured to use 4F-TV.COM as the browser, but any browser
  891. such as Buerg's LIST or the internal 4DOS LIST command can be used.  The
  892. later is an internal command and requires shelling to DOS, a slow process.
  893. The external utilities, however, display a file in a literal eye-blink.
  894.  
  895. (Page 18.)
  896.  
  897. The <G+> and <^G+> commands recognize archive files if they are
  898. self-extracting (.EXE) files or if they have one of these extensions: .ZIP,
  899. .ARC, .DWC, .LBR, .LZH, .PAK or .ZOO.  When an archive is detected an
  900. archive viewer is called.  There are various types of archive browsers
  901. available.  FV.COM shows a simple listing of the contents.  ZR, LR, AR and
  902. ZOR not only show a listing (of ZIP, LHZ, ARJ and ZOO file respectively),
  903. but can view the text of files inside the archive and extract selected
  904. files from the archive.  These four programs can be found on BBSs as
  905. XRAY.ZIP or XRAY???.ZIP.
  906.  
  907. 4F-XRAY.BAT was provided with your copy of 4FILES to allow the most
  908. appropriate one of these five browsers to be called automatically via one
  909. 4FILES utility port.  If you use this batch file, it is best mapped to
  910. the <G+> key, and it is handy to then have FV mapped independently to the
  911. <Ctrl><G+> key.  4FILES comes with a different mapping.
  912.  
  913. While in browsers and other utilities, mouse buttons work "as initialized"
  914. by 4FILES.  The combination of <left-button> = View and <right-button> =
  915. Escape, combined with movement of the 4FILES cursor bar by the mouse,
  916. allows one handed "rapid-fire" inspection of multiple files.  (Note: if
  917. you load 4FILES via SHROOM or call a utility via SWAPDOS, the mouse will
  918. be automatically disabled, temporarily.  This is necessary since the mouse
  919. handler gets overwritten.)
  920.  
  921. In the midst of your rapid firing though, you will sometimes inadvertently
  922. exit from 4FILES (even without the mouse).  To avoid this, you can
  923. reconfigure to disable quitting via the <ESC> key.  The <^ESC> and <@ESC>
  924. keys still function, and allow you to quit to the original or current
  925. directory respectively.  Improper <ESC> use will then display a menu of the
  926. proper keys.  If you use NEWKEY, to enable 4FILES to use the <^ESC> key,
  927. run NEWKEYSP.EXE, pick "I" on the menu, and make an entry for <^ESC>.
  928.  
  929.  
  930. EDITING FILES
  931. -------------
  932. <F2> calls your editor, loading it with the filename of the current
  933. record.  As supplied, editor access to .COM .EXE .BIN .OBJ .SYS .LIB .WKS
  934. .DB & .OVL extensions and the seven above archive extensions is denied.
  935. The denied extensions configurable.  Denials protect the integrity of
  936. non-text files.
  937.  
  938. A second editor or word processor (or any utility, such as a .GIF viewer)
  939. may be mapped to <^F2>.  The denied extensions apply to this key as well.
  940. If a disk is write-protected, <F2> will give an error message.  If you
  941. have no editor, pick up PC-Mag's free TED.COM.
  942.  
  943. Note that an "R" switch is provided in the configuration listing for each
  944. utility port.  It forces reloading the current directory upon return from
  945. the utility, and should be "ON" for any editor or other utility which can
  946. change file size or directory contents.  "W" (wait before redisplaying)
  947. should be off since you will want to return immediately from an editor.
  948.  
  949. To create a NEW file, hit <F2> while on a NON-FILE RECORD.  This will not
  950. work if the "R" switch is off.  You will be prompted for names for the new
  951.  
  952. (Page 19.)
  953.  
  954. files, but may hit <CR> on the blank field blank if you wish.  Some
  955. editors may not be able to utilize more than one filename from the command
  956. line.
  957.  
  958.  
  959. OTHER UTILITY PORT KEYS
  960. -----------------------
  961. Utilities of any type may be mapped to the <F3> and <F8> keys.  <F3> is
  962. initially set up to find duplicates of the current file by calling
  963. WHERE.EXE.  Bruce Gavin's utility FIND.EXE is a good choice here.
  964.  
  965.  
  966. UNZIPPING FILES
  967. ---------------
  968. <F4> is used to call an archive utility, such as 4UNZIP (a shareware
  969. utility  which in turn calls PKUNZIP) or SHEZ or XRAY.BAT.  A list is
  970. shown of the files archived in a .ZIP or other file archive, and files can
  971. be unzipped singly or in marked groups.  4UNZIP is important here since it
  972. will recover the file notes 4FILES archived with their files.  Note: If
  973. certain keyboard buffer expanders are used, the current version of 4UNZIP
  974. crashes (immediately or a soon after use, with or without 4FILES) if
  975. certain keyboard buffer-expanders are used.  Test your setup!
  976.  
  977. 4FILES will soon have a built-in routine which will replace 4UNZIP
  978. completely, and which will work on all types of archives, not just .ZIP.
  979.  
  980.  
  981. ====================
  982. UTILITY PORTS IN USE
  983. ====================
  984.  
  985. A potential difficulty which 4FILES avoids is that some utilities and
  986. editors you might like to call allow you to delete/rename files or change
  987. drives/directories.  When the utility is exited, 4FILES by default explic-
  988. itly changes back to its last drive/directory and rereads the directory
  989. list.  The bar is returned to the last record it was on, or if deleted, to
  990. the nearest record number possible.  This process takes a little longer
  991. than assuming that the directory structure is unchanged, and also destroys
  992. the "+/-" note-modified indicators and any file marks, but is SAFE.
  993.  
  994. Alternatively, you may tell 4FILES not to reload the directory by setting
  995. the "R" switch for a utility port to "N".  Use the "N" setting ONLY if you
  996. know the utility is incapable of the operations mentioned above.
  997.  
  998. Note that the switch for the browser is also operative when displaying Help
  999. or this manual with <F1> or <^F1>.  Two help files are provided: 4F.HLP
  1000. and 4F.KEY.  The file 4FILES will call is 4F.HLP, so if you wish to use
  1001. the other, rename both files.
  1002.  
  1003. (Page 20.)
  1004.  
  1005. ===============
  1006. USING NOTE MODE
  1007. ===============
  1008.  
  1009. ANNOTATING FILES
  1010. ================  4FILES supports file notes (or "descriptions" in 4DOS
  1011. parlance) up to 40-characters long.  Each directory with annotated files
  1012. will contain a hidden file named DESCRIPT.ION, containing the note data for
  1013. all files in the directory.
  1014.  
  1015. Beginning with release 5.0, 4DOS can handle file notes up to 200
  1016. characters long, but 4FILES will not be able to use the extra capacity
  1017. until a later release.  For now though, 4FILES does detect notes of over
  1018. 40-characters and will warn you of the situation.  To limit creation of
  1019. notes by 4DOS or other utilities to 40 characters, be sure that in your
  1020. 4DOS.INI file the directive DescriptionMax=040 is set (the default value).
  1021.  
  1022. File copying, moving, or renaming will however always work properly
  1023. regardless of description length since 4FILES relies directly on 4DOS
  1024. resources for these functions.  The only caveat is, again, that once a
  1025. note is edited and 4FILES rewrites DESCRIPT.ION, all notes are written
  1026. to disk, and only 40 characters can be written for each.
  1027.  
  1028. Great attention has been devoted to making 4FILES a true power tool for
  1029. creating or modifying one or a multitude of notes.  These are the features:
  1030.  
  1031.  
  1032. CUT & PASTE & NOTE DELETES
  1033. ==========================  <F9> initiates text-copying mode.  Highlight
  1034. the desired text by moving the cursor horizontally, and then hit <CR> to
  1035. put it in the paste buffer.  <@F9> copies the whole note to the buffer,
  1036. and <^F9> cuts (rather than copying) selected text to the buffer.
  1037. Captured text stays in the buffer when changing drives or directories.
  1038.  
  1039. <F10> pastes text in the buffer at the cursor position.  If a PASTE
  1040. causes an overflow of the 40-character note space, the note is moved to
  1041. an 80-character space at the bottom of the screen.  This expanded field
  1042. is fully editable (see following).  <F10> is inactive in FLR mode.
  1043.  
  1044. ^Y deletes the entire note, and is also functional all text input fields
  1045. and command lines in 4FILES.
  1046.  
  1047. In Note Mode, ^D will delete the notes of all marked files.  As with file
  1048. deletion, a double-tap of the "Y" key is required to affirm the deletion.
  1049. The prompt is put on a different part of the screen than for file
  1050. deletion, to be sure you realize that you are deleting notes, not files.
  1051.  
  1052.  
  1053. EXPANDED EDIT FIELD
  1054. ===================  Expanded Field Mode is triggered whenever typing or
  1055. pasting causes the length of the current note to exceed 40 characters, and
  1056. allows editing over a full 80-character field.  The note is moved to a
  1057. highlighted 80-character field at the bottom of the screen and the
  1058. 40-character field is blotted out.  Two "eyebrows" of "blot" characters,
  1059. each 40-characters long, are placed above this field, and act as a guide
  1060.  
  1061. (Page 21.)
  1062.  
  1063. for where the over-long note will be truncated when <CR> or <ESC> is
  1064. hit. The intent of the blotted out 40-character field, eyebrows, and
  1065. highlighted bottom row is to draw your eyes down to the expanded field.
  1066.  
  1067. To return to the 40-character field, hit <ESC> or <CR>.  <ESC> will return
  1068. to the current record and <CR> moves the cursor to the next record.  In
  1069. both cases the note is truncated after the 40th character.
  1070.  
  1071.  
  1072. FLUSH RIGHT (FLR) MODE
  1073. ======================  To create notes which are easy to scan by eye, it
  1074. is sometimes useful to make part of a note left justified and part of it
  1075. right justified.  Hitting <Sh-Rt-Arrow> provides right justified text in
  1076. either of two ways:
  1077.  
  1078. 1. If there is text to the right of the cursor, it is bumped over to the
  1079. right margin.  The cursor is not moved, and 4FILES remains in its normal,
  1080. left justified editing mode.
  1081.  
  1082. 2. If there is no text to the right of the cursor, 4FILES enters Flush-
  1083. Right Mode (FLR).  The cursor is moved to the right margin, and highlighted
  1084. indicators are set-up to show the part of the note field which is available
  1085. for FLR text entry.  Text will grow leftward from the cursor, which is
  1086. initially outside the field.  Editing is forced into insert mode.  All
  1087. horizontal cursor movement keys are active.  ^Left & ^Right behave slightly
  1088. different than in normal mode, putting the cursor between words, and
  1089. Shft-BS is enabled.  Collision of new FLR text with any left-justified text
  1090. is prevented.  Cut and paste are not allowed.
  1091.  
  1092.  
  1093. QUITTING FLR MODE
  1094. =================  There are three ways to leave FLR mode, with differing
  1095. effects on the text cursor and the cursor bar.  In all cases, the
  1096. pre-existing insert or overwrite mode will be restored.  The choices:
  1097.  
  1098.         <ESC>            Leaves the cursor where it is.
  1099.         <Sh-Left>        Sends the cursor home.
  1100.         (Record-change)  (All vertical cursor keys act normally.)
  1101.  
  1102.  
  1103. INSERT / OVERWRITE MODES
  1104. ========================  The INSERT mode default may be changed from the
  1105. configuration menu.  The active mode may be toggled with <INS>.
  1106.  
  1107.  
  1108. ==============================
  1109. INTERNAL CONFIGURATION ROUTINE
  1110. ==============================
  1111.  
  1112. CUSTOMIZING 4FILES
  1113. ==================  You can change 4FILES' on-screen appearance, the
  1114. INSERT / OVERWRITE default, "utility port" setups, and a number of other
  1115. features.  <Alt-F10> displays the Main Configuration Menu.  If you make
  1116. changes, this menu will have two choices added to it:  "(S)ession only
  1117. changes" or "(P)ermanent changes."  The later choice saves the
  1118.  
  1119. (Page 22.)
  1120.  
  1121. configuration to disk in a .CFG file.  When quitting 4FILES, you
  1122. will have an another opportunity to save session-only configuration
  1123. changes.
  1124.  
  1125. If you rename 4FILES, 4FILES will detect its new name and will recognize
  1126. only a .CFG file of the same name.
  1127.  
  1128.  
  1129. "Utility Ports" Configuration Screen
  1130. ====================================
  1131. Each utility port has a Key/Function name indicating which key accesses
  1132. the utility and the recommended use for the port.  The first field of each
  1133. line is the "utility field", and is for an alias name, file name (filespec)
  1134. or a complete pathspec for a utility or application.  A complete pathspec
  1135. will speed loading and is recommended, but is not necessary if the program
  1136. is in your PATH.  (DOS must know where to find the program, either from
  1137. the pathspec or by searching each directory listed in your system's PATH.)
  1138. In all cases, a file extension MUST be given.  Valid extensions include
  1139. .BAT, .BTM and .ALS.  ".ALS" must be appended to aliases or DOS internal
  1140. commands.  .ALS is a flag for 4FILES, and is not included in the actual
  1141. call.  All commands without extensions will fail to execute.
  1142.  
  1143. If you wish to swap 4FILES to EMS or XMS memory or a hard disk before
  1144. executing a utility or application, SWAPDOS.COM can be used.  Enter SWAPDOS
  1145. in the utility field.  The name of the program to be called then goes in
  1146. the tail ("T=") field, preceded by any command line switches for SWAPDOS
  1147. and followed by any of its own switches.
  1148.  
  1149. Another swap program which can be used for this is SHROOM.  4FILES rather
  1150. than the utility is loaded via SHROOM, so SHROOM should not be placed in a
  1151. port's configuration.  With SWAPDOS, swapping only occurs for the selected
  1152. utilities, while SHROOM will swap for all utilities and when shelling to
  1153. DOS.  On the other hand, SHROOM does fast executions via the DOS EXEC
  1154. function, while SWAPDOS makes a slower shell to DOS.  On any utility or
  1155. DOS calls in which SHROOM or SWAPDOS is active, the 4FILES mouse and
  1156. keyboard handlers are necessarily disabled during the call.
  1157.  
  1158. Errors in calling .COM and .EXE programs from 4FILES (e.g. file not found)
  1159. are shown as "configuration incorrect", but execution errors for batch
  1160. files and aliases are not trapped.  If execution is a quick flash on the
  1161. screen, you need to repeat the operation with a "screen pause" to see what
  1162. is happening. There are two ways to do this; one global and one specific to
  1163. the utility.  To pause after execution of all utilities and the DOS shell
  1164. (^E commands), set the "Pause after ^E" configuration switch to "Y".  To
  1165. cause a particular utility to pause after execution, set its  "H=" (hold
  1166. screen) switch to "Y".  There is also a "Pause after ^X" switch.
  1167.  
  1168. Displaying Help and this manual with <F1> and <^F1> (respectively) will
  1169. work only if the <G+> BROWSE key is configured correctly.
  1170.  
  1171. The next field in the utility-port block is the command line tail.  This
  1172. sends filenames, command line switches or other parameters to the utility.
  1173. The following macros may be placed anywhere needed among other parameters
  1174. (to save space you may omit space characters before and after them):
  1175.  
  1176. (Page 23.)
  1177.  
  1178.    $0    Inserts file or directory name; allows operations on directories.
  1179.  
  1180.    $D $d Inserts drive letter, colon, full pathspec and filename.ext.
  1181.    $P $p Inserts pathspec, but without the drive letter and colon.
  1182.    $F $f Inserts the filename and extension.
  1183.    $N $n Inserts a space, then the filename without extension.
  1184.  
  1185.    $1    Inserts drive letter only, with no colon.
  1186.    $2    Inserts full path, without drive or filename.
  1187.    $3    Inserts filename without extension or "." character.
  1188.    $4    Inserts extension without "." character.
  1189.  
  1190.    (Example: The string $1:$2\$3.$4 is equivalent to $D.)
  1191.  
  1192. The "H" field is a YES/NO field which determines whether or not 4FILES
  1193. waits for a keyhit after the utility has finished executing.  Set it to "Y"
  1194. for utilities which run straight through and exit without any user input.
  1195.  
  1196. The "R" field is also a YES/NO field which determines whether 4FILES
  1197. reloads the directory list and DESCRIPT.ION file after the utility exits.
  1198. It must be set to "Y" if the utility is capable of managing files or
  1199. changing drives and directories.  It should for example be "Y" for an
  1200. editor or word processor.
  1201.  
  1202.  
  1203. "Configuration Options" Screen
  1204. ==============================
  1205. This screen provides switches, grouped into sections, for the following:
  1206.  
  1207.  
  1208. KEYBOARD/MOUSE SWITCHES:
  1209. ------------------------
  1210. International Keyboard Code:
  1211.    -- Two letter DOS keyboard-country-code.  LEAVE THIS BLANK UNLESS YOU
  1212.       HAVE A PROBLEM.  Takes effect next session.
  1213.  
  1214. Keyboard Type:
  1215.    -- "1" = AT keyboard, <G*>, <G->, <G+> keys active.
  1216.       "2" = PC keyboard, substitutes <Scl-Lock> for <G*>.
  1217.       "3" = Laptop.  Substitutes <[>, <]>, and <ENTER> for above.
  1218.  
  1219. Overtype Default?
  1220.    -- The INSERT mode default can be changed to OVERTYPE.  The default
  1221.       state has the line cursor, the alternate state has the block cursor.
  1222.  
  1223. Disable QUIT via <ESC>?
  1224.    -- To avoid inadvertent exits via <ESC> set this to "Y" and exit with
  1225.       <^ESC> or <@ESC>.  (If you use NEWKEY, see P.10.)  In MS-Windows and
  1226.       OS/2, setting this switch allows task switching to occur.
  1227.  
  1228. Substitute <CR> for <G+> Key in File Mode?
  1229.    -- "Y" substitutes the <Enter> (<CR>) key for the <G+> key, in File Mode
  1230.       only.  <CR> retains its text writing meaning in Note Mode.
  1231.  
  1232. (Page 24.)
  1233.  
  1234. Let 4FILES Enable the Mouse?
  1235.    -- "N" leaves the mouse set up as-received by 4FILES.  "Y" causes 4FILES
  1236.       to install its own mouse handler.  Takes effect in next 4FILES
  1237.       session.
  1238.  
  1239.  
  1240. VIDEO SWITCHES:
  1241. ---------------
  1242. Video Mode (hex), Alternate #:
  1243.    -- Spaces are provided for three extended video modes, and these must be
  1244.       hex numbers from your video card manual.  If these fields are blank,
  1245.       BIOS methods will be used to switch video modes on EGA and VGA
  1246.       monitors.  Providing numbers here may provide better performance or
  1247.       more preferable fonts.  <Ctrl-F7> switches modes.
  1248.  
  1249. Use Snow Prevention if CGA?
  1250.    -- Set to "Y" if your CGA monitor has a snow problem.
  1251.  
  1252. OK to restore font?
  1253.    -- Since 4FILES is capable of changing the number of EGA/VGA rows
  1254.       displayed, it attempts to restore the original video state when it
  1255.       exits.  In some cases it is necessary or desirable to restore the
  1256.       original font as well, but a switch is provided since this fails on
  1257.       some systems.  EMS memory is required for storing the font.
  1258.  
  1259. At Exit & Shell: Enable Blinking?
  1260.    -- 4FILES disables blinking to allow all color choices.  Set this to
  1261.       "Y" only if some programs you use display strange colors where there
  1262.       should be blinking text after 4FILES has been run or when called
  1263.       from within 4FILES.  This is a problem of poorly behaved programs,
  1264.       not a problem with 4FILES.  The Utility Ports Configuration now has a
  1265.       blink enable switch for each port to avoid this problem during calls.
  1266.  
  1267. At Exit: Use 4FILES Colors in DOS?
  1268.    -- "Y" leaves the screen set to the 4FILES text color at exit; with "N"
  1269.       DOS color is restored.  (Results with "Y" may not be visually
  1270.       pleasing if you use ANSI.)
  1271.  
  1272.       If this is set to "Y," the Enable Blinking switch should be set to
  1273.       "N" to assure that all of your colors are maintained.  If Enable
  1274.       Blinking is set to "Y" and your 4FILES text background is dark
  1275.       grey or a high intensity color, something has to give and at exit
  1276.       any colors that will blink will be to modified to non-blinking
  1277.       colors -- all or part of your DOS screen would flash otherwise.
  1278.  
  1279. At Exit: Show Previous DOS Screen?
  1280.    -- Determines whether the 4FILES screen is left showing at exit or
  1281.       whether the previous DOS screen is shown.  The later will not work
  1282.       unless you have a TEMP directory designated in your environment.
  1283.  
  1284.  
  1285. SHELLING OPTIONS:
  1286. -----------------
  1287. ^C/^M "prompt-for-each" prompt ON?
  1288.    -- Determines whether or not you will be prompted before each file is
  1289.  
  1290. (Page 25.)
  1291.  
  1292.       copied or moved when working with marked files.  Eliminates one
  1293.       keystroke at the beginning of the operation.  Has no effect unless
  1294.       you are running under 4DOS.
  1295.  
  1296. Prompt before Copy/Move Overwrite?
  1297.    -- Determines whether duplicate filenames found in the target directory
  1298.       will be automatically over-written or whether you will be prompted to
  1299.       quit or continue.
  1300.  
  1301. Use Copy/Move Alias?
  1302.    -- "N" is the default.  Use __CAUTION__ if you change this.  "Y"
  1303.       disables 4FILES' protection against trashing a file if you specify a
  1304.       non-existent directory during a marked files copy/move.  If set to
  1305.       "Y" your aliases for both Copy and Move must provide this protection.
  1306.  
  1307. Run COPY/MOVE/RENAME in Full Screen?
  1308.    -- For best appearance, set this to "N" and see if your video system
  1309.       will work properly with the smaller window provided.  4FILES sets up
  1310.       the window and DOS then runs within it.  "N" works for most systems.
  1311.  
  1312. Run Archivers in Full Screen?
  1313.    -- Similar to the above, providing separate control for windowing of file
  1314.       archiving operations (with the Z commands).
  1315.  
  1316. Pause After ^E DOS Commands?
  1317.    -- If the result of an (^E)xecute flashes off screen, either set this
  1318.       to "Y" or put "++" at the end of the ^E command input line to pause.
  1319.  
  1320. Pause After ^X or <F9> Program Runs?
  1321.    -- Does the same as the above for direct executions (no "++" option).
  1322.  
  1323.  
  1324. OTHER OPTION SWITCHES:
  1325. ----------------------
  1326.  
  1327. Never Save File Marks on Exit?
  1328.    -- If you don't intend to use the /M command line switch, setting this to
  1329.       "Y" will avoid writing DEMARCAT.ION files unnecessarily.
  1330.  
  1331. Never Save File Marks on Directory Change?
  1332.    -- If you don't care to have your file marks retained during a session,
  1333.       setting this to "Y" will avoid writing DEMARCAT.ION.
  1334.  
  1335. AT STARTUP: Read Old File Marks?
  1336.    -- If the switch two above is set to "N," setting this switch to "Y"
  1337.       will cause file marks from a previous session to be used.
  1338.  
  1339. AT STARTUP: Show File Attributes?
  1340.    -- Normally 4FILES starts up with the file time shown field displayed;
  1341.       this switch shows file attributes instead.  (See also, <F7> key.)
  1342.  
  1343. AT STARTUP: Start in Note Mode?
  1344.    -- Determines whether startup is in File Mode or Note Mode.
  1345.  
  1346. (Page 26.)
  1347.  
  1348. AT STARTUP: Leave Num-Lock As-is?
  1349.    -- Determines whether the keypad controls the cursor or types numbers.
  1350.  
  1351. Beep Turned On?
  1352.    -- 4FILES is supplied with this set to "Y."
  1353.  
  1354.  
  1355. Further note on the "Use Copy/Move Alias?" Switch
  1356. -------------------------------------------------
  1357. Setting this switch to "Y" is not recommended, but is provided for power
  1358. users.  It determines whether an existing 4DOS command or user alias named
  1359. COPY, MOVE or RENAME will be unaliased before sending the command.
  1360.  
  1361. NOTE THAT ENABLING ALIASES DISABLES THE SAFETY IN 4FILES WHICH PREVENTS
  1362. MARKED FILES FROM OVERWRITING ONE ANOTHER IF THE TARGET DIRECTORY DOES NOT
  1363. EXIST.  You MUST incorporate this safety yourself into BOTH the copy and
  1364. move aliases you use, for example by using the 4DOS /D switch.
  1365.  
  1366. The 4FILES switch is provided to support users who have aliases which
  1367. complete a fragmentary target path, given for a copy/move operation, into
  1368.  
  1369. a full path.  4FILES cannot be safe when used this way since such aliases
  1370. would be pre-empted by 4FILES' prompt to create the non-existent target
  1371. directory, which is what a path fragment appears to be.
  1372.  
  1373. The switch is completely safe if set to "N."  If set to "Y," you must
  1374. take the above precautions, and your aliases must be able to handle
  1375. (either by using or discarding them) both the /R and /P switches.
  1376.  
  1377.  
  1378. "Configure Colors & Highlights" Screen
  1379. ======================================
  1380.  
  1381. The color configuration screen does not truly portray the 4FILES colors
  1382. (so that the location of input fields can be clearly shown), so a sample
  1383. screen is shown at the bottom of the screen.  Just follow the instructions
  1384. on the screen.  Since 4FILES turns screen blinking off, background colors
  1385. and monochrome highlights not normally available may be used.  If dark
  1386. grey or high intensity background is used, you should set the "Enable
  1387. Blinking" switch to "N."
  1388.  
  1389. Some color combinations may not work with some "ported utilities".  For
  1390. example, if a utility automatically sets up a black on white cursor bar
  1391. without clearing the screen to white on black text first, AND if you have
  1392. 4FILES text set to black on white, you won't see the cursor bar.   This
  1393.  
  1394. occurs with 4UNZIP & VDE.COM.  The only solution is to pick text colors for
  1395. 4FILES which avoid the conflict.  Please suggest to authors of such
  1396. programs that they need a "smarter" set up of screen attributes.
  1397.  
  1398. (Page 27.)
  1399.  
  1400. ================
  1401. DISPLAY FEATURES
  1402. ================
  1403.  
  1404. 4FILES works with any video text mode of 80x25 or higher.  At startup 4FILES
  1405. automatically detects the display type and acts appropriately.  You may
  1406. quickly alternate between three or four video modes using the Ctrl-<F7>
  1407. key if you have an EGA or VGA monitor.  More about this in a moment.
  1408.  
  1409. At startup, except for HGC, MDA and CGA video cards, if a higher mode is
  1410. used it will be automatically implemented.  For HGC, MDA and CGA running
  1411. higher modes (such as with UltraVision), the /+ command line switch must be
  1412. used. The reason is that not all cards in this class are 100% BIOS
  1413. compatible, in some cases defeating the automatic detection, and this
  1414. arrangement assures that all systems will run " out of the box" in 80x25
  1415. mode.  When calling 4FILES from an application running a higher mode, 80x25
  1416.  
  1417. mode may be forced with the /8 switch.  When calling utilities or shelling,
  1418. the screen may look its best (depending on your color choice) if ANSI.SYS
  1419. is not loaded.
  1420.  
  1421. If a CGA video card is detected, a no-snow video writing method is used by
  1422. default.  For faster displays, this method may be configured "off".
  1423.  
  1424. Video mode switching is useful for displaying a longer list in fine type
  1425. or a shorter list in more readable type.  There are two ways to achieve
  1426. video mode switching using the Ctrl-<F7> key.
  1427.  
  1428. Method 1:  By default, BIOS methods are used to alternate between a 25, 43
  1429. and 50 line display.  (There is no 50-line mode for EGA.)
  1430.  
  1431. Method 2:  This method is supported by some VGA cards and gives superior
  1432. results.  It is activated by specifying extended video modes on the
  1433. Configuration Options Menu.  If these fields are blank, Method 1 will be
  1434. used.  You must use numbers supplied in your video card manual (there are
  1435. no standards) and they must be hexadecimal values.  You may toggle between
  1436. the three (or fewer) specified modes and the mode you were in at startup
  1437. (i.e.  four modes to choose from).  There is one case for which Method 2
  1438. will default to Method 1, and that is if when starting 4FILES, MODE CON
  1439. LINES = nn had been used to set up a 43 or 50 line mode in DOS.
  1440.  
  1441.      Rules for Method 2: 1> The extra modes must use at least 80 columns.
  1442.      2> You cannot switch between color and monochrome modes.  3> Use hex
  1443.      values from your video card manual -- other numbers will give
  1444.      unpredictable results.
  1445.  
  1446. VIDEO RESTORATION.  At exit the original video mode and number of lines is
  1447. restored.  A configuration menu switch determines whether the original
  1448. font is also restored; the default is not to restore since this does work
  1449. with all EGA/VGA hardware.  EMS memory is needed to save the original font.
  1450.  
  1451. WHAT YOU SEE ON-SCREEN
  1452. ----------------------
  1453. "T" and "E" indicators near the top and bottom of the screen indicate that
  1454. the top or end of the listing is shown on screen.  Used disk bytes are
  1455.  
  1456. (Page 28.)
  1457.  
  1458. shown in File Mode, and the 4FILES version number is shown in Note Mode.  A
  1459. file count is displayed at all times.  An "S" indicator with an up arrow
  1460. symbol on the top row means the file search direction is upward; if there
  1461. is no symbol shown the direction is downward.  "PROTECTED" and "ROOT FULL"
  1462. messages indicate that the full range of file management and note editing
  1463. features are not available for the current disk.  "Protected" means the
  1464. disk is write protected.
  1465.  
  1466. Records with altered notes are flagged with a "+/-" character at mid-line.
  1467. A different character is shown for unaltered notes.  A "delta" character
  1468. next to a filename means the file is marked for group file management.
  1469.  
  1470.  
  1471. ===================================
  1472. OPERATING WITH SPECIAL ENVIRONMENTS
  1473. ===================================
  1474.  
  1475. RUNNING UNDER MS-WINDOWS
  1476. ========================  4FILES runs well as a non-Windows application.
  1477. Windows is detected automatically, and the <CTRL-ESC> and <ALT-ESC> keys
  1478. will serve their Windows rather than 4FILES functions.  <Shift-ESC> or
  1479. <ESC> are then used to terminate 4FILES (depending on your configuration).
  1480.  
  1481. Note that the mouse will work as intended only when 4FILES is run in a full
  1482. screen window -- when the program is in a smaller window the Windows mouse
  1483. handler is operative.  As you should know, you may toggle between windowed
  1484. and full screen with the Windows <Alt><Enter> key.  The provided 4F.PIF
  1485. file causes 4FILES to startup in a window, but you may modify the PIF.
  1486.  
  1487. This is the recommended way to install 4FILES in Windows:
  1488.  
  1489. 1) It is best to have two 4FILES installations; one in the Startup Group
  1490. which will always be loaded automatically into a minimized-icon or window
  1491. whenever you load Windows, and one that is always handy in whichever Group
  1492. is normally active on your desktop.  This is one example of how to do
  1493. this.  Your DOS installation of 4FILES should be completed before
  1494. proceeding.  Be sure 4F-I-WIN.ICO and 4F.PIF are in the same directory as
  1495. the program, or alternately put copies of them in your Windows directory.
  1496.  
  1497. 2)  Open (for example) the Startup Group.  From the Program Manager menu
  1498. line select "File," then "New" and "OK" with "Program Item" selected.  You
  1499. are now in the Program Properties dialog box.  Leave the Description
  1500. blank; <TAB> to the next field and type d:\path\4F.PIF directly into
  1501. the field (substitute pathspec to your 4F installation for "d" and "path").
  1502. Alternatively, you can browse through the directory tree to find 4F.PIF.
  1503. Back in the Program Properties box, type "OK."
  1504.  
  1505.     Especially if you are using Windows for WorkGroups, running 4FILES.COM
  1506. directly as the "Program Item," rather than listing its PIF there may result in
  1507. messages like "Unable to access video display" or "This application has
  1508. violated system integrity."  If you get these messages, be sure you are running
  1509. from the PIF and/or compare documentation in 4F-PIF.TXT to the settings in your
  1510. PIF file.
  1511.  
  1512. (Page 29.)
  1513.  
  1514. 3)  You are now back in the Group box, with a DOS icon for 4FILES
  1515. highlighted.  Select "File," "Properties."  Type in the working
  1516. directory you want 4F to log onto when it loads, and if the 4F.PIF
  1517. default CTRL-CapsLock hotkey is unsuitable, select a different on in
  1518. this box.  Then select "Change Icon," and in the box which is shown,
  1519. either type in d:\path\4F-I-WIN.ICO, or browse to select this file.
  1520.  
  1521. Finally, if you do not wish 4FILES to load immediately (remember, this is
  1522. the Startup Group), prefering instead to have it appear as an icon at the
  1523. bottom of the screen, set the "Run Minimized" box.  To save your work,
  1524. select the upper left corner button of the box and select save.
  1525.  
  1526. 4)  If you ever create your own .PIF, set the KB Required to 128K.
  1527. Although 4FILES is a .COM file, it needs memory for 64K of data in
  1528. addition to its own code and buffers, which is also approaching 64K.  Set
  1529. KB_Desired to 640K, to leave room for utilities called from 4FILES.
  1530.  
  1531. 5)  It is recommended that you do a duplicate installation in the Windows
  1532. Group you will normally have showing on your desktop.  This way, if you
  1533. terminate the startup group copy of 4FILES you have another 4FILES icon
  1534. handy, eliminating the needed to reopen the startup group box first.
  1535.  
  1536. Using 4FILES in Windows
  1537. -----------------------
  1538. For regular 4FILES use (except during evaluation under COMMAND.COM) be
  1539. sure your COMSPEC environment variable specifies 4DOS or NDOS.  To use
  1540. the mouse in 4FILES, your mouse driver MUST be loaded prior to loading
  1541. Windows; although Windows does not need a pre-loaded driver, 4FILES does.
  1542. The mouse will have 4FILES functions when 4FILES is full screen, and
  1543. it will have its Windows functions when 4FILES is in a window.  You may
  1544. toggle 4FILES between full screen and window displays with <Alt><Enter>.
  1545.  
  1546. 4F.PIF, as supplied, starts 4FILES in a full screen.  To change this
  1547. default to a "windowed" startup, run the PIF-Editor icon and select Open
  1548. on its left title bar button.  Find the 4F.PIF file, and set the
  1549. appropriate button under "Display Useage."
  1550.  
  1551. <Alt><ESC> swaps out of 4FILES to other tasks.  When the swap cycle
  1552. comes back to 4FILES, if 4FILES is running full screen, you will come
  1553. back to the 4FILES icon and will have to reopen it.  If it is running in
  1554. a window though, you will come back to your place on the 4FILES screen, or
  1555. the screen of a utility you may have called from 4FILES and been in when
  1556. you swapped tasks.  4F-WIN.PIF sets the Windows short-cut to Alt+CAPSLOCK;
  1557. this may be changed on the PIF-Editor "Advanced" screen.
  1558.  
  1559. One handy use of 4FILES is to have it in a background window that has an
  1560. edge or corner showing.  Suppose you are in a Windows application, for
  1561. example PageMaker, and you are looking at a directory list, trying to
  1562. decide which file to load.  The Windows directory display does not show
  1563. file notes or allow you to view a file, and it can be hard to figure out
  1564. which file you want.  Just click on the 4FILES window to bring it to the
  1565. foreground, change to the same directory, and read your notes.  Then click
  1566. on the window for your application, and you are ready to go.  Of course,
  1567. with the 4FILES window handy in the background it is also easy to update
  1568. your file notes after creating or editing a file with another application.
  1569.  
  1570. (Page 30.)
  1571.  
  1572. RUNNING UNDER OS/2
  1573. ==================  Behavior is like under Windows.  4FILES runs well
  1574. from its icon, in a DOS VDM, or from the OS/2 (or 4OS2) command line.
  1575. Using the icon allows the OS/2 Mouse_Exclusive_Access (M_E_A) switch to be
  1576. configured "on," for proper mouse action.  If it is on, any mouse button
  1577. will extinguish the OS/2 mouse cursor; to restore it type Ctrl-ESC, and
  1578. then ESC to clear the task menu.  If M_E_A is not set, 4FILES must be run
  1579. full screen for proper mouse action.  To set M_E_A, press the Right Button
  1580. on the 4FILES icon, press Right Arrow, then select in succession: Settings,
  1581. Session, DOS Window, and DOS Settings.  Type "M," find  Mouse_Exclusive_
  1582. Access, turn it on, and save the setting.  While you are at it, select the
  1583. General tab in the Settings notebook and load the 4F-OS2.ICO icon.
  1584.  
  1585. Unless you are simply evaluating 4FILES, be sure you have OS/2 set up to
  1586. run 4DOS as the shell for any DOS VDM where you will load 4FILES.  From
  1587. within 4FILES, type: "^E^E ++" and at the ensuing command line type:
  1588. "VER".  You should see 4DOS and its version number followed by the OS/2
  1589. version number.  This check is necessary to assure that your file
  1590. descriptions will be transferred with their files and to take advantage of
  1591. other 4DOS features 4FILES uses.  See the Chapter 4 of the 4DOS
  1592. Installation Guide for details.
  1593.  
  1594.  
  1595. RUNNING UNDER DESQVIEW
  1596. ======================  4FILES is DESQview (DV) aware, and may be used in
  1597. small or full windows.  Note however that a defect in current versions of
  1598. DesqView/X prevents some important keystrokes in 4FILES from being
  1599. recognized.  This is a problem with DV/X, not 4FILES, and Quarterdeck Tech
  1600. Support has been notified of a need for a fix.
  1601.  
  1602. Even though 4FILES is fully DV-aware, "Writes directly to screen" must be
  1603. set to "yes" since utilities you call from 4FILES may not be DV-aware.
  1604. DV's Transfer and Learn functions are fully functional, even though 4FILES
  1605. employs its own keyboard handler.  4FILES' time slice will be released
  1606. while 4FILES is idling.
  1607.  
  1608. Sufficient memory must be allotted to 4FILES for itself plus the largest
  1609. utility (or the DOS secondary shell) which will be called from within it.
  1610. You may wish to have "Open" menu entries for a few copies of 4FILES, each
  1611. with a different name and its own .CFG file.  For example, one copy might
  1612. be setup to call TED (a small freeware text editor) as the editor so 4FILES
  1613. can be fully functional with minimal memory requirements; and another copy
  1614. might call Multi-Edit (a full featured editor) and be set up for 350+K of
  1615. memory.  Due to 4FILES' small size it is realistic to use multiple copies
  1616. (each with its own .CFG file) to provide this flexibility.
  1617.  
  1618. When setting up for 4FILES it is suggested that the filename plus extension
  1619. be used, causing DV to load 4FILES directly itself rather than calling DOS
  1620. to load it.  This  saves  several K of memory and saves  much time during
  1621. utility calls since execution will be  direct.  On utility calls if  DOS
  1622. loaded 4FILES, DV will shell to DOS before the  utility is loaded.  Also,
  1623. if a utility is called while 4FILES is in a small window, the utility's
  1624. screen may appear to be blank and unscrollable, depending on the location
  1625. of text on the page.  In this situation just zoom the window to full size.
  1626.  
  1627. (Page 31.)
  1628.  
  1629. In the DV setup for 4FILES, set "Uses it's own colors" to yes, but don't
  1630. use colors which interfere with blinking.  For  example, when dark grey is
  1631. used for the 4FILES list background, 4FILES  will  display correctly but
  1632. when you switch to another window the whole 4FILES window will blink.  Some
  1633. monochrome highlight choices have this same effect.
  1634.  
  1635. Under DESQview the 4FILES CTRL-ESC and ALT-ESC keys loose their meaning
  1636. since 4FILES always loads to its home directory.  These keys can still be
  1637. useful though, allowing "plain" ESC to be deactivated as described herein.
  1638.  
  1639.  
  1640. ===============
  1641. SAFETY FEATURES
  1642. ===============
  1643.  
  1644. DISK OVERFLOW PREVENTION
  1645. ========================  In DOS, a file write that exceeds disk capacity
  1646. truncates the file, usually with no immediate outward indication of a
  1647. problem.  Automatic protection against such data loss must be provided by
  1648. the  program itself, and 4FILES is so equipped.
  1649.  
  1650. Whenever you change records or directories, 4FILES checks for an overflow
  1651. condition.  If your edits exceed disk capacity, you are immediately alerted
  1652. with a message giving the number of excess bytes.  At this point the note
  1653. file is still in memory, and operations which would cause a file write
  1654. are blocked.  These include drive or directory changes, calling browse or
  1655. edit utilities, and quitting.  Meanwhile, you have FULL editing freedom,
  1656. even text insertion and pasting, while editing your notes down.
  1657.  
  1658. The overflow bytes message is updated on each record change, and the byte
  1659. tally can run up as high as necessary.  When the message stops appearing,
  1660. the notes will then fit on disk and blocked-off functions are re-enabled.
  1661. Entirely deleting a note deducts more than the note size from the overflow;
  1662. the length of the "filename.ext" plus three delimiter bytes are also
  1663. nixed.  If you delete a file (as opposed to just its note) or subdirectory
  1664. with the D or K commands, the space freed up from the record and its note
  1665. will be properly accounted for.  Changes during ^E operations are
  1666.  
  1667. accounted for also since the directory is always reread afterward.
  1668.  
  1669. 4FILES pinpoints available disk space down to the last byte, but in one
  1670. unusual circumstance the overflow detection behavior may seem strange,
  1671. although it is still working correctly.  Writing a  new file requires at
  1672. least one cluster of disk space (1024, 2048, or 4096 bytes, depending on
  1673. the drive). Writing the first note in a subdirectory requires one cluster
  1674. of available space, but if the disk is already full, doing so will cause an
  1675. overflow condition.  You might try going to another subdirectory that has
  1676. notes and deleting a few notes, but this probably will not work.  You may
  1677. appear to free up enough bytes, but unless this also frees up a cluster
  1678. 4FILES will still indicate an overflow since one does in fact exist.
  1679.  
  1680. Unmarking files may also reduce disk requirements, especially if you
  1681. unmark all files, freeing up a whole cluster from DEMARCAT.ION.
  1682.  
  1683. (Page 32.)
  1684.  
  1685. READ ONLY "TRAP" AVOIDED
  1686. ========================  4DOS and 4FILES can move and edit notes only if
  1687. the file "attribute" of DESCRIPT.ION allows a file write.  Unfortunately,
  1688. the "READ-ONLY" attribute can be inadvertently set by some utilities,
  1689. especially those which can operate on blocks of files (such as XTREE Pro).
  1690. When loading a directory, 4FILES checks ahead for the READ-ONLY attribute,
  1691. and will prompt you to clear it.  Were this not done, note edits you think
  1692. you are saving could be lost or notes could be lost during file copying
  1693. and moving.
  1694.  
  1695. If you say "NO" to clearing the attribute during a directory change, you
  1696. return to the old directory.  During 4FILES startup, picking "NO"
  1697. terminates the program. "YES" clears the bit, and operations are normal.
  1698.  
  1699. NEVER intentionally mark a DESCRIPT.ION file "READ-ONLY" for any reason.
  1700. 4FILES catches the error, but 4DOS unfortunately does not.
  1701.  
  1702. 4FILES also will not allow you to use the A or ^A commands to change the
  1703. attributes of DESCRIPT.ION, nor will it allow you to copy or rename it.  It
  1704. may be deleted only if all notes have been erased.  Such protections are
  1705. essential to the safety of the file description system.
  1706.  
  1707.  
  1708. TIMELY INACCESSIBLE-DISK DETECTION
  1709. ==================================  Files on a write protected disk
  1710. cannot be altered, or if the root directory is full, files can't be
  1711. added to it.  During 4FILES startup and all drive or directory changes an
  1712. immediate check is made to see if one of those conditions exists.  If so,
  1713. you will be alerted with a prominent "PROTECTED" or "ROOT FULL" message.
  1714.  
  1715. As appropriate, certain 4FILES functions are disabled, and you will get
  1716. an error message if you try to use them.  For example, in a full root you
  1717. will not be able to edit notes unless the DESCRIPT.ION file already
  1718. exists.  You can view files on a protected disk, but file management and
  1719. note editing is impossible. No wasted time writing notes you can't save!!
  1720. OS/2 sometimes gives annoying write protected disk messages even though
  1721. 4FILES has already noted the condition -- I am looking for a fix for this.
  1722.  
  1723.  
  1724. INTERNAL CRITICAL ERROR HANDLER
  1725. ===============================  DOS handles some simple, common situations
  1726. as critical errors, and can disrupt execution of a program.  These include
  1727. leaving a drive door open or calling a drive with no disk inserted.  4FILES
  1728. has its own critical error handler to treat such problems seamlessly, and
  1729. goes also improves handling of drives A and B in single floppy systems.
  1730.  
  1731.  
  1732. ===========
  1733. 4FILES TIPS
  1734. ===========
  1735.  
  1736. Here are some ideas for making the most of 4FILES in everyday use.
  1737.  
  1738. 1) TEAMWORK WITH LARGE APPLICATIONS #1:  4FILES is a real time saver when
  1739. used in conjunction with some application programs.  For example, you can
  1740.  
  1741. (Page 33.)
  1742.  
  1743. write a 4DOS alias which loads 4FILES whenever you exit your comm program.
  1744. Using Procom as an example, if you create this 4DOS/NDOS alias:
  1745.  
  1746.        ALIAS COM = C:\COM\PROCOM ^ 4FILES C:\COM\DOWN /T/D
  1747.  
  1748. the command "COM" will cause 4FILES to be load when Procom exits.  Your
  1749. download directory will be shown sorted in reverse order by file creation
  1750. time, placing new files at the top.  Alternatively, using /E/D would put
  1751. .ZIPS at the top.  Then, using <G+> you may view the contents of the new
  1752. text or .ZIP files.  To unzip a file, type F4 to call PKUNZIP or 4UNZIP.
  1753.  
  1754.  
  1755. 2) TEAMWORK WITH LARGE APPLICATIONS #2:  In Windows or OS/2, keep a corner
  1756. of the 4FILES window visible in the background where it is immediately
  1757. accessible.  Use 4FILES to refer to your file notes when you are having
  1758. trouble deciding which file to load into a Windows application from the
  1759. "sparse" directory lists Windows provides.  This also keeps 4FILES handy
  1760. for quick file note updates when you created or modify data files.
  1761.  
  1762. 3) MORE ROOM FOR BIG APPLICATIONS:  To make more room for big applications,
  1763. you can use SHROOM or SWAPDOS to swap 4FILES to EMS or XMS memory or disk.
  1764. See details elsewhere in this manual.  The freed-up memory may make the
  1765. difference between your application running or not running.
  1766.  
  1767.  
  1768. 4) MULTIPLE 4FILES CONFIGURATIONS: You can write a variety of aliases to
  1769. quickly load 4FILES in specialized, frequently used configurations.  An
  1770. alias called 4E might call 4FILES with the /E switch set.  Another called
  1771. 4T, might make the call 4FILES C:\WP\TEXT.  In such aliases, giving the
  1772. full pathspec to 4FILES will speed loading, or you may want to have the
  1773. directory containing 4FILES listed early in your PATH statement.
  1774.  
  1775.  
  1776. 5) SPEED YOUR RETURN AFTER SHELLING TO DOS: use this alias: ALIAS = E EXIT.
  1777. Then "E <CR>" gets you back to 4FILES (or other shelling program) fast from
  1778. the secondary shell.
  1779.  
  1780.  
  1781. 6) REMEMBER THE "DOUBLE-TAP" KEYS:   ^E^E, < G**>, and the double strokes
  1782. to quit the Sort menu.  Also <G***> to return to the previous directory.
  1783.  
  1784.  
  1785. 7) FREEZING THE SCREEN #1: With the ^E command or when using a utility
  1786. port with a batch file or alias, a message might flash off screen too fast
  1787. to read, or it may appear that nothing happens at all.  Appending "++" to
  1788. the command freezes the screen after execution until a key is hit, so you
  1789. can see what happened.  4FILES can also be configured for automatic pause.
  1790.  
  1791.  
  1792. 8) FREEZING THE SCREEN #2: Some utilities you may like to use will scroll
  1793. several pages right off the screen.  The solution is to call an alias, as
  1794. in these silly but easy examples using DIR.  They are most conveniently
  1795. placed in your alias loading file, but can be entered on the command line
  1796. if the alias expansion is enclosed in single quotes (once entered they are
  1797. in memory, ready for use).  "=" is not needed from the command line.
  1798.  
  1799. (Page 34.)
  1800.  
  1801.         ALIAS DP=DIR | MORE
  1802.     or  ALIAS DL=DIR | C:\UTIL\LIST.COM /S
  1803.  
  1804. The first example pipes to the MSDOS MORE program which pauses at the end
  1805. of each page.  The later pipes output into Vern Buerg's LIST program,
  1806. which allows back and forth scrolling through the output.  To put this to
  1807. heavy use, such an alias could be mapped to the 4FILES F8 key.
  1808.  
  1809. 9) OPTIMUM KEYBOARD:  If your function keys are across the top, getting a
  1810. keyboard with F-keys on the left will REALLY speed up your work in all
  1811. programs and make it more accurate.  In 4FILES the proximity of these keys
  1812. to <ESC>, <TAB>, <CTRL> and <ALT> is handy, especially for marking and
  1813. unmarking files with ^F5 and ^F6.  I love my Northgate Ultra!
  1814.  
  1815. If you have a laptop computer, be sure to select KeyboardType=3 from the
  1816. Configuration Options screen.  Also, check out the separate cursor keypad
  1817. units described above under "Directory Navigation".
  1818.  
  1819. 10) FAST LOADING OF CALLED UTILITIES:  On the configuration screen,
  1820. provide the full pathspec and filename for each utility, rather than
  1821. relying on DOS to search for the program in your PATH.  Your utilities
  1822. will load in the blink of an eye; relying on PATH you will probably notice
  1823. at least some delay, depending on how deep the PATH must be searched.
  1824.  
  1825. 11)  FAST SHELLING AND LOADING OF 4FILES:  Setting your COMSPEC to a copy
  1826. of 4DOS in a RAMdisk will dramatically improve performance.  4FILES
  1827. loading will be blindingly fast if it too is called from the RAMdisk via
  1828. an alias or your PATH.  With 4FILES in a RAMdisk, you should call it with
  1829. a 4DOS alias that, after after exit, clears the R attribute on the hard
  1830. disk copy of 4F.CFG and over copies it with 4F.CFG from the RAMdisk.
  1831. Besides saving any configuration changes, the session number (necessary to
  1832. prevent file marks from earlier sessions from be redisplayed) is saved.
  1833.  
  1834. 12) COLOR SUGGESTION FOR COLOR MONITORS:  As supplied 4FILES displays
  1835. in colors that won't interfere with screen blinking.  Through experiment-
  1836. ation I have come up with two other color schemes which I feel are easier
  1837. on the eyes, and very functional.  In particular, they give a good balance
  1838. between the color of the cursor bar and the colors of both normal text and
  1839. sorted fields.  The best one has a dark grey background, which may require
  1840. switch adjustments of some 4FILES utility ports if you have trouble with
  1841. some utilities you call blinking uncontrollably (this is a quirk of IBM
  1842. type computers, which can show either 8-bit color, or 7-bit color with one
  1843. bit meaning "blink," combined with programs that assume 7-bit color.)
  1844.  
  1845.                            COLOR SET #1               COLOR SET #2
  1846.                     -------------------------    -----------------------
  1847.     FIELD         || BACKGROUND   CHARACTER   || BACKGROUND   CHARACTER
  1848.     ------------- || ----------   ----------- || ----------   ----------
  1849.     NORMAL TEXT   || Dark  Grey   Dark Green  || Black        Dark Cyan
  1850.     SORTED FIELD  || Dark  Grey   Light Yell  || Black        Light Yell
  1851.     CURSOR BAR    || Light Grey   Black       || Light Grey   Black
  1852.     CUT HI-LIGHT  || Dark  Red    Black       || Dark  Grey   Light Red
  1853.     FUNCTION KEY  || Dark  Grey   Light Grey  || Light Grey   Black
  1854.     MENU TEXT     || Dark  Grey   Dark  Cyan  || Black        Rust
  1855.     INDICATORS    || Dark  Red    Light White || Dark  Red    Light Grey
  1856.  
  1857. (Page 35.)
  1858.  
  1859. ====================================
  1860. 4FILES ... ORIGIN & FUTURE EVOLUTION
  1861. ====================================
  1862.  
  1863. 4FILES is coded entirely in assembly language for high speed and small
  1864. size; consequently the work involved has been considerable.  The code is
  1865. is over 840K and 26,000 lines, written entirely in-house.
  1866.  
  1867. The concept arose from the lack in 4DOS of two things.  1)  4DOS has no
  1868. good means to create or edit the file notes it otherwise handles so well,
  1869.  
  1870. and its internal note editor is basic and frustrating to use.  2) while
  1871. 4DOS has its own internal transfer commands (COPY, MOVE and RENAME) which
  1872. automatically keep notes with their files, it does not have a good way to
  1873. perform these operations on marked groups of files.  4DOS unaware
  1874. utilities capable of marked file operations (such as XTREE-PRO) are
  1875. however also unsatisfactory, since they are oblivious to file notes and
  1876. will trash them.  4FILES was designed as a tool to do all of these things
  1877. and more, such as zipping file notes into an archive with their files.
  1878. In addition, every file manager I tried left much to be desired in terms
  1879. of efficiency from the user's viewpoint.  A simple interface packing a lot
  1880. of power has been my goal.
  1881.  
  1882. The 4FILES project is not yet complete.  Future releases will have an
  1883. internal ability to unzip and view archived files, 200-character file
  1884. description ability, a dual-directory workspace for file management, and a
  1885. built-in ability to swap to EMS or XMS memory when calling utilities or
  1886. shelling to DOS.  Your requests for additional features or changes to
  1887. existing ones are very welcome!
  1888.  
  1889.  
  1890. ===========================================================================
  1891.   AGREEMENT -- USE / PAYMENT / DISTRIBUTION / & LICENSING OF "4FILES"
  1892. ===========================================================================
  1893.  
  1894. WHAT YOU GET FOR PAYMENT
  1895. ========================  With registration you receive:  1) The latest
  1896. version of 4FILES and a printed manual;  2) a serial number which allows
  1897. you to brand newer minor releases and the next major version as they
  1898. appear on bulletin boards or at disk vendors <minor versions are also
  1899. optionally available by mail>; 4) a free upgrade to the next major version
  1900. by postal mail or E-mail; 5) related shareware and public domain programs
  1901. to fill the 4FILES disk; and 6) free technical support.
  1902.  
  1903. 4FILES has been a very time consuming project because I have gone to great
  1904. pains both to maximize its convenience and power and to assure protection
  1905. of your data.  Please recognize this effort by paying for your copy
  1906. promptly, and by passing 4FILES on to others who might enjoy it.
  1907.  
  1908.  
  1909. AGREEMENT FOR USE AND DISTRIBUTION
  1910. ==================================  4FILES and its documentation are
  1911. copyrighted intellectual property which are distributed as shareware, and
  1912. may be used or distributed only in compliance with the following terms and
  1913. conditions.  4FILES is neither free nor in the public domain.  All rights
  1914.  
  1915. (Page 36.)
  1916.  
  1917. are reserved worldwide by the author.  Any use of 4FILES constitutes your
  1918. agreement to all provisions herein.
  1919.  
  1920.  
  1921. USE & PAYMENT FOR A SINGLE COMPUTER
  1922. ===================================  Use of 4FILES is free during your
  1923. evaluation period.  This period ends when you begin to use 4FILES for any
  1924. useful work which is not incidental to exploring its capabilities, and may
  1925. not exceed 30-days beyond your acquisition date.  When you use 4FILES for
  1926. the primary purpose of accomplishing useful work (as contrasted to a
  1927. genuine evaluation) you are obligated to do your "share" of the shareware
  1928. arrangement by paying for your copy promptly.
  1929.  
  1930.  
  1931. MULTIPLE USE & SITE LICENSING
  1932. =============================  A site license is required if 4FILES can
  1933. potentially be used simultaneously on more than one computer, terminal or
  1934. workstation in a business, institution, organization, government agency,
  1935. home, etc.   To apply for a license, please fill out the Order Form below
  1936. or 4F_ORDER.TXT.  A sample site license and multiple-copy discount rates
  1937. are contained in the file 4F-SITE.TXT
  1938.  
  1939.  
  1940. DISTRIBUTION OF 4FILES
  1941. ======================
  1942. Distribution by any means is encouraged, provided:
  1943.  
  1944. 1) ... that the distribution includes all original files (see Packing
  1945. List, below) in their unaltered forms and with unaltered filenames, and
  1946. does not include the .CFG file.  If the package is incomplete its
  1947. distribution is prohibited; please contact me for a complete package.  A
  1948. BBS may add a tag file listing it as the source, and disk vendors may add
  1949. introductory or installation batch files.
  1950.  
  1951. 2) ... that, unless a higher figure has been approved in writing, the
  1952. distribution fee does not exceed $8 if 4FILES is distributed alone or $12
  1953. (in 1991 dollars) if it is packed on-disk with other programs.  Commercial
  1954. vendors who are not members of ASP must have written permission to
  1955. distribute.  Please inquire as necessary.
  1956.  
  1957. 3) ... that in any vendor catalog or other publication, it is clearly
  1958. stated that this is shareware and that $30 must be paid to Hand-Crafted
  1959. Software if the program is useful, in addition to the distribution fee (if
  1960. any).
  1961.  
  1962. 4) ... that 4FILES may not be included or bundled with other goods or
  1963. services without express written permission of the author.  Inquiries are
  1964. welcome, and a non-shareware version can be produced for such purposes.
  1965.  
  1966.  
  1967. WARRANTY & DISCLAIMER
  1968. =====================  Any use of 4FILES constitutes your agreement that it
  1969. is provided "as-is" with no express or implied warranty (other than free
  1970. technical support), that you assume full responsibility for assuring that
  1971. it performs acceptably on your system, and that in no event shall Larry
  1972.  
  1973. (Page 37.)
  1974.  
  1975. Edwards, Hand-Crafted Software or their successors be held liable for any
  1976. damages arising from use of the program.
  1977.  
  1978. ----------------------------------------------------------------------------
  1979. I hope you think my soft"wares" are terrific; much extra effort has been
  1980. expended toward that end.  Your payment will be (or is) much appreciated.
  1981. Please let me know of any improvements you would like.
  1982. ----------------------------------------------------------------------------
  1983.  
  1984.  
  1985. ============
  1986. PACKING LIST   (All files except 4F.COM, TV.COM & 4F.PIF
  1987. ============    are readable text files.)
  1988.  
  1989.     4F      .COM   4FILES Program file.
  1990.     4F      .TXT   Full documentation.
  1991.     4F      .HLP   HELP text file.
  1992.     4F      .PIF   Setup file for Windows.
  1993.     4F-I-OS2.ICO   Icon for use with OS/2.
  1994.     4F-I-WIN.ICO   Icon for use with Windows.
  1995.     4F-INSTL.TXT   Detailed installation instructions for DOS.
  1996.     4F-READ .ME    Introductory information, and a word on compatibility.
  1997.     4F-ORDER.TXT   Order Form.
  1998.     4F-PIF  .TXT   How to regenerate your Windows .PIF file, if lost.
  1999.     4F-SITE .TXT   Sample site license & multiple-copy discount rates.
  2000.     4F-TV   .COM   Tiny Viewer, public domain file browser.
  2001.     4F-TV   .TXT   Tiny Viewer documentation.
  2002.     4F-UPDAT.TXT   Changes in current version + 4FILES history.
  2003.     4F-VEND .TXT   Info for SYSOPs & disk vendors.
  2004.     4F-XRAY .BAT   Lets 4FILES call XRAY suite of archive viewers/extractors.
  2005.     FILE_ID .DIZ   Description for BBSs.
  2006.     VENDINFO.DIZ   Info on 4FILES formatted for BBS & disk vendor use.
  2007.  
  2008.                                                                  (More)
  2009.  
  2010.  
  2011. 38.                         4FILES ORDER FORM
  2012.                             =================
  2013.  
  2014.          Larry T. Edwards // Hand-Crafted Software // (907)-747-8996
  2015.              Box 6001 // Sitka, Ak 99835 USA // (FAX)-747-4801
  2016.              CompuServe:72037,3607  INTERNET:edwards@execpc.com
  2017.  
  2018. PAYMENT METHODS:
  2019. 1) By check, International Postal Money Order, cash (use registered
  2020.    mail if sending cash), or company or government purchase order to
  2021.    the above postal address.
  2022.  
  2023. 2) By credit card with our agent: PsL 800-242-4775 or 713-524-6394,
  2024.    fax=713-524-6398, Box 35705 Houston, Tx 77235 (program #10574).
  2025.  
  2026. 3) By credit card with Compuserve: !Go SWREG. (program #912=4FILES,
  2027.    #3504=4FILES-PRO).
  2028.  
  2029.  ===== PLEASE PRINT CLEARLY! =====                     4FILES VERSION 3.30
  2030.  
  2031. Your name: _____________________________________ Position:_________________
  2032.  
  2033. Company: _______________________________________  Phone: (W) ______________
  2034.  
  2035. Street or Box: ___________________________________       (H) ______________
  2036.  
  2037. City/State/Zip: __________________________________  Country: ______________
  2038.  
  2039. E-Mail Addresses: CIS ___________.  INTERNET: _________________
  2040.  
  2041. Send free major upgrade by  __E-mail, __ postal mail (__ 5", __ 3" disk).
  2042.  
  2043. I got 4FILES from (name BBS/vendor/etc):________________, ____________ Forum
  2044.  
  2045. Using 4FILES with:  __ MSDOS  __ Novell-DOS  __Windows  __OS/2  __DV  __DV/X
  2046.              with:  __ a network (type & version __________________________)
  2047.              with:  __ 4DOS   __ NDOS   __COMMAND.COM
  2048.  
  2049. $___  Payment for simultaneous use of 4FILES on one machine or terminal
  2050.       only, for $30.  Price includes printed manual, related shareware &
  2051.       public domain utilities to fill the disk, unlimited free tech
  2052.       support, a free major upgrade, and minor upgrades by download.
  2053.  
  2054. $___  Payment for use of 4FILES on up to ___ computers or terminals.
  2055.       (See the mulitiple-copy discount schedule in the file 4F-SITE.TXT.)
  2056.  
  2057. $___  Upgrade to 4FILES-PRO ($5 per copy).
  2058.  
  2059. $___  As they become available, mail me the next __ minor upgrades ($4 each).
  2060.  
  2061. $___  Shareware copy of latest 4DOS ($4).
  2062.  
  2063. =====
  2064.  
  2065. $___   TOTAL.             Date: _____________
  2066.  
  2067. ===============================================================
  2068. COMMENTS / PROBLEMS / CHANGES & ADDITIONS YOU DESIRE IN 4FILES: (Use back)
  2069. ===============================================================