Description of the setup procedure [.COMMAND]SETUP.COM

January 1995, Johannes Plass

##################################################################

SETUP.COM accepts the following parameters:

 COMPILE : Set up additional logicals and symbols for compilation 
           purposes.   
 DISTRIB : Set up symbols and logicals only for the software included
           in this package at present. It is not recommended to leave
           this parameter away.
 NOLOG   : Suppress messages.
 <compiler definition> : Parameter of the form <compiler>=<compiler command>
           where <compiler> is either DECC or VAXC,
                 <compiler command> represents the command used to invoke the
                            compiler and must be either CC/DECC or CC/VAXC
                            or CC.

Parameter parsing is not case sensitive and is order independant. Unknown
parameters are ignored without warning, white space and tabulators are
eliminated before parsing. All parameters are optional.

#####
           
SETUP.COM first defines a minimal set of logicals required at run time:

 X11_ROOT 		concealed logical pointing to the top directory
			of this X11 tree.
 BITMAP_DIRECTORY	X11_ROOT:[BITMAPS]
 X11_LIBRARY		X11_ROOT:[EXE]       on OpenVMS VAX
			X11_ROOT:[EXE_ALPHA] on OpenVMS AXP         
 XMULIBSHR		X11_LIBRARY:XMULIBSHR.EXE
 XAW3DLIBSHR		X11_LIBRARY:XAW3DBSHR.EXE

#####

SETUP.COM proceeds by (re)defining DECW$USER_DEFAULTS in the process table as
the list of translations that results from appending "X11_ROOT:[DEFAULTS]" to
the list of all translations of DECW$USER_DEFAULTS in the logical name table
returned by F$TRNLNM("DECW$USER_DEFAULTS",,,,,"TABLE_NAME").
   
#####

The presence of the COMPILE parameter causes the following logicals to be
defined.

 X11_DIRECTORY		DECW$INCLUDE
 XAW_DIRECTORY		X11_ROOT:[XAW3D]
 XMU_DIRECTORY		X11_ROOT:[XMU]
 X11R4_VMS_DIRECTORY	X11_ROOT:[X11R4_VMS]

Also, in presence of the COMPILE parameter, the following foreign commands
will be defined:

 XMMK   A low-level command used to build particular parts of the software.
        XMMK invokes either MMS or MMK with some platform dependant macros.
        For instance XMMK may be defined as
          $MMK_DIR:MMK/MAC=("__DECC__=CC",X11R5=1)
        or as
          MMS/MAC=(__VAX__=1,"__VAXC__=CC/VAXC",X11R4=1)
        or as
          MMS/MAC=(__ALPHA__=1,"__DECC__=CC",X11R5=1)
        The macros X11R4 and X11R5 are used in the makefiles as flags for
        X11 R4 and X11 R5 environments. The decision about the X11 release is
        based on the (non)presence of the library DECW$XTLIBSHRR5.EXE
        in SYS$SHARE.
        The macros __VAX__ and __ALPHA__ indicate the platform.
        The macros __DECC__=CC, __DECC__=CC/DECC, __VAXC__=CC, and
        __VAXC__=CC/VAXC specify the compiler and its invocation command.
        XMMK may be used from within a particular source directory to build
        the software that resides in it. XMMK does not place the resulting
        libraries or executables in the correct destination directories.
        XMMK should be used if problems are encountered when using XMAKE.
        XMMK will not copy resulting executables, libraries etc. into
        X11_LIBRARY.
 XMAKE  The high-level command used to build particular or all parts of this
        software. For help about XMAKE type
         $ XMAKE 
        on the command line.

#####

SETUP.COM also defines all necessary logicals and foreign commands to
invoke any client that is part of this package.

