_______________________________________________________________________
_______________________________________________________________________

 Building PSPRINT
_______________________________________________________________________
_______________________________________________________________________

 The PSPRINT driver combines open-source patches and resources with
 restricted-source files from IBM's DDK. This package contains the
 open-source components. You will have to obtain the DDK components
 elsewhere. When combined using the instruction below, the end result
 will be a completely self-contained development environment with no
 external dependencies except your copy of VACPP (3.08 or 3.65).

_______________________________________________________________________

 One-time Setup
_______________________________________________________________________

 The initial setup for PSPRINT involves three activities:
   * copying and modifying the 'print\' tree from the DDK
   * applying patches
   * configuring 'build.cmd' so it can find VACPP

 The steps below will guide you through each activity.

_______________________________________________________________________

 === DDK ===

 0- create a root directory for this project

 1- copy the 'print\' directory and all of its contents from
    the DDK to your project's root directory. Do NOT rename
    your copy of the 'print\' directory.

 2- rename 'print\mri\en\osdd\pscript\post32' as 'psprint'

 3- rename 'print\src\osdd\pscript\post32' as 'psprint'

 4- unzip 'new_ppds.zip' into 'print\mri\en\osdd\pscript\ppd'

 5- unzip 'icons.zip' into 'print\src\osdd\pscript\psprint';
    let it overwrite the existing icons

 6- copy 'nmake.exe' from the Warp4.5 Toolkit or DDK into
    'print\tools\os2.386\bin'

 7- replace 'print\obj\os2c\r206\lib\os2386.lib' with the
    version from the Warp4.5 ToolKit

 8- optional;
    in 'print\mri\en\osdd', delete \42xx \mini \omni \plotter
    in 'print\src\osdd', delete \42xx \ft32 \mini \omni \plotter
    in 'print\src', delete \testtool

 Note: if you are creating an SVN repo, you must use the "--no-ignore"
       flag when importing to ensure all files (including *.exe and
       *.lib) get committed.

 Tip:  you can reduce the final size of your SVN repo by more than
       80% by finishing setup before importing the 'print\' tree.

_______________________________________________________________________

 === Patches ===

 Apply just one of the "combined" patches or apply all of the
 "incremental" patches. Set the current directory to the top-
 level 'print\' directory before applying any patch.

 Tip: if you are setting up an SVN repository, apply patch
      '00-svn-ignore.diff' before any of the other patches
      (either combined or incremental). It tells SVN to ignore
      files and directories created by the build process.

_______________________________________________________________________

 === Configuration ===

 0- copy 'print\src\osdd\pscript\psprint\build.cmd' to your
    top-level 'print\' directory.

 1- edit your copy of 'build.cmd' to fill in the version of
    VACPP you are using and the path to its top-level directory

 Note: 'build.cmd' can be run from its original location, from your
       top-level 'print\' directory, or from the directory above that.
       Using a copy in one of the alternate locations allows you to
       modify it without having it listed when you run "svn status".
       (If you applied '00-svn-ignore.diff', SVN will explicitly
       ignore the copy in 'print\'.)

_______________________________________________________________________

 Building
_______________________________________________________________________

 CD to your top-level 'print\' directory and enter 'build'.

 'build.cmd' sets all the environment variables the build process
 requires - there's no need to set up the environment yourself.
 By default, it creates a "retail English" version. Review the
 script for other build options.

_______________________________________________________________________

 Rich Walsh
 20 August 2018
