CDE/cde/programs/dtwm

Conditional Compilation
-----------------------

The following is a listing of the conditional compilation switches that
are "not obvious." Excluded are hardware or OS identifiers (e.g. __ultrix),
header file include flags, and macros (e.g. ABS).

ALTERNATE_POSTMENU
This turns on menu posting by a simple call to XtManageChild.
Normally, some underbar routines are called.

DT_LEFT_JUSTIFY_TITLE
This causes the text in the window titles to be left justified
instead of centered. NOTE that WSM must also be turned on for
this to take effect.

CONCAT_TEXTLIST
If turned on, then all members of compound text window
properties (WM_NAME, WM_ICON_NAME) are converted to XmStrings
and concatenated together. Normally, only the first member
is taken.

CONFIG_RELATIVE_TO_CLIENT
If defined, then programmatic window configurations are
absolute. Normally, the window frame offset is taken into
account if it would have been during a user-driven config.

DEBUG
Turns on code that prints out error messages (specifically
protocol errors).

DEBUGGER
Turns on code to help debugging Help-on-item.

DEBUG_ICON_BOX
Turns on code that alters iconbox spacing to help debug iconbox.
(?)

DEBUG_RESOURCE_DATABASE
Turns on code that dumps out dtwm's local resource database
to aid in debugging resource problems.

DEBUG_SESSION_HINTS
If defined, the session hints property is left on the root
window after being read. Normally, it is deleted.

DISALLOW_DEEP_ICONS
Turns off code that allows icon pixmaps of depth greater than
one.

DONT_FILTER_ICON_WINDOWS
This disables code that tries to prevent an icon window from being
managed as a normal toplevel window.

FUTURE
This appears to enable code that will allow item help to work
over window icons. I suspect that this is not completely
implemented.

ICCC_COMPLIANT
This enables stricter ICCCM compliance. Specifically, some
clients didn't get WM_PROTOCOLS quite right.

INTEGRATION_TESTING_
Swaps assignment of black and white on wait state cursor as
a quick indicator of which client is showing the wait state.

LARGECURSORS
Allows cursors larger than 16x16.

MCCABE
Conditional compile for McCabe complexity metrics.

MESSAGE_CAT
Enables message catalog code for local language support.

MOTIF_DEFAULT_ICON
Enables the default window icon with four buttons.

NO
Vestigal/experimental code for position help dialog (WmHelp.c).

NO_OL_COMPAT
If defined, then code to read and interpret Open Look window
manager hints is removed.

NO_SETPGRP
If defined, then child processes started by f.exec are not
put into their own process group.

NO_SHAPE
If defined, then the shape extension is not supported.

NO_WMQUERY
If defined, the code to provide the WM_QUERY functionality is
removed.

NO_DT
If defined, then code that references the Dt library is removed.

OLD
Vestigal code in WmHelp.c

OLD_CODE
Vestigal code.

OLD_COLORMAP
Vestigal code.

OLD_TAKE_FOCUS
Vestigal code.

PANACOMM
HP Panacom division modification to support clients running
in their X terminals.

PARANOID
If enabled, the a server grab is done around a property read.
(This is probably not necessary.)

PORT_NOVFORK
Enable for systems that don't have the vfork() call.

PORT_OLDXLIB
Enables code that works around an old bug in XGetClassHint().

R2_COMPAT
Enables support for old clients that still pass window geometry
hint information in WM_NORMAL_HINTS.

ROOT_ICON_MENU
Experimental code to provide MS Windows-like traversal of focus
between root icons with menus posted.

SGI_FOCUS_PATCH
Fixes a specific window focus problem.

UNMAP_ON_RESTART
All windows are unmapped on restart.

_BMS
Formerly used to denote code that interfaced to the HP Broadcast
message server. This code has been switched over to ICCC
messaging. The ifdef's should be removed, the code should stay.

_CMDINV
The #ifdef is somewhat vestigal--it's not even put in
correctly. This brackets code that is partly used to send the
ready message. It should be removed, the code should stay.

_NO_PROTO
If turned on, then pre-ANSI function prototypes are used.

_NO_WM
Enables testing code in WmPanel.c that allows it to be compiled
with a test program outside of the window manager.

notdef
Enables more complete resource comparison in WmResource.c which
could make resource utilization more optimal. This is currently
turned off to avoid some problems with the pixmap resources.