| 1 |  | 
|---|
| 2 | Building FM/2 | 
|---|
| 3 | ============= | 
|---|
| 4 |  | 
|---|
| 5 | This document explains how to build FM/2 from source. | 
|---|
| 6 |  | 
|---|
| 7 | Tools | 
|---|
| 8 | ===== | 
|---|
| 9 |  | 
|---|
| 10 | The following tools are currently used to build the FM/2 binaries | 
|---|
| 11 |  | 
|---|
| 12 | OpenWatcom v1.6 or newer | 
|---|
| 13 | IBM Developers Toolkit v4.5 | 
|---|
| 14 | lxlite LX compressor | 
|---|
| 15 |  | 
|---|
| 16 | Older versions of the Toolkit may work.  The OpenWatcom implementation of | 
|---|
| 17 | the Toolkit should work, but this has not been fully verified.  There are no | 
|---|
| 18 | known special setup requirements. | 
|---|
| 19 |  | 
|---|
| 20 | Not all versions of RC.EXE are created equal.  Currently, the best version to | 
|---|
| 21 | use is | 
|---|
| 22 |  | 
|---|
| 23 | 12-18-97   6:01         868,000           0  RC.EXE | 
|---|
| 24 |  | 
|---|
| 25 | which reports itself as | 
|---|
| 26 |  | 
|---|
| 27 | IBM RC (Resource Compiler) Version 5.00.002 Dec 18 1997 | 
|---|
| 28 |  | 
|---|
| 29 | and it is available from | 
|---|
| 30 |  | 
|---|
| 31 | <ftp://ftp.software.ibm.com/ps/products/warpzilla/os2tk40rc.zip> | 
|---|
| 32 |  | 
|---|
| 33 | You can get LXLITE.EXE from | 
|---|
| 34 |  | 
|---|
| 35 | <http://hobbes.nmsu.edu/cgi-bin/h-search?key=lxlite&pushbutton=Search> | 
|---|
| 36 |  | 
|---|
| 37 | You can get OpenWatcom from | 
|---|
| 38 |  | 
|---|
| 39 | <http://www.openwatcom.org> | 
|---|
| 40 |  | 
|---|
| 41 |  | 
|---|
| 42 | Building | 
|---|
| 43 | ======== | 
|---|
| 44 |  | 
|---|
| 45 | Use subversion to pull a copy of the source code distribution into your | 
|---|
| 46 | client workspace.  See | 
|---|
| 47 |  | 
|---|
| 48 | <http://svn.netlabs.org/fm2> | 
|---|
| 49 |  | 
|---|
| 50 | for instructions on how to do this. | 
|---|
| 51 |  | 
|---|
| 52 | Build the release version with | 
|---|
| 53 |  | 
|---|
| 54 | wmake | 
|---|
| 55 |  | 
|---|
| 56 | Build the debug version with | 
|---|
| 57 |  | 
|---|
| 58 | wmake DEBUG=1 | 
|---|
| 59 |  | 
|---|
| 60 | or | 
|---|
| 61 |  | 
|---|
| 62 | set DEBUG=1 | 
|---|
| 63 | wmake | 
|---|
| 64 |  | 
|---|
| 65 | The build outputs are: | 
|---|
| 66 |  | 
|---|
| 67 | av2.exe | 
|---|
| 68 | databar.exe | 
|---|
| 69 | dirsize.exe | 
|---|
| 70 | eas.exe | 
|---|
| 71 | fm3.exe | 
|---|
| 72 | fm4.exe | 
|---|
| 73 | global.exe | 
|---|
| 74 | ini.exe | 
|---|
| 75 | killproc.exe | 
|---|
| 76 | sysinfo.exe | 
|---|
| 77 | undel.exe | 
|---|
| 78 | vcollect.exe | 
|---|
| 79 | vdir.exe | 
|---|
| 80 | viewinfs.exe | 
|---|
| 81 | vtree.exe | 
|---|
| 82 |  | 
|---|
| 83 | dll\fm3dll.dll | 
|---|
| 84 | dll\fm3res.dll | 
|---|
| 85 |  | 
|---|
| 86 |  | 
|---|
| 87 | dll\fm3res.str | 
|---|
| 88 |  | 
|---|
| 89 | dll\ipf\fm3.hlp | 
|---|
| 90 |  | 
|---|
| 91 | internal\mkstr.exe | 
|---|
| 92 |  | 
|---|
| 93 | Release Packaging | 
|---|
| 94 | ================= | 
|---|
| 95 |  | 
|---|
| 96 | FM/2 is released as a WarpIN package. | 
|---|
| 97 |  | 
|---|
| 98 | The basic process is | 
|---|
| 99 |  | 
|---|
| 100 | wmake wpi | 
|---|
| 101 |  | 
|---|
| 102 | See | 
|---|
| 103 |  | 
|---|
| 104 | <http://svn.netlabs.org/fm2/wiki/WPIBuild> | 
|---|
| 105 |  | 
|---|
| 106 | for more details. | 
|---|
| 107 |  | 
|---|
| 108 |  | 
|---|
| 109 | About FM/2 | 
|---|
| 110 | ========== | 
|---|
| 111 |  | 
|---|
| 112 | FM2 was originally written by | 
|---|
| 113 |  | 
|---|
| 114 | Mark Kimes | 
|---|
| 115 | <hectorplasmic@worldnet.att.net> | 
|---|
| 116 |  | 
|---|
| 117 | He has kindly allowed us to take over maintenance and support of FM/2 and to | 
|---|
| 118 | release the program under the GNU GPL license.  I'm sure he would appreciate | 
|---|
| 119 | a Thank You note for his generosity. | 
|---|
| 120 |  | 
|---|
| 121 |  | 
|---|
| 122 | Support | 
|---|
| 123 | ======= | 
|---|
| 124 |  | 
|---|
| 125 | FM/2 is a Netlabs project.  The project URL is | 
|---|
| 126 |  | 
|---|
| 127 | <http://svn.netlabs.org/fm2> | 
|---|
| 128 |  | 
|---|
| 129 | The user support mailing list is | 
|---|
| 130 |  | 
|---|
| 131 | <mailto:fm2-user@netlabs.org> | 
|---|
| 132 |  | 
|---|
| 133 | Like all Netlabs mailing list, this is mirrored to gmane. | 
|---|
| 134 |  | 
|---|
| 135 | In addition the maintainers, monitor the comp.os.os2.programmer.misc | 
|---|
| 136 | newsgroup and others in the comp.os.os2.* hierarchy. | 
|---|
| 137 |  | 
|---|
| 138 | There is also an archived Yahoo group at | 
|---|
| 139 |  | 
|---|
| 140 | http://tech.groups.yahoo.com/group/fm2/ | 
|---|
| 141 |  | 
|---|
| 142 | The list is closed to new posts, but contains some useful info. | 
|---|
| 143 |  | 
|---|
| 144 | If all else fails, you can always e-mail me directly at | 
|---|
| 145 |  | 
|---|
| 146 | Steven H. Levine | 
|---|
| 147 | steve53@earthlink.net | 
|---|
| 148 |  | 
|---|
| 149 | Thanks and enjoy. | 
|---|
| 150 |  | 
|---|
| 151 | $Id: BUILDING 717 2007-06-28 18:55:23Z stevenhl $ | 
|---|