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.
4 ** Distinguishing OSes **
6 CYGWIN Compiling the Cygwin port.
8 MSDOS Compiling the MS-DOS port.
10 __DJGPP_MINOR__ Minor version number of the DJGPP library; used only in msdos.c and dosfns.c.
11 DOS_NT Compiling for either the MS-DOS or native MS-Windows port.
12 WINDOWSNT Compiling the native MS-Windows (W32) port.
13 __MINGW32__ Compiling the W32 port with the MinGW port of GCC.
14 _MSC_VER Compiling the W32 port with the Microsoft C compiler.
15 DARWIN_OS Compiling on Mac OS X or pure Darwin (and using s/darwin.h).
17 ** Distinguishing GUIs **
19 HAVE_NTGUI Use the native W32 GUI for windows, frames, menus&scrollbars.
20 HAVE_NS Use the NeXT/OpenStep/Cocoa UI under Mac OS X or GNUstep.
21 NS_IMPL_GNUSTEP Compile support for GNUstep implementation of NS GUI API.
22 NS_IMPL_COCOA Compile support for Cocoa (Apple) implementation of NS GUI API.
23 HAVE_X11 Compile support for the X11 GUI.
24 HAVE_X_WINDOWS Compile support for X Window system
25 (It looks like, nowadays, if HAVE_X11 is set, HAVE_X_WINDOWS must
26 be, and vice versa. At least, this is true for configure, and
27 msdos; not sure about nt.)
28 USE_LUCID Use the Lucid toolkit for menus&scrollbars. Requires HAVE_X11.
29 USE_MOTIF Use the Motif toolkit for menus&scrollbars. Requires HAVE_X11.
30 USE_GTK Use the Gtk toolkit for menus&scrollbars. Requires HAVE_X11.
34 FRAME_TERMCAP_P A tty (character terminal) frame.
35 FRAME_X_P A frame on X Window system.
36 FRAME_MSDOS_P An MS-DOS frame (used only by the DOS port).
37 FRAME_W32_P A frame using native MS-Windows GUI.
38 FRAME_WINDOW_P A GUI frame (like X, w32, etc.)
40 ** Support for accessing other processes on the system **
42 HAVE_PROCFS The /proc filesystem is supported.
44 ** Compile-time options **
46 REL_ALLOC Compile in the relocatable memory allocator ralloc.c.
47 SYSTEM_MALLOC Use the system library's malloc.
48 subprocesses System can use subprocesses (for M-x shell for example). Defined by default, only MSDOS undefines it.
49 USE_LISP_UNION_TYPE Define it in lisp.h to make Lisp_Object be a union type instead of the default int.
51 ** System specific macros, decribed in detail in src/s/template.h
63 ** Machine specific macros, decribed in detail in src/m/template.h
67 USER_FULL_NAME If defined, overrides the default pw->pw_gecos for getting at the full user name. Only MSDOS overrides the default.
69 ** Replace, the definition is trivial: SWITCH_ENUM_CAST
71 ** Defines from src/m/*.h and src/s/*.h. Some of these might not be used in the code anymore, so they can be removed. The HAVE_* definitions are probably handled by autoconf, so it might be possible to just remove them from src/[sm]/*.h.
81 BROKEN_DATAGRAM_SOCKETS
83 BROKEN_GET_CURRENT_DIR_NAME
84 BROKEN_NON_BLOCKING_CONNECT
85 BROKEN_PTY_READ_AFTER_EAGAIN
111 GC_LISP_OBJECT_ALIGNMENT
112 GC_MARK_SECONDARY_STACK
115 GMALLOC_INHIBIT_VALLOC
116 GNU_LIBRARY_PENDING_OUTPUT_COUNT
139 HAVE_INVERSE_HYPERBOLIC
151 HAVE_PSTAT_GETDYNAMIC
174 HAVE_SYS_SYSTEMINFO_H
202 MIN_PTY_KERNEL_VERSION -- only used on Mac
203 MODE_LINE_BINARY_TEXT
230 SETPGRP_RELEASES_CTTY
236 SIGNALS_VIA_CHARACTERS
242 SYSTEM_PURESIZE_EXTRA
254 USE_TOOLKIT_SCROLL_BARS