
                              D O U B L E  V1.8

                              by John Augustine

  Double was written in Assembly for MS Dos systems, but it can also be used
via Windows.  It doesn't need much memory and no "installation" is required.

  PLEASE NOTE:

  This is NOT a "free" program. See "CONCLUSION" near the end of this document
for details on making a small "donation" and becoming a "donor".

  Please read, "IMPROVE.TXT" (use "HELP.EXE") for improvement information.

  TWO FILES FEATURE:

  Double allows you to view two files in text or hexadecimal mode at the same
time.  Also, you can view a single file.  Why would you want to view two files
at the same time?  There are many file compare utilities (including Dos's
"FC") that report differences between two files, but they don't clearly
indicate where these differences are located in the files.  That's why I made
Double.  Double allows you to view two files in two different formats, "Split
Screen" (top half for file 1 and bottom half for file 2) or "Interlaced"
(lines
1,3,5,etc. for file 1 and lines 2,4,6,etc. for file 2).

  SEARCH FOR DIFFERENCES MODE (V1.3):

  Search mode (option) searches for differences between two files and stops
the search, displaying the differences highlighted on the screen.  You can
use this feature to compare two files automatically.  You don't have to
bother looking for the differences.  This is especially useful when the files
are very large, and you don't want to spend a lot of time viewing each "page"
for highlighted differences.  If the difference is as small as a period, it
is possible to miss it by visual comparison, even with the "HiLite" feature.

  IMPORTANT NOTE:

  If a file compare utility indicated a difference between the two text files,
it is possible that a non-text character/s may be the reason.  For this
reason, I recommend not using the Character screening (text mode) option which
replaces non-text characters with spaces.

  SEARCH FOR A TEXT PATTERN (Double View, Split Screen) (V1.7).

  This feature can be very useful when you want to compare the same procedure,
chapter, etc. in an older version of a document or source code to the same in
a new version.  Due to changes in the new version, the location of a specific
procedure/s (etc.) will not be the same.  This makes it difficult to locate
for comparison.  That's why this feature was added.  All you have to do is
enter the name, title, chapter with number ("Chapter 8"), etc.

  "HiLite" FEATURE (V1.2)

  1. You can "HiLite" (High Light) characters that don't match between the two
files.  The position of each character in the display is VERY IMPORTANT
because each character is compared by position to it's "counterpart".
Example: In Interlace Mode, the first character in top line (display) of file
1 is compared to the first character in second line down of file 2, etc.  The
same position compare applies to Split Screen mode.  If one character is
different, it is difficult to spot without this feature.  Use the space bar to
toggle HiLite on or off.

  2. This feature can be used to quickly locate where in a file, additions
were made or something was removed (when comparing to the original), by
scanning through both files at the same time.  Tip: Use Search mode.

  3. This feature can be used to locate similar (example: paragraphs) between
two files or the same file (enter the same file name for file 1 and 2).  If
you are looking for a similar part of the same file located elsewhere, press
F1 or F2 keys to move only file 1 or file 2 (F3 makes both files movable).  As
you scan (pressing Up/Dn keys), a similar part will have a small amount of
HiLited characters.

  IMPORTANT HiLite Note:

  If the lines of one file were shifted downward or upward by 1 line so that,
say line 100 of file 1 is the same as line 101 of file 2, then the HiLite
feature may be misleading at first.  What looks like identical lines will show
up HiLited because they are at the wrong line position.  Remember, in
Interlace mode, line 1 (display) is compared to line 2 (second line down from
the top), line 3 is compared to line 4, etc.  To correct this, adjust one file
with respect to the other so that line 1 (file 1) is the same as line 2 (file
2), etc.  You can see this misleading effect by selecting the same file for
file 1 and file 2.  Shift file 2 by one line with respect to file 1.

  "SEEK DOUBLE" DUPLICATE OR MORE LINES IN A FILE:

  This feature allows you to search a file, normally a text type file, for two
or more consecutive lines that are duplicate, in part or whole (up to 80
columns).  The depth into each line for comparison is adjustable from 1 to 80
columns.  Note: The comparison is case sensitive.

  IMPORTANT "SEEK DOUBLE" NOTE:

  To be effective, lines must not exceed 79 characters in length.  Otherwise,
