annotate admin/CPP-DEFINES @ 96650:d010216f9d3f

(Screen): Copyedit. Define "buffer" and "current buffer" early on. (Point): Copyedit. Relegate historical trivia to a footnote. (Mode Line): Explain mode-line format more consistently. (Menu Bar): Copyedit.

Here are some of the cpp macros used, together with some short explanation
of their use.  Feel free to add more macros and more categories.

** Distinguishing OSes **

MAC_OS		Compiling for the `mac' window-system.
MAC_OS8		Compiling for Mac OS Classic (v8 or v9). No longer supported, all code using it can be removed.
MAC_OSX		Compiling for Mac OS X.  Not bare Darwin.
CYGWIN		Compiling the Cygwin port.
__CYGWIN__	Ditto
MSDOS		Compiling the MS-DOS port.
__MSDOS__	Ditto.
__DJGPP__	Major version number of the DJGPP library for the DOS port.
__DJGPP_MINOR__ Minor version number of the DJGPP library.
__GO32__	Compiling the DOS port with DJGPP v1.x (obsolete).
DOS_NT		Compiling for either the MS-DOS or native MS-Windows port.
WINDOWSNT	Compiling the native MS-Windows (W32) port.
__MINGW32__	Compiling the W32 port with the MinGW port of GCC.
_MSC_VER	Compiling the W32 port with the Microsoft C compiler.
IRIX6_5         Compiling on Irix-6.5
USE_LISP_UNION_TYPE Define it in lisp.h to make Lisp_Object be a union type instead of the default int.

** Distinguishing GUIs **

HAVE_NTGUI	Use the native W32 GUI for windows, frames, menus&scrollbars.
HAVE_CARBON	Compile support for the Carbon GUI.  Requires MAC_OS?
HAVE_X11	Compile support for the X11 GUI.
HAVE_X_WINDOWS	Compile support for X Window system
X11		??  Makefile.in suggests it's equivalent to HAVE_X11
USE_LUCID	Use the Lucid toolkit for menus&scrollbars.  Requires HAVE_X11.
USE_MOTIF	Use the Motif toolkit for menus&scrollbars.  Requires HAVE_X11.
USE_GTK		Use the Gtk   toolkit for menus&scrollbars.  Requires HAVE_X11.

** Frame types **

FRAME_TERMCAP_P	A tty (character terminal) frame.
FRAME_X_P	A frame on X Window system.
FRAME_MSDOS_P	An MS-DOS frame (used only by the DOS port).
FRAME_MAC_P	A Mac frame.
FRAME_W32_P	A frame using native MS-Windows GUI.
FRAME_WINDOW_P	A GUI frame (like X, w32, etc.)

** Compile-time options **
REL_ALLOC	Compile in the relocatable memory allocator ralloc.c.
SYSTEM_MALLOC	Use the system library's malloc.

** Replace, the definition is trivial: SWITCH_ENUM_CAST

** 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.


ADDR_CORRECT
ADJUST_EXEC_HEADER
AIX
AMPERSAND_FULL_NAME
A_TEXT_OFFSET
A_TEXT_SEEK
BAUD_CONVERT
BCOPY_DOWNWARD_SAFE
BCOPY_UPWARD_SAFE
BITS_PER_EMACS_INT
BITS_PER_LONG
BROKEN_DATAGRAM_SOCKETS
BROKEN_FIONREAD
BROKEN_GET_CURRENT_DIR_NAME
BROKEN_NON_BLOCKING_CONNECT
BROKEN_PTY_READ_AFTER_EAGAIN
BROKEN_SA_RESTART
BROKEN_SIGAIO
BROKEN_SIGIO
BROKEN_SIGPOLL
BROKEN_SIGPTY
BSD4_2
BSD4_3
BSD_PGRPS
BSD_SYSTEM
BSTRING
CANNOT_DUMP
CLASH_DETECTION
COFF
COFF_BSD_SYMBOLS
CRT0_DUMMIES
C_DEBUG_SWITCH
C_SWITCH_MACHINE
C_SWITCH_SYSTEM
C_SWITCH_SYSTEM_TEMACS
C_SWITCH_X_SYSTEM
DATA_END
DATA_SEG_BITS
DATA_START
DBL_MIN_REPLACEMENT
DECLARE_GETPWUID_WITH_UID_T
DEFAULT_ENTRY_ADDRESS
DEFAULT_SOUND_DEVICE
DEVICE_SEP
DIRECTORY_SEP
DONT_REOPEN_PTY
DOT_GLOBAL_START
DOUG_LEA_MALLOC
DebPrint
EMACSDEBUG
EMACS_CONFIGURATION
EMACS_CONFIG_OPTIONS
EMACS_INT
EMACS_UINT
END_FILES_1
EXPLICIT_SIGN_EXTEND
FILE_SYSTEM_CASE
FIRST_PTY_LETTER
FLOAT_CHECK_DOMAIN
FSCALE
Fread
GAP_USE_BCOPY
GC_LISP_OBJECT_ALIGNMENT
GC_MARK_SECONDARY_STACK
GC_MARK_STACK
GC_SETJMP_WORKS
GETPGRP_NO_ARG
GMALLOC_INHIBIT_VALLOC
GNU_LIBRARY_PENDING_OUTPUT_COUNT
GNU_LINUX
GNU_MALLOC
HAVE_AIX_SMT_EXP
HAVE_ALLOCA
HAVE_AVAILABILITYMACROS_H
HAVE_BCMP
HAVE_BCOPY
HAVE_CBRT
HAVE_CLOSEDIR
HAVE_CRTIN
HAVE_DUP2
HAVE_EUIDACCESS
HAVE_FMOD
HAVE_FPATHCONF
HAVE_FREXP
HAVE_FSYNC
HAVE_FTIME
HAVE_GETCWD
HAVE_GETDOMAINNAME
HAVE_GETHOSTNAME
HAVE_GETLOADAVG
HAVE_GETPAGESIZE
HAVE_GETPT
HAVE_GETTIMEOFDAY
HAVE_GETWD
HAVE_H_ERRNO
HAVE_INDEX
HAVE_INET_SOCKETS
HAVE_INVERSE_HYPERBOLIC
HAVE_LIB64_DIR
HAVE_LIBKSTAT
HAVE_LIBNCURSES
HAVE_LIBPTHREADS
HAVE_LIBXMU
HAVE_LIMITS_H
HAVE_LINUX_VERSION_H
HAVE_LOGB
HAVE_LONG_FILE_NAMES
HAVE_LRAND48
HAVE_MENUS
HAVE_MKDIR
HAVE_MKTIME
HAVE_MOUSE
HAVE_PERROR
HAVE_PSTAT_GETDYNAMIC
HAVE_PTYS
HAVE_PWD_H
HAVE_RANDOM
HAVE_RENAME
HAVE_RES_INIT
HAVE_RINDEX
HAVE_RINT
HAVE_RMDIR
HAVE_SELECT
HAVE_SETLOCALE
HAVE_SETPGID
HAVE_SETRLIMIT
HAVE_SETSID
HAVE_SHUTDOWN
HAVE_SOCKETS
HAVE_SOUND
HAVE_STDLIB_H
HAVE_STRERROR
HAVE_STRFTIME
HAVE_STRING_H
HAVE_STRUCT_UTIMBUF
HAVE_SYSINFO
HAVE_SYSVIPC
HAVE_SYSV_SIGPAUSE
HAVE_SYS_SELECT_H
HAVE_SYS_SYSTEMINFO_H
HAVE_SYS_TIMEB_H
HAVE_SYS_TIME_H
HAVE_TCATTR
HAVE_TERMIO
HAVE_TERMIOS
HAVE_TERMIOS_H
HAVE_TEXT_START
HAVE_TIMEVAL
HAVE_TM_ZONE
HAVE_TZSET
HAVE_UNISTD_H
HAVE_UTIMES
HAVE_UTIME_H
HAVE_VOLATILE
HAVE_WINDOW_SYSTEM
HAVE_WORKING_VFORK
HAVE_XRMSETDATABASE
HPUX
IBMR2AIX
INHIBIT_X11R6_XIM
INTERNAL_TERMINAL
INTERRUPT_INPUT
IRIS
IRIS_4D
IS_ANY_SEP
IS_DIRECTORY_SEP
KERNEL_FILE
LDAV_SYMBOL
LD_SWITCH_MACHINE
LD_SWITCH_MACHINE_TEMACS
LD_SWITCH_SITE
LD_SWITCH_SYSTEM
LD_SWITCH_SYSTEM_1
LD_SWITCH_SYSTEM_TEMACS
LD_SWITCH_SYSTEM_tmp
LD_SWITCH_X_DEFAULT
LIBS_CARBON
LIBS_DEBUG
LIBS_IMAGE
LIBS_MACHINE
LIBS_SYSTEM
LIBS_TERMCAP
LIBX11_SYSTEM
LIBXMU
LIB_GCC
LIB_MATH
LIB_MOTIF
LIB_STANDARD
LIB_STANDARD_LIBSRC
LINKER
LINK_CRTL_SHARE
LINUX_SBRK_BUG
LISP_FLOAT_TYPE
LNOFLSH
LOAD_AVE_CVT
LOAD_AVE_TYPE
LOCALTIME_CACHE
MAIL_USE_FLOCK
MAIL_USE_LOCKF
MAIL_USE_POP
MAIL_USE_SYSTEM_LOCK
MAXPATHLEN
MAX_PRINT_CHARS
MIN_PTY_KERNEL_VERSION -- only used on Mac
MODE_LINE_BINARY_TEXT
MULTI_KBOARD
MUST_UNDEF__STDC__
NARROWPROTO
NEED_BSDTTY
NEED_ERRNO
NEED_LIBW
NEED_PTEM_H
NEED_UNISTD_H
NLIST_STRUCT
NOMULTIPLEJOBS
NONSYSTEM_DIR_LIBRARY
NOT_C_CODE
NOT_USING_MOTIF
NO_ABORT
NO_ARG_ARRAY
NO_EDITRES
NO_HYPHENS_IN_FILENAMES
NO_MATHERR
NO_REMAP
NO_SHARED_LIBS
NO_SIOCTL_H
NO_SOCK_SIGIO
NO_TERMIO
NSIG
NSIG_MINIMUM
NULL
NULL_DEVICE
N_BADMAG
N_SYMOFF
N_TRELOFF
N_TXTOFF
ORDINARY_LINK
OTHER_FILES
O_APPEND
O_BINARY
O_CREAT
O_EXCL
O_RDONLY
O_RDWR
O_TEXT
O_TRUNC
O_WRONLY
PAGESIZE
PENDING_OUTPUT_COUNT
PNTR_COMPARISON_TYPE
POSIX
POSIX_SIGNALS
PREFER_VSUSP
PTY_ITERATION
PTY_NAME_SPRINTF
PTY_OPEN
PTY_TTY_NAME_SPRINTF
PURESIZE
PURE_SEG_BITS
RUN_TIME_REMAP
SA_RESTART
SECTION_ALIGNMENT
SEGMENT_MASK
SEPCHAR
SETPGRP_RELEASES_CTTY
SETUP_SLAVE_PTY
SHARABLE_LIB_BUG
SIGALRM
SIGCHLD
SIGHUP
SIGKILL
SIGNALS_VIA_CHARACTERS
SIGN_EXTEND_CHAR
SIGPIPE
SIGQUIT
SIGTRAP
SIGTYPE
SOLARIS2
START_FILES
START_FILES_1
STDC_HEADERS
SYMS_SYSTEM
SYSTEM_PURESIZE_EXTRA
SYSTEM_TYPE
SYSV_SYSTEM_DIR
S_IFLNK
Srandom
TAB3
TABDLY
TERM
TERMINFO
TEXT_END
TEXT_START
THIS_IS_CONFIGURE
THIS_IS_MAKEFILE
TIME_WITH_SYS_TIME
TIOCSIGSEND
TM_IN_SYS_TIME
ULIMIT_BREAK_VALUE
UNEXEC
UNIX98_PTYS
USE_CRT_DLL
USE_MAC_IMAGE_IO
USE_MMAP_FOR_BUFFERS
USE_TOOLKIT_SCROLL_BARS
USG
USG5
USG5_4
USG_SHARED_LIBRARIES
USG_SUBTTY_WORKS
VALBITS
VIRT_ADDR_VARIES
VMS
WORDS_BIG_ENDIAN
WRETCODE
XINT
XOS_NEEDS_TIME_H
XPNTR
XSET
XUINT
_AIX
_ARCH_PPC64
_CALLBACK_
_FILE_OFFSET_BITS
_LP64
_MALLOC_INTERNAL
_NAIVE_DOS_REGS
_VARARGS_
_WINSOCKAPI_
_WINSOCK_H
__ELF__
__FreeBSD__
__FreeBSD_version
__GNUC__
__NetBSD__
__OpenBSD__
__STDC__
__arch64__
__cplusplus
__hpux
__ia64__
__linux__
__mc68000__
__mips__
_longjmp
_setjmp
_start
abort
access
alloca
bcmp
bcopy
brk
bzero
calloc
chdir
chmod
chown
close
const
creat
ctime
dup
dup2
edata
emacs
etext
execlp
execvp
fcloseall
fdopen
fgetchar
fileno
flushall
fopen
fputchar
free
fsync
ftruncate
fwrite
getdefdir
getdisk
getenv
getpid
getuid
getw
gmtime
i386
index
init_process
isatty
kill
link
linux
localtime
logb
lseek
m68k
malloc
mips
mkdir
mktemp
open
pclose
pipe
popen
putw
random
read
realloc
rename
rindex
rmdir
sbrk
select
sigmask
signal
sigsetmask
sleep
spawnve
srandom
static
strdup
strerror
stricmp
strnicmp
strupr
subprocesses
sun
sys_nerr
system
temacs
tzname
tzset
umask
unix
unlink
utimbuf
utime
vfork
wait
write
xfree

# arch-tag: bc80061a-1168-4911-9766-46aaf2640250