cde/programs/dtwm/README

   1 Conditional Compilation
   2 -----------------------
   3
   4 The following is a listing of the conditional compilation switches that
   5 are "not obvious." Excluded are hardware or OS identifiers (e.g. __ultrix),
   6 header file include flags, and macros (e.g. ABS).
   7
   8     ALTERNATE_POSTMENU
   9         This turns on menu posting by a simple call to XtManageChild.
  10         Normally, some underbar routines are called.
  11
  12     DT_LEFT_JUSTIFY_TITLE
  13         This causes the text in the window titles to be left justified
  14         instead of centered. NOTE that WSM must also be turned on for
  15         this to take effect.
  16
  17     CONCAT_TEXTLIST
  18         If turned on, then all members of compound text window
  19         properties (WM_NAME, WM_ICON_NAME) are converted to XmStrings
  20         and concatenated together. Normally, only the first member
  21         is taken.
  22
  23     CONFIG_RELATIVE_TO_CLIENT
  24         If defined, then programmatic window configurations are
  25         absolute. Normally, the window frame offset is taken into
  26         account if it would have been during a user-driven config.
  27
  28     DEBUG
  29         Turns on code that prints out error messages (specifically
  30         protocol errors).
  31
  32     DEBUGGER
  33         Turns on code to help debugging Help-on-item.
  34
  35     DEBUG_ICON_BOX
  36         Turns on code that alters iconbox spacing to help debug iconbox.
  37         (?)
  38
  39     DEBUG_RESOURCE_DATABASE
  40         Turns on code that dumps out dtwm's local resource database
  41         to aid in debugging resource problems.
  42
  43     DEBUG_SESSION_HINTS
  44         If defined, the session hints property is left on the root
  45         window after being read. Normally, it is deleted.
  46
  47     DISALLOW_DEEP_ICONS
  48         Turns off code that allows icon pixmaps of depth greater than
  49         one.
  50
  51     DONT_FILTER_ICON_WINDOWS
  52         This disables code that tries to prevent an icon window from being
  53         managed as a normal toplevel window.
  54
  55     FUTURE
  56         This appears to enable code that will allow item help to work
  57         over window icons. I suspect that this is not completely
  58         implemented.
  59
  60     HP_VUE
  61         This enables code that provides compatibility with HP_VUE.
  62
  63     ICCC_COMPLIANT
  64         This enables stricter ICCCM compliance. Specifically, some
  65         clients didn't get WM_PROTOCOLS quite right.
  66
  67     INTEGRATION_TESTING_
  68         Swaps assignment of black and white on wait state cursor as
  69         a quick indicator of which client is showing the wait state.
  70
  71     LARGECURSORS
  72         Allows cursors larger than 16x16.
  73
  74     MCCABE
  75         Conditional compile for McCabe complexity metrics.
  76
  77     MESSAGE_CAT
  78         Enables message catalog code for local language support.
  79
  80     MOTIF_DEFAULT_ICON
  81         Enables the default window icon with four buttons.
  82
  83     NO
  84         Vestigal/experimental code for position help dialog (WmHelp.c).
  85
  86     NO_OL_COMPAT
  87         If defined, then code to read and interpret Open Look window
  88         manager hints is removed.
  89
  90     NO_SETPGRP
  91         If defined, then child processes started by f.exec are not
  92         put into their own process group.
  93
  94     NO_SHAPE
  95         If defined, then the shape extension is not supported.
  96
  97     NO_WMQUERY
  98         If defined, the code to provide the WM_QUERY functionality is
  99         removed.
 100
 101     NO_DT
 102         If defined, then code that references the Dt library is removed.
 103
 104     OLD
 105         Vestigal code in WmHelp.c
 106
 107     OLD_CODE
 108         Vestigal code.
 109
 110     OLD_COLORMAP
 111         Vestigal code.
 112
 113     OLD_TAKE_FOCUS
 114         Vestigal code.
 115
 116     PANACOMM
 117         HP Panacom division modification to support clients running
 118         in their X terminals.
 119
 120     PARANOID
 121         If enabled, the a server grab is done around a property read.
 122         (This is probably not necessary.)
 123
 124     PORT_NOVFORK
 125         Enable for systems that don't have the vfork() call.
 126
 127     PORT_OLDXLIB
 128         Enables code that works around an old bug in XGetClassHint().
 129
 130     R2_COMPAT
 131         Enables support for old clients that still pass window geometry
 132         hint information in WM_NORMAL_HINTS.
 133
 134     ROOT_ICON_MENU
 135         Experimental code to provide MS Windows-like traversal of focus
 136         between root icons with menus posted.
 137
 138     SGI_FOCUS_PATCH
 139         Fixes a specific window focus problem.
 140
 141     UNMAP_ON_RESTART
 142         All windows are unmapped on restart.
 143
 144     _BMS
 145         Formerly used to denote code that interfaced to the HP Broadcast
 146         message server. This code has been switched over to ICCC
 147         messaging. The ifdef's should be removed, the code should stay.
 148
 149     _CMDINV
 150         The #ifdef is somewhat vestigal--it's not even put in
 151         correctly. This brackets code that is partly used to send the
 152         ready message. It should be removed, the code should stay.
 153
 154     _NO_PROTO
 155         If turned on, then pre-ANSI function prototypes are used.
 156
 157     _NO_WM
 158         Enables testing code in WmPanel.c that allows it to be compiled
 159         with a test program outside of the window manager.
 160
 161     notdef
 162         Enables more complete resource comparison in WmResource.c which
 163         could make resource utilization more optimal. This is currently
 164         turned off to avoid some problems with the pixmap resources.