annotate src/s/README @ 1330:4542b72c005e

[xemacs-hg @ 2003-03-01 07:25:26 by ben] build patch Makefile.in.in: Move src deletions to src/Makefile.in.in. dump-paths.el, dumped-lisp.el: Delete. Combine stuff into setup-paths.el. find-paths.el: Removed. Make this file contain generic routines only. Move stuff to compute Emacs roots to setup-paths.el. startup.el: Removed. Move these variables into setup-paths.el. setup-paths.el, startup.el: Removed. Combine all high-level code for computing the paths into setup-paths.el. Create new function startup-find-load-path to encapsulate all logic for computing `load-path'. Eliminate invocation-directory and invocation-name parameters since there is no point (false generality) -- the code references other globals, which cannot be specified. Eliminate some code duplicated between setup-paths.el and startup.el. Clean up the debug-paths code and output load-path in addition. Add logic to paths-emacs-root-p to support separated source and build trees. loadup.el, make-docfile.el, update-elc-2.el, update-elc.el: Rewrite to allow for separated source and build trees, as may occur in MS Windows. NOTE TO BUILD HACKERS: loadup.el, make-docfile.el, update-elc.el and update-elc-2.el made two assumptions that are no longer correct: (1) The source and build trees are in the same place. (2) They can make assumptions about where `.' is. These files now compute the locations of the source and build roots at the top of the file. *ALL* constant file names or path snippets must now be made absolute using expand-file-name and one of these roots. dumped-lisp.el, packages.el: Removed. Remove some unused lists of Lisp files. packages-hardcoded-lisp (empty, in any case) moved to dumped-lisp.el. startup.el: When a compiled init file is out-of-date wrt the uncompiled version, load the uncompiled version and issue a nasty warning. update-elc-2.el: Force touching of auto-autoloads files when REBUILD_AUTOLOADS was set. update-elc.el: Fix code that checks whether dumping is necessary to check against xemacs.dmp, not xemacs.exe, when Unix and pdump. lwlib-Xm.c: Fix compile warning. README, config.inc.samp, xemacs.mak: -- Major reorganization and cleanup. -- Add support for separated build tree and source tree. -- Delete all support for X Windows building, since it's totally bit-rotten and will never be fixed up. Instruct people to use Cygwin if they want such support. make-build-dir: New script to create a skeleton build tree for use with separated build and source tree compilation. m/acorn.h, m/alliant-2800.h, m/alliant.h, m/altos.h, m/amdahl.h, m/arm.h, m/att3b.h, m/aviion.h, m/clipper.h, m/cnvrgnt.h, m/convex.h, m/cydra5.h, m/delta.h, m/delta88k.h, m/dpx2.h, m/elxsi.h, m/ews4800r.h, m/gould.h, m/hp800.h, m/hp9000s300.h, m/i860.h, m/ibmps2-aix.h, m/ibmrs6000.h, m/ibmrt-aix.h, m/ibmrt.h, m/intel386.h, m/iris4d.h, m/iris5d.h, m/iris6d.h, m/irist.h, m/m68k.h, m/masscomp.h, m/mg1.h, m/mips-nec.h, m/mips-siemens.h, m/mips.h, m/nh3000.h, m/nh4000.h, m/ns32000.h, m/plexus.h, m/powerpc.h, m/sequent-ptx.h, m/sequent.h, m/sgi-challenge.h, m/stride.h, m/tad68k.h, m/targon31.h, m/tekxd88.h, m/template.h, m/tower32.h, m/tower32v3.h, m/ustation.h, m/wicat.h, m/xps100.h, data.c, doc.c, editfns.c, emacs.c, lrecord.h, ntheap.c, process-unix.c, sysdep.c, unexec.c: Delete all support for bit-rotten CANNOT_DUMP. Just use pdump. Makefile.in.in: Lots o' cleanup. Use names like LISP, SRC instead of lispdir, srcdir, for consistency with xemacs.mak and the conventions in the rest of the file. Eliminate use of ${...} in favor of $(...), to make it easier to move code between this file and xemacs.mak. Fix dependency handling wrt NEEDTODUMP to eliminate problems some people (e.g. Vin) have been seeing with non-GNU makes. Write a long section about the subtle but oh-so-important differences in dependency processing between nmake, make, and GNU make. Add unicode-encapsulate target, from xemacs.mak. chartab.c, lrecord.h: Fix crash due to attempt to free objects across dump/undump.
author ben
date Sat, 01 Mar 2003 07:25:56 +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.