Changes between Version 7 and Version 8 of BuildingFm2


Ignore:
Timestamp:
Sep 27, 2007, 7:26:49 PM (13 years ago)
Author:
Steven Levine
Comment:

Update content and clean up wiki formatting.

Legend:

Unmodified
Added
Removed
Modified
  • BuildingFm2

    v7 v8  
    11
     2= BUILDING FILEMANAGER/2 (FM/2) =
    23
     4This document explains how to build FM/2 from source.
    35
    4 == '''BUILDING FILEMANAGER/2 (FM/2)''' ==
    5 
    6 
    7 This document explains how to build FM/2 from source.[[BR]]
    8 [[BR]]
    9 
    10 
    11 '''Tools[[BR]]
    12 ===='''
     6== Tools ==
    137
    148The following tools are currently used to build the FM/2 binaries
    159
    16   OpenWatcom V1.6 or newer[[BR]]
    17   IBM Developers Toolkit v4.5[[BR]]
    18   lxlite LX compressor[[BR]]
     10 * [http://www.openwatcom.org OpenWatcom]
     11 * rc.exe from the IBM Developers Toolkit v4.5
     12 * lxlite LX compressor
    1913
    20 Older versions of the Toolkit may work.  The OpenWatcom implementation of
    21 the Toolkit should work.  There are no known special setup requirements.
     14[http://www.openwatcom.org OpenWatcom] v1.6 or newer should work.  There are no known special setup requirements.
     15
     16Older versions of the IBM Toolkit may work.  The Toolkit is on your eComStation CD#2.
    2217
    2318Not all versions of RC.EXE are created equal.  Currently, the best version to use is
    2419
    25  12-18-97   6:01         868,000           0  RC.EXE
     20  12-18-97   6:01         868,000           0  RC.EXE
    2621
    2722which reports itself as
    2823
    29  IBM RC (Resource Compiler) Version 5.00.002 Dec 18 1997
     24  IBM RC (Resource Compiler) Version 5.00.002 Dec 18 1997
    3025
    3126and it is available from
    32 
    33   <ftp://ftp.software.ibm.com/ps/products/warpzilla/os2tk40rc.zip>
     27[ftp://ftp.software.ibm.com/ps/products/warpzilla/os2tk40rc.zip Toolkit update for Mozilla]
    3428
    3529You can get LXLITE.EXE from
     30[http://hobbes.nmsu.edu/cgi-bin/h-search?key=lxlite&pushbutton=Search lxlite from Hobbes]
    3631
    37  <http://hobbes.nmsu.edu/cgi-bin/h-search?key=lxlite&pushbutton=Search>
    38 
    39 You can get OpenWatcom from
    40 
    41  <http://www.openwatcom.org>
    42 
    43 
    44 '''Building[[BR]]
    45 ======'''
     32== Building ==
    4633
    4734Use subversion to pull a copy of the source code distribution into your
    48 client workspace.  See
     35client workspace.  See [wiki:/ Getting the Sources] for instructions.
    4936
    50  <http://svn.netlabs.org/fm2>
    51 
    52 for instructions on how to do this.
    53 
    54 
    55 ''All build commands must be run from inside the Trunk directory containing the source code.''
    56 
     37Run the build commands must be run from top directory of your Subversion workspace.  The directory will contain the  top level makefile.
    5738
    5839Build the release version with
    59 
     40{{{
    6041  wmake DEBUG=0
    61 
     42}}}
    6243or
    63 
    64   set DEBUG=0[[BR]]
     44{{{
     45  set DEBUG=0
    6546  wmake all
     47}}}
    6648
    6749Build the debug version with
     50{{{
     51  wmake DEBUG=1
     52}}}
     53or
     54{{{
     55  set DEBUG=1
     56  wmake all
     57}}}
    6858
    69   wmake DEBUG=1
    70 
    71 or
    72 
    73   set DEBUG=1[[BR]]
    74   wmake all
     59When switching between debug and release builds, add the -a switch to the wmake command line.  This forces all files to be rebuilt.
    7560
    7661The build outputs are:
    7762
    78   av2.exe[[BR]]
    79   databar.exe[[BR]]
    80   dirsize.exe[[BR]]
    81   eas.exe[[BR]]
    82   fm3.exe[[BR]]
    83   fm4.exe[[BR]]
    84   global.exe[[BR]]
    85   ini.exe[[BR]]
    86   killproc.exe[[BR]]
    87   sysinfo.exe[[BR]]
    88   undel.exe[[BR]]
    89   vcollect.exe[[BR]]
    90   vdir.exe[[BR]]
    91   viewinfs.exe[[BR]]
    92   vtree.exe
     63 * av2.exe
     64 * databar.exe
     65 * dirsize.exe
     66 * eas.exe
     67 * fm3.exe
     68 * fm4.exe
     69 * global.exe
     70 * ini.exe
     71 * killproc.exe
     72 * sysinfo.exe
     73 * undel.exe
     74 * vcollect.exe
     75 * vdir.exe
     76 * viewinfs.exe
     77 * vtree.exe
    9378
    94   dll\fm3dll.dll[[BR]]
    95   dll\fm3res.dll
     79 * dll\fm3dll.dll
     80 * dll\fm3res.dll
     81 * dll\fm3res.str
     82 * dll\ipf\fm3.hlp
    9683
     84 *  internal\mkstr.exe
    9785
    98   dll\fm3res.str
    99 
    100   dll\ipf\fm3.hlp
    101 
    102   internal\mkstr.exe
    103 [[BR]]
    104 
    105 '''Compressing Dlls and Exes:[[BR]]
    106 ========================='''
     86== Compressing Dlls and Exes ==
    10787
    10888Lxlite.exe needs to be in a directory listed in the PATH statement of your config.sys or build enviroment cmd file.
    10989
    11090To compress exe/dlls, run
     91{{{
     92wmake lxlite
     93}}}
    11194
    112 wmake lxlite
    113 [[BR]]
    114 [[BR]]
    115 
    116 '''Release Packaging[[BR]]
    117 ================'''
     95== Release Packaging ==
    11896
    11997FM/2 is released as a WarpIN package.
    12098
    12199The basic process is
     100{{{
     101  wmake wpi
     102}}}
     103See [wiki:WPIBuild] for more details.
    122104
    123   wmake wpi
    124 
    125 See
    126 
    127  <http://svn.netlabs.org/fm2/wiki/WPIBuild>
    128 
    129 for more details.
    130 [[BR]]
    131 [[BR]]
    132 
    133 '''Building, Compressing, and Packaging with a Single CMD Statement[[BR]]
    134 ==================================================='''
     105== Building, Compressing, and Packaging with a Single CMD Statement ==
    135106
    136107Open a text editor and add the following lines.
    137 
    138 set debug=0[[BR]]
    139 wmake all && wmake lxlite && wmake wpi[[BR]]
    140 
     108{{{
     109set debug=0
     110wmake all && wmake lxlite && wmake wpi
     111}}}
    141112Save 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.
    142113
    143 
    144 '''About FM/2[[BR]]
    145 ========='''
     114== About FM/2 ==
    146115
    147116FM2 was originally written by
    148 
    149   Mark Kimes
    150   <hectorplasmic@worldnet.att.net>
     117[mailto:hectorplasmic@worldnet.att.net Mark Kimes]
    151118
    152119He 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.
    153 [[BR]]
    154 [[BR]]
    155120
    156 '''Support[[BR]]
    157 ======'''
     121== Support ==
    158122
    159 FM/2 is a Netlabs project.  The project URL is
     123FM/2 is a Netlabs project.  The project URL is [wiki:/ fm/2]
    160124
    161  <http://svn.netlabs.org/fm2>
    162 
    163 The user support mailing list is
    164 
    165   <mailto:fm2-user@netlabs.org>
     125The user support mailing list is at [mailto:fm2-user@netlabs.org fm/2 Users Mailing List]
    166126
    167127Like all Netlabs mailing list, this is mirrored to gmane.
     
    169129In addition the maintainers, monitor the comp.os.os2.programmer.misc newsgroup and others in the comp.os.os2.* hierarchy.
    170130
    171 There is also an archived Yahoo group at
    172 
    173  http://tech.groups.yahoo.com/group/fm2user/
     131There is also an archived Yahoo group at http://tech.groups.yahoo.com/group/fm2user/
    174132
    175133The list is closed to new posts, but contains some useful info.
    176134
    177135If all else fails, you can always e-mail me directly at
    178 
    179   Steven H. Levine
    180   steve53@earthlink.net
     136[mailto:steve53@earthlink.net Steven H. Levine]
    181137
    182138Thanks and enjoy.
    183139
    184140$Id$
    185 [[BR]]
     141