Restore 6.4 build: 9639 released: 2009-03-09

Restore old MS DOS floppy backups.

Copyright: (c) 2017 Canadian Mind Products.

asm command line utility.
Download from: http://mindprod.com/products4.html#RESTORE

----

Notes:

This program can only be used from the command prompt, (or via an command
line style icon shortcut) e.g. under Windows command.exe or JPSoft
tcmd.exe, formerly called the DOS box. Just clicking the programs in a
directory listing will not do anything useful. Just typing the program
names at the command prompt will not either.

This program requires a manual install! See below.

This program works with vanilla text files, (e.g. ASCII files or UTF-8
Unicode files). You will need a text editor to create and view them, not a word
processor. e.g. notepad, Visual Slick Edit or other suitable text editor
http://mindprod.com/jgloss/editor.html. You must use a monospaced font
http://mindprod.com/jgloss/monospacedfonts.html (aka fixed pitch, aka
programmer font) to view your files, or they won't look properly aligned.

I put out an avalanche of free software into the world, and submit PAD
files to hundreds of distribution sites, but I rarely hear back from
anyone.  What's happening?  Does it all just work fine?  It is so
complicated nobody can figure out how to use it and they give up on it?
It is it useful?  Since everyone has the source, do people just fix the
programs to their liking themselves?  Did you have trouble installing?  Do
I presume you know too much?  I would be happy to hear from you about your
experiences, positive or negative and your requests for improvements.  A
one-line email to roedy@mindprod.com would be great.

===> Free <===
Full source included.
You may even include the source code, modified or unmodified
in free/commercial open source/proprietary programs that you write and distribute.
May be used freely for any purpose but military.
For more details on this restriction, see
http://mindprod.com/contact/nonmil.html
If you include any Canadian Mind Products code in your own applications,
your app too must be labelled non-military use only.
http://mindprod.com/contact/nonmil.html
All ASM source and EXE files code are included.

----

Prerequisites:

This program runs under Microsoft Windows or DOS only (e.g. Win2K/XP/Vista) in a DOS compatibility box).

----

Installing on a PC:

Download source and executable files to run on your own machine as a standalone utility.
To install, extract the zip download with WinZip
(or similar unzip utility) into any directory you please,
often J:\ --  ticking off the <span class="click">use folder names</span> option.

----

Installing on a MacIntosh:

This assembler program will not run on a Mac.

----

Rebuilding:

The zip already contains the necessary exe, so unless you modify
the program, there is no need to recompile the source or re-assemble it..
Configure.java basedir="E:/" in rebuild.xml to the drive where your files are and tweak rebuild.xml.
Use ANT and rebuild.xml, not build.xml, to reassemble and link.

----

Use:

RESTORE 6.3 is freware replacement for the official DOS Restore.
    It restore old MSDOS or PCDOS floppy backups.
    What's wrong with the official DOS Restore versions 2.0 to 7.0.
1.  You may no longer have the PC DOS or MS DOS softaware or
    know how to install it.
2.  The DOS 3.2 version according to a Microsoft technician has 22
    reported bugs.  It is "the lemon of MS DOS" to use his phrase.
3.  Under DOS 3.2, MS DOS and PC DOS use incompatible formats for
    Restore diskettes.  You cannot restore files backed up on
    IBM PC DOS to an MS DOS system and vice versa.
4.  DOS 3.2 and 3.3 disk formats are incompatible. You cannot
    restore files backed up on DOS 3.3 to a machine running DOS
    3.2.  Version 3.2 Restore will not run under DOS 3.3, etc.
5.  DOS 5.0 restore can now read DOS 3.2 backups, but not vice versa.
6.  DOS 6.0 backup is completely incompatible with earlier versions.
Canadian Mind Products Restore works under all versions of PC
and MS DOS from 2.0 to 7.0 and will restore diskettes created by
DOS BACKUP 2.0 through 5.0.  It runs fine under Windows or OS/2
in the DOS emulation box.
This allows you to restore your backups even if you have changed
operating systems.  It also allows you to distribute large files
or programs on floppy to people running an unknown variety of
operating systems.  This is how the Federal Aviation
Administration distributed code to all the airports.
WARNING! RESTORE only works with 8.3 filenames.
Copyright: (c) 1986-2017 Canadian Mind Products
freeware
May be freely distributed and used for any purpose but
military. For more details on the restriction, see
http://mindprod.com/roedy.html#NONMILITARY
The only restriction is that this is for non-military use
only.
The command line options are compatible with PC and MS Dos restore.
Syntax
======
 RESTORE.COM A: [C:][path\][filespec] [/S] [/P] [/Q]
 Where:
 A:      = source floppy drive, i.e. A:, B:, etc.
 C:      = target hard drive, i.e. C:, D:, etc.
 path    = the directory where the files will be placed.
 filespec = the specification of files to be restored.
           May include wildcard chars. * and ?.
 /S      = restore subdirectories also.
 /P      = prompt before restoring each file.
 /Q      = quiet, suppress advertising banner.
