= BUILDING FILEMANAGER/2 (FM/2) = This document explains how to build FM/2 from source. == Tools == The following tools are currently used to build the FM/2 binaries * [http://www.openwatcom.org OpenWatcom] * rc.exe from the IBM Developers Toolkit v4.5 * lxlite LX compressor [http://www.openwatcom.org OpenWatcom] v1.6 or newer should work. There are no known special setup requirements. Older versions of the IBM Toolkit may work. The Toolkit is on your eComStation CD#2. Not all versions of RC.EXE are created equal. Currently, the best version to use is 12-18-97 6:01 868,000 0 RC.EXE which reports itself as IBM RC (Resource Compiler) Version 5.00.002 Dec 18 1997 and it is available from [ftp://ftp.software.ibm.com/ps/products/warpzilla/os2tk40rc.zip Toolkit update for Mozilla] You can get LXLITE.EXE from [http://hobbes.nmsu.edu/cgi-bin/h-search?key=lxlite&pushbutton=Search lxlite from Hobbes] == Building == Use subversion to pull a copy of the source code distribution into your client workspace. See [wiki:/ Getting the Sources] for instructions. Run the build commands must be run from top directory of your Subversion workspace. The directory will contain the top level makefile. Build the release version with {{{ wmake DEBUG=0 }}} or {{{ set DEBUG=0 wmake all }}} Build the debug version with {{{ wmake DEBUG=1 }}} or {{{ set DEBUG=1 wmake all }}} When switching between debug and release builds, add the -a switch to the wmake command line. This forces all files to be rebuilt. The build outputs are: * av2.exe * databar.exe * dirsize.exe * eas.exe * fm3.exe * fm4.exe * global.exe * ini.exe * killproc.exe * sysinfo.exe * undel.exe * vcollect.exe * vdir.exe * viewinfs.exe * vtree.exe * dll\fm3dll.dll * dll\fm3res.dll * dll\fm3res.str * dll\ipf\fm3.hlp * internal\mkstr.exe == Compressing Dlls and Exes == Lxlite.exe needs to be in a directory listed in the PATH statement of your config.sys or build enviroment cmd file. To compress exe/dlls, run {{{ wmake lxlite }}} == Release Packaging == FM/2 is released as a WarpIN package. The basic process is {{{ wmake wpi }}} See [wiki:WPIBuild] for more details. == Building, Compressing, and Packaging with a Single CMD Statement == Open a text editor and add the following lines. {{{ set debug=0 wmake all && wmake lxlite && wmake wpi }}} Save file naming it possibly Build_FM2.cmd. Copy the file to your FM2 source code "trunk" directory. It must be run from inside this directory to build, compress, and make the wpi file. After running, open the "Warpin" subdirectory located in the "trunk" directory. The Warpin file will be build inside this directory. == About FM/2 == FM2 was originally written by [mailto:hectorplasmic@worldnet.att.net Mark Kimes] He has kindly allowed us to take over maintenance and support of FM/2 and to release the program under the GNU GPL license. I'm sure he would appreciate a Thank You note for his generosity. == Support == FM/2 is a Netlabs project. The project URL is [wiki:/ fm/2] The user support mailing list is at [mailto:fm2-user@netlabs.org fm/2 Users Mailing List] Like all Netlabs mailing list, this is mirrored to gmane. In addition the maintainers, monitor the comp.os.os2.programmer.misc newsgroup and others in the comp.os.os2.* hierarchy. There is also an archived Yahoo group at http://tech.groups.yahoo.com/group/fm2user/ The list is closed to new posts, but contains some useful info. If all else fails, you can always e-mail me directly at [mailto:steve53@earthlink.net Steven H. Levine] Thanks and enjoy. $Id$