Category : Pascal Source Code
Archive   : ZIPTV20.ZIP
Filename : ZIPTV.DOC

Z i p T V

Version 2.0, 09-9-89

Online Zipfile Directory/Text View Module

ZIPTV20.ZIP

Copyright (C) 1989 Samuel H. Smith; ALL RIGHTS RESERVED


This program is supported by:

The Tool Shop BBS
Phoenix, AZ
(602) 279-2673 (2400) - Free node
(602) 264-3969 (HST 9600)
(602) 279-0230 (Hayes V9600)


'ZIPTV' is a small zipfile text-view utility. It allows you to
directly list out text files in a zipfile without first extracting them.
This version is compatible with network filesharing. It is based on the
zipfile text-view function in ProDOOR. Run ZIPTV without parameters
for a summary of command syntax.

This utility can be used as a simple DOOR in systems that can provide
one or more filespecs for zipfile viewing.

This utility is compatible with PKware PKZ090.EXE, PKZ092.EXE and
PKZ101.EXE file formats.


Usage
-----
ziptv [-Pport] [-Tminutes] [-Llines] FILE[.zip] ... FILE [OUT]

-Pn Enables com port COMn and monitors carrier.
Local operation allowed with -P0.

-Tn Allows user to stay in program for n minutes.

-Ln Specifies lines per page in 'more?' prompts.


Example PCBVIEW.BAT for PCBoard 14.0 (dos 3.3 and later)
------------------------------------
@ziptv -p1 %1 >pcbview.txt


Example PCBVIEW.BAT for PCBoard 14.0 (dos 3.2 and earlier)
------------------------------------
echo off
ziptv -p1 %1 >pcbview.txt


Example PROD.CNF for ProDoor 2.9 (2-18-89 and later)
--------------------------------
; Archive manipulation commands
; list members, text to stdout, xtract file to file, test, rearc
ZIPtv -p$N$ -t$TIME$
pkunZIP -c >$R$
proxZIP >$R$
pkunZIP -t >$R$
prorarc $R$
.ZIP has errors!


Example PRO-R.BAT for ProDoor 3.0
---------------------------------
:zip
chkpath ziptv %0 >>%3
if errorlevel 1 goto end
ziptv -p%1 -t%2 >>%3 %4
if errorlevel 1 goto error
goto end


Revision history
----------------

2-16-89
Initial alpha test release. Not all compression methods are
implemented.

2-18-89
The 'unshrink' procedure is now working partially. It stops when the
'partial clear' code is received (this happens after about 30k of
text has already been seen). This version of ziptv is probably good
enough for general use. Look for a fix to this last unshrink bug in
the next week.

3-5-89
First fully operational release; should correctly unzip all
compression methods. First public release of source code.

3-10-89
Cleaned up error messages during carrier loss and timeout. Reduced
memory needs by about 12k during unshrinking.

3-14-89
Fixed a new bug in 3-10 version that caused endless message scrolling
when carrier was lost. Added code to detect local operation. If A
-p1 or -p2 parameter is provided, but carrier is not present when the
door initializes, it will assume "local mode via PCBoard" and will
disable the carrier check. This should allow sysop access to ZIPTV
via pcboard's F V function. If a caller is online and drops carrier
just as ZIPTV loses carrier, the program will time out and recycle
the board after the time specified in the -T parameter.

4-7-89
Corrected time-left calculation when crossing over midnight.

7-18-89
Added automatic support for EGA 43 line screen modes.
Added partial support for dos version 2.

9-1-89
Beta release supporting PKZ101 "implode" compression format. This
version has not yet been optimized for speed or memory and probably
has some bugs.
9-5-89
Optimized memory usage during un-Implode operation.
Added -L option to control lines per page.

9-9-89
Added support for non-standard COM port configurations. To use
com ports other than the normal COM1 and COM2, you can now insert the
following statements in your batch file:
SET COMBASE=nnnn ;port base I/O address (decimal)
SET COMIRQ=n ;port IRQ setting

Released as ZIPTV20.ZIP.


LICENSE
=======

SourceWare: What is it?
-----------------------

SourceWare is my name for a unique concept in user supported
software.

Programs distributed under the SourceWare concept always offer
complete source code.

This package can be freely distributed so long as it is not
modified or sold for profit. If you find that this program is
valuable, you can send me a donation for what you think it is
worth. I suggest about $10.

Send your contributions to:
Samuel. H. Smith
5119 N. 11 ave 332
Phoenix, Az 85013


Why SourceWare?
---------------

Why do I include source code? Why isn't the donation
manditory? The value of good software should be self-evident.
The source code is the key to complete understanding of a
program. You can read it to find out how things are done. You
can also change it to suit your needs, so long as you do not
distribute the modified version without my consent.


Copyright
---------

If you modify this program, I would appreciate a copy of the
new source code. I am holding the copyright on the source
code, so please don't delete my name from the program files or
from the documentation.




SUPPORT
=======

I work very hard to produce a software package of the highest
quality and functionality. I try to look into all reported
bugs, and will generally fix reported problems within a few
days.

Since this is user supported software under the SourceWare
concept, I don't expect you to contribute if you don't like it
or if it doesn't meet your needs.

If you have any questions, bugs, or suggestions, please contact
me at:
The Tool Shop BBS
(602) 279-2673 (2400) - Free node
(602) 264-3969 (HST 9600)
(602) 279-0230 (Hayes V9600)

The latest version is always available for downloading.

Enjoy! Samuel H. Smith
Author and Sysop of The Tool Shop.