Samples of Use
==============
 RESTORE.COM A: C:\*.* /S /P    -- restores all files, letting you
                                   decide which ones to restore individually.
 RESTORE A: C:\*.BAT/S          -- restores all BAT files in all
                                   subdirectories.
 RESTORE A: C:\MySub\MyFile.Ext
 RESTORE A: C:\MySub\*.*/P/S/Q
 RESTORE A: C:\MySub/P
 RESTORE A: C:\MySub
 RESTORE A: \MySub              -- presumes default drive
 RESTORE A: C:*.*               -- presumes default directory
 RESTORE A: C:\*.BAT/S          -- restores all BAT files in all
                                subdirectories.
 It is not as elaborate as the commercial versions, only the /S
 and /P switches are supported.
Version 6.2 displays the new address and phone number.  Also
documentation and program listings clarify the use of Restore
under DOS 5.0 and 7.0.  Clarification on site licenses and bundling
restore to install your software.
ASSEMBLING
You can use the ANT scripts, or assemble and link manually.
REBUILD.XML is a simple restore build that presumes all files are already in the project directory.
Build with ant -f rebuild.xml zip
Assemble restore using ANT
Invoke with [ant clean] to erase class files and start over.
Invoke with [ant assemble] to just assemble and link.
Invoke with [ant zip] to create zip files containing source and executables.
You must have ml.exe, ml.err (the assembler) and link.exe on the path.
You can get ml.exe 6.15 from http://download.microsoft.com/download/vb60ent/Update/6/W9X2KXP/EN-US/vcpp5.exe extract with WinZip.
You can get link.exe 5.6 from http://download.microsoft.com/download/vc15/Update/1/WIN98/EN-US/Lnk563.exe and extract with WinZip.
ml.exe/link.exe 9.0, bundled with Visual C++ Express available from http://www.microsoft.com/express/download/#webInstall,
will NOT work unless you modify the ANT script and modify the source code drastically.
You could assemble manually with:
ml.exe /AT/c /Fl /Zf restore.asm
and link with:
link.exe /MAP /TINY restore.obj,restore.com,restore.map;
For details of ANT use, see http://mindprod.com/jgloss/ant.html


----

Version History:

 1.0 1985-11-01 not released to the public
                restored all files ignoring the filespec

 2.0 1986-12-25 /P /Q /S options.
                allowed you to select files to be restored.

 3.0 1987-01-28 released to Charware subscribers
                fixed bug when restore had to handle 10 or more diskettes.

 4.0 1987-03-05 fixed bug RESTORE A: C:*.* /S in root directory did not work.
                was treated as RESTORE A: C:\\*.* /S instead of C:\*.* /S
                fixed bug.  Originally all disks in the backup set were
                checked to makes sure they were created on the same day
                to make sure they were part of the same set.  Because backups
                can be created with the /A option, it is possible each diskette
                in the set is part of a different set.  Thus the check was
                removed.

 4.1 1987-05-08 version number now prints as part of the "Screwed up" message
                RESTORE.TXT documention separated from ASM source code
                change mailing address

 4.2 1987-07-09 beeps when wants disk

 4.3 1988-04-09 change of mailing address in banner

 4.4 1988-12-24 change of mailing address in banner

 5.0 1989-03-03 very limited distribution
                added support for DOS 3.3 through DOS 4.01
                this was a major rewrite that took many times
                longer to write than the original.  For this
                reason Version 5.0 is not Charware, but rather
                ShareWare.

 5.1 1989-05-24 more friendly, simpler, less technical error messages.
                fancier prompts.
                tidier source code.
                bug fixed that restored a file fragment when you inserted
                the wrong diskette.
                avoid reprompting entire prompt when input bad.
                Abort Retry Ignore keystrokes no longer echo.
                / options no longer picky about leading space.
                warning message if source not A: or B:
                warning message if target not C: through G:
                fancier banner, with pause

 5.2 1989-07-26 add extra blank line ahead of insert disk prompt
                extra information on site licenses
                separate registering text.
                now assembled with Optasm

 5.3 1990-02-05 there are bugs in DOS 2.0 and 2.1 that can
                interfere with Restore.
                changes to Default_Subdir now account for the
                DOS bug when DOS gives mixed upper and lower
                case for the current directory and when DOS
                sometimes give directory names that are
                too long.

 5.4 1990-08-03 better explanation of registration in banner.

 5.5 1990-10-13 new documentation warning that RESTORE cannot restore
                to a different directory.
                new docs on how to handle problem of a restoring a backup
                when you don't know what is on it.
                better heading in the docs
                now works on LANS, no more IOCTL calls on hard drives.
                ^ now accepted as valid character in a filename.
                You can now assemble RESTORE in a way that makes it
                more suitable as an install program for multi-disk
                software packages.
                Some versions of DOS and some cachers have a bug that
                they fail to notice when you change the diskette in a
                floppy drive and thus give the program data from the previous
                diskette instead of the current one.  To bypass this
                bug I added a disk reset just prior to each diskette
                swap.  The symptom is that the program claims diskette
                1 is in the drive, and demands diskette 2, when in fact
                you have already inserted diskette 2.

 5.6 1992-02-06 notes that works on DOS 5.0

 6.0 1993-06-17 notes on DOS 5 and DOS 6 use.
                new address and phone number.
                new information on site licensing.

 6.1 1996 10-29 embed Quathiaski address
                notes on DOS 7.0.

 6.2 1998-11-08 embed Barker address

 6.3 2007-07-21 now free

 6.4 2009-03-09 bundled with ANT build script.

-30-