== '''BUILDING FILEMANAGER/2 (FM/2)''' ==


This document explains how to build FM/2 from source.[[BR]]
[[BR]]


'''Tools[[BR]]
===='''

The following tools are currently used to build the FM/2 binaries

  OpenWatcom V1.7 or newer[[BR]]
  IBM Developers Toolkit v4.5[[BR]]
  lxlite LX compressor[[BR]]

Older versions of the Toolkit may work.  The OpenWatcom implementation of
the Toolkit should work.  There are no known special setup requirements.

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>

You can get LXLITE.EXE from

 <http://hobbes.nmsu.edu/cgi-bin/h-search?key=lxlite&pushbutton=Search>

You can get OpenWatcom from

 <http://www.openwatcom.org>


'''Building[[BR]]
======'''

Use subversion to pull a copy of the source code distribution into your
client workspace.  See

 <http://svn.netlabs.org/fm2>

for instructions on how to do this.


''All build commands must be run from inside the Trunk directory containing the source code.''


Build the release version with

  wmake DEBUG=0

or

  set DEBUG=0[[BR]]
  wmake all

Build the debug version with

  wmake DEBUG=1

or

  set DEBUG=1[[BR]]
  wmake all

The build outputs are:

  av2.exe[[BR]]
  databar.exe[[BR]]
  dirsize.exe[[BR]]
  eas.exe[[BR]]
  fm3.exe[[BR]]
  fm4.exe[[BR]]
  global.exe[[BR]]
  ini.exe[[BR]]
  killproc.exe[[BR]]
  sysinfo.exe[[BR]]
  undel.exe[[BR]]
  vcollect.exe[[BR]]
  vdir.exe[[BR]]
  viewinfs.exe[[BR]]
  vtree.exe

  dll\fm3dll.dll[[BR]]
  dll\fm3res.dll


  dll\fm3res.str

  dll\ipf\fm3.hlp

  internal\mkstr.exe
[[BR]]

'''Compressing Dlls and Exes:[[BR]]
========================='''

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
[[BR]]
[[BR]]

'''Release Packaging[[BR]]
================'''

FM/2 is released as a WarpIN package.

The basic process is

  wmake wpi

See

 <http://svn.netlabs.org/fm2/wiki/WPIBuild>

for more details.
[[BR]]
[[BR]]

'''Building, Compressing, and Packaging with a Single CMD Statement[[BR]]
==================================================='''

Open a text editor and add the following lines.

set debug=0[[BR]]
wmake all && wmake lxlite && wmake wpi[[BR]]

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[[BR]]
========='''

FM2 was originally written by

  Mark Kimes
  <hectorplasmic@worldnet.att.net>

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.
[[BR]]
[[BR]]

'''Support[[BR]]
======'''

FM/2 is a Netlabs project.  The project URL is

 <http://svn.netlabs.org/fm2>

The user support mailing list is

  <mailto:fm2-user@netlabs.org>

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

  Steven H. Levine
  steve53@earthlink.net

Thanks and enjoy.

$Id$
[[BR]]