cde/programs/dtwm/README

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