dmake/doc/public/os2.txt

   1 OS/2 specific information for dmake.  This information is provided in the
   2 hope that it makes it easier to install and recompile dmake in a OS/2
   3 environment.
   4
   5 Notes on the OS/2 implementation of dmake:
   6 ==========================================
   7
   8 As shipped the DOS versions of dmake will run under OS/2 protected mode.
   9 However, support for a full OS/2 version is also provided.  The OS/2 version
  10 will run in parallel under OS/2.
  11
  12 Bootstrapping the binary:
  13 -------------------------
  14    A make.cmd file is provided to bootstrap the binary.  The file contains
  15    several targets for bootstrapping.  Invoking the batch file with no
  16    arguments lists the possibilities shown below.
  17
  18       INDEX:  You must specify one of:
  19          ibm      - IBM C2 compile.
  20
  21    The only supported compiler under OS/2 is the Visual Age ICC compiler.
  22    I have tested the build using this compiler.  The resulting binary
  23    performs proper directory caching and file-name case mapping for cached
  24    directories and is capable of parallel target builds.  The only known
  25    limitation of the OS/2 implementation is the treatment of library time
  26    stamps.  Libraries do not have time stamps on members and the timestamp
  27    of the library is used instead.
  28
  29
  30 OS/2 Specifics
  31 --------------
  32
  33    There is a small number of OS/2 specific features that need to be
  34    stated.
  35
  36    1. The environment variables TMP as well as TMPDIR are checked for the
  37       location of the directory where dmake should place any temporary files.
  38       TMPDIR is checked before TMP.
  39
  40    2. Appropriate limits are setup for MAXPROCESSES and buffer sizes etc.
  41       See output of 'dmake -V'.
  42
  43    3. By default dmake will look for the startup.mk file in the path:
  44
  45           $(ROOTDIR)/dmake/startup/startup.mk
  46
  47       This is more in keeping with OS/2 philosophy.  You may still rename
  48       and put it anywhere else you like by defining the MAKESTARTUP
  49       environment variable.
  50
  51    4. Swapping the dmake binary to disk is not supported under OS/2.
  52
  53
  54 Other notes:
  55 ------------
  56    dmake does not care if you are running cmd.exe or some other command
  57    interpretter, you must however specify the proper values of the environment
  58    variables SHELL, SHELLFLAGS, GROUPSHELL, and GROUPFLAGS in order for things
  59    to work correctly.  Read the man page first.
  60
  61    Group recipes under OS/2 that use cmd.exe as the command interpretter
  62    require you to set the GROUPSUFFIX macro.
  63
  64    As shipped the startup.mk files try to figure out what
  65    command interpretter you are using and set things up appropriately.
  66    Two command interpretters are supported in the shipped startup.mk file,
  67    cmd.exe (via COMSPEC), and the MKS Korn shell.
  68
  69    dmake does not contain any builtin commands.  It gets all commands it
  70    executes from an external file system.  It is therefore most useful if it
  71    is used in conjunction with an environment similar to that provided by
  72    the MKS Tool kit, or equivalent.
  73
  74    dmake now supports the MKS argument passing conventions.  The facility is
  75    enabled by setting .MKSARGS:=1 and is set by default in the startup.mk file
  76    if an MKS Korn shell is detected as being the active command interpretter.