home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR4
/
WSP150.ZIP
/
WSP1.DOC
< prev
Wrap
Text File
|
1993-06-11
|
16KB
|
356 lines
<< WSP.DOC >>
WSP version 1.50 ;Binary Diff Update Program
-----------------------------------------------------------------------------
1992/12/23
amapro Wakichi
-----------------------------------------------------------------------------
WSP.COM compares two files and extracts smallest
possible difference in a file with extension WUP.
WSP.COM updates OLDFILE with WUP-file, to NEWFILE.
WSP.COM makes SelfUpdating COM file. Namely, you can put a SelF-eXtracting
header to WUP of size less than 1 Kilobyte.
Then you may run this file to upgrade all OLDFILE into NEWFILE.
This SFX.COM knows everything you just run and get upgraded.
WSP.COM works as DIFF.EXE, and as PATCH.EXE of Larry Wall. With BINARIES!
WSP.COM is an ideal tool for shareware authors because of the minimum
costs of communication expenses, and the ease of upgrading for
your customers. Or if your database files are formattedbut wth the sa
but with different contents, you may take differences and compact the
storage by eliminating the formatting frames.
WSP.COM works under generic MS-DOS.
WSP.COM is FREE for loyalty, FREE to use, and FREE to distribute.
You may distribute WSP150.lzh file and use for shareware
distributions. You may distribute your upgrading files in
SelF-eXtracting.COM file without our permission. You may use
WSP.COM for your commercial distribution, as long as
you attach our copyright statement somewhere.
-----------------------------------------------------------------------------
WSP.COM features:
(1) WSP compares ASCII and Binary files byte by byte and tries to make
smallest possible diff-file, ignoring common parts of files.
WSP extracts difference even from two different files as far as
there are some common parts among them.
(2) WSP makes self-updating COM file with a small header of size less than
1KB. You just run this self-extracting self-executing COM file to
update your customers.
(3) You may add a telop file to the DIFFFILE explaining what the COM is to do,
You may use this message to instruct users how to update, and whether
the update was complete.
(4) WSP.COM has a tiny size, runs very fast., and has a simple command structure.
(5) WSP.COM takes number of distinct DIFF files together to update
number of files by a single COM file.
(6) WSP.COM displays while it is making difference. You will see from
this display the part where two files differ by bar charts.
(7) WSP.COM keeps the file size, time stamps and CRC of both old and
new files. Alert for the unexpected changes in the files and for
possible infection from Virus in your system.
-----------------------------------------------------------------------------
Usage:
You need at least 256KB of free memory to use this software.
When you are to use this program as a child process, you may
fail to update or properly update your files.
You may use both '-' and '/' for switch character. You may write
options successively when you use more than two options except for
the message options, see below for messages.
The following message will be displayed when you type WSP from
your command line.
-----------------------------------------------------------------------------
C>WSP
WSP version 1.50 FILE UPDATING UTILITY ; copyright (C) amapro Wakichi 1992-93
==============================================================================
[1] To update a file with .WUP file:
WSP [-D | -T, B] diffile[.WUP] [outdir\]
-D: display .WUP -T: overrides Time Stamp of OLDFILE
-B: do not backup old.file(s).
[2] To make .WUP DIFFFILE.
WSP [-A, M,!,Pn,Qn,Rn,W,N,O,L] OLDFILE NEWFILE [DIFFFILE[.WUP] | selffile.COM]
-A: Add or Assemble .WUP files into one.
-M:-M=MSGFILE Display msgfile at the termination
-!:-!=msgfile Display msgfile as the telop before execution.
-P: n (n=1-255) Default P21 minimum off set for pointer.
-Q: n (n=1-255) Default Q7 minimum bytes for comparison.
-R: n (n=1-255) Default R18 minimum bytes for a match.
-W: Let WSP try to make minimal sized DIFFFILE
-N: Use NEWFILE name when OLDFILE and NEWFILE have distinct name.
-O: Use OLDFILE name when OLDFILE and NEWFILE have distinct name.
-L: Extract Diff in old format 1.20
[3] To make a self-updating COM file.
WSP -S diffile[.WUP] [selfupd [.COM]] Specify any name for COM.
------------------------------------------------------------------------------
WSP.COM is a copyright reserved FREE software. You may Distribution and Use
this software without our permission, without any loyalty.
[1] How to update.
WSP [-D | -T, B] difffile.wup [output directory]
By default, WSP names all diff-file with extension .WUP.
Example: You want to update UFO.COM, you have old UFO.COM and UFO.WUP
on your current directory. Then type:
A>WSP UFO
You have to have the old-file on your current directory, but you may
specify .WUP file from different directory with full path name.
When you update FILE.exe with FILE.WUP, you will get new FILE.EXE
and you are left with $ILE.EXE as the backup. When you already have
$ILE.EXE on your directory, you will be asked
"$ILE.EXE exits Overwrite [Y/N]?"
Answer Y if you don't need the older version of FILE.EXE.
Answer N and copy $ILE.EXE to some other place for your reference.
Then proceed with back up. A FILE with the name starting with $
is backuped with the name '$' replaced by '!'.
When you don't need the older version, use '-B' option.
Older file is replaced by Updated file.
C>WSP -B C:\SOFT\UFO
will erase old UFO.COM in the current directory and replace it with
new UFO.COM. using UFO.WUP in the directory C:\SOFT as updating
DIFFFILE.
You may specify the directory of updated new file.
C>WSP B:UFO C:\
Old UFO.COM is in the current directory, UFO.WUP is in the drive
B: and you get the new UFO.COM in the root directory.
Remember you have to put '\' to specify a directory.
To DISPLAY the content of a diff-file, use '-D' switch.
C>WSP -D UFO
UFO.WUP is supposed to be on your current directory.
What You see is the message:
"UFO.WUP :OLDFILE name date, time -> NEWFILE name, date, time."
WSP.COM checks the TIME STAMP and FILE SIZE of the original file.
If you have copied or touched the TIME STAMP or padded some codes
you are refused by WSP to update. Use switch '-T' to override
this difficulty.
C>WSP -T UFO
C>Self_Upd.COM
Selfupdating COM file is an executable. Just type the name of
the self-updating COM file while OLDFILE is on your current directory.
This COM file always back up the OLDFILE with the name first character
replaced by '$', as FILE.EXE is backed up with $ILE.EXE. If you already
have $ILE.EXE on your current directory, self-updating COM will not ask
you and overwrites the older file.
You may use self-updating COM file as a .WUP DIFFFILE.
You may display the contents by
C>WSP -D self_upd.COM
or you may update retouched OLDFILE ignoring the Time Stamp by
C>WSP -T selfupd.COM
-----------------------------------------------------------------------------
[2] How to make a .WUP file.
WSP [-A, M,!,Pn,Qn,Rn,W,N,O] OLDFILE NEWFILE [DIFFFILE]
Basic Usage.
C>WSP B:UFO.COM C:UFO.COM
You update OLDFILE UFO.COM in B: drive to NEWFILE
C:UFO.COM with UFO.WUP on the current directory.
You don't need to specify the name of updating diff-file.
When you have to use some specific name for updating
DIFFFILE, especially when you are to make self-updating
file.
C>WSP B:UFO.COM C:UFO.COM UFO_UP
You get UFO_UP.WUP on your current directory.
NEWFILE name is not necessarily the same with
the OLDFILE. NEWFILE name overrides the OLDFILE
name.
When WSP is working to make DIFFFILE, WSP shows a bar chart showing
progress and what it does. WSP print "=" when it sees common part and
"*" when it sees different part. Caution, WSP shows displays signs
"=" or "*" per 64KB block. Hence if WSP makes up a DIFFFILE of size
more than that, WSP is not displaying a rough map of what it does.
-----------------------------------------------------------------------------
Options.
-A:
Add or Assemble .WUP files into one. You can update executables and
documents with one updating .WUP file.
C>WSP B:UFO.COM C:UFO.COM UFO-UP1
C>WSP B:UFO.DOC C:UFO.DOC UFO-UP2
C>WSP -A UFO-UP1 UFO-UP2 UFO-UP
Two WUP files UFO-UP1.WUP and UFO-UP2.WUP is assembled in UFO-UP.WUP.
-M: Message can be displayed when an error occurred.
A>WSP -M=B:MSG.TXT B:UFO.COM C:UFO.COM
MSG.TXT is included in UFO.WUP. The maximum size of message
is 510 bytes.
-!: Telop file to display at updating.
C>WSP -!=B:MSG.TXT B:UFO.COM C:UFO.COM
MSG.TXT will be displayed when you start updating. Here is a
sample:
You are updating your older version of UFO.COM to newer
version. You have to have your UFO.WUP on your current
directory. Your new UFO.COM is generated here and your
old UFO.COM is supposed to be in C:\SOFT\. Are you ready [Y/N]?
There is no restriction in the size of this MSG.TXT.
You can only use up to 23 lines when you don't want to miss
any line of text.
-P: Minimum offset for the Pointer. (n=1-255) default:21
-Q: Minimum length of replacement for a match.(n=1-255) default: 7
-R: Minimum length of a match. (n=1-255) default:18
These three options affect the size of .WUP file.ü@ü@ü@
For text files with small changes, like proof readings,
larger values of P, Q, R will decrease the size dramatically.
-W: Optimal .WUP file construction. Time consuming, but makes
relatively small .WUP file, almost always. This option is
particularly effective if your data were sorted with different
key, for an example. WSP may fail to generate smaller DIFFFILE
in case of two very similar files. Display character "=" changes
into ">" with this option.
-N: NEWFILE Name by default.
-O: OLDFILE Name by default.
When you try to update files with different names, you may choose
either one of two names as the NEWFILE name. Useful when your
.WUP file contains several distinct .WUP files.
-L: WSP generates DIFFFILE compatible with Version 1.20 or earlier.
WSP ver.1.50 is upper compatible and hence can update any file
made by all versions. However versions 1.20 or earlier had diff-
erent file headers.
-----------------------------------------------------------------------------
Remark. Some known tips to generate minimal sized DIFFFILE.
(1) Changing Q-option will show you an immediate change in size.
Try the values Q4-Q20 first.
(2) -W option is time consuming but results in a favorable diff-file
generally. However, if you compare two small files, you may
run into a larger DIFFFILE.
(3) -P option has the default value P21. When you change the value,
you had better change with step 10, from P10-P200.
(4) -R option would not change the size of DIFFFILE from certain
values up. Set large values for Text files.
I recommend to change -P,-R first. Then try -W option.
Finally increase -Q option starting with the value Q4.
-----------------------------------------------------------------------------
[3] How to make a self-updating COM file.
There are two ways to make.
(a) Sepecify .COM name for DIFFFILE.
C>WSP B:UFO.COM C:UFO.COM UFO_SUP.COM
WSP.COM will automatically generate a self-extracting and self-executing
COM file. I emphasize, the size of DIFFFILE must be less than 60KB.
(b) Make with -S option form .WUP file(s).
WSP -S DIFFFILE [.WUP] [sfxupdt[.COM]]
WSP -s DIFFFILE
You can't make a self-update file from a .WUP file of size more than
60KB. You don't need to type .WUP or .COM. 'Sfxupdt.com' can be any
name.
Example
A>WSP -S UFO UFO_SUP
UFO.WUP has SFX header and becomes UFO_SUP.COM that updates
UFO.COM to a newer version.
----------------------------------------------------------------------------
[4].
WSP.COM is a new simple tool to update your informations. There are so many
documents, databases or communication BBS's which are updating contents
every moment. I wish WSP.COM to help you decrease your troubles and amount
of Disk storages by keeping the differences only. Please try and send
your suggestions or bug reports. Please send them through:
kenjirou@mathdent.im.uec.ac.jp
K.Okubo on GEnie
74100,2565 Compuserve.
Finally I gratefully acknowledge the kind cooperation of K.Okubo
for the preparation of this English Document, and my friends who contributed
fresh ideas and bug reports during the designing and upgrading of this
program.
amapro Wakiti Koichi Wada.
-----------------------------------------------------------------------------
Revision History
version 1.00 92/09/05 First Version
Version 1.01 92/09/13
(1) There were some hardware specific problems in managing memories.
More general routines were devised.
(2) Abnormal behavior corrected when there were Upper and Lower characters in
file_names.
(3) Self-updating accepts -T option from this version on.
(4) Back_up file name was changed form .BAK to $*.*.
(5) New options -B and -Q were introduced.
Version 1.11 92/09/26
(1) Graphic display in the extraction of DIFFFILE was introduced.
(2) Option -! to show telop file. Telop is displayed with self-updating
file, too.
(3) Option -M to display a message upon the completion.
(4) New switches to enforce default names -N and -O.
Version 1.12 92/09/28
(1) Fill the gap between 64KB barrier between OLDFILE less than 64KB and
NEWFILE greater than 64KB.
(2) A new graphic display is designed for the case when the NEWFILE size
is greater than 64KB. Display is always in one single line now.
Version 1.20 92/12/23
(1) Some machine dependent escape sequence is removed.
(2) A bug in graphic display is corrected. When the size of a file is
too small, display looked froze.
(3) Disk Full Warning is newly added.
Version 1.50 93/06/01
(1) New DIFFFILE format for smaller file size.
(2) New version with English message were added.
(3) New Display while making up DIFFFILE.
(4) Self-Validation check for updating the original file.
(5) Following Bugs fixed:
Hang Up in extracting a new DIFFFILE.
Failed to make correct DIFFFILE in making DIFF of more than 60KB.
Forced the extension .COM to self-updating file of size more than 64KB.
(6) Some of Parameters were changed.
File descripter had 25 bytes max-size, now 47 size.
Option switches may be written successively without '-' interruption.
You don't need '\' at the end of path specification.
(7) If WSP sees no file specified in -A option, a void file is added.
Similarly, WSP dose not delete DIFF for non-existing update, keep original.
Display for Self-Updating COM is modified.
New option -L is added for compatibility.