home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1587 / xal.doc < prev    next >
Encoding:
Text File  |  1992-04-30  |  16.8 KB  |  365 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.                   AAA   RRRR    CCCC  H   H  IIIII  V   V  EEEEE
  10.                  A   A  R   R  C      H   H    I    V   V  E
  11.                  AAAAA  RRRR   C      HHHHH    I    V   V  EEEE
  12.                  A   A  R  R   C      H   H    I     V V   E
  13.                  A   A  R   R   CCCC  H   H  IIIII    V    EEEEE
  14.  
  15.                     L      IIIII  SSSSS  TTTTT  EEEEE  RRRR
  16.                     L        I    S        T    E      R   R
  17.                     L        I     SSS     T    EEEE   RRRR
  18.                     L        I        S    T    E      R  R
  19.                     LLLLL  IIIII  SSSSS    T    EEEEE  R   R
  20.  
  21.  
  22.               XAL - THE ultimative and fast archive-file-lister.
  23.  
  24.  
  25.                            D O C U M E N T A T I O N
  26.                            ─────────────────────────
  27.                                     for the
  28.  
  29.                        ┌───────────────────────────────┐
  30.                        │ EXTENDED-ARCHIVE-LISTER (XAL) │
  31.                        │ Version: 1.00.A    01.05.1992 │
  32.                        └───────────────────────────────┘
  33.  
  34.                                  (C) 1991-1992
  35.                          MDI Maikel-Data International
  36.                             Postlagerkarte 094360 E
  37.                               D-7000 Stuttgart-10
  38.                                 Germany, Europe
  39.  
  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.          XAL V.1.00                  - 1 -           (C) 1991-1992 MDI
  60.  
  61.          ABBREVIATIONS used in this documentation :
  62.          ─────────────────────────────────────────────────────────────
  63.          MDI=Maikel-Data International     XAL=Extended-Archive-Lister
  64.  
  65.  
  66.          SYSTEM-REQUIREMENTS :
  67.          ─────────────────────────────────────────────────────────────
  68.          XAL  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.          XAL requires operating-systems MS-DOS / PC-DOS 2.00 or later.
  72.  
  73.  
  74.          DISCLAIMER :
  75.          ─────────────────────────────────────────────────────────────
  76.          XAL 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 XAL. YOU ARE USING XAL ON YOUR OWN RISK !
  81.  
  82.  
  83.          GENERAL REMARKS about (c)opyright and distribution :
  84.          ─────────────────────────────────────────────────────────────
  85.          XAL (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 XAL in any
  88.          way. This document has to be distributed always together with
  89.          the executable file XAL.EXE. This document and the executable
  90.          file may be changed by MDI at any time without an indication.
  91.  
  92.          XAL is   N O T   (!) for sale, it is absolute free of charge.
  93.          If  SW-/PD-VENDORS  are interested in distributing  XAL,  the
  94.          charges for distribution MUST NOT exceed US$ 10.00 per disk !
  95.          If you find XAL of value, please distribute it free and share
  96.          it with all your friends.
  97.          ! Copying XAL 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 XAL
  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  XAL  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.          XAL V.1.00                  - 2 -           (C) 1991-1992 MDI
  120.  
  121.          XAL USAGE and ADVANTAGES :
  122.          ─────────────────────────────────────────────────────────────
  123.          Purpose : XAL lists the contents of archived-files created by
  124.                    all popular compression (archiving)-programs. Refer
  125.                    appendix D for the supported archiving-programs.
  126.                    You may specify the archived-files  (*.ARC/ARJ/ICE/
  127.                    LZH/PAK/ZIP/ZOO)  to be  explored  as  well as  the
  128.                    files to be  displayed  with the  wildcards "*" and
  129.                    "?". Refer appendix B for the use of wildcards.
  130.  
  131.          Notice :  If this version of  XAL  is not compatible with the
  132.                    archiving-program you use so please send us a short
  133.                    message what happend.  Please state the  version of
  134.                    XAL you currently have and send us  - if possible -
  135.                    a  shareware / pd-version  of  your  "incompatible"
  136.                    archiving-program.  You  will  receive  the  latest
  137.                    updated version of XAL  free as soon as available !
  138.  
  139.          You may interrupt XAL with any keystroke.  An interruption is
  140.          indicated with a big cursor (█).  Any next keystroke instruct
  141.          XAL to continue. XAL may be aborted with [ESC] or [CTRL-C] at
  142.          any time.
  143.  
  144.          XAL reports the results  in one of the  following languages :
  145.              - English            - French               - German
  146.          The convenient  language  will be detected automatically, but
  147.          you may choose an other language with the parameter /Mcode.
  148.  
  149.          XAL offers the possibility to redirect the output into a file
  150.          or to a printer. Please refer appendix A for more details.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.          General remarks :
  172.          ─────────────────────────────────────────────────────────────
  173.          XAL  always  starts  in  the  current  directory  if there is
  174.          nothing other indicated.   If you  want  to  explore archived
  175.          files in  other  directories,  you  must  specify this in the
  176.          command line, example is XAL D:\PACKETS\*.LZH.
  177.  
  178.          _____________________________________________________________
  179.          XAL V.1.00                  - 3 -           (C) 1991-1992 MDI
  180.  
  181.          XAL INPUT-PARAMETERS :
  182.          ─────────────────────────────────────────────────────────────
  183.          ┌───────────────────────────────────────────────────────────┐
  184.          │ Usage: XAL [drive:][\][path\] name.ext [files][S][>Redir] │
  185.          └───────────────────────────────────────────────────────────┘
  186.  
  187.            [drive:]  drive to search on
  188.          [\][path\]  path  to search in
  189.            name.ext  name(s) of archived file(s) to be explored
  190.             [files]  specification of the files to be displayed
  191.  
  192.            [>Redir]  output-redirection     (redirection refer app. A)
  193.  
  194.                 [S]  switches to be set :
  195.  
  196.          ─────────────────────────────────────────────────────────────
  197.  
  198.             /H       : show help-screen.
  199.             /H+      : show license-screen -----> PLEASE READ THIS !!!
  200.  
  201.             /O       : show only the statictics of the archived files
  202.             /N       : do not show the statistics of archived files
  203.  
  204.             /Mcode   : modify the output-language of XAL, where
  205.                                  code = 33 means French language and
  206.                                  code = 49 means German language.
  207.                        Any other code = means English language.
  208.  
  209.  
  210.  
  211.          XAL EXAMPLE-CALLS :
  212.          ─────────────────────────────────────────────────────────────
  213.  
  214.          XAL /H                     : show the main help-screen.
  215.  
  216.          XAL *.*                    : show the contents of all in the
  217.                                       current  path  located archived
  218.                                       files
  219.  
  220.          XAL *.lzh                  : same, only *.LZH-file(s)
  221.  
  222.          XAL *.arc /n               : same,   only  *.ARC-file(s)  and
  223.                                       without statistics-output
  224.  
  225.          XAL *.zoo /o               : same,   only  *.ZOO-file(s)  and
  226.                                       display  only  statistics-output
  227.  
  228.          XAL d:\12\*.z* a*.sys /n   : display all  a*.sys-files stored
  229.                                       in  *.Z*-archived files  located
  230.                                       in path D:\12
  231.  
  232.          XAL /M1                    : set output-language to English
  233.          XAL /M33                   : set output-language to French
  234.          XAL /M49                   : set output-language to German
  235.  
  236.          XAL *.lzh > prn            : search for  *.LZH-archived files
  237.                                       and send output  to the printer.
  238.          _____________________________________________________________
  239.          XAL V.1.00                  - 4 -           (C) 1991-1992 MDI
  240.  
  241.          APPENDIX A - explanation of [> Redir] :
  242.          ─────────────────────────────────────────────────────────────
  243.          XAL allows you to "redirect" the output.   In the description
  244.          above, it's called  [> Redir].  This means,  you may send the
  245.          output into a file or direct to your printer.
  246.          [> Redir] into any file :       > [drive:\path\] filename.ext
  247.          [> Redir] to a printer  :       > prn
  248.  
  249.          Example: XAL *.* > a:\otto\result.dat     (output into  file)
  250.                   XAL d:\otto\*.lzh *.sys > prn    (output to printer)
  251.  
  252.  
  253.          APPENDIX B - explanation of wildcards "*" and "?" :
  254.          ─────────────────────────────────────────────────────────────
  255.          The "*" wildcard means ignore all characters to the right and
  256.          the "?" wildcard means any character in that position is in a
  257.          match.
  258.          Example : *.bak  :  any  filename  with the extension of .bak
  259.                    ?.*    :  filename with one char. and any extension
  260.                    ??.??  :  filename and extension with two charcters
  261.  
  262.  
  263.          APPENDIX C                             █▀▀▀▀▀▀▀▀▀▀▀▀▀ █ ▀ ▀▀█
  264.          ──────────                             █ ▀█▀▀█▀▀█ █▀▀▀█ █   █
  265.                                                 █  █  ▀  █ █▄▄▄█ █▄▄ █
  266.          Copyrights / Trademarks :              █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  267.          ─────────────────────────────────────────────────────────────
  268.          IBM PC/XT/AT  - IBM International Business Machines
  269.          PC-DOS        - IBM International Business Machines
  270.          MS-DOS        - Microsoft Corporation
  271.          MDI and logo  - MDI Maikel-Data International
  272.          ─────────────────────────────────────────────────────────────
  273.  
  274.  
  275.          APPENDIX D - ARCHIVING-PROGRAMS supported by XAL :
  276.          ─────────────────────────────────────────────────────────────
  277.          *.ARC : PKARC 3.50/3.60, PKPAK 3.61           (C) PKWARE Inc.
  278.          *.ARJ : ARJ 2.00/2.20                         (C) Robert Jung
  279.          *.ICE : LHICE 1.14                            (C) H.Yoshizaki
  280.          *.LZH : LHARC 1.13, LHA 2.10/2.12             (C) H.Yoshizaki
  281.          *.PAK : PAK 2.51                              (C) NoGate Con.
  282.          *.ZIP : PKZIP 1.02/1.10                       (C) PKWARE Inc.
  283.          *.ZOO : ZOO 2.01/(2.10)                       (C) Raul  Dhesi
  284.          ─────────────────────────────────────────────────────────────
  285.  
  286.  
  287.          APPENDIX E - contributions and donations :
  288.          ─────────────────────────────────────────────────────────────
  289.          The employment of XAL is absolute free of charge for you ....
  290.                                  ... BUT :
  291.          If you find XAL of value,  you may send MDI a donation, maybe
  292.          US$ 10.00 (≈DM 15.-) [or more ?]. YOUR financial support will
  293.          help us improving XAL and other software-products.
  294.  
  295.                 ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !
  296.                 ! !  Thank YOU very much  for YOUR support  ! !
  297.                 ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !
  298.          _____________________________________________________________
  299.          XAL V.1.00                  - 5 - [EOF]     (C) 1991-1992 MDI
  300.  
  301. ------------------- please cut here, fill out and send back -----------------
  302.  
  303.   █▀▀▀▀▀▀▀▀▀▀▀▀▀ █ ▀ ▀▀█                                [XAL V.1.00.A 05/92]
  304.   █ ▀█▀▀█▀▀█ █▀▀▀█ █   █                               ┌───────────────────┐
  305.   █  █  ▀  █ █▄▄▄█ █▄▄ █                               │ REGISTRATION-FORM │
  306.   █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█                               └───────────────────┘
  307.   ==========================================================================
  308.   Mail back to : MDI ■ Postlagerkarte 094360E ■ D-7000 Stuttgart-1 ■ Germany
  309.   ==========================================================================
  310.  
  311.   Name      *) : ___________________________________________________________
  312.  
  313.   Company   *) : ___________________________________________________________
  314.  
  315.   Address   *) : ___________________________________________________________
  316.  
  317.   ZIP / City   : _______ ________________________________ / ________________
  318.  
  319.   *) let free these passages, if you want to send an anonymous registration.
  320.   ==========================================================================
  321.  
  322.   I RECEIVED THE FOLLOWING FREE (!) Maikel-Data International (MDI) PROGRAMS
  323.  
  324.   Programname  : Extended-Archive-Lister (XAL) ___________  Version : 1.00.A
  325.  
  326.   Programname  : _________________________________________  Version : ______
  327.  
  328.   Date of purchase : ____ / ____ / ______  Price (per disk) : ______________
  329.  
  330.   ==========================================================================
  331.  
  332.   FROM WHERE DID YOU OBTAIN OUR PROGRAMS, please circle and fill out the box
  333.  
  334.   [  ]  computer-using friend   *)   ┌────────┤ obtaining-address ├────────┐
  335.   [  ]  user-group/user-club    >>   │                                     │
  336.                                      │                                     │
  337.   [  ]  pd-/shareware-dealer    >>   │                                     │
  338.   [  ]  software library        >>   │                                     │
  339.   [  ]  computer-store          >>   │                                     │
  340.                                      │                                     │
  341.   [  ]  ftp-server              >>   │                                     │
  342.   [  ]  network                 >>   │                                     │
  343.   [  ]  mailbox                 >>   │                                     │
  344.   [  ]  bulletin-board               │                                     │
  345.   [  ]  _____________________   >>   └─────────────────────────────────────┘
  346.  
  347.   ==========================================================================
  348.   [  ] YES, I WANT TO SUPPORT THE MDI-SOFTWARE-DEVELOPMENT WITH AN AMOUNT OF
  349.        US$ __________  AND ENCLOSE THE AMOUNT TO THIS LETTER (please cash) !
  350.  
  351.   [  ] please send information  about updates / new programs when available.
  352.   ==========================================================================
  353.   Use  the  reverse side  for  comments,  suggestions  or  anything else ...
  354.  
  355.  
  356.  
  357.  
  358.          MDI Maikel-Data International
  359.             Postlagerkarte 094360 E
  360.          D-7000 Stuttgart-10 / Germany
  361.  
  362.  
  363.  
  364.  
  365.