ReleaseTool.cmd

This is a menu-driven REXX program, found in the base directory of the repository, which...

• provides guidance through this process
• facilitates many of the following tasks, including (but not limited to):
  • the changes to version numbers
  • the changes to copyright dates and strings

To avoid omissions and/or errors in some of the following tasks, the use of this program is recommended.

Ensure work in progress is committed and new files added:

Post a message to the Netlabs FM/2 developer's mailing list, FM2_Dev, asking if all developers have committed their changes for the release build. Allow at least 24 hours for responses.

Process completed tickets

Verify all completed tickets marked closed.

Any residual open tickets must be moved to a future version milestone before or when the version milestone is marked complete. See marking milestones complete.

Select version #

Version numbers are of the form x.yy.zz, where x is the major version, yy is the minor version and zz is the CSD level. The CSD level is typically 00 and is not displayed unless it has some other value.

The separator for user visible version numbers is a period. The period may be transformed to an underscore or dash when the version number is used to derive a directory name.

The current version is 3.17.00.

WarpIN drops leading zeros, but we supply them to get alpha sorts in directory and file listings.

Final check source code and update markings

Check build level and copyright dates in

av2.def
databar.def
dirsize.def
dll\fm3dll.def
dll\fm3res.def
eas.def
fm3.def
fm4.def
global.def
ini.def
killproc.def
sysinfo.def
undel.def
vcollect.def
vdir.def
viewinfs.def
vtree.def

The bldlevel and copyright strings are of the form

@#SLAInc:3.14#@##1## 07/21/2008 03:14:00 GKYBuild::EN:US:0:U:@@FM/2 Runtime DLL Copyright (c) 1993, 1998 M. Kimes Copyright (c) 2001, 2008 Steven Levine and Associates, Inc.

Check warpin\fm2.wis post build (use wmake -a to assure it updates).

PACKAGEID =

Check file_id.diz

version #

Check HISTORY

version #

Check dll\version.h

version #=
VERSION_MAJOR
VERSION_MINOR
VERREALMINOR

Include the date for all releases. Include the time on BETA releases

Check README

version # (major releases only)

Commit modified files and verify

Commit with

svn commit

Verify everything checked in with

svn status -v |& less

Look for unexpected ?s in column 1. These can indicate new files that must be added to the repository.

To prevent spurious ?s, edit global-ignores in %HOME%\.subversion\config to suppress the marking for known build products.

Rebuild with

wmake -a.

Verify no regressions.

Apply tag

Tags are of the form FM2-3_xx-yy, where xx is the minor version and yy is the CSD level. The CSD will typically be 00.

Create the tag with a command similar to

svn copy -m"Tag release FM2-3_17_00" http://svn.netlabs.org/repos/fm2/trunk
                                     http://svn.netlabs.org/repos/fm2/tags/FM2-3_17_00

Build for release

If fm2_workspace\trunk is the root directory of your FM/2 source workspace, build with

cd fm2_workspace\trunk
set HIMEM=
set DEBUG=
set WARNALL=
set FORTIFY=
wmake -a

Test release build

Test the binaries. At a minimum you should run all the exes and do some basic file manipulation with each. You should, where possible, also verify that any bugs that were fixed for the release are working as expected.

Lxlite binaries

Run

wmake lxlite

to compress exes and dlls.

Retest final build

Verify that all exes continue to load and run after being compressed. Lxlite has no known defects, but it's better to be safe.

Build distro

Run

wmake dist

to build distribution .wpi. See Building FM/2 WarpIN installation files for more information.

Zip the distribution FM2*.wpi and add the FM2utilities wpi package if desired.

We do not routinely build source distributions since the source is available from Netlabs.

Test wpi

Do both an install over an existing install and a clean install.

Do it with just the FM/2 package and with the FM/2utils package.

Distribute distro

Prepare fm2-x.xx.txt for Hobbes.

Upload the distro to /pub/incoming on Hobbes and to /incoming/fm2 Netlabs.

Post a request to community@… to move the distro from /incoming/fm2 to /pub/fm2.

If Netlabs /pub/fm2 is looking cluttered, request that the older version be moved to /pub/fm2/archives.

If Netlabs /incoming/fm2 has obsolete test files, request that they be deleted.

Mark milestone complete

Create a TRAC version for the next version, if needed.

Mark the current version as the default version for new tickets.

Create a TRAC milestone for the next version release, if needed.

Mark the new milestone as the default milestone.

Mark the completed milestone as complete and move any residual tickets to a future milestone.

TRAC can move the tickets in bulk when you mark the version milestone complete.

Known tags

See source:tags for the full list.

Some recent tags are

FM2-3_25_0
FM2-3_24_0
FM2-3_23_0
FM2-3_22_0
FM2-3_21_0
FM2-3_20_0
FM2-3_19_1
FM2-3_19_00
FM2-3.18-00
FM2-3.17-00 
FM2-3.16-00 
FM2-3.15-00
FM2-3.14-00 
FM2-3.13-00
FM2-3.12-00
FM2-3.11-00
FM2-3.10-00
FM2-3.09-00
FM2-3.08
FM2-3.07
FM2-3.07.BETA-01
FM2-3.06.00 First OpenWatcom Build
FM2-3.05.09