home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DF461.ZIP / XR103.TXT < prev    next >
Text File  |  1993-06-06  |  34KB  |  722 lines

  1.                           Archive X-Ray Programs 1.03
  2.  
  3.                               AR 1.11 (ARJ)
  4.                               LR 1.02 (Lharc)
  5.                               ZR 1.27 (ZIP)
  6.                              ZOR 1.01 (ZOO)
  7.  
  8.            Copyright 1990 - 1993 by Gordon Haff and Bit Masons Consulting.
  9.                              All rights reserved.
  10.  
  11.           Command:  ZR or AR or LR or ZOR
  12.  
  13.           Purpose:  Provides a scrollable environment for selecting
  14.                     files contained within a ZIP file and viewing or
  15.                     extracting their contents
  16.  
  17.           Syntax:   ZR [d:][\path\]filename.ZIP [/n]
  18.  
  19.           Commands: <Enter> views files
  20.                     <Space> extracts files
  21.                     <d> deletes files
  22.                     <esc> to exit
  23.  
  24.           Prereqs:  100% IBM Compatible PC running DOS 3.0 or higher
  25.  
  26.           Archive Name:   XRAY103.ZIP
  27.  
  28.           Associated Programs:
  29.  
  30.                     In their default configuration, the programs REQUIRE
  31.                     Vern Buerg's LIST file viewing program (or 4DOS
  32.                     with LIST as the viewer name) and the corresponding
  33.                     archive program (PKUNZIP, LHA, ARJ, or ZOO).  LIST,
  34.                     PKUNZIP, 4DOS, and ARJ are Shareware and either
  35.                     require separate registration with their authors or
  36.                     request a donation.  See the individual program
  37.                     license agreements for details. AR also requires the
  38.                     included UNARJXR, a slightly modified version of
  39.                     Robert Jung's UNARJ to which he retains full
  40.                     copyright.
  41.  
  42.                     While these programs can be operated from the DOS
  43.                     command line using the format described above, they
  44.                     are most conveniently called as a user-defined shell
  45.                     command (or SmartViewer in DF 4.0 and later) from
  46.                     within the author's Directory Freedom (DF) program.
  47.  
  48.                     PC Magazine's PATCH program is included together with
  49.                     PATCH information files for modifications.  See
  50.                     PATCH.DOC for usage information.
  51.  
  52.           Other:    Your COMSPEC variable must be set.  See Section 2.1.
  53.  
  54.  
  55.           X-Ray 1.03                                                  2
  56.  
  57.                                  ┌─────────┐
  58.                            ┌─────┴───┐     │              (tm)
  59.                          ──│         │o    │──────────────────
  60.                            │   ┌─────┴╨──┐ │  Association of
  61.                            │   │         │─┘  Shareware
  62.                            └───│    o    │    Professionals
  63.                          ──────│    ║    │────────────────────
  64.                                └────╨────┘    MEMBER
  65.  
  66.                               DISCLAIMER OF WARRANTY
  67.  
  68.           This program is provided AS IS. Bit Masons Consulting MAKES NO
  69.           WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING WITHOUT
  70.           LIMITATION, ANY WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR
  71.           A PARTICULAR PURPOSE.
  72.  
  73.           The entire and exclusive liability and remedy for breach of this
  74.           Limited Warranty shall be limited to replacement of defective
  75.           diskette(s) or documentation and shall not include or extend to
  76.           any claim for or right to recover any other damages, including
  77.           but not limited to, loss of profit, data, or use of the
  78.           software, or special, incidental, or consequential damages or
  79.           other similar claims, even if Bit Masons has been specifically
  80.           advised of the possibility of such damages. In no event will the
  81.           publishers' liability for any damages to you or any other person
  82.           ever exceed the lower of suggested list price or actual price
  83.           paid for the license to use the software, regardless of any form
  84.           of the claim.
  85.  
  86.           BIT MASONS SPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES, EXPRESS
  87.           OR IMPLIED, INCLUDING BUT NOT LIMITED TO, ANY IMPLIED WARRANTY
  88.           OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
  89.  
  90.                                     LICENSE
  91.  
  92.           The X-Ray archive viewers are distributed as free, copyrighted
  93.           software.  What this means is that you can use these programs
  94.           for as long as you like without cost or obligation.  What you
  95.           cannot do is to sell this software or make a profit off of it
  96.           (except as described below) without the express written
  97.           permission of the author.
  98.  
  99.           The X-Ray archive viewers are the sole property of Gordon Haff.
  100.           These programs may be freely copied and transferred to
  101.           individual parties.  They may be posted on Bulletin Board
  102.           systems (BBS) for electronic access as long as NO FEE is charged
  103.           for its distribution except for private BBS operations that
  104.           charge a regular user subscription fee.  Computer information
  105.           services such as Compuserve (CIS), Genie, and Byte Information
  106.           Exchange (BIX) are authorized to post this product for
  107.           subscriber access.  The X-Ray archive viewers may be distributed
  108.           on diskette only by 1) disk distributors/vendors who are
  109.           associate members of the Association of Shareware Professionals
  110.           (ASP) or 2) users groups which do not charge more than a nominal
  111.           fee ($5) to cover the costs of distribution.  Any changes to
  112.           these policies must be made in writing by the author.
  113.  
  114.           X-Ray 1.03                                                  3
  115.  
  116.           This software is produced by a member of the Association of
  117.           Shareware Professionals (ASP).  The ASP wants to make sure that
  118.           the shareware principle works for you. If you are unable to
  119.           resolve a shareware-related problem with an ASP member by
  120.           contacting the member directly, ASP may be able to help. The ASP
  121.           Ombudsman can help you resolve a dispute or problem with an ASP
  122.           member, but does not provide technical support for members'
  123.           products.  Please write to the ASP Ombudsman at 545 Grover Rd.,
  124.           Muskegon, MI 49442-9427 or send a Compuserve message via
  125.           easyplex to ASP Ombudsman 70007,3536.
  126.  
  127.  
  128.                                   TECHNICAL SUPPORT
  129.  
  130.  
  131.           Since this program is a freebie, unlike the shareware programs
  132.           for which I request a registration fee, I'm not going to make any
  133.           guarantees here with respect to bug fixes or other technical
  134.           support.  Having said that, I do like my programs to be as
  135.           bug-free as possible, so feel free to report any problems which
  136.           you run across.
  137.  
  138.  
  139.                Contact via:
  140.  
  141.                     Channel 1 BBS            (617) 354-8873
  142.                     Compuserve User ID#      72561,2637  (See Note 1)
  143.                     InterNet/ARPANET         72561.2637@compuserve.com
  144.  
  145.                     U.S. Mail                3205 Windsor Ridge Dr.
  146.                                              Westboro MA 01581
  147.                     Telephone                (508) 898-3321 (after 6pm
  148.                                                           Eastern time)
  149.  
  150.           The above are roughly in order of preference (i.e. how quickly
  151.           I'm likely to see your message and be able to respond).  I check
  152.           Channel One almost daily and the other electronic services at
  153.           least weekly in most cases.  In addition, I monitor the ILink
  154.           and the PCRelay Shareware relays through Channel One.
  155.  
  156.           Note 1:
  157.           When contacting me via Compuserve, please use the Easyplex mail
  158.           system since I do not regularly monitor any of the IBM SIG
  159.           message bases.
  160.  
  161.           X-Ray 1.03                                                  4
  162.  
  163.  
  164.           1.0     Why and Whence the X-Ray Viewers?
  165.           ----------------------------------------
  166.  
  167.           The main reason that I originally wrote Z-Ray (as in Zip X-Ray)
  168.           is the following:  I have a shareware file management program
  169.           called Directory Freedom which is small and fast in spite of
  170.           having more wonderful and exciting features than I could
  171.           possibly describe here (Plug #1).  Yet, there was still one
  172.           thing which I continually ended up having to exit DF to do --
  173.           namely, to view the contents of files contained within ZIP
  174.           files.
  175.  
  176.           This annoyed me.
  177.  
  178.           I looked high and low for a program which I could call with DF's
  179.           nifty user-defined shell function (Plug #2), but nothing did
  180.           exactly what I needed.  So out came the assembler and, a week or
  181.           so later, out popped ZR.
  182.  
  183.           As time passed, I also wanted to be able to do the same thing
  184.           with other archive formats I sometimes used -- ARJ and Lharc.
  185.           So, taking Z-Ray as a base, I wrote AR and LR.  These latter two
  186.           programs do work a little differently (inside) from ZR -- see
  187.           the Technical notes -- but these differences should generally be
  188.           invisible to the user.
  189.  
  190.           So.... armed with these viewers, DF can now perform most of the
  191.           major archiving and de-archiving functions for the major
  192.           formats used on PC's.  (DF 4.0 and later has the capability to
  193.           archive files.)  For the fancy stuff (such as selective archive
  194.           updates), you'll still need a program like ARCMASTER or SHEZ,
  195.           but DF will be able to handle all the everyday stuff.
  196.  
  197.  
  198.           X-Ray 1.03                                                  5
  199.  
  200.  
  201.           2.0     How does it Work?
  202.           -------------------------
  203.  
  204.           I'm glad you asked that question.  It works incredibly well.
  205.           Oh.. HOW does it work.  Well, there's nothing to it.
  206.  
  207.           (Note: The rest of this section just shows ZR.  There are no
  208.           differences at the operational level between ZR and the other
  209.           programs.  Just substitute AR (for ARJ files), LR (for Lharc
  210.           files), or ZOR (for ZOO files) if you are using one of those
  211.           formats.)
  212.  
  213.           The command line syntax is just:
  214.  
  215.                 ZR [d:][\path\]filename.ZIP [/n]
  216.  
  217.           So, any of the following are valid:
  218.  
  219.                ZR TEST.ZIP
  220.                ZR C:\FOO\TEST.ZIP
  221.                ZR E:\FOOBAR.ZIP /n
  222.  
  223.           You do need to type the extension since ZR will look into any
  224.           file with a ZIP format (including self-extracting files).
  225.  
  226.           /n (or -n) will sort the list in ascending alphabetical order.
  227.  
  228.           Assuming the specified file exists and is valid, you'll get a
  229.           window on the screen which looks something like the following.
  230.           The top line in the directory will be highlighted.
  231.  
  232.    Z-Ray 1.27 Copyright 1990,93 by Gordon Haff and Bit Masons Consulting
  233. ┌──────────────────────────────────────────────────────────────────────────────┐
  234. │                                                                              │
  235. │  Filename       Before  Method  CR   After    Date    Time    CRC    Attr    │
  236. │  ------------ -------- -------- --- ------- -------- ------ -------- ----    │
  237. │  ASCAN.C         11591 Imploded 72%    3278  3-15-90  8:29p C48F03BC ---a    │
  238. │  ASIZE.C         17195 Imploded 76%    4134  3-15-90 12:31a A68B0C17 ---a    │
  239. │  BBSWEEP.C        6465 Imploded 69%    2031  1-22-90  1:06a 68E0379C ---a    │
  240. │  CONVERT.C       37526 Imploded 77%    8446  3-14-90 10:21p 2B42D1B8 ---a    │
  241. │  HEADER.C        11732 Imploded 72%    3342  3-03-90 10:03p E67A9698 ---a    │
  242. │  IBMDOS.C         2765 Imploded 71%     812  2-17-90  5:39p 4575BF5C ---a    │
  243. │  MACROS.C          301   Shrunk 31%     207 11-27-89  7:49p 9D902C85 ---a    │
  244. │  MAKEFILE         1602 Imploded 74%     412  3-06-90  4:51p 9C92811F ---a    │
  245. │  REDATE.C        17883 Imploded 79%    3710  1-22-90  1:07a 86A021A8 ---a    │
  246. │  SELF.C           1654 Imploded 66%     567  1-21-90 10:21p 65F69EE4 ---a    │
  247. │  TEST.C          10242 Imploded 69%    3142  3-15-90  8:29p B53434B5 ---a    │
  248. │  UNARC.C         15631 Imploded 74%    4136  3-06-90  7:35p 50C371B8 ---a    │
  249. │  UNIVERSE.C       7370 Imploded 69%    2256  3-14-90  9:21p 91B1CE5F ---a    │
  250. │  VERSION.C        1551 Imploded 48%     804  2-16-90 11:27p B7B98077 ---a    │
  251. │  VIEW.C          23958 Imploded 75%    6006  3-06-90  9:38p 5E983326 ---a    │
  252. │                                                                              │
  253. │                                                                              │
  254. │                                                                              │
  255. └──────────────────────────────────────────────────────────────────────────────┘
  256.     15 Files      167466          74%   43283      PKZIP Version: 1.1
  257.  
  258.           X-Ray 1.03                                                  6
  259.  
  260.           You can move the highlight bar around with the <Up Arrow>, <Down
  261.           Arrow>, <PgUp>, <PgDn>, <Home>, and <End Keys>,  These do pretty
  262.           much what you'd expect them to do.
  263.  
  264.           You can quit by hitting the <Esc> key.
  265.  
  266.           And now we come to the useful part -- you can view the contents
  267.           of a file by pressing the <Enter> key.
  268.  
  269.           What the <Enter> key does is pipe the contents of the highlighted
  270.           file to Vernon Buerg's LIST program.  PKUNZIP and LIST MUST BE
  271.           PRESENT IN YOUR PATH OR THIS WON'T WORK!!!  Later on, I explain
  272.           how the default command line can be changed in case you've
  273.           renamed LIST or know some other way to do the same thing.  The
  274.           default exec line is:
  275.  
  276.                PKUNZIP -c ~ ` | list /s
  277.  
  278.                where:
  279.  
  280.                     ~ is the name of the archive being viewed
  281.                     ` is the name of the selected file
  282.  
  283.                These names are filled in dynamically by ZR.  The command
  284.                lines differ for AR, LR, and ZOR.  See the customization
  285.                section.
  286.  
  287.           But Wait!  There's more! You can also EXTRACT the highlighted
  288.           file.  Pressing <space> or e will extract the highlighted file
  289.           with the following default command line:
  290.  
  291.                PKUNZIP ~ `
  292.  
  293.           As with the viewer, this function requires that PKUNZIP be
  294.           present in your path.  The extraction will take place to the
  295.           current DOS directory.  Finally, pressing d will delete the
  296.           highlighted file.
  297.  
  298.           About the Totals line:
  299.  
  300.           The totals line on the bottom gives you some summary information
  301.           about the archive -- total files, uncompressed and compressed
  302.           bytes, compression percentage, and PKZIP version number (in the
  303.           case of ZR).
  304.  
  305.           The PKZIP version number is the oldest version of PKZIP which
  306.           was used in creating the archive.  USUALLY (as in almost all of
  307.           the time) all files in an archive will have been archived using
  308.           the same version, but this isn't necessarily the case -- files
  309.           can be added to an existing archive and the versions don't
  310.           necessarily have to match.
  311.  
  312.           X-Ray 1.03                                                  7
  313.  
  314.  
  315.           2,1  COMSPEC Variable.
  316.           ----------------------
  317.  
  318.           In order for any of the X-Ray viewers to work, your COMSPEC
  319.           environment variable must be set.  This variable tells ZR
  320.           {AR,LR,ZOR} the name and the location of the command interpreter to
  321.           use when it shells to the appropriate archive program.  Without
  322.           a COMSPEC variable, ZR will display a file listing, but you will
  323.           be unable to view the contents of files.  AR, LR, and ZOR will not
  324.           even get this far since they depend on the archive program
  325.           itself to generate the file list.
  326.  
  327.           To set the COMSPEC variable, include a line such as:
  328.  
  329.                SET COMSPEC=C:\COMMAND.COM
  330.  
  331.           in your AUTOEXEC.BAT file.  The above example is typical for a
  332.           hard disk system but other COMSPEC lines such as:
  333.  
  334.                SET COMSPEC=C:\4DOS.COM       and
  335.                SET COMSPEC=\COMMAND.COM
  336.  
  337.           are also possible.  The former uses J.P. Software's excellent
  338.           4DOS as the shell and the latter uses COMMAND.COM on the current
  339.           logical disk (This would be common for a floppy-only system).
  340.  
  341.           You can view your environment settings at any time
  342.           by typing SET at the DOS prompt.
  343.  
  344.           (Actually with recent versions of 4DOS, it probably isn't
  345.           necessary to set a COMSPEC since 4DOS is smart enough to use an
  346.           intelligent default.  Still, it doesn't hurt.  And it MUST be
  347.           set if you use the standard DOS COMMAND.COM shell.)
  348.  
  349.           X-Ray 1.03                                                  8
  350.  
  351.  
  352.           3.0     Customizing ZR, AR, ZOR, and LR.
  353.           ----------------------------------------
  354.  
  355.           (NOTE: See PATCH.DOC for information on making modifications 
  356.           using the ZIF patch information files.)
  357.  
  358.           I haven't gone and written a fancy user-friendly configuration
  359.           program for these programs, but you can do some limited
  360.           modification if you have a hex editor of some sort such as
  361.           Norton's DiskEdit or NU.  Debug will also do in a pinch for the
  362.           more adventurous.
  363.  
  364.           MAKE ALL MODIFICATIONS ON A COPY!  ALSO -- make sure that the
  365.           rev of the program matches this documentation since the offsets
  366.           could change between revisions!
  367.  
  368.                Colors:
  369.                -------
  370.  
  371.                     Variable          Offset          Default
  372.                     --------          ------          -------
  373.                     C_NORMAL            0Eh            02h
  374.                     C_INVERSE           0Fh            74h
  375.                     C_INTENSE           10h            03h
  376.                     C_BORDER            11h            4Eh
  377.  
  378.           C_BORDER is the attribute for the window border, C_INTENSE for
  379.           the heading in the window, C_INVERSE for the bar.  The color
  380.           values are in standard DOS combined foreground/background format.
  381.           See the Appendix for details on the values you can enter.
  382.  
  383.           The value at offset 12h can be changed from a 0 to a 1 to
  384.           disable the archive file delete function.
  385.  
  386.                Command Lines:
  387.                -------------
  388.  
  389.           The default command line for the viewer is:
  390.  
  391.           ZR:     PKUNZIP -c ~ ` | list /s
  392.           AR:     ARJ p ~ ` | list /s
  393.           LR:     LHA p ~ ` | list /s
  394.           ZOR:    ZOO -p ~ ` | list /s
  395.  
  396.           and resides from offset 16h through 33h, padded with spaces
  397.           (20h).  (These offsets, like those for the colors, are relative
  398.           to the beginning of the file at 0000h.)  If you modify this
  399.           command line, be careful not to overflow the space allotted to
  400.           it (there's a NULL (00) on the end) or the results will likely
  401.           be very unpleasant.
  402.  
  403.  
  404.           X-Ray 1.03                                                  9
  405.  
  406.           The default command line for the Archive extract is:
  407.  
  408.           ZR:     PKUNZIP ~ `
  409.           AR:     ARJ e ~ `
  410.           LR:     LHA e ~ `
  411.           ZOO:    ZOO -e ~ `
  412.  
  413.           and resides from offsets 38h through 55h.
  414.  
  415.           The default command line for the Archive delete is:
  416.  
  417.           ZR:     PKUNZIP -d ~ `
  418.           AR:     ARJ d ~ `
  419.           LR:     LHA d ~ `
  420.           ZOO:    ZOO -d ~ `
  421.  
  422.           and resides from offsets 5Ah through 77h.
  423.  
  424.  
  425.           In addition, LR, AR, and ZOR specify a command line which
  426.           extracts the archive file list information to a temporary file.
  427.           The equivalent line does not exist in ZR because ZR does its own
  428.           decoding of the archive.
  429.  
  430.           The default command line for this is:
  431.  
  432.           AR:     UNARJXR ~ > xr99tmp
  433.           LR:     LHA ~ > xr99tmp
  434.           ZOR:    ZOO VC ~ > xr99tmp
  435.  
  436.           and resides from offsets 7Ch through 99h.
  437.  
  438.           The temporary file name, which must match the name in the
  439.           above command line, resides from 9Bh through A8h.
  440.  
  441.           X-Ray 1.03                                                 10
  442.  
  443.  
  444.           4.0     Configuring DF to use ZR:
  445.           --------------------------------
  446.  
  447.           This is also very easy.  Just configure SmartViewer lines (using
  448.           DFCONFIG) to read:
  449.  
  450.                Command line             Extension
  451.                ------------             ---------
  452.                ZR ~                     ZIP
  453.                AR ~                     ARJ
  454.                LR ~                     LZH
  455.                ZOR ~                    ZOO
  456.  
  457.           When you highlight an archive file with DF and press the <Enter>
  458.           key, you will pop directly into the file listing window of the
  459.           appropriate utility from which you can select files to view.  No
  460.           file names to type!  Isn't that easy?  Of course, you can
  461.           also setup standard user-defined function keys if you wish.)
  462.  
  463.           5.0     Technical and Acknowledgments.
  464.           --------------------------------------
  465.  
  466.           ZR does its own decoding of a ZIP archive file by reading in the
  467.           central directory structure.  It will read all versions of PKZIP
  468.           archives up to and including at least version 2.04g.  I strongly 
  469.           recommend that you do NOT use PKZIP/PKUNZIP 2.04 versions prior 
  470.           to 2.04g.
  471.  
  472.           LR, and ZOR on the other hand, create a temporary file which
  473.           contains the contents of an archive listing generated by the
  474.           archiver itself.  This archive listing is then parsed into the
  475.           appropriate format for the scrollable display.  The programs
  476.           were developed using Lharc (LHA) 2.10, and ZOO 2.1.
  477.           Differences in the archive display format in either program
  478.           could therefore cause difficulties.  AR does something similar
  479.           but because of some problems caused by changing formats, it
  480.           uses a modified version of ARJ's demo viewer to generate the
  481.           listing.
  482.  
  483.           One of these days, my goal is to write native mode decoders for
  484.           at least ARJ.
  485.  
  486.           ZR, AR, ZOR, and LR were written using Borland's Turbo Assembler
  487.           3.0 and Turbo Debugger 3.0, American Cybernetic's Multi-Edit
  488.           6.0, and Base Two Development's Spontaneous Assembly assembler
  489.           library 2.0.
  490.  
  491.           The hardware environment was a homebrew 386 (named Dejah Thoris)
  492.           based on an AMI 20MHz full-size motherboard with a Micropolis
  493.           160MB ESDI disk and Ultrastore 12(F) ESDI controller.  It is a
  494.           dual monitor system with an Orchid Prodesigner 512KB VGA board
  495.           and an IBM MDA board.
  496.  
  497.           Last, but certainly not least, thanks to my Directory Freedom
  498.           beta crew who have also helped out in debugging ZR as well.
  499.  
  500.           X-Ray 1.03                                                  11
  501.  
  502.  
  503.           6.0     Other Programs from Gordon Haff and Bit Masons Consulting:
  504.           -----------------------------------------------------------------
  505.  
  506.           Directory Freedom (DF):
  507.  
  508.               Offers users a fast, compact alternative to DOS Shells which
  509.             provides 1) selective file and directory operations; 2) a
  510.             scrollable environment for examining files and directories; 3)
  511.             user-defined keys which can operate upon highlighted files
  512.             (e.g. by defining an editor).  All this in a program which
  513.             takes less than 35KB since it is written in assembler! Easily
  514.             customized through an external configuration program. A "look-
  515.             and-feel" similar to PC Mag's DR, but does much more.  Now with
  516.             SmartViewers, a system information screen, and many more 
  517.             exciting new features.
  518.                          Shareware: $25 Registration
  519.                          Latest version: 4.61 (DF461.ZIP)
  520.  
  521.  
  522.           the last word:
  523.  
  524.             'the last word' is a quotations trivia game in which 1 to 4
  525.             players compete against each other and their own high scores in
  526.             identifying the source of quotations and completing partial
  527.             quotes.  Most answers are entered free-form and are matched
  528.             against a set of acceptable responses with a sophisticated
  529.             pattern-recognition algorithm.  'the last word' runs in text
  530.             mode -- including on mono displays -- and offers a high level
  531.             of user configurability.
  532.                          Shareware: $15 Registration
  533.                          Latest version: 1.00  (LWORD100.ZIP)
  534.  
  535.           Name Date:
  536.  
  537.             Renames a file to a template such as the current date.  In
  538.             other words, if the current date were 10-06-90, the file
  539.             'FILENAME.QWK' would be renamed to 901006.QWK.  Version 2.0
  540.             is highly configurable with many command-line options
  541.             including the complete specification of the format template
  542.             to be used for renaming.  This is a handy program for
  543.             archiving message packets from bulletin boards, for example.
  544.                          Free, copyrighted software
  545.                          Latest version: 2.0 (NAMD200.ZIP)
  546.  
  547.  
  548.           X-Ray 1.03                                                  12
  549.  
  550.           Convert:
  551.  
  552.             Unit conversion calculator for Windows 3.1.  Comes with a data
  553.             file containing a large number of common (and not so common)
  554.             conversions in categories such as length, speed, pressure,
  555.             volume, and time.  The data file is a plain ASCII text file so
  556.             the user may add or delete units to best fit his individual
  557.             needs (or use the built-in editor).  Version 2.01 is a 
  558.             complete rewrite from version 1.01 and has a whole new look 
  559.             and many new features.
  560.                            Shareware: $15 Registration
  561.                            Latest version: 2.01  (CVT201.ZIP)
  562.  
  563.           Volume label Edit and Copy:
  564.  
  565.             Edit, delete, and copy volume labels.  Will use absolute disk
  566.             read/write operations as required to deal with "non-standard"
  567.             volume labels such as those with lower case characters.  The
  568.             Copy function could be used as part of a batch file to backup
  569.             distribution disks to a different sized floppy.
  570.                            Free, copyrighted software
  571.                            Latest version: 1.10  (VEC110.ZIP)
  572.  
  573.  
  574.           MAKETEST:
  575.  
  576.             Command-line utility to create test files.  Lets you create
  577.             any number of test files with user-specified names and sizes.
  578.             Automatically can add characters to avoid duplicate names.
  579.             This is an easy way to create something like 100 zero-length
  580.             files.  Handy for users or programmers who want to test a
  581.             program's capabilities.
  582.                            Free, copyrighted software with QB source
  583.                            Latest version: 1.0  (MKTST100.ZIP)
  584.  
  585.  
  586.  
  587.           These programs and others (Multi-Edit macros for use with Qmail
  588.           Deluxe, for example) are available on many fine bulletin boards.
  589.           The latest releases are always available on Channel One.   If you
  590.           just have to get a copy of one or more of these programs and
  591.           can't find one, however, I can send them out for a nominal media
  592.           and postage charge.
  593.  
  594.           X-Ray 1.03                                                  13
  595.  
  596.  
  597.           7.0     History:
  598.           ---------------
  599.  
  600.           ZR:
  601.           ---
  602.           Rev. 1.27      PKZIP 2.0x "deflated" archive type display
  603.                          Fixed documented offset of "delete archive" patch
  604.                          Added patch script
  605.           Rev. 1.26      Added delete archive file option
  606.           Rev. 1.25      Changed display routines so directory no longer
  607.                            overlaid over previously viewed file
  608.                          Added bottom totals/version display
  609.           Rev. 1.24      Additional memory management modifications
  610.           Rev. 1.23      Rewrote memory management so that larger (in
  611.                            terms of number of ZIPped files) archives can be
  612.                            handled (archives containing > 256 files at
  613.                            least are OK)
  614.                          /n command-line to optionally sort list is
  615.                            ascending filename order
  616.                          Name changed from ZV (ZipView) to ZR (Z-Ray)
  617.           Rev. 1.22      Corrected error message for when not enough
  618.                          memory to store interpreted file names
  619.           Rev. 1.21      Fixed another big with <End> and <PgDn> keys when
  620.                          directory less than a screenful
  621.           Rev. 1.20      Fixed bug with <End> key when cursor at bottom of
  622.                               directory
  623.                          Added <PgUp> and <PgDn> keys
  624.                          Added Extract Archive function
  625.           Rev. 1.11      Fixed problem when SHARE was installed (Thanks to
  626.                          Dr. Herbert Markley for finding this -- the .ZIP
  627.                          file wasn't closed when the EXEC occurred and
  628.                          PKUNZIP, being the well written program that it
  629.                          is, was rightly refusing to have anything to do
  630.                          with the file as a consequence.)
  631.           Rev. 1.10      Fixed display problem on monochrome systems
  632.                          Fixed problems with ZIP files < 10Kbytes
  633.           Rev. 1.0       Initial Release
  634.  
  635.           AR:
  636.           ---
  637.           Rev. 1.11
  638.           Rev. 1.10      By using a modified version of the UNARJ extract
  639.                          program (called UNARJXR.EXE), AR can now handle a
  640.                          variety of ARJ archives it was choking on (Rev
  641.                          2.30, environment settings, etc.)
  642.           Rev. 1.01      Added delete archive file option
  643.           Rev. 1.0       Initial Release
  644.  
  645.           LR:
  646.           ---
  647.           Rev. 1.02
  648.           Rev. 1.01      Added delete archive file option
  649.           Rev. 1.0       Initial Release
  650.  
  651.           X-Ray 1.03                                                  13
  652.  
  653.  
  654.           ZOR:
  655.           ----
  656.           Rev. 1.01
  657.           Rev. 1.0       Initial Release
  658.  
  659.  
  660.           8.0     Known Limitations and Peculiarities:
  661.           --------------------------------------------
  662.  
  663.           (i.e. These are free programs and I got tired of beating out my
  664.           brains over it for the time being.)
  665.  
  666.           All:
  667.           ----
  668.               o  The piping mechanism to LIST can truncate long files.
  669.                  Unfortunately, there is no warning that such truncation
  670.                  has taken place.
  671.  
  672.           ZR:
  673.           ---
  674.               o  Truncates the display of files archived with their paths
  675.                  and will not pipe them to the viewer properly if the
  676.                  entire path and filename is greater than 13 characters.
  677.  
  678.           AR,LR:
  679.           ------
  680.               o  Will not handle paths
  681.  
  682.               o  Rely on a specific file display format generated by the
  683.                  archiver (not really true any longer with AR)
  684.  
  685.           ZOR:
  686.           ----
  687.               o  As for AR, LR
  688.  
  689.               o  Sometimes the file display as piped to LIST comes out
  690.                  double-spaced.  I'm not sure of the reason for this, but
  691.                  it is not a function of ZOR; you will obtain the same result
  692.                  if you pipe an archived file to LIST from the DOS command
  693.                  line.
  694.  
  695.  
  696.           X-Ray 1.03                                                  14
  697.  
  698.                               APPENDIX A
  699.  
  700.                                 COLORS
  701.  
  702.  
  703.           The color number stored for use in ZR, AR, LR, and ZOR are
  704.           combined foreground/background attributes of the type used by
  705.           DOS.  This combined attribute value is simply the foreground and
  706.           background numbers, as given below, bit-wise OR'd together.
  707.           That's a fancy way of saying added together for our purposes
  708.           here.  (Remember though that these are hexadecimal numbers.)
  709.           For example, yellow on a blue background is given by 1Eh (0Eh +
  710.           10h).
  711.  
  712.  
  713.           Foreground (normal)  Foreground (intense)         Background
  714.           --------------------------------------------------------------
  715.            0  black              8   dark gray               0   black
  716.            1  blue               9   light blue             10h  blue
  717.            2  green             0Ah  light green            20h  green
  718.            3  cyan              0Bh  light cyan             30h  cyan
  719.            4  red               0Ch  light red              40h  red
  720.            5  magenta           0Dh  light mag.             50h  magenta
  721.            6  brown             0Eh  yellow                 60h  brown
  722.            7  gray              0Fh  intense white          70h  gray