| 1 | = Building WarpIN (WPI) install files for FM/2 = |
| 2 | |
| 3 | == Prerequisites == |
| 4 | |
| 5 | * A drive with long filename support |
| 6 | * A functional FM/2 build environment. (See build instructions elsewhere for details.) |
| 7 | * IBM !VisualAge C++ version 3.65 with FP2 (Soon to be Open Watcom.) |
| 8 | * OS/2 Develoeprs Toolkit v4.5 or newer |
| 9 | * SVN |
| 10 | * WarpIN, version 0.9.20 or later, installed |
| 11 | * A functional version of SED installed |
| 12 | |
| 13 | == How-to == |
| 14 | 1. Use '''SVN CHECKOUT''' and/or '''SVN UPDATE''' to ensure you have the latest source files. |
| 15 | 2. From the base of the source subtree, use '''NMAKE ALL''' to ensure you have the latest binaries. |
| 16 | 3. (Optional) Set environment variables to manage/customize the Warpin file creation. (See below for details.) |
| 17 | 4. From the base of the source subtree, use '''NMAKE DIST''' which will compress the executables and build the WarpIN installation files. |
| 18 | |
| 19 | NOTE: If repeated builds of WarpIN installation files from the same FM/2 binary files are needed/desired, then repeated compression of the executables is not needed. Use '''NMAKE WPI''' to skip the compression steps and just build the WarpIN files. |
| 20 | |
| 21 | == Customizing the WPI build through environment variables. == |
| 22 | BUILD_FM2UTILS:: |
| 23 | By default, a WPI file is cretaed for both FM/2 and the optional, separate FM/2 utilities package. To prevent the creation/update of the FM/2 Utilities WPI file, use '''SET BUILD_FM2UTILS=0'''. |
| 24 | FM2_VER:: |
| 25 | The WPI file for FM/2 is named '''FM2'''''<version-string>'''''.WPI'''. The ''<version-string>'' portion of the file name can be set through the '''FM2_VER''' environment variable. For example, '''SET FM2_VER=-3-5-9''' will result in '''FM2-3-5-9.WPI''' being created/updated. |
| 26 | FM2UTILS_VER:: |
| 27 | The WPI file for FM/2 Utilities is named '''FM2UTILS'''''<version-string>'''''.WPI'''. The ''<version-string>'' portion of the file name can be set through the '''FM2UTILS_VER''' environment variable. For example, '''SET FM2UTILS_VER=-1-0-1''' will result in '''FM2UTILS-1-0-1.WPI''' being created/updated. |
| 28 | |
| 29 | |
| 30 | |