home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / podstawy / dos / 4dos / 4uzytki / 4utils86.exe / 4UTILS.DOC < prev    next >
Text File  |  1995-07-09  |  33KB  |  917 lines
  1.                                                                    9Jul95
  2.  
  3.                   4      U   U TTTTT I L     SSSSS
  4.                   4  4   U   U   T   I L     S
  5.                   4  4   U   U   T   I L     S
  6.                   4  4   U   U   T   I L      SSS
  7.                   44444  U   U   T   I L         S
  8.                      4   U   U   T   I L         S
  9.                      4   U   U   T   I L         S
  10.                      4   UUUUU   T   I LLLLL SSSSS
  11.  
  12.                  4UTILS - A small 4DOS Utility Collection
  13.  
  14.        Binary created using Turbo Pascal 7.0 (c) Borland International 1992
  15.  
  16.  
  17.        Note: This document has been formatted and is ready for printing.
  18.              (60 lines per page, up to 75 characters per line.)
  19.  
  20.  
  21.  
  22.                  Table of contents:
  23.                  ──────────────────
  24.  
  25.  
  26.          0.   Legal Status, Warranty ............................... 2
  27.          1.   Distribution Policy .................................. 2
  28.          2.   Introduction ......................................... 3
  29.          3.   Getting started ...................................... 4
  30.          4.   4DESC - a simple 4DOS-description editor ............. 5
  31.           4.1  Command line switches and parameters ................ 5
  32.           4.2  Editing and changing descriptions ................... 5
  33.          5.   4FF   - a simple file finder ......................... 7
  34.           5.1  Command line switches and parameters ................ 7
  35.          6.   Customizing 4DESC and 4FF - the 4UTILS.INI file ...... 9
  36.          7.   (Re)Compiling 4DESC or 4FF............................12
  37.          8.   Bugs and Comments.....................................13
  38.          9.   How to reach the authors..............................15
  39.         10.   Acknowledgements......................................15
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.            4UTILS - A small 4DOS Utility Collection              Page 1
  61.  
  62.  
  63.  0. Legal Status, Warranty
  64.  ─────────────────────────────────────────────────────────────────────────
  65.  
  66.  ╔══════════════════════════════════════════════════════════════════════╗
  67.  ║                                                                      ║
  68.  ║ Since 4UTILS is licensed free of charge, the authors, David Frey     ║
  69.  ║ and Tom Bowden, provide absolutely no warranty of any kind, either   ║
  70.  ║ expressed or implied, including, but not limited to, the implied     ║
  71.  ║ warranties of fitness for a particular purpose.                      ║
  72.  ║                                                                      ║
  73.  ║ 4UTILS is provided "as is"; the entire risk as to the quality and    ║
  74.  ║ performance of the program is with you. Should the program prove     ║
  75.  ║ defective, you assume the cost of all necessary servicing, repair    ║
  76.  ║ or correction.                                                       ║
  77.  ║                                                                      ║
  78.  ║ In no event will any copyright holder, or any other party who may    ║
  79.  ║ modify and/or redistribute the program as permitted below, be liable ║
  80.  ║ to you for damages, including any general, special, incidental       ║
  81.  ║ or consequential damages arising out of the use or inability to use  ║
  82.  ║ the program (including but not limited to loss of data or data being ║
  83.  ║ rendered inaccurate or losses sustained by you or third parties or a ║
  84.  ║ failure of the program to operate with any other programs), even if  ║
  85.  ║ such holder or other party has been advised of the possibility of    ║
  86.  ║ such damages.                                                        ║
  87.  ║                                                                      ║
  88.  ╚══════════════════════════════════════════════════════════════════════╝
  89.  
  90.  These programs are freeware: you are allowed to use, copy and change them
  91.  free of charge, when the following conditions are met:
  92.  
  93.  * 4DESC or 4FF may not be sold or hired.
  94.  
  95.  * Never change copyright statements: the copyright remains in our hands.
  96.  
  97.  * If you make any (considerable) changes to the source code, please let
  98.    us know (send us a copy or a listing). We would like to see what you
  99.    have done.
  100.  
  101.  
  102.  1. Distribution Policy
  103.  ────────────────────────────────────────────────────────────────────────
  104.  
  105.  You can distribute these utilities under the following conditions:
  106.  
  107.  * You ask no contribution from the receiver of this package except
  108.    from a nominal copying charge not to exceed US $6. (SFr. 10).
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.            4UTILS - A small 4DOS Utility Collection              Page 2
  121.  
  122.  
  123.  * This archive must be left intact (repacking allowed). That means the
  124.    receiver of this package must receive the following files:
  125.  
  126.    Length  Method   Size  Ratio   Date    Time   CRC-32    Name
  127.    ------  ------   ----  -----   ----    ----   ------    ----
  128.     49296  Deflate  24644  50%  09-07-95  17:50  d1c3fd2f  4desc.exe
  129.     38597  Deflate   8775  77%  09-07-95  17:50  d1ffa4b1  4desc.pas
  130.      1799  Deflate    817  55%  09-07-95  17:50  fe0cdf9e  4desc.txt
  131.     49552  Deflate  24607  50%  09-07-95  17:50  4bafe410  4desc86.exe
  132.     47568  Deflate  22260  53%  09-07-95  19:00  6b56ce04  4ff.exe
  133.     17592  Deflate   5333  70%  09-07-95  19:00  e73a78a9  4ff.pas
  134.      1932  Deflate    812  58%  09-07-95  19:00  33cf4f89  4ff.txt
  135.     47728  Deflate  22222  53%  09-07-95  19:00  2dd040d7  4ff86.exe
  136.     32881  Deflate  11246  66%  09-07-95  17:50  80674160  4utils.doc
  137.      4023  Deflate   1585  61%  09-07-95  17:50  2d5a4fee  4utils.smp
  138.      1997  Deflate    579  71%  09-07-95  17:50  9d8a949e  desc.btm
  139.     22364  Deflate   6181  72%  09-07-95  17:50  e8833674  descript.pas
  140.     12229  Deflate   3687  70%  09-07-95  17:50  4cbc21d9  displayk.pas
  141.      3195  Deflate   1239  61%  09-07-95  17:50  1f60796b  dmouse.pas
  142.       401  Deflate    274  32%  09-07-95  15:38  3bab006d  file_id.diz
  143.      1462  Deflate    666  54%  09-07-95  17:50  515f0ad0  fix.pas
  144.      5842  Deflate   2088  64%  09-07-95  19:00  02be5b7f  globals.pas
  145.      8497  Deflate   2848  66%  09-07-95  17:50  f11584a6  handlein.pas
  146.      1648  Deflate    591  64%  09-07-95  17:50  99f6d947  packing.lst
  147.      9654  Deflate   2991  69%  09-07-95  19:00  1010a54e  scanarjf.pas
  148.      6496  Deflate   1983  69%  09-07-95  19:00  b8477542  scanlzhf.pas
  149.      9160  Deflate   2533  72%  09-07-95  19:00  cdd57f08  scanzipf.pas
  150.     13559  Deflate   3374  75%  09-07-95  17:50  84f8dfaa  stringda.pas
  151.      4692  Deflate   2106  55%  09-07-95  17:50  3212e82c  whats.new
  152.    ------          ------  ---                             -------
  153.    392164          153441  61%                             24
  154.  
  155.  2. Introduction
  156.  ─────────────────────────────────────────────────────────────────────────
  157.  
  158.  4UTILS is a small collection of 4DOS *) utilities. I have created
  159.  them for my needs and I'm releasing them as freeware.
  160.  
  161.  *) 4DOS is a trademark of JP Software Inc,
  162.                            PO Box 1470
  163.                            E. Arlington
  164.                            MA 02174
  165.                            USA
  166.  
  167.  I'm a happy (and registered) user of 4DOS and I could not return to plain
  168.  COMMAND.COM. In course of time I began to write tools which were aware of
  169.  an important 4DOS feature: file descriptions.
  170.  
  171.  These file descriptions are very handy; when I was searching some files
  172.  (with  `FF read.me' for example) I've often missed them. So I decided to
  173.  write a 4DOS aware file finder.
  174.  
  175.  4DESC was written because 4DOS's `describe' is not able of cutting and
  176.  pasting. As a (hobby) programmer, I need this feature quite often, since
  177.  the executables and the source code often get similar descriptions.
  178.  Getting bored of retyping similar descriptions I wrote 4DESC.
  179.  
  180.            4UTILS - A small 4DOS Utility Collection              Page 3
  181.  
  182.  
  183.  3. Getting started
  184.  ─────────────────────────────────────────────────────────────────────────
  185.  
  186.  Installing 4UTILS is simple. Do the following:
  187.  (In this example I assume you install the 4UTILS package in C:\4UTILS;
  188.   please change the directory name if this does not apply.)
  189.  
  190.      i) create a new directory where 4UTILS should reside,
  191.         and change into it:
  192.  
  193.          CDD C:\
  194.          MKDIR 4UTILS (or MD 4UTILS)
  195.          CD 4UTILS
  196.  
  197.     ii) unzip the contents of 4UTILSx.ZIP:
  198.  
  199.          UNZIP C:\TEMP\4UTILSxy.ZIP
  200.  
  201.          ^^^^  ^^^^^^^^      ^
  202.          |     |             |
  203.          |     |             The newest version of 4UTILS, the version
  204.          |     |             number is coded in the last letters,
  205.          |     |             e.g. 4UTILS86.ZIP
  206.          |     |
  207.          |     The directory where 4UTILSxy.ZIP resides
  208.          |
  209.          UNZIP is the unzipper you are using. You can either use UNZIP
  210.          from the InfoZip Group (free) or original PKUNZIP.
  211.  
  212.  
  213.    iii) Append the directory 4UTILS to your path.
  214.  
  215.         ESET PATH
  216.         Press <End> and type ';C:\4UTILS'
  217.  
  218.         or
  219.  
  220.         SET path=%path%;C:\4UTILS
  221.  
  222.  
  223.     iv) Run DESC.BTM to describe your newly extracted files.
  224.  
  225.      v) Adapt (or create) a suitable 4UTILS.INI file, if needed.
  226.         (see section `Customizing')
  227.  
  228.         A sample 4UTILS.INI file has been provided, it's name is
  229.         4UTILS.SMP. It contains the default values 4DESC/4FF would
  230.         use and a few explanations of the parameters.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.            4UTILS - A small 4DOS Utility Collection              Page 4
  241.  
  242.  
  243.  4.   4DESC - a simple 4DOS-description editor
  244.  ─────────────────────────────────────────────────────────────────────────
  245.  
  246.  4.1  Command line switches and parameters
  247.  ─────────────────────────────────────────
  248.  
  249.  The Syntax of 4DESC is : 4DESC [/help] [/mono] [/dontask] [d:][\path]
  250.  
  251.  There are three command line switches:
  252.  
  253.  /help    jumps directly into the help screen, after a key press you can
  254.           start editing.
  255.  
  256.  /mono    4DESC automatically detects on startup whether you are using a
  257.           monochrome or a color monitor. This switch is intended to
  258.           override this detection (useful on EGA/VGA displays only).
  259.  
  260.  /dontask suppresses the `May I save ?' questions. The descriptions will
  261.           always be saved. This feature eases navigation in directory
  262.           trees, but may save unwanted changes too.
  263.  
  264.  When supplying a path specification, 4DESC will read the description file
  265.  residing in the path you specified.
  266.  
  267.  
  268.  4.2  Editing and changing descriptions
  269.  ──────────────────────────────────────
  270.  
  271.  The following keys have special meanings:
  272.  
  273.  Arrow Keys, PgUp, PgDn, Home, End moves bar resp. cursor
  274.  
  275.  Ctrl-PgUp  moves to first line      | Ctrl-PgDn   moves to last line
  276.  Ctrl-Left  moves to previous word   | Ctrl-Right  moves to next word
  277.  Ctrl-Home  deletes from cursor to   | Ctrl-End    deletes from cursor to
  278.             start of line            |             end of line
  279.  Backspace  deletes character        | DEL         deletes character
  280.             before cursor            |             under cursor
  281.  INS        toggles from insert mode |
  282.             to overwrite mode and    |
  283.             vice versa.              |
  284.                                      |
  285.  Alt-D      deletes current          |
  286.             description entirely     |
  287.  Alt-C      copy current description | Alt-M or    move current description
  288.             to buffer 2)             | Alt-T       to buffer 2)
  289.  Alt-P      pastes the buffer to     |
  290.             current description      |
  291.                                      |
  292.  Alt-S or                            |
  293.  Shift-F10  Shell to (4)DOS          |
  294.                                      |
  295.  ESC        Exits 4DESC, i.e. saves  | Alt-X       Exits 4DESC, i.e. saves                                     |
  296.             the descriptions and     |             the descriptions and
  297.             returns to the directory |             stays in the currently
  298.             where it has been started|             selected directory.
  299.             from.                    |
  300.            4UTILS - A small 4DOS Utility Collection              Page 5
  301.  
  302.  
  303.  Alt-Q      Quits 4DESC, i.e.        |
  304.             discards the changes and |
  305.             returns to the original  |
  306.             directory                |
  307.                                      |
  308.  F3 or                               |
  309.  Alt-V      View highlighted file    | Alt-E       Edit highlighted file
  310.  F4 or      Change into highlighted  | F5 or       Change into highlighted
  311.  ENTER on dir directory.             | ENTER on .. directory.
  312.             (one level down)         |             (one level up)
  313.  F6 or                               |
  314.  Alt-L      Change drive             |
  315.                                      |
  316.  Ctrl-N   sort directory by name     | Ctrl-R Ctrl-N reverse sort by name
  317.  Ctrl-E   sort directory by extension| Ctrl-R Ctrl-E reverse sort by ext.
  318.  Ctrl-S   sort directory by size     | Ctrl-R Ctrl-S reverse sort by size
  319.  Ctrl-D   sort directory by date     | Ctrl-R Ctrl-D reverse sort by date
  320.  
  321.  Shift+Cursor selects part of text
  322.  
  323.  Shift+INS  Paste current selection  | Ctrl+INS    Copy   current selection
  324.  Shift+DEL  Cut   current selection  | Ctrl+DEL    Delete current selection
  325.  
  326.  1) A "Edit" flag will appear on the bottom right side of the screen
  327.  2) " "Buf"    "    "    "    "   "     "     "    "   "   "     "
  328.  
  329.  Remark: When changing directories/drives the question
  330.          "Descriptions have been edited. Shall they be saved (Y/N) ?"
  331.          will appear; you need therefore not to worry about your
  332.          description's actuality.
  333.          (should you regard the questions as annoying, use the /dontask
  334.           switch, as described above.)
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.            4UTILS - A small 4DOS Utility Collection              Page 6
  361.  
  362.  
  363.  5.   4FF   - a simple file finder
  364.  ─────────────────────────────────────────────────────────────────────────
  365.  
  366.  5.1  Command line switches and parameters
  367.  ─────────────────────────────────────────
  368.  
  369.  Syntax of 4FF is:
  370.  
  371.  4FF [/a:[[+|]-]rash][/z-alz][/s][/b][/ddesc][/x][/f][/n][/p][/?] [dir] {file}
  372.  
  373.  This time there is a bunch of command line switches, but they are rather
  374.  simple.
  375.  
  376.  /a     followed by a combination of
  377.          r (read only),  -r (not read only)
  378.          a (archive)  ,  -a (not archived)
  379.          s (system)   or -s (not system)
  380.          h (hidden)      -h (not hidden)
  381.  
  382.         searches for files which have these attributes set resp. reset.
  383.  
  384.         Examples:
  385.  
  386.         . 4ff /a:-r *.exe *.com
  387.           searches for executable, writeable files.
  388.  
  389.         . 4ff /a:a *.*
  390.           searches for files which have not been backed up yet.
  391.  
  392.  /zx    do search in the archive type denoted by the letter x. x my be
  393.         one of the following:
  394.             - : do not scan archives at all.
  395.             a : do scan .ARJ archives only
  396.             l : do scan .LZH archives only
  397.             z : do scan .ZIP archives
  398.  
  399.         By default 4FF scans .lzh, .zip and .arj archives, using /zx will
  400.         will speed 4FF up.
  401.  
  402.         Example: 4FF /z- *.bak
  403.  
  404.         Searching for *.bak files in archives is not very intelligent !
  405.  
  406.  /s     scan only subdirectories of given path `start-dir'
  407.  
  408.         4FF will begin scanning the subdirectory you specified in start
  409.         dir and will recurse to the deeper levels. This will speed your
  410.         search up, if you roughly know where your files reside.
  411.  
  412.  /b     bare listing (omits size, date, and descriptions)
  413.  
  414.         This switch is intended for producing "bare" file listing (file
  415.         names only) for batch files or piping into other programs.
  416.  
  417.  
  418.  
  419.  
  420.         4UTILS - A small 4DOS Utility Collection              Page 7
  421.  
  422.  /ddesc Display all files which contain the (sub)string 'desc' in their
  423.         descriptions.
  424.  
  425.  /x     scan all fixed drives (floppy drives excluded)
  426.         Example: 4FF /x *.bak *.swp *.tmp
  427.  
  428.         Locates backup, swap and temporary files, which generally may be
  429.         deleted before backing up your hard disk.
  430.  
  431.  /f     similar to /x but scans all drives (floppy drives included)
  432.  
  433.  /m:nn  set right margin to nn.
  434.         When printing direct to your line printer, you can set the printer
  435.         width by this switch.
  436.  
  437.         Example: 4FF /m:132 *.pas > prn:
  438.  
  439.         [Note: Putting your printer in 132 column mode is your duty!]
  440.  
  441.  /p     page output
  442.  
  443.         pages the output, i.e. prints a "-- more --" message and waits for
  444.         key to be pressed.
  445.  
  446.  /?     shows a small help display.
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.            4UTILS - A small 4DOS Utility Collection              Page 8
  481.  
  482.  
  483.  6.   Customizing 4DESC and 4FF - the 4UTILS.INI file
  484.  ─────────────────────────────────────────────────────────────────────────
  485.  
  486.  This section is only for people interested in customizing 4FF or 4DESC.
  487.  You need not to worry about all the options described below if you "just"
  488.  want to use 4DESC/4FF _and_ if you are happy with the country settings
  489.  and the colors.
  490.  If you are familiar with the SSTOOLS.INI file (as a FRACTINT or PICLAB
  491.  user) or if the 4DOS.INI has already been changed by you, you shouldn't
  492.  have problems with the 4UTILS.INI file.
  493.  A 4UTILS.INI file consists of several sections, enclosed in square
  494.  brackets ([ and ]). The case of the keywords is (at least for 4DESC/4FF)
  495.  not relevant.
  496.  
  497.  Remark: The following examples have been taken out of 4UTILS.SMP - a
  498.          sample 4UTILS.INI file.
  499.  
  500.  In this release a new feature has been introduced (thanks to Jorj Strumolo
  501.  for this suggestion):
  502.   The 4DOS.INI file will be evaluated too, so you are allowed to place all
  503.   this stuff into the 4DOS.INI file too (instead of creating a separate
  504.   4UTILS.INI file)
  505.   [ but you should use 4DOS version 5.0 or above, the old version does not
  506.     (officially) support the presence of "foreign" sections. It may support
  507.     it unofficially, but this has not been tested. ]
  508.  
  509.  To be precise, 4DESC reads first the contents of the 4DOS.INI file (first
  510.  searched in the directory where 4DOS resides (via COMSPEC) and then in the
  511.  root directory of the boot drive, i.e C:\). Afterwards the contents of the
  512.  4UTILS.INI file (searched in the directory where 4DESC/4FF has been star-
  513.  ted from, in the path or via the 4UTILS-environment variable) will be
  514.  appended. The consequence is, that you can put 4DOS-Statements in a
  515.  4UTILS.INI file (e.g. ampm, Editmode, CursorIns, CursorOver etc). This
  516.  "trick" is handy for 4DOS 4.02 users, who want to set the EditMode
  517.  variable.
  518.  
  519.  I suggest you one of the following strategies:
  520.  0) Live with the defaults.
  521.  
  522.  1) put everything into a 4UTILS.INI file and forget 4DOS.INI.
  523.     Put the 4UTILS.INI file in the same directory where 4UTILS resides or
  524.     set the 4UTILS environment variable.
  525.  
  526.     If you are working on a (hard)diskless PC or if you are the network
  527.     administrator you'll prefer this method. Reason for this strategy:
  528.     it is not always easy to locate the "right" 4DOS.INI file in a net-
  529.     worked environment, since it is not easy to tell where it resides (The
  530.     question is, where 4DOS looked for it settings, there is even the
  531.     possibility to put the @4dos.ini-entry into CONFIG.SYS!)
  532.  
  533. 2) On a stand-alone PC running 4DOS 5.0 you can put the settings into the
  534.    4DOS.INI file. You may even split the information into a 4DOS.INI-part
  535.    and into a 4UTILS.INI part.
  536.  
  537. 3) Recompile 4DESC/4FF with the proper settings (cf Chapter 7)
  538.  
  539.  
  540.            4UTILS - A small 4DOS Utility Collection              Page 9
  541.  
  542.  [DateAndTimeFormats]
  543.  
  544.  ! The section title has been renamed from [Date & Time Formats]. This was
  545.  ! necessary to appease the 4DOS parser (Sorry, but you may have to change
  546.  ! your .INI file)
  547.  
  548.  The following entries are possible:
  549.  
  550.  DateFormat = mmddyy |  ddmmyy | yymmdd | ddMMMyy
  551.               7.10.92, 10-07-92, 92/10/7,  7Oct92.
  552.  
  553.  DateSep   = -
  554.  
  555.  Date separator is a hyphen (mm-dd-yy)
  556.  
  557.  TimeFormat= 12
  558.  
  559.  valid entries are: 12 (am/pm) or 24 (24 hours).
  560.  (you can also use 4DOS's am-Flag)
  561.  
  562.  TimeSep   = :
  563.  
  564.  Time separator is a colon  (hh:mm). Fill in what you like.
  565.  
  566.  MilleSep  = '
  567.  
  568.  Fill in what you like for the thousands separator.
  569.  
  570.  NOTE: 4DESC / 4FF detect on startup where you live. (provided that
  571.        your COUNTRY= settings in CONFIG.SYS has been properly set.)
  572.        The switches above are merely cosmetic.
  573.  
  574.  [ColorDisplay]
  575.  
  576.  That is the place where you may change the colors!
  577.  The following colors are available (case not significant)
  578.  
  579.   Black    , DarkGray
  580.   Blue     , LightBlue
  581.   Green    , LightGreen
  582.   Cyan     , LightCyan
  583.   Red      , LightRed
  584.   Magenta  , LightMagenta
  585.   Brown    , Yellow
  586.   LightGray, White
  587.  
  588.  StatusFg = Blue         ; Status line foreground color
  589.  StatusBg = Cyan         ;   "      "  background   "
  590.  DirFg    = LightBlue    ; Directories are shown in DirFg on NormBg
  591.  SelectFg = Blue         ; Select bar foreground color
  592.  SelectBg = Cyan         ;   "     "  background   "
  593.  HighFg   = LightRed     ; Highlighted foreground,
  594.                            used for "Edit" and "Cut" marks
  595.  NormFg   = LightGray    ; normal foreground color
  596.  NormBg   = Blue         ;   "    background   "
  597.  WarnFg   = Yellow       ; foreground for warning messages.
  598.  WarnBg   = Cyan         ; background  "     "       "
  599.  
  600.            4UTILS - A small 4DOS Utility Collection              Page 10
  601.  
  602.  [MonoDisplay]
  603.  
  604.  The same for monochrome displays...
  605.  
  606.  StatusFg = Black
  607.  StatusBg = LightGray
  608.  DirFg    = White
  609.  SelectFg = Black
  610.  SelectBg = LightGray
  611.  HighFg   = LightGray;
  612.  NormFg   = LightGray
  613.  NormBg   = Black
  614.  WarnFg   = Black
  615.  WarnBg   = White
  616.  
  617.  [GeneralDisplay]
  618.  
  619.  Justify= Left | Left.Left | Right.Left
  620.  
  621.  Determines the arrangement of the filenames and their extensions.
  622.  Left      = xxxxxx.yyy
  623.  Left.Left = xxxxxx  .yyy
  624.  Right.Left=   xxxxxx.yyy
  625.  
  626.  ! This variable replaces the old LeftJust = Y|N entry.
  627.  
  628.  FullSize = Yes | No | Y | N
  629.  
  630.  Set FullSize=Y to get the `full' size display (x'xxx'xxx [Bytes])
  631.  instead of  (xxxK).
  632.  
  633.  Viewer = any-viewer-you like
  634.  
  635.  Let Viewer point to your favorite viewer (defaulting to list).
  636.  
  637.  Editor = any-editor-you prefer
  638.  
  639.  The same settings for your favourite editor (default: edit), but I
  640.  suggest TPE (Turbo Powers Editor).
  641.  
  642.  Hidden = Yes | No | Y | N
  643.  
  644.  Setting Hidden=Y enables display of hidden files. System files have the
  645.  hidden attribute often set, so be sure to turn the Hidden=Yes line, if
  646.  you plan to describe system files.
  647.  
  648.  SortCriteria= name    | ext     | size     | date     |
  649.                rev-name| rev-ext | rev-size | rev-date
  650.  
  651.  Sets the (initial) sort criterion for 4DESC. Defaults to name.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.            4UTILS - A small 4DOS Utility Collection              Page 11
  661.  
  662.  [Misc]
  663.  
  664.  Delimiters=<list of separators>
  665.  Delimiters=,.();:-!?/[]{}+*='`"@%&$_£
  666.  
  667.  This separator list is used by the Ctrl-Left, Ctrl-Right algorithm.
  668.  
  669.  PasteMovesToNextIndex= Y | N
  670.  
  671.  When pasting a description line, the bar "normally" moves to the next line
  672.  (this ist at least the old behaviour). Set PasteMovesToNextIndex=No to
  673.  suppress this.
  674.  
  675.  [Mouse]
  676.  
  677.  UseMouse = Y | N
  678.  
  679.  Switch the mouse autodetect off. Set UseMouse=N if you have a mouse
  680.  connected, but do not want to use it.
  681.  
  682.  VMickeysPerKeyPress = 2
  683.  HMickeysPerKeyPress = 2
  684.  
  685.  These 2 parameters control the "jumpiness" of the cursor when using the
  686.  mouse. The cursor follows the mouse movements in x- or y-direction when
  687.  more than VMickeysPerKeypress in x resp HMickeysPerKeypress in y direction
  688.  were made.
  689.  
  690.  NOTE: These two parameters are _hardware-dependent_, strictly speaking
  691.        speed dependent. Play around with these values till you get a
  692.        smooth scrolling.
  693.  
  694.  
  695.  The following parameters are originally 4DOS parameters and are typically
  696.  found in a 4DOS.INI file. They can nevertheless exist in a 4UTILS.INI file,
  697.  but then they count only for 4DESC/4FF. Put them in a blank section or in
  698.  a [primary] section.
  699.  
  700.  ampm = y | n
  701.  EditMode = Insert | Overstrike
  702.  CursorOver = nnn
  703.  CursorIns  = nnn
  704.  
  705.  Please refer to 4DOS's help for further explanation of the meaning.
  706.  
  707.  [4FF]
  708.  
  709.  These options concern only 4FF.
  710.  
  711.  DoPage = Yes | No | Y | N
  712.  
  713.  Set DoPage = Y if you want to have permanent paging.
  714.  (Remark: Redirecting output is still allowed, in this case the paging
  715.           parameter will be ignored.)
  716.  
  717.  HilightMore = Yes | No | Y | N
  718.  
  719.  Choose whether to hilights the "-- more --" message (Y) or not (N).
  720.             4UTILS - A small 4DOS Utility Collection              Page 12
  721.  
  722.  7. (Re)Compiling 4DESC or 4FF
  723.  ─────────────────────────────────────────────────────────────────────────
  724.  
  725.  Some hints about (re)compiling 4DESC or 4FF:
  726.  (Recompiling 4DESC might be useful if you want to change the default
  727.   colors *and* want to save the space a 4UTILS.INI file would occupy.)
  728.  
  729.  . 4DESC and 4FF have been written in Turbo Pascal 7.0
  730.  . They use the features Turbo Pascal 7.0 provides, i.e.
  731.  
  732.    * Inline Assembling ( ASM ... END )
  733.  
  734.      If you don't have an inline assembler, recode the parts containing
  735.      ASM-statements.
  736.  
  737.  ! * The description handling is done in the DESCRIPT.PAS unit.
  738.  !   It uses a TSortedCollection to maintain a sorted list of directory
  739.  !   entries plus their corresponding descriptions.
  740.  !
  741.  !   This unit is used both from 4DESC and 4FF.
  742.  !
  743.  !   It would be hard work to throw out the object-oriented part:
  744.  !   You'd have to rewrite the whole unit.
  745.  
  746.    * 4FF uses the FormatStr-procedures, that implies the following:
  747.  
  748.      4FF uses the Objects and the Drivers-Unit shipped with Turbo Pascal
  749.      6.0/7.0 sinces it uses the FormatStr procedure. (FormatStr is hidden
  750.      in the Drivers unit, which needs Objects in order to work).
  751.  
  752.    * The TEST286.PAS unit shipped with Turbo Pascal 6.0/7.0 is needed to
  753.      detect the processor type. This is used in conjunction with the {$G+}
  754.      compiler directive to prevent lock ups on PCs and XTs.
  755.  
  756.      Remove the G+ directive, if you don't have (or find ;-) the
  757.      TEST286.PAS unit.
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.             4UTILS - A small 4DOS Utility Collection              Page 13
  781.  
  782.  
  783.   8. Bugs and Comments
  784.   ─────────────────────────────────────────────────────────────────────────
  785.  
  786.   Known bugs, comments and deficiencies:
  787.  
  788.   . Non-standard VGA-modes are now supported by 4DESC (Thanks to Robert
  789.     Juhasz for his FIX.PAS!)
  790.     However, you may encounter problems with your ANSI.SYS driver under DOS.
  791.     (I, David, had the usual trouble with the DOS-5.0 ANSI.SYS when running
  792.      an 132x60 screen - the driver recognized only 25 rows.)
  793.  
  794.   . Diacritics in filenames are not handled in a logical way: they are not
  795.     down-cased. This is necessary for DOS; if they were down-cased (in the
  796.     description file) DOS/4DOS would not find the corresponding description
  797.     line anymore! This deficiency is not relevant for english-speaking people,
  798.     and it should not be relevant for the others too; special characters in
  799.     DOS filenames are not a good idea, anyway. (It is not guaranteed how
  800.     DOS treats special-characters in filenames, legal DOS filenames consist
  801.     of the letters A-Z plus the characters "!#$%&'()-@^_`{}" and "~".
  802.     4DOS (and other programs) use "%^@()" and "`" internally, so they should
  803.     be avoided.)
  804.  
  805.   . 4DESC does not support file filtering (e.g. `4desc *.pas'). It would be
  806.     awkward to implement this. It is not as easy as it looks: Currently I'm
  807.     reading the whole directory and the whole description file. Fine.
  808.     Masking out some directory entries is easy, but what happens with the
  809.     excess descriptions ? On the one hand, they must be read in, or you'll
  810.     loose descriptions, on the other hand, they should not be displayed
  811.     (the user supplied *.pas, so (s)he doesn't want to see the descriptions
  812.     for the *.bak files). To make things more complicated, the indexing -
  813.     on the screen - is done directly; if you introduce a visible switch
  814.     4DESC would loose its speed.
  815.  
  816.     Since I have implemented sorting, is file filtering IMO superfluous.
  817.  
  818.   . I'm not going to write yet another Norton Commander, so if you really
  819.     want to delete or rename files in 4DESC go ahead, but do not forget
  820.     to change the description file.
  821.  
  822.   If you find any bugs not listed above drop us a note. Please
  823.   describe your system you are working on (which CPU, 4DOS version
  824.   specialities etc).
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.             4UTILS - A small 4DOS Utility Collection              Page 14
  841.  
  842.  
  843.   9. How to reach the authors
  844.   ─────────────────────────────────────────────────────────────────────────
  845.  
  846.   Our addresses are:
  847.  
  848.   David Frey,               &   Tom Bowden
  849.   Urdorferstrasse 30            1575 Canberra Drive
  850.   8952 Schlieren ZH             Stone Mountain, GA 30088-3629
  851.   Switzerland                   USA
  852.  
  853.   eMail:                        eMail:
  854.   david@eos.uu.ch               73247.3571@compuserve.com
  855.  
  856.  
  857.   10. Acknowledgements
  858.   ─────────────────────────────────────────────────────────────────────────
  859.  
  860.   The following people - in alphabetical order - helped to improve 4DESC
  861.   resp. 4FF by supplying suggestions, bug reports and hints.
  862.  
  863.   Gateau Alain                     - Empty Drive bug.
  864.   Jan Brentved                     - 4FF Piping bug. (4ff 1.83 was not able
  865.                                      to pipe its output into LIST/s)
  866.   Peter C. Broekhuizen             - Arrow right stops after last character.
  867.                                    - Arrow left scrolls as last as possible
  868.                                    - Display of current column
  869.                                    - Cut & Paste via shift-keys.
  870.   Miguel Farah F.                  - ^Home erases from cursor to beginning
  871.                                      of line,
  872.                                    - ^PgUp moves bar to .. instead of .
  873.                                    - Querier mode suppresses save-messages.
  874.                                    - suggested Sorting
  875.   Charles Goldie                   - reported bugs in the localisation code
  876.                                    - suggested that entabbing of 4utils.ini
  877.                                      should be allowed
  878.   Robert Juhasz                    - contributed his FIX.PAS unit in order
  879.                                      to support the Super VGA modi.
  880.   Tobias Oetiker                   - inspired me to put this software on the
  881.                                      net.
  882.   José Joäo Colen Marques da Silva - suggested Sorting (among others)
  883.   Jorj Strumolo                    - ESC escapes into startup directory,
  884.                                      while Alt-X exits into the selected one.
  885.                                    - Overstrike, Block cursor question.
  886.                                    - Additional reading in the 4DOS.INI file
  887.                                    - suggested Sorting
  888.   Antti J Tuominen                 - suggested the /d flag in 4FF: /d scans
  889.                                      the descriptions for a given string.
  890.                                    - pointed out that the scrolling in 4DESC
  891.                                      wasn't coherent (jumpy scrolling up vs.
  892.                                      smooth scrolling down)
  893.   Andreas Tranquillini             - beta testing and editing improvements
  894.                                    - Justify options
  895.                                    - UseMouse switch
  896.                                    - and a lot more...
  897.  
  898.  
  899.  
  900.             4UTILS - A small 4DOS Utility Collection              Page 15
  901.  
  902.   Silvano Sgrignoli                - /x switch,
  903.                                    - single drive support
  904.                                    - /h supersedes any options
  905.                                    - no scan inside archives when looking
  906.                                      for descriptions
  907.   Frank Zago                       - Range bug in 4FF,
  908.                                    - directory name parsing
  909.   pi                               - Insert/Overwrite cursor question
  910.                                    - BUG: When a description is empty,
  911.                                      pressing the right key moves one
  912.                                      position left.
  913.                                    - .INI file will be read in dynamically,
  914.                                      so it can be as big as 64KB.
  915.  
  916.   ...and other people I forgot to mention.
  917.