the line/s will "wrap" into another line/s on screen.  Note: The comparison
is performed in screen memory.

  EXAMPLES FOR USING DOUBLE:

 1.  I copied the Windows "SYSTEM.INI" and "WIN.INI" to another directory (as
backups) before installing a new Windows based application.  This new
application modified those files in the Windows directory.  I used DOUBLE to
view the differences between the backup versions and the modified versions.
It was easy to spot.

 2.  Someone modified your financial records behind your back, but you have a
back up.  You can use DOUBLE to see all the changes.

 3.  Compare, in hex mode, the boot or MBR sector from your hard disk/drive,
you saved earlier, to the current boot or MBR (or those of another hard disk
or logical drive) to see differences.  Note: Use "Sector Access" (see
"OTH-PGMS.TXT") to copy those sectors into files.

 4.  Compare modifications in source code or a document to that of an older
version.

 5.  Seek duplicate lines in a list of songs sorted in alphabetical order.

  GETTING STARTED:

  Type (without quotes) "DOUBLE FILE1 FILE2" and press Enter

  or

  Type "DOUBLE" and press Enter (you can enter or "Select" the file name/s
later).

  If you want to view two files, one in another directory, simply enter the
path\filename for the file in the other directory.

  IMPORTANT NOTE:

  During the Double View or Search mode, the path(s) is removed (V1.5 feature)
and only the filenames are displayed due to the limited space.  Without the
path removing feature, the display could be corrupted.

  CONTROL KEYS:

  The Tab (PgDn X 10), PgUp, PgDn, Up and Dn (arrow Up/Dn) keys moves through
both documents at the same time, unless you press F1 or F2 keys to make only
file 1 or file 2 movable (not both).  If you encounter a part that had
additions (say in file 2) which "pushed" the rest of the document downstream,
you can move file 2 while file 1 remains stationary by pressing F2.  Now the
Up/Dn keys will only move file 2.  NOTE: Pressing F3 makes both files movable.

  "END" KEY COMMAND WHILE VIEWING TWO FILES:

  Pressing the "End" key to go to the end of a document, will stop when the
end of either file 1 or file 2 is reached first (nearest), unless F1 or F2
keys had been pressed.  Press the End key again (both files movable) to reach
the end of the other file.  Note: If you are at the end of one file, and you
press a different key afterwards, press End twice to move to the end of the
other file.

  INPUT FILENAMES 3 WAYS:

  Note: "F1_NAME.TXT" & "F2_NAME.TXT" represent the names of files.

  1. Type "DOUBLE F1_NAME.TXT F2_NAME.TXT" (Without quotes) and press Enter.

  2. Within DOUBLE, you can type the file name (or change it) at the file name
     prompt.

  3. Instead of typing a file name/s at the file name prompt, press F1 to
     select from a list of all the files in the current directory displayed in
     alphabetical order.

  CONCLUSION:

  This is NOT a "free" program.  A one time donation is expected.  You choose
the amount ($5.00 minimum).  For your donation, you will become a "donor".
Your name, etc. will be added to the "donors" list.  As a "donor" (one time
donation), you can select (ask for) one or more programs to receive FREE such
as "Tree Restore", etc.  See (use "HELP") "OTH-PGMS.TXT" for information
about other programs.  Please include your e-mail address with your donation,
and the name/s of the other program/s you want (if any).  I will tell you in
the email message about the attachment (programs.zip) so you know it is safe
to open.  As a "donor", you will be entitled to receive all improved and new
programs (at your request) developed in the future (sent to you by e-mail).
As a "donor", you may request (from time to time) the latest list of programs
from which you can select to receive FREE.  If you know another shareware
author with a better offer, please let me know.

  The donation will motivate me to develop more programs and make improvements
in existing programs (add new features).

  Comments or complaints are always welcomed via email.  If you use "snail
mail" and expect a reply, please include a S.A.S.E.

  If you are overseas, the local bank charges a $10.00 service fee for checks
outside of U.S. I recommend that you send U.S. cash instead.

  Send $5.00 (or more) check, money order, or cash (put in foil for security)
to:

                     John Augustine N3AOF
                     3129 Earl St.
                     Laureldale, Pa 19605

            E-Mail:  jaugust@bellatlantic.net

