The TOPS-20 versions of SQ and USQ are based on the "portable" version
known as SQU-PORT.LBR, as recently updated to version 3.  Several
changes were required to make this version compatible with the TOPS-20
KCC compiler and runtime package, as well as the TOPS-20 environment
itself.  All such changes, plus certain others, are contained within
TOPS20 conditionals.  Some of these conditional may also apply to
certain Unix environments as well as for TOPS-20.

Inquiries on the availability of KCC should be directed to
INFO-KCC-REQUEST@SRI-NIC.ARPA.  However, it should not be necessary to
recompile these programs as the executables should run in any TOPS-20
environment, release 5 and up.

Since makesq and makeusq are unique to Unix systems, MAKESQ.MIC and
MAKEUSQ.MIC are provided for those of you wishing to regenerate the
programs.  Note that the LOAD step requires LIBT20.REL to be available
in C:.  This module, as well as the ready-to-run executables, are
provided in this directory.  Sources for LIBT20 will eventually be
made available when its documentation is completed.

Note also that MAKEUSQ.MIC renames the resulting USQ.EXE to LUSQ.EXE
so that it may be used separately from the MIDAS version of USQ.
Although USQ is significantly faster than LUSQ, LUSQ can handle
arbitrarily large files.

Changes to SQ:

1. The input filename is uppercased and stripped of any leading
device, directory names, or trailing generation numbers before it is
stored in the file.

2. The output filename follows the CP/M convention of replacing the
second character of the type field with a "Q".  If there is no type
field, then "QQQ" is used.  The output filename is truncated to eight
characters for the file name and three characters for the file type.

3. When an ASCII input file is read past EOF, CP/M EOFs (^Zs) are
returned until the next 128-byte boundary.  When an 8-bit TOPS-20
binary input file is read past EOF, binary zeroes are returned to the
next 128-byte boundary.

4. Wildcard input filenames are accepted by this version.


Changes to USQ:

1. Both regular USQ and the "preview" option will terminate processing
upon the first decoded CP/M EOF returned.

2. The preview option returns the "unprintable" characters as-is and
lets the system convert them for display.

3. This version accepts wildcard filenames to unsqueeze.

4. This version automatically runs ASCIFY to convert the resulting
file, if necessary, to a 7-bit ASCII text file.  Otherwise, the file
is left as an 8-bit TOPS-20 binary file.


See the sources for other changes.

Frank J. Wancho
WANCHO@SIMTEL20.ARPA
