*****************************************************************************

This is the README file for the PORTAGE application and VxD
for Windows 3.1 and Windows 95.  If you follow the directions
given below, you should have no problems building the code
and adapting it to your own work.

Please direct any questions, comments, or inquiries to:

Don Matthews
Matthews Consulting
P.O. Box 776
Woodland Park, CO  80866

719-687-3225
matthews@rmii.com
72262,46

*****************************************************************************

You should have the following two files:

README.TXT   (this file)
PORTAGE.EXE  (a self-extracting ZIP file)

When you run PORTAGE.EXE, be sure to specify the -d option, so that
sub-directories get created, as shown below:

portage -d

You may place the code wherever you wish, but for quick and easy building,
with minimal changes to the MAKE files, you should follow the directions
shown below:

1.)  On your C drive, go to the root and make a sub-directory called PORTAGE.
2.)  Copy PORTAGE.EXE to that sub-directory.
3.)  Go to the sub-directory PORTAGE and type the following:  portage -d
4.)  You can delete PORTAGE.EXE at this point, since you no longer need it.

To build the Windows 3.1 application:
------------------------------------

1.)  Start up Visual C++ version 1.52.

2.)  From the Project menu, choose Open, and select the following file:
     
     c:\portage\w31\app\portage.mak

3.)  When asked if this is an external makefile, select YES.

4.)  When asked if you would like to create PORTAGE.C and PORTAGE.H,
     select Cancel.  Those files already exist in your directory, but
     they used to exist on drive D when the code was ZIPped up.

5.)  To build the code, choose Rebuild from the Project menu.

6.)  To close the project, choose Close from the Project menu.

To build the Windows 3.1 VxD:
----------------------------

You will need the following files (from the Windows 3.1 DDK)
in order to build the VxD:

c:\win31\ddk\386\tools\masm5.exe
c:\win31\ddk\386\tools\link386.exe
c:\win31\ddk\386\tools\addhdr.exe
c:\win31\ddk\386\tools\mapsym32.exe

c:\win31\ddk\386\include\vmm.inc
c:\win31\ddk\386\include\debug.inc

1.)  Start up Visual C++ version 1.52.

2.)  From the Project menu, choose Open, and select the following file:
     
     c:\portage\w31\vxd\portage.mak

3.)  When asked if this is an external makefile, select YES.

4.)  When asked if you would like to create PORTAGE.ASM and PORTAGE.INC,
     select Cancel.  Those files already exist in your directory, but
     they used to exist on drive D when the code was ZIPped up.

5.)  To build the code, choose Rebuild from the Project menu.
     
     Note:  Don't worry about the fact that the Visual C++ IDE
     reports one error and one warning.  You can see for yourself
     from the output that there are no errors and no warnings.

6.)  To close the project, choose Close from the Project menu.

To build the Windows 95 application:
-----------------------------------

1.)  Start up Visual C++ version 2.1.

2.)  From the File menu, choose Open, and select the following file:
     
     c:\portage\w95\app\portage.mak

3.)  To build the code, choose Rebuild from the Project menu.
     
     Note:  If your screen goes blank, don't worry.  This is
     a problem that was introduced in Visual C++ 2.1, but is
     not in Visual C++ 2.0.  To get back to Visual C++, simply
     hit Alt-Tab.

4.)  To close the project, choose Close from the File menu, when the main
     project window is highlighted.

To build the Windows 95 VxD:
---------------------------

You will need the following files (from the Windows 95 DDK)
in order to build the VxD:

c:\win95\ddk\bin\link386.exe  (this is actually from the Windows 3.1 DDK)
c:\win95\ddk\bin\addhdr.exe   (this is actually from the Windows 3.1 DDK)

c:\win95\ddk\inc32\vmm.inc
c:\win95\ddk\inc32\shell.inc
c:\win95\ddk\inc32\debug.inc

You will also need the following files (from MASM 6.11)
in order to build the VxD:

c:\masm611\bin\ml.err
c:\masm611\bin\ml.exe

You will also need the following files (from SoftICE/W)
in order to build the VxD for debugging:

c:\winice95\msym.exe  (this can actually come from SoftICE for Windows 3.1)

1.)  Start up Visual C++ version 2.1.

2.)  From the File menu, choose Open, and select the following file:
     
     c:\portage\w95\vxd\portage.mak

3.)  To build the code, choose Rebuild from the Project menu.
     
     Note:  If your screen goes blank, don't worry.  This is
     a problem that was introduced in Visual C++ 2.1, but is
     not in Visual C++ 2.0.  To get back to Visual C++, simply
     hit Alt-Tab.

4.)  To close the project, choose Close from the File menu, when the main
     project window is highlighted.

To run the Windows 3.1 application and VxD:
------------------------------------------

1.)  Install the VxD by editing your SYSTEM.INI file as shown below:

     [386Enh]
     device=c:\portage\w31\vxd\portage.386

2.)  Start up Windows 3.1, choose Run from the File menu, specifying the
     following file:

     c:\portage\w31\app\portage.exe

To run the Windows 95 application and VxD:
------------------------------------------

1.)  Install the VxD by editing your SYSTEM.INI file as shown below:

     [386Enh]
     device=c:\portage\w95\vxd\portage.386

2.)  Start up Windows 95, choose Run from the Start menu, specifying the
     following file:

     c:\portage\w95\app\portage.exe

     Note that under Windows 95, you can run both the 16-bit Windows 3.1
     application and the 32-bit Windows 95 application with the Windows 95
     VxD.