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 **
13 CYGWIN Compiling the Cygwin port.
18 MSDOS Compiling the MS-DOS port.
20 __DJGPP_MINOR__ Minor version number of the DJGPP library; used only in msdos.c and dosfns.c.
21 DOS_NT Compiling for either the MS-DOS or native MS-Windows port.
22 WINDOWSNT Compiling the native MS-Windows (W32) port.
23 __MINGW32__ Compiling the W32 port with the MinGW port of GCC.
24 _MSC_VER Compiling the W32 port with the Microsoft C compiler.
25 DARWIN_OS Compiling on Mac OS X or pure Darwin (and using s/darwin.h).
31 ** Distinguishing GUIs **
33 HAVE_NTGUI Use the native W32 GUI for windows, frames, menus&scrollbars.
34 HAVE_NS Use the NeXT/OpenStep/Cocoa UI under Mac OS X or GNUstep.
35 NS_IMPL_GNUSTEP Compile support for GNUstep implementation of NS GUI API.
36 NS_IMPL_COCOA Compile support for Cocoa (Apple) implementation of NS GUI API.
37 HAVE_X11 Compile support for the X11 GUI.
38 HAVE_X_WINDOWS Compile support for X Window system
39 (It looks like, nowadays, if HAVE_X11 is set, HAVE_X_WINDOWS must
40 be, and vice versa. At least, this is true for configure, and
41 msdos; not sure about nt.)
45 USE_LUCID Use the Lucid toolkit for menus&scrollbars. Requires HAVE_X11.
46 USE_MOTIF Use the Motif toolkit for menus&scrollbars. Requires HAVE_X11.
47 USE_GTK Use the Gtk toolkit for menus&scrollbars. Requires HAVE_X11.
51 FRAME_TERMCAP_P A tty (character terminal) frame.
52 FRAME_X_P A frame on X Window system.
53 FRAME_MSDOS_P An MS-DOS frame (used only by the DOS port).
54 FRAME_W32_P A frame using native MS-Windows GUI.
55 FRAME_WINDOW_P A GUI frame (like X, w32, etc.)
57 ** Support for accessing other processes on the system **
59 HAVE_PROCFS The /proc filesystem is supported.
61 ** Compile-time options **
63 REL_ALLOC Compile in the relocatable memory allocator ralloc.c.
64 SYSTEM_MALLOC Use the system library's malloc.
65 subprocesses System can use subprocesses (for M-x shell for example).
66 Defined by default, only MSDOS undefines it.
67 DEBUG_LISP_OBJECT_TYPE Define it in lisp.h enable compile time checks
70 ** System specific macros
79 USER_FULL_NAME If defined, overrides the default pw->pw_gecos for
80 getting at the full user name. Only MSDOS overrides the default.
82 ** Miscellaneous defines. Some of these might not be used in the code
83 anymore, so they can be removed.
86 BROKEN_DATAGRAM_SOCKETS
88 BROKEN_GET_CURRENT_DIR_NAME
89 BROKEN_NON_BLOCKING_CONNECT
90 BROKEN_PTY_READ_AFTER_EAGAIN
102 GC_MARK_SECONDARY_STACK
111 HAVE_ATTRIBUTE_ALIGNED
123 HAVE_DBUS_TYPE_IS_VALID
124 HAVE_DBUS_VALIDATE_BUS_NAME
125 HAVE_DBUS_VALIDATE_INTERFACE
126 HAVE_DBUS_VALIDATE_MEMBER
127 HAVE_DBUS_VALIDATE_PATH
128 HAVE_DBUS_WATCH_GET_UNIX_FD
130 HAVE_DECL_LOCALTIME_R
136 HAVE_DECL_SYS_SIGLIST
138 HAVE_DECL___SYS_SIGLIST
166 HAVE_GETOPT_LONG_ONLY
175 HAVE_GET_CURRENT_DIR_NAME
179 HAVE_GNUTLS_CALLBACK_CERTIFICATE_VERIFY
180 HAVE_GNUTLS_CERTIFICATE_SET_VERIFY_FUNCTION
185 HAVE_GTK_ADJUSTMENT_GET_PAGE_SIZE
186 HAVE_GTK_DIALOG_GET_ACTION_AREA
187 HAVE_GTK_FILE_SELECTION_NEW
189 HAVE_GTK_MULTIDISPLAY
190 HAVE_GTK_ORIENTABLE_SET_ORIENTATION
191 HAVE_GTK_WIDGET_GET_MAPPED
192 HAVE_GTK_WIDGET_GET_SENSITIVE
193 HAVE_GTK_WIDGET_GET_WINDOW
194 HAVE_GTK_WIDGET_SET_HAS_WINDOW
195 HAVE_GTK_WINDOW_SET_HAS_RESIZE_GRIP
203 HAVE_KERBEROSIV_DES_H
204 HAVE_KERBEROSIV_KRB_H
207 HAVE_KRB5_ERROR_E_TEXT
211 HAVE_LANGINFO_CODESET
245 HAVE_MACHINE_SOUNDCARD_H
247 HAVE_MAGICKEXPORTIMAGEPIXELS
248 HAVE_MAGICKMERGEIMAGELAYERS
260 HAVE_MULTILINGUAL_MENU
265 HAVE_OTF_GET_VARIATION_GLYPHS
266 HAVE_PERSONALITY_LINUX32
272 HAVE_PSTAT_GETDYNAMIC
294 HAVE_SIGNED_${GLTYPE}
295 HAVE_SIGNED_SIG_ATOMIC_T
316 HAVE_STRUCT_ERA_ENTRY
317 HAVE_STRUCT_IFREQ_IFR_ADDR
318 HAVE_STRUCT_IFREQ_IFR_ADDR_SA_LEN
319 HAVE_STRUCT_IFREQ_IFR_BROADADDR
320 HAVE_STRUCT_IFREQ_IFR_FLAGS
321 HAVE_STRUCT_IFREQ_IFR_HWADDR
322 HAVE_STRUCT_IFREQ_IFR_NETMASK
323 HAVE_STRUCT_NLIST_N_UN_N_NAME
324 HAVE_STRUCT_STAT_ST_ATIMENSEC
325 HAVE_STRUCT_STAT_ST_ATIMESPEC_TV_NSEC
326 HAVE_STRUCT_STAT_ST_ATIM_ST__TIM_TV_NSEC
327 HAVE_STRUCT_STAT_ST_ATIM_TV_NSEC
328 HAVE_STRUCT_STAT_ST_BIRTHTIMENSEC
329 HAVE_STRUCT_STAT_ST_BIRTHTIMESPEC_TV_NSEC
330 HAVE_STRUCT_STAT_ST_BIRTHTIM_TV_NSEC
332 HAVE_STRUCT_TM_TM_ZONE
346 HAVE_SYS_SYSTEMINFO_H
363 HAVE_UNSIGNED_LONG_LONG_INT
385 HAVE_XSCREENNUMBEROFSCREEN
386 HAVE_XSCREENRESOURCESTRING
393 HAVE___BUILTIN_UNWIND_INIT
394 HAVE___EXECUTABLE_START
419 SIGNALS_VIA_CHARACTERS
421 SYSTEM_PURESIZE_EXTRA
430 USE_TOOLKIT_SCROLL_BARS
478 srandom (conf_post.h may undo)
529 execvp (also emacsclient.c [WINDOWSNT])
564 wait (also movemail.c [WINDOWSNT])