annotate src/s/README @ 593:5fd7ba8b56e7

[xemacs-hg @ 2001-05-31 12:45:27 by ben] xemacs-faq.texi: Major rewrite. Update all MS Windows info to current. Redo section 6.1 almost completely. Incorporate sections 1 and 2 of Hrvoje's FAQ. etags.el: Fix infloop when going up to the root. s\cygwin32.h: Don't unilaterally include ntplay, but only when we're compiling with native sound (look in configure now). event-msw.c: Fix yet more problems with C-g handling. Implement debug-mswindows-events. event-stream.c, events.h, signal.c, sysdep.h: Rearrange the signal-handling code to eliminate the former spaghetti logic paths in it. Document clearly what "low-level" and "high-level" timeouts are. Rename some functions with unclear names (e.g. "...alarm...") to names that reflect what they actually do (e.g. "...async_timeout..."). Fix numerous bugs discovered in the process. console-x.h, event-Xt.c, event-msw.c, frame-x.c: Hopefully make XEmacs properly maintain the "iconified" state on frames at all times. This should fix the "can't delete a frame with C-x 5 0 when there's another iconified frame out there" bug. Put a notice in of further changes that should probably be made to clean up the frame-visibility support. (especially directed at Jan Vroonhof) lisp.h, miscplay.c: Rename SBufbyte to CBufbyte to avoid a misleading name. Eliminate UChar, which is not used anywhere and contributes no semantic info. Add a comment about the documentation-only properties of the char/unsigned char typedefs. Add SChar_Binary as an explicitly `signed' version of Char_Binary and put back the `signed' declarations in miscplay.c. alloc.c: Use char typedefs. console-msw.c, device-msw.c, dialog-msw.c, editfns.c, fileio.c, glyphs-eimage.c, menubar-msw.c, ntplay.c, objects-msw.c, realpath.c, redisplay-msw.c, select-msw.c, syswindows.h, win32.c: Eliminate numerous C++ errors. frame-msw.c: Eliminate numerous C++ errors and Mule-ize. glyphs-msw.c: Eliminate numerous C++ errors and use char typedefs. configure.in: Fix problems detecting both native and Linux sound on Cygwin when compiled with --with-msw=no. Rearrange file-coding handling a bit to avoid warning when compiling with Mule. configure.in, configure.usage, INSTALL: Document XEMACS_CC and corresponding compiler option --xemacs-compiler. Explain how to build xemacs using a C++ compiler.
author ben
date Thu, 31 May 2001 12:45:41 +0000
parents 376386a54a3c
children 861f2601a38b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 This directory contains C header files containing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 operating-system-specific definitions. Each file describes a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 particular operating system. The emacs configuration script edits
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 ../config.h to include the appropriate one of these files, and then
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 each emacs source file includes config.h.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 template.h is a generic template for system descriptions; it describes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 the parameters a system file can specify.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 General XEmacs Changes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 ---------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 The following is a list of those changes made globally across all
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 files. They are not marked individually in each header file. All
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 other changes should be preceded by a comment /* XEmacs change */.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 1. Removed all #defines of [read|write|open|close]. This is now
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 handled automatically by checking the INTERRUPTIBLE_IO etc. flags.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20 2. Removed all instances of #undef SIGIO and replaced them with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21 #define BROKEN_SIGIO. Jamie says:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23 /* use BROKEN_SIGIO instead of this kludge -- jwz */
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 3. All instances of HAVE_GETWD, HAVE_DUP2, HAVE_UNISTD_H, NEED_UNISTD_H,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26 HAVE_GETTIMEOFDAY and NEED_REALPATH removed. We detect these
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 automatically with configure.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29 4. All instances of HAVE_X11 replaced with HAVE_X_WINDOWS. We don't
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30 support X10 or earlier so the HAVE_X11 define was purged.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32 5. Most of the signal crap (e.g. redefining sigsetmask, defining
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33 POSIX_SIGNALS) has been removed. There are four possible
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34 signal paradigms that all systems fall into, and we auto-detect
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 them in configure and handle them in syssignal.h.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 6. Removed references to INTERRUPT_INPUT. XEmacs does not use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38 this bizarre way of reading input.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 7. Removed references to BROKEN_FIONREAD. FIONREAD is used only
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41 in INTERRUPT_INPUT and in the select() emulator, neither of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 which are supported in XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 8. Removed references to NOMULTIPLEJOBS. This is unused in XEmacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 and in FSF Emacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 9. Removed references to HAVE_WAIT_HEADER and WAIT_USE_INT.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48 They are unnecessary with the cleaned up syswait.h in XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 (We autodetect sys/wait.h). Instead, #define or #undef
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 HAVE_UNION_WAIT.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52 10. Removed BSTRING. Not used anywhere. (If the header file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 says there are bugs in bcopy() or the like, however, a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 #define BROKEN_BCOPY is added for reference.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 11. Removed #defines of bcopy, bzero, bcmp, index, rindex.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57 XEmacs makes consistent use of the ANSI-equivalent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58 functions memcpy, memset, memcmp, strchr, strrchr.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60 12. '#define subprocesses' removed. Use '#define NO_SUBPROCESSES'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61 if they don't exist.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63 13. References to HAVE_VFORK removed. configure detects this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65 14. Removed references to SYSV_SYSTEM_DIR, NONSYSTEM_DIR_LIBRARY,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66 HAVE_SOCKETS, HAVE_SYSVIPC. configure detects these.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68 15. Removed defines of HAVE_TERMIOS, HAVE_TERMIO, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69 HAVE_TCATTR (when HAVE_TERMIOS was also defined).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 configure detects these and systty.h automatically defines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71 HAVE_TCATTR when HAVE_TERMIOS is defined.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
72
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
73 16. Removed SETPGRP_RELEASES_CTTY. Not necessary any more, with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74 fixed definitions of EMACS_SEPARATE_PROCESS_GROUP et al.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76 17. Removed defines of NLIST_STRUCT. configure detects this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78 18. Removed defines of _setjmp and _longjmp. configure detects this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
79
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80 19. Removed all '#define static' business. Defines NO_REMAP instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 20. Removed defines of HAVE_MACH_MACH_H. configure detects this.