rwbuild

USAGE:  rwbuild  [-d] [-f<platform file>] [-i<workspace directory>] 
             [-l] [-m] [-o<product tree path>] -t<build type number> 
             [-w] [-z] <part directory>[/target]

The command line options are:

-d	No argument. Builds shared or DLL libraries.
-f	Path to platform-related data file (values for RWOPSYS, 
	RWCOMPILER, compiler command name)
-i	Path to the workspace directory.
-l	Export C++ library source to workspace.
-o	Product tree path for embedded calls to genmake and rwinstal
        when -w is set.
-m	Include embedded invocation of genmake.
-t	Numeric build type.
-w	No argument. Distinguishes an executable build from
	a C++ library build. 
-z	No argument. Include embedded invocation of rwinstal.

The script rwbuild is primarily used to process a previously generated makefile, resulting in the construction of a library or an executable. If the last argument on the command line contains a target, it becomes the target of the call to make. After exporting the environmental variables defined in rwsetup.spm, rwbuild invokes make. For PC builds, rwbuild selects a make appropriate to the chosen compiler (for example, nmake for Msvc).

It is important to note that nature of the last command line argument varies depending on whether the build is of a C++ library (-w absent) or of an application (-w present). For a library build, the path is a product tree directory. For an application build, the path is a workspace directory. For all other scripts, this last argument always specifies a product tree directory.

The -m and -z flags allow CBM to include invocation of genmake and/or rwinstal in the execution of the rwbuild script. Setting of the -w flag determines the processing order for these "embedded" calls. When -w and either -m or -z are set, the -o argument must be specified to identify the product tree location because the last argument on the command line for rwbuild then refers to the workspace. When rwbuild calls genmake or rwinstal, it must specify a product tree reference, in this case the -o argument, as the last argument to these scripts. Note that the -o argument must include an individual target when appropriate. If -o is set without -w, or without -m or -z, it is ignored.

If the -l flag is set, it is passed to genmake and/or rwinstal. If the -f flag is present, it causes rwbuild to make an embedded call to rwsetup.

CBM User Guide Scripts rwinstal
Index