1 Here are some of the cpp macros used, together with some short explanation
2 of their use. Feel free to add more macros and more categories.
3 Most of these are from config.in, so it's probably better to put the
4 explanations in that file. Ideally, everything would be defined and
5 documented in config.in, and this file would not be necessary.
8 ** Distinguishing OSes **
12 CYGWIN Compiling the Cygwin port.
16 MSDOS Compiling the MS-DOS port.
18 __DJGPP_MINOR__ Minor version number of the DJGPP library; used only in msdos.c and dosfns.c.
19 DOS_NT Compiling for either the MS-DOS or native MS-Windows port.
20 WINDOWSNT Compiling the native MS-Windows (W32) port.
21 __MINGW32__ Compiling the W32 port with the MinGW or MinGW-w64 ports of GCC.
22 _MSC_VER Compiling the W32 port with the Microsoft C compiler.
23 MINGW_W64 Compiling the W32 port with the MinGW-w64 port of GCC.
24 DARWIN_OS Compiling on Mac OS X or pure Darwin (and using s/darwin.h).
29 ** Distinguishing GUIs **
31 HAVE_NTGUI Use the native W32 GUI for windows, frames, menus&scrollbars.
32 HAVE_NS Use the NeXT/OpenStep/Cocoa UI under Mac OS X or GNUstep.
33 NS_IMPL_GNUSTEP Compile support for GNUstep implementation of NS GUI API.
34 NS_IMPL_COCOA Compile support for Cocoa (Apple) implementation of NS GUI API.
35 HAVE_X11 Compile support for the X11 GUI.
36 HAVE_X_WINDOWS Compile support for X Window system
37 (It looks like, nowadays, if HAVE_X11 is set, HAVE_X_WINDOWS must
38 be, and vice versa. At least, this is true for configure, and
39 msdos; not sure about nt.)
43 USE_LUCID Use the Lucid toolkit for menus&scrollbars. Requires HAVE_X11.
44 USE_MOTIF Use the Motif toolkit for menus&scrollbars. Requires HAVE_X11.
45 USE_GTK Use the Gtk toolkit for menus&scrollbars. Requires HAVE_X11.
49 FRAME_TERMCAP_P A tty (character terminal) frame.
50 FRAME_X_P A frame on X Window system.
51 FRAME_MSDOS_P An MS-DOS frame (used only by the DOS port).
52 FRAME_W32_P A frame using native MS-Windows GUI.
53 FRAME_WINDOW_P A GUI frame (like X, w32, etc.)
55 ** Support for accessing other processes on the system **
57 HAVE_PROCFS The /proc filesystem is supported.
59 ** Compile-time options **
61 REL_ALLOC Compile in the relocatable memory allocator ralloc.c.
62 SYSTEM_MALLOC Use the system library's malloc.
63 subprocesses System can use subprocesses (for M-x shell for example).
64 Defined by default, only MSDOS undefines it.
65 DEBUG_LISP_OBJECT_TYPE Define it in lisp.h enable compile time checks
68 ** System specific macros
77 USER_FULL_NAME If defined, overrides the default pw->pw_gecos for
78 getting at the full user name. Only MSDOS overrides the default.
80 ** Miscellaneous defines. Some of these might not be used in the code
81 anymore, so they can be removed.
84 BROKEN_DATAGRAM_SOCKETS
86 BROKEN_GET_CURRENT_DIR_NAME
87 BROKEN_PTY_READ_AFTER_EAGAIN
97 GC_MARK_SECONDARY_STACK
106 HAVE_ATTRIBUTE_ALIGNED
118 HAVE_DBUS_TYPE_IS_VALID
119 HAVE_DBUS_VALIDATE_BUS_NAME
120 HAVE_DBUS_VALIDATE_INTERFACE
121 HAVE_DBUS_VALIDATE_MEMBER
122 HAVE_DBUS_VALIDATE_PATH
123 HAVE_DBUS_WATCH_GET_UNIX_FD
125 HAVE_DECL_LOCALTIME_R
131 HAVE_DECL_SYS_SIGLIST
133 HAVE_DECL___SYS_SIGLIST
157 HAVE_GETOPT_LONG_ONLY
166 HAVE_GET_CURRENT_DIR_NAME
174 HAVE_GTK_ADJUSTMENT_GET_PAGE_SIZE
175 HAVE_GTK_DIALOG_GET_ACTION_AREA
176 HAVE_GTK_FILE_SELECTION_NEW
178 HAVE_GTK_MULTIDISPLAY
179 HAVE_GTK_ORIENTABLE_SET_ORIENTATION
180 HAVE_GTK_WIDGET_GET_MAPPED
181 HAVE_GTK_WIDGET_GET_SENSITIVE
182 HAVE_GTK_WIDGET_GET_WINDOW
183 HAVE_GTK_WIDGET_SET_HAS_WINDOW
184 HAVE_GTK_WINDOW_SET_HAS_RESIZE_GRIP
191 HAVE_KERBEROSIV_KRB_H
193 HAVE_KRB5_ERROR_E_TEXT
197 HAVE_LANGINFO_CODESET
216 HAVE_MACHINE_SOUNDCARD_H
218 HAVE_MAGICKEXPORTIMAGEPIXELS
219 HAVE_MAGICKMERGEIMAGELAYERS
231 HAVE_MULTILINGUAL_MENU
236 HAVE_OTF_GET_VARIATION_GLYPHS
237 HAVE_PERSONALITY_LINUX32
243 HAVE_PSTAT_GETDYNAMIC
264 HAVE_SIGNED_${GLTYPE}
265 HAVE_SIGNED_SIG_ATOMIC_T
285 HAVE_STRUCT_ERA_ENTRY
286 HAVE_STRUCT_IFREQ_IFR_ADDR
287 HAVE_STRUCT_IFREQ_IFR_ADDR_SA_LEN
288 HAVE_STRUCT_IFREQ_IFR_BROADADDR
289 HAVE_STRUCT_IFREQ_IFR_FLAGS
290 HAVE_STRUCT_IFREQ_IFR_HWADDR
291 HAVE_STRUCT_IFREQ_IFR_NETMASK
292 HAVE_STRUCT_NLIST_N_UN_N_NAME
293 HAVE_STRUCT_STAT_ST_ATIMENSEC
294 HAVE_STRUCT_STAT_ST_ATIMESPEC_TV_NSEC
295 HAVE_STRUCT_STAT_ST_ATIM_ST__TIM_TV_NSEC
296 HAVE_STRUCT_STAT_ST_ATIM_TV_NSEC
297 HAVE_STRUCT_STAT_ST_BIRTHTIMENSEC
298 HAVE_STRUCT_STAT_ST_BIRTHTIMESPEC_TV_NSEC
299 HAVE_STRUCT_STAT_ST_BIRTHTIM_TV_NSEC
301 HAVE_STRUCT_TM_TM_ZONE
315 HAVE_SYS_SYSTEMINFO_H
332 HAVE_UNSIGNED_LONG_LONG_INT
353 HAVE_XSCREENNUMBEROFSCREEN
354 HAVE_XSCREENRESOURCESTRING
361 HAVE___BUILTIN_UNWIND_INIT
362 HAVE___EXECUTABLE_START
385 SIGNALS_VIA_CHARACTERS
387 SYSTEM_PURESIZE_EXTRA
396 USE_TOOLKIT_SCROLL_BARS
444 srandom (conf_post.h may undo)
495 execvp (also emacsclient.c [WINDOWSNT])
530 wait (also movemail.c [WINDOWSNT])