Custom Library Name Suffixes

CBM offers the capability of adding a custom suffix to generated library names. The specified suffix appears in the library name just before the extension. This might prove useful for identifying build information in the library name itself. For example, you might add the suffix "w" to Msvc builds and "b" to Borland builds, resulting in library names such as tls7dw.lib and tls7db.lib.

One way of specifying a custom suffix is by changing the environment for the current session only. On Unix platforms, export UNIQUE_LIB=<your_suffix> in the current shell before invoking rwspm. Similarly, on Windows or OS/2 platforms, set UNIQUE_LIB=<your_suffix> in the current environment before invoking rwspm.

If you want a given suffix to be added whenever you conduct a particular type of build, do the following:

1. Make a copy of an existing platform file, to be found in the directory <rw_root>/scripts/platform, saving it under a new name. For example, you might save the file as MyBorlandBuilds.in.
   
   

   • Select the properties file for the operating system and compiler combination you will use, such as w32_bcc.in for the Borland C++ compiler on Windows.
     
     
   • Be sure the edited copy remains in the platform directory.
   
   WARNING: Do not directly edit the files of the platform directory! This could jeopardize the correct functionality of Software Parts Manager should you later acquire and begin using the interface.
   
   
2. Add the line UNIQUE_LIB=<your_suffix> to the new file.
   
   
3. Use the file name you assigned the edited file as the -f argument to rwspm.

CBM User Guide Building With CBM
Index