Motif provides widget writers with several dozen convenience routines known collectively as the Xme functions. Motif provides these to simplify widget writing. Widget writers should use these Xme functions whenever possible.
The Xme routines perform the following kinds of widget-writing services:
This chapter provides an overview of the Xme functions. Chapter 17 contains reference documentation for each Xme function.
Xme functions were not available in releases of Motif prior to Release 2.0. Prior to Release 2.0, Motif provided several dozen undocumented _Xm routines for widget writers and for internal use. Motif strongly recommends that you not use any of these _Xm routines in your widgets.
Many of the _Xm routines have Xme equivalents. For example, _XmClearBorder is equivalent to XmeClearBorder . To help users make the transition from _Xm routines to Xme routines, the Motif Release 2.0 XmP.h header file contains #define statements that convert some of the old _Xm calls into their new Xme equivalents. Thus, if your code calls any of the _Xm routines listed in these #define statements, and you compile against the Release 2.0 header files, the C preprocessor will automatically convert the _Xm calls to the proper Xme calls. However, Motif does not guarantee that these #define statements will continue to be available in future releases.