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 **
14 CYGWIN Compiling the Cygwin port.
19 MSDOS Compiling the MS-DOS port.
21 __DJGPP_MINOR__ Minor version number of the DJGPP library; used only in msdos.c and dosfns.c.
22 DOS_NT Compiling for either the MS-DOS or native MS-Windows port.
23 WINDOWSNT Compiling the native MS-Windows (W32) port.
24 __MINGW32__ Compiling the W32 port with the MinGW port of GCC.
25 _MSC_VER Compiling the W32 port with the Microsoft C compiler.
26 DARWIN_OS Compiling on Mac OS X or pure Darwin (and using s/darwin.h).
32 ** Distinguishing GUIs **
34 HAVE_NTGUI Use the native W32 GUI for windows, frames, menus&scrollbars.
35 HAVE_NS Use the NeXT/OpenStep/Cocoa UI under Mac OS X or GNUstep.
36 NS_IMPL_GNUSTEP Compile support for GNUstep implementation of NS GUI API.
37 NS_IMPL_COCOA Compile support for Cocoa (Apple) implementation of NS GUI API.
38 HAVE_X11 Compile support for the X11 GUI.
39 HAVE_X_WINDOWS Compile support for X Window system
40 (It looks like, nowadays, if HAVE_X11 is set, HAVE_X_WINDOWS must
41 be, and vice versa. At least, this is true for configure, and
42 msdos; not sure about nt.)
46 USE_LUCID Use the Lucid toolkit for menus&scrollbars. Requires HAVE_X11.
47 USE_MOTIF Use the Motif toolkit for menus&scrollbars. Requires HAVE_X11.
48 USE_GTK Use the Gtk toolkit for menus&scrollbars. Requires HAVE_X11.
52 FRAME_TERMCAP_P A tty (character terminal) frame.
53 FRAME_X_P A frame on X Window system.
54 FRAME_MSDOS_P An MS-DOS frame (used only by the DOS port).
55 FRAME_W32_P A frame using native MS-Windows GUI.
56 FRAME_WINDOW_P A GUI frame (like X, w32, etc.)
58 ** Support for accessing other processes on the system **
60 HAVE_PROCFS The /proc filesystem is supported.
62 ** Compile-time options **
64 REL_ALLOC Compile in the relocatable memory allocator ralloc.c.
65 SYSTEM_MALLOC Use the system library's malloc.
66 subprocesses System can use subprocesses (for M-x shell for example).
67 Defined by default, only MSDOS undefines it.
68 DEBUG_LISP_OBJECT_TYPE Define it in lisp.h enable compile time checks
71 ** System specific macros
80 USER_FULL_NAME If defined, overrides the default pw->pw_gecos for
81 getting at the full user name. Only MSDOS overrides the default.
83 ** Miscellaneous defines. Some of these might not be used in the code
84 anymore, so they can be removed.
87 BROKEN_DATAGRAM_SOCKETS
90 BROKEN_GET_CURRENT_DIR_NAME
91 BROKEN_NON_BLOCKING_CONNECT
92 BROKEN_PTY_READ_AFTER_EAGAIN
105 GC_MARK_SECONDARY_STACK
114 HAVE_ATTRIBUTE_ALIGNED
127 HAVE_DBUS_TYPE_IS_VALID
128 HAVE_DBUS_VALIDATE_BUS_NAME
129 HAVE_DBUS_VALIDATE_INTERFACE
130 HAVE_DBUS_VALIDATE_MEMBER
131 HAVE_DBUS_VALIDATE_PATH
132 HAVE_DBUS_WATCH_GET_UNIX_FD
134 HAVE_DECL_LOCALTIME_R
140 HAVE_DECL_SYS_SIGLIST
142 HAVE_DECL___SYS_SIGLIST
174 HAVE_GETOPT_LONG_ONLY
184 HAVE_GET_CURRENT_DIR_NAME
188 HAVE_GNUTLS_CALLBACK_CERTIFICATE_VERIFY
189 HAVE_GNUTLS_CERTIFICATE_SET_VERIFY_FUNCTION
194 HAVE_GTK_ADJUSTMENT_GET_PAGE_SIZE
195 HAVE_GTK_DIALOG_GET_ACTION_AREA
196 HAVE_GTK_FILE_SELECTION_NEW
198 HAVE_GTK_MULTIDISPLAY
199 HAVE_GTK_ORIENTABLE_SET_ORIENTATION
200 HAVE_GTK_WIDGET_GET_MAPPED
201 HAVE_GTK_WIDGET_GET_SENSITIVE
202 HAVE_GTK_WIDGET_GET_WINDOW
203 HAVE_GTK_WIDGET_SET_HAS_WINDOW
204 HAVE_GTK_WINDOW_SET_HAS_RESIZE_GRIP
212 HAVE_KERBEROSIV_DES_H
213 HAVE_KERBEROSIV_KRB_H
216 HAVE_KRB5_ERROR_E_TEXT
220 HAVE_LANGINFO_CODESET
254 HAVE_MACHINE_SOUNDCARD_H
256 HAVE_MAGICKEXPORTIMAGEPIXELS
257 HAVE_MAGICKMERGEIMAGELAYERS
270 HAVE_MULTILINGUAL_MENU
275 HAVE_OTF_GET_VARIATION_GLYPHS
276 HAVE_PERSONALITY_LINUX32
282 HAVE_PSTAT_GETDYNAMIC
306 HAVE_SIGNED_${GLTYPE}
307 HAVE_SIGNED_SIG_ATOMIC_T
329 HAVE_STRUCT_ERA_ENTRY
330 HAVE_STRUCT_IFREQ_IFR_ADDR
331 HAVE_STRUCT_IFREQ_IFR_ADDR_SA_LEN
332 HAVE_STRUCT_IFREQ_IFR_BROADADDR
333 HAVE_STRUCT_IFREQ_IFR_FLAGS
334 HAVE_STRUCT_IFREQ_IFR_HWADDR
335 HAVE_STRUCT_IFREQ_IFR_NETMASK
336 HAVE_STRUCT_NLIST_N_UN_N_NAME
337 HAVE_STRUCT_STAT_ST_ATIMENSEC
338 HAVE_STRUCT_STAT_ST_ATIMESPEC_TV_NSEC
339 HAVE_STRUCT_STAT_ST_ATIM_ST__TIM_TV_NSEC
340 HAVE_STRUCT_STAT_ST_ATIM_TV_NSEC
341 HAVE_STRUCT_STAT_ST_BIRTHTIMENSEC
342 HAVE_STRUCT_STAT_ST_BIRTHTIMESPEC_TV_NSEC
343 HAVE_STRUCT_STAT_ST_BIRTHTIM_TV_NSEC
345 HAVE_STRUCT_TM_TM_ZONE
359 HAVE_SYS_SYSTEMINFO_H
377 HAVE_UNSIGNED_LONG_LONG_INT
399 HAVE_XSCREENNUMBEROFSCREEN
400 HAVE_XSCREENRESOURCESTRING
407 HAVE___BUILTIN_UNWIND_INIT
408 HAVE___EXECUTABLE_START
436 SETPGRP_RELEASES_CTTY
442 SIGNALS_VIA_CHARACTERS
447 SYSTEM_PURESIZE_EXTRA
457 USE_TOOLKIT_SCROLL_BARS
505 srandom (conf_post.h may undo)
556 execvp (also emacsclient.c [WINDOWSNT])
591 wait (also movemail.c [WINDOWSNT])