| 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 $
 | 
|---|