XEmacs 21.2-b1
[chise/xemacs-chise.git.1] / src / s / README
1 This directory contains C header files containing
2 operating-system-specific definitions.  Each file describes a
3 particular operating system.  The emacs configuration script edits
4 ../config.h to include the appropriate one of these files, and then
5 each emacs source file includes config.h.
6
7 template.h is a generic template for system descriptions; it describes
8 the parameters a system file can specify.
9
10 General XEmacs Changes
11 ---------------------------
12 The following is a list of those changes made globally across all
13 files.  They are not marked individually in each header file.  All
14 other changes should be preceded by a comment /* XEmacs change */.
15
16
17 1. Removed all #defines of [read|write|open|close].  This is now
18    handled automatically by checking the INTERRUPTIBLE_IO etc. flags.
19
20 2. Removed all instances of #undef SIGIO and replaced them with
21    #define BROKEN_SIGIO.  Jamie says:
22
23    /* use BROKEN_SIGIO instead of this kludge -- jwz */
24
25 3. All instances of HAVE_GETWD, HAVE_DUP2, HAVE_UNISTD_H, NEED_UNISTD_H,
26    HAVE_GETTIMEOFDAY and NEED_REALPATH removed.  We detect these
27    automatically with configure.
28
29 4. All instances of HAVE_X11 replaced with HAVE_X_WINDOWS.  We don't
30    support X10 or earlier so the HAVE_X11 define was purged.
31
32 5. Most of the signal crap (e.g. redefining sigsetmask, defining
33    POSIX_SIGNALS) has been removed.  There are four possible
34    signal paradigms that all systems fall into, and we auto-detect
35    them in configure and handle them in syssignal.h.
36
37 6. Removed references to INTERRUPT_INPUT.  XEmacs does not use
38    this bizarre way of reading input.
39
40 7. Removed references to BROKEN_FIONREAD.  FIONREAD is used only
41    in INTERRUPT_INPUT and in the select() emulator, neither of
42    which are supported in XEmacs.
43
44 8. Removed references to NOMULTIPLEJOBS.  This is unused in XEmacs
45    and in FSF Emacs.
46
47 9. Removed references to HAVE_WAIT_HEADER and WAIT_USE_INT.
48    They are unnecessary with the cleaned up syswait.h in XEmacs.
49    (We autodetect sys/wait.h).  Instead, #define or #undef
50    HAVE_UNION_WAIT.
51
52 10. Removed BSTRING.  Not used anywhere. (If the header file
53     says there are bugs in bcopy() or the like, however, a
54     #define BROKEN_BCOPY is added for reference.)
55
56 11. Removed #defines of bcopy, bzero, bcmp, index, rindex.
57     XEmacs makes consistent use of the ANSI-equivalent
58     functions memcpy, memset, memcmp, strchr, strrchr.
59
60 12. '#define subprocesses' removed.  Use '#define NO_SUBPROCESSES'
61     if they don't exist.
62
63 13. References to HAVE_VFORK removed.  configure detects this.
64
65 14. Removed references to SYSV_SYSTEM_DIR, NONSYSTEM_DIR_LIBRARY,
66     HAVE_SOCKETS, HAVE_SYSVIPC.  configure detects these.
67
68 15. Removed defines of HAVE_TERMIOS, HAVE_TERMIO, and
69     HAVE_TCATTR (when HAVE_TERMIOS was also defined).
70     configure detects these and systty.h automatically defines
71     HAVE_TCATTR when HAVE_TERMIOS is defined.
72
73 16. Removed SETPGRP_RELEASES_CTTY.  Not necessary any more, with
74     fixed definitions of EMACS_SEPARATE_PROCESS_GROUP et al.
75
76 17. Removed defines of NLIST_STRUCT.  configure detects this.
77
78 18. Removed defines of _setjmp and _longjmp.  configure detects this.
79
80 19. Removed all '#define static' business.  Defines NO_REMAP instead.
81
82 20. Removed defines of HAVE_MACH_MACH_H.  configure detects this.