home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1587 / xff.doc < prev    next >
Encoding:
Text File  |  1992-04-30  |  19.5 KB  |  421 lines
  1.  
  2.  
  3.              EEEEE  X   X  TTTTT  EEEEE  N   N  DDDD   EEEEE  DDDD
  4.              E       X X     T    E      NN  N  D   D  E      D   D
  5.              EEEE     X      T    EEEE   N N N  D   D  EEEE   D   D
  6.              E       X X     T    E      N  NN  D   D  E      D   D
  7.              EEEEE  X   X    T    EEEEE  N   N  DDDD   EEEEE  DDDD
  8.  
  9.                            FFFFF  IIIII  L      EEEEE
  10.                            F        I    L      E
  11.                            FFFF     I    L      EEEE
  12.                            F        I    L      E
  13.                            F      IIIII  LLLLL  EEEEE
  14.  
  15.                     FFFFF  IIIII  N   N  DDDD   EEEEE  RRRR
  16.                     F        I    NN  N  D   D  E      R   R
  17.                     FFFF     I    N N N  D   D  EEEE   RRRR
  18.                     F        I    N  NN  D   D  E      R  R
  19.                     F      IIIII  N   N  DDDD   EEEEE  R   R
  20.  
  21.  
  22.          XFF - THE ultimative and very fast File- and Directory-Finder
  23.  
  24.  
  25.                            D O C U M E N T A T I O N
  26.                            ─────────────────────────
  27.                                     for the
  28.  
  29.                         ┌─────────────────────────────┐
  30.                         │ EXTENDED-FILE-FINDER  (XFF) │
  31.                         │ Version: 1.50.A  01.02.1992 │
  32.                         │ Revision 1.50.D  01.05.1992 │
  33.                         └─────────────────────────────┘
  34.  
  35.                                  (C) 1989-1992
  36.                          MDI Maikel-Data International
  37.                             Postlagerkarte 094360 E
  38.                               D-7000 Stuttgart-10
  39.                                 Germany, Europe
  40.  
  41.                      ─────────────────────────────────────
  42.                             █▀▀▀▀▀▀▀▀▀▀▀▀▀ █ ▀ ▀▀█
  43.                             █ ▀█▀▀█▀▀█ █▀▀▀█ █   █
  44.                             █  █  ▀  █ █▄▄▄█ █▄▄ █
  45.                             █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  46.                      ─────────────────────────────────────
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.          The latest (current) MDI-program-versions may be ordered at :
  54.          Public Brand ■ 3750 Kentucky A.■ Indianapolis, IN 46241 ■ USA
  55.          PC-SIG ■ 1030 D East Duane Avenue ■ Sunnyvale, CA 94086 ■ USA
  56.          CDV Shareware ■ Ettlinger Str. 5 ■ D-7500 Karlsruhe ■ Germany
  57.          PD-Service Lage ■ Postfach 1743 ■ D-4937 Lage/Lippe ■ Germany
  58.          _____________________________________________________________
  59.          XFF V.1.50                  - 1 -           (C) 1989-1992 MDI
  60.  
  61.          ABBREVIATIONS used in this documentation :
  62.          ─────────────────────────────────────────────────────────────
  63.          MDI = Maikel-Data International    XFF = Extended-File-Finder
  64.  
  65.  
  66.          SYSTEM-REQUIREMENTS :
  67.          ─────────────────────────────────────────────────────────────
  68.          XFF  is designed  to run  on an  IBM PC/XT/AT/386/486/...  or
  69.          100%-compatible microcomputer with any graphics-adapter,  one
  70.          floppy-disk-drive and 256 kBytes of RAM.
  71.          XFF requires operating-systems MS-DOS / PC-DOS 2.00 or later.
  72.  
  73.  
  74.          DISCLAIMER :
  75.          ─────────────────────────────────────────────────────────────
  76.          XFF IS LICENSED  "AS IS"  WITHOUT ANY WARRANTIES OF MERCHANT-
  77.          ABILITY OR  FITNESS FOR A  PARTICULAR PURPOSE.   ABSOLUTE ALL
  78.          WARRANTIES ARE EXPRESSLY DISCLAIMED. IN NO EVENT SHALL MDI BE
  79.          LIABLE FOR INDIRECT OR CONSEQUENTIAL DAMAGES ARISING FROM THE
  80.          USE OF XFF. YOU ARE USING XFF ON YOUR OWN RISK !
  81.  
  82.  
  83.          GENERAL REMARKS about (c)opyright and distribution :
  84.          ─────────────────────────────────────────────────────────────
  85.          XFF (with documentation) is (c)opyrighted work and NOT in the
  86.          Public-Domain. All rights reserved worldwide !   You must not
  87.          decompile, disassemble, reverse-engineer or modify XFF in any
  88.          way. This document has to be distributed always together with
  89.          the executable file XFF.EXE. This document and the executable
  90.          file may be changed by MDI at any time without an indication.
  91.  
  92.          XFF is   N O T   (!) for sale, it is absolute free of charge.
  93.          If  SW-/PD-VENDORS  are interested in distributing  XFF,  the
  94.          charges for distribution MUST NOT exceed US$ 10.00 per disk !
  95.          If you find XFF of value, please distribute it free and share
  96.          it with all your friends.
  97.          ! Copying XFF into mailboxes, BBS's and ftp-servers welcome !
  98.  
  99.  
  100.          SUGGESTIONS - DONATIONS - PROBLEMS :
  101.          ─────────────────────────────────────────────────────────────
  102.          Because we (MDI) do not raise any fee (!!!) for using our XFF
  103.          we have an urgent entreaty to YOU :
  104.          Please drop us a notice  from where you received our program.
  105.          This in no circumstance for you, but your notice give us very
  106.          important information  where people  know about our program !
  107.          You  can  help  us  improving  XFF  by  sending  suggestions,
  108.          discovered problems or new ideas.  AND of course you may send
  109.          us donations(), they'll be GREATLY appreciated (see app. E).
  110.          Please send all messages and contributions () to :
  111.  
  112.          █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█   The last page of this document
  113.          █           MDI            █   is a - if you want anonymous -
  114.          █  Postlagerkarte 094360E  █   "registration-form".    Please
  115.          █   D-7000 Stuttgart - 1   █   fill out this page and send it
  116.          █     Germany / Europe     █   back to MDI.
  117.          █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█                      Thank you !
  118.          _____________________________________________________________
  119.          XFF V.1.50                  - 2 -           (C) 1989-1992 MDI
  120.  
  121.          XFF USAGE and ADVANTAGES :
  122.          ─────────────────────────────────────────────────────────────
  123.          Purpose : XFF checks the indicated  disk(s) / path  very fast
  124.                    to find any of the specified entries.   You may use
  125.                    the  wildcards  "*" and "?"  to specify the entries
  126.                    you want XFF to search for (refer appendix B, too).
  127.                    If desired, XFF looks inside archived files to find
  128.                    the specified entries.  Please refer appendix D for
  129.                    the supported archiving-programs.
  130.  
  131.                    In most PC-NETWORKS, XFF will work proper and fast.
  132.  
  133.          You may interrupt XFF with any keystroke.  An interruption is
  134.          indicated with a big cursor (█).  Any next keystroke instruct
  135.          XFF to continue. XFF may be aborted with [ESC] or [CTRL-C] at
  136.          any time.
  137.  
  138.          XFF reports the results  in one of the  following languages :
  139.              - English            - French               - German
  140.          The convenient  language  will be detected automatically, but
  141.          you may choose an other language with the parameter /Mcode.
  142.  
  143.          XFF offers the possibility to redirect the output into a file
  144.          or to a printer. Please refer appendix A for more details.
  145.  
  146.  
  147.          General remarks :
  148.          ─────────────────────────────────────────────────────────────
  149.          XFF  always  starts  in the  root-directory [:\]  if there is
  150.          nothing other indicated.  With parameter /P  you may instruct
  151.          XFF to start in the current directory. But it's also possible
  152.          to start XFF in any path on any drive.
  153.          Example : C:\OTTO > XFF d:\back\*.bak
  154.          So XFF begins to search for entries in  D:\BACK.   XFF always
  155.          shows the name of momentary examined path/file on the screen.
  156.  
  157.          The text-retrieval-algorithm used with parameter /R,  will be
  158.          optimized in a future version.
  159.  
  160.  
  161.          Annotation to the statistics-output :
  162.          ─────────────────────────────────────────────────────────────
  163.          The significances of the symbols F, A and S are
  164.          F : number of files including archived files
  165.          A : number of files STORED INSIDE archived files
  166.          S : number of subdirectories
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.          Please notice :  some of the following parameter-combinations
  177.          are senseless, e.g. /O with /S,/R or /S with /F,/C,/L etc ...
  178.          _____________________________________________________________
  179.          XFF V.1.50                  - 3 -           (C) 1989-1992 MDI
  180.  
  181.          XFF INPUT-PARAMETERS :
  182.          ─────────────────────────────────────────────────────────────
  183.          ┌───────────────────────────────────────────────────────────┐
  184.          │  Usage : XFF [drive:][\][path\] [name.ext] [S] [> Redir]  │
  185.          └───────────────────────────────────────────────────────────┘
  186.  
  187.            [drive:]  drive to search on
  188.          [\][path\]  path  to search in
  189.          [name.ext]  what to search for   (for wildcards refer app. B)
  190.  
  191.           [> Redir]  output-redirection     (redirection refer app. A)
  192.  
  193.                 [S]  switches to be set :
  194.  
  195.          ─────────────────────────────────────────────────────────────
  196.  
  197.             /A[list] : search  on all  [listed]  existing  DOS-drives.
  198.  
  199.             /C       : make a  CRC-calculation  with all  found files.
  200.  
  201.             /H       : show help-screen.
  202.  
  203.             /H+      : show license-screen -----> PLEASE READ THIS !!!
  204.  
  205.             /I       : search only for "invisible" entries, this means
  206.                        only entries with hidden- or system-attributes.
  207.  
  208.             /L       : look also in archived files.
  209.  
  210.             /O       : look only in archived files.
  211.  
  212.             /E[spec] : show  exact  the  [specified]  contents  of one
  213.                        archived file    (notice : only one is allowed)
  214.  
  215.             /Mcode   : modify the output-language of XFF, where
  216.                                  code = 33 means French language and
  217.                                  code = 49 means German language.
  218.                        Any other code = means English language.
  219.  
  220.             /P       : start search in present  (= current) directory.
  221.  
  222.             /Rtext   : search only for files  containing the specified
  223.                        text. With /R, a text MUST be specified (blanks
  224.                        are prohibited inside this text).
  225.  
  226.             /F       : search  only  for files  (not for directories).
  227.  
  228.             /S       : search  only  for directories  (not for files).
  229.  
  230.             /T       : toggle  the format of the  output-date  between
  231.                        MM-DD-YYYY and TT.MM.JJJJ.
  232.  
  233.             /D+|-|=MM-DD-YYYY : search only entries, where the date is
  234.                        newer (+) than MM-DD-YYYY or
  235.                        older (-) than MM-DD-YYYY or
  236.                        same  (=) as   MM-DD-YYYY.
  237.  
  238.          _____________________________________________________________
  239.          XFF V.1.50                  - 4 -           (C) 1989-1992 MDI
  240.  
  241.          XFF EXAMPLE-CALLS :
  242.          ─────────────────────────────────────────────────────────────
  243.  
  244.          XFF                        : search for *.* on current drive.
  245.  
  246.          XFF /H                     : show the main help-screen.
  247.  
  248.          XFF /H+                    : show important license-screen.
  249.  
  250.          XFF ?af.*                  : search entries matching ?af.*
  251.  
  252.          XFF f:                     : search for *.* on drive F:
  253.  
  254.          XFF d:\test\               : search for *.* in path D:\TEST
  255.  
  256.          XFF /L                     : search for *.* on current drive
  257.                                       and in all archived files.
  258.  
  259.          XFF *.da /O                : search for *.da only in archived
  260.                                       files on current drive.
  261.  
  262.          XFF c:\xyz.zip /E          : show exact the complete contents
  263.                                       of the archived file c:\xyz.zip
  264.  
  265.          XFF c:\xyz.zip /E*.bak     : show all files matching *.bak in
  266.                                       the archived file c:\xyz.zip
  267.  
  268.          XFF *.com /I               : search for  "invisible"  entries
  269.                                       matching *.com on current drive.
  270.  
  271.          XFF *.exe /P /C            : search for *.exe in present path
  272.                                       and make CRC-test to found files
  273.  
  274.          XFF a*.* /S                : search a*.* directory-entries.
  275.  
  276.          XFF *.bat /A               : search *.bat on all dos-drives.
  277.  
  278.          XFF *.bat /Aabdg           : searche for *.bat on dos-drives
  279.                                       A:, B:, D: and G:
  280.  
  281.          XFF s*.exe /R(C)           : search for all files matching
  282.                                       *.exe and containing text "(C)".
  283.  
  284.          XFF *.cfg /D+12-31-1991    : search for *.cfg, where the date
  285.                                       is newer than "12-31-1991".
  286.  
  287.          XFF *.gfx /T /N            : search for *.gfx, do not scan
  288.                                       subdirs, toggle the date-format.
  289.  
  290.          XFF /M1                    : set output-language to English.
  291.  
  292.          XFF /M33                   : set output-language to French.
  293.  
  294.          XFF /M49                   : set output-language to German.
  295.  
  296.          XFF *.bak > prn            : search for  *.bak  and send the
  297.                                       output to the printer.
  298.          _____________________________________________________________
  299.          XFF V.1.50                  - 5 -           (C) 1989-1992 MDI
  300.  
  301.          APPENDIX A - explanation of [> Redir] :
  302.          ─────────────────────────────────────────────────────────────
  303.          XFF allows you to "redirect" the output.   In the description
  304.          above, it's called  [> Redir].  This means,  you may send the
  305.          output into a file or direct to your printer.
  306.          [> Redir] into any file :       > [drive:\path\] filename.ext
  307.          [> Redir] to a printer  :       > prn
  308.  
  309.          Example: XFF *.* > a:\otto\result.dat     (output into  file)
  310.                   XFF d:\otto\*.pif > prn          (output to printer)
  311.  
  312.  
  313.          APPENDIX B - explanation of wildcards "*" and "?" :
  314.          ─────────────────────────────────────────────────────────────
  315.          The "*" wildcard means ignore all characters to the right and
  316.          the "?" wildcard means any character in that position is in a
  317.          match.
  318.          Example : *.bak  :  any  filename  with the extension of .bak
  319.                    ?.*    :  filename with one char. and any extension
  320.                    ??.??  :  filename and extension with two charcters
  321.  
  322.  
  323.          APPENDIX C                             █▀▀▀▀▀▀▀▀▀▀▀▀▀ █ ▀ ▀▀█
  324.          ──────────                             █ ▀█▀▀█▀▀█ █▀▀▀█ █   █
  325.                                                 █  █  ▀  █ █▄▄▄█ █▄▄ █
  326.          Copyrights / Trademarks :              █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  327.          ─────────────────────────────────────────────────────────────
  328.          IBM PC/XT/AT  - IBM International Business Machines
  329.          PC-DOS        - IBM International Business Machines
  330.          MS-DOS        - Microsoft Corporation
  331.          MDI and logo  - MDI Maikel-Data International
  332.          ─────────────────────────────────────────────────────────────
  333.  
  334.  
  335.          APPENDIX D - ARCHIVING-PROGRAMS supported by XFF :
  336.          ─────────────────────────────────────────────────────────────
  337.          *.ARC : PKARC 3.50/3.60, PKPAK 3.61           (C) PKWARE Inc.
  338.          *.ARJ : ARJ 2.00/2.20                         (C) Robert Jung
  339.          *.ICE : LHICE 1.14                            (C) H.Yoshizaki
  340.          *.LZH : LHARC 1.13, LHA 2.10/2.12             (C) H.Yoshizaki
  341.          *.PAK : PAK 2.51                              (C) NoGate Con.
  342.          *.ZIP : PKZIP 1.02/1.10                       (C) PKWARE Inc.
  343.          *.ZOO : ZOO 2.01/(2.10)                       (C) Raul  Dhesi
  344.          ─────────────────────────────────────────────────────────────
  345.  
  346.  
  347.          APPENDIX E - contributions and donations :
  348.          ─────────────────────────────────────────────────────────────
  349.          The employment of XFF is absolute free of charge for you ....
  350.                                  ... BUT :
  351.          If you find XFF of value,  you may send MDI a donation, maybe
  352.          US$ 10.00 (≈DM 15.-) [or more ?]. YOUR financial support will
  353.          help us improving XFF and other software-products.
  354.  
  355.                 ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !
  356.                 ! !  Thank YOU very much  for YOUR support  ! !
  357.                 ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !
  358.          _____________________________________________________________
  359.          XFF V.1.50                  - 6 - [EOF]     (C) 1989-1992 MDI
  360.  
  361. ------------------- please cut here, fill out and send back -----------------
  362.  
  363.   █▀▀▀▀▀▀▀▀▀▀▀▀▀ █ ▀ ▀▀█                                [XFF V.1.50.D 05/92]
  364.   █ ▀█▀▀█▀▀█ █▀▀▀█ █   █                               ┌───────────────────┐
  365.   █  █  ▀  █ █▄▄▄█ █▄▄ █                               │ REGISTRATION-FORM │
  366.   █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█                               └───────────────────┘
  367.   ==========================================================================
  368.   Mail back to : MDI ■ Postlagerkarte 094360E ■ D-7000 Stuttgart-1 ■ Germany
  369.   ==========================================================================
  370.  
  371.   Name      *) : ___________________________________________________________
  372.  
  373.   Company   *) : ___________________________________________________________
  374.  
  375.   Address   *) : ___________________________________________________________
  376.  
  377.   ZIP / City   : _______ ________________________________ / ________________
  378.  
  379.   *) let free these passages, if you want to send an anonymous registration.
  380.   ==========================================================================
  381.  
  382.   I RECEIVED THE FOLLOWING FREE (!) Maikel-Data International (MDI) PROGRAMS
  383.  
  384.   Programname  : Extended File Finder (XFF) ______________  Version : 1.50.D
  385.  
  386.   Programname  : _________________________________________  Version : ______
  387.  
  388.   Date of purchase : ____ / ____ / ______  Price (per disk) : ______________
  389.  
  390.   ==========================================================================
  391.  
  392.   FROM WHERE DID YOU OBTAIN OUR PROGRAMS, please circle and fill out the box
  393.  
  394.   [  ]  computer-using friend   *)   ┌────────┤ obtaining-address ├────────┐
  395.   [  ]  user-group/user-club    >>   │                                     │
  396.                                      │                                     │
  397.   [  ]  pd-/shareware-dealer    >>   │                                     │
  398.   [  ]  software library        >>   │                                     │
  399.   [  ]  computer-store          >>   │                                     │
  400.                                      │                                     │
  401.   [  ]  ftp-server              >>   │                                     │
  402.   [  ]  network                 >>   │                                     │
  403.   [  ]  mailbox                 >>   │                                     │
  404.   [  ]  bulletin-board               │                                     │
  405.   [  ]  _____________________   >>   └─────────────────────────────────────┘
  406.  
  407.   ==========================================================================
  408.   [  ] YES, I WANT TO SUPPORT THE MDI-SOFTWARE-DEVELOPMENT WITH AN AMOUNT OF
  409.        US$ __________  AND ENCLOSE THE AMOUNT TO THIS LETTER (please cash) !
  410.  
  411.   [  ] please send information  about updates / new programs when available.
  412.   ==========================================================================
  413.   Use  the  reverse side  for  comments,  suggestions  or  anything else ...
  414.  
  415.  
  416.  
  417.  
  418.          MDI Maikel-Data International
  419.             Postlagerkarte 094360 E
  420.          D-7000 Stuttgart-10 / Germany
  421.