annotate src/s/README @ 4539:061e030e3270

Fix some bugs in load-history construction, built-in symbol file names. lib-src/ChangeLog addition: 2008-12-27 Aidan Kehoe <kehoea@parhasard.net> * make-docfile.c (main): Allow more than one -d argument, followed by a directory to change to. (put_filename): Don't strip directory information; with previous change, allows retrieval of Lisp function and variable origin files from #'built-in-symbol-file relative to lisp-directory. (scan_lisp_file): Don't add an extraneous newline after the file name, put_filename has added the newline already. lisp/ChangeLog addition: 2008-12-27 Aidan Kehoe <kehoea@parhasard.net> * loadup.el (load-history): Add the contents of current-load-list to load-history before clearing it. Move the variable declarations earlier in the file to a format understood by make-docfile.c. * custom.el (custom-declare-variable): Add the variable's symbol to the current file's load history entry correctly, don't use a cons. Eliminate a comment that we don't need to worry about, we don't need to check the `initialized' C variable in Lisp. * bytecomp.el (byte-compile-output-file-form): Merge Andreas Schwab's pre-GPLv3 GNU change of 19970831 here; treat #'custom-declare-variable correctly, generating the docstrings in a format understood by make-docfile.c. * loadhist.el (symbol-file): Correct behaviour for checking autoloaded macros and functions when supplied with a TYPE argument. Accept fully-qualified paths from #'built-in-symbol-file; if a path is not fully-qualified, return it relative to lisp-directory if the filename corresponds to a Lisp file, and relative to (concat source-directory "/src/") otherwise. * make-docfile.el (preloaded-file-list): Rationalise some let bindings a little. Use the "-d" argument to make-docfile.c to supply Lisp paths relative to lisp-directory, not absolutely. Add in loadup.el explicitly to the list of files to be processed by make-docfile.c--it doesn't make sense to add it to preloaded-file-list, since that is used for purposes of byte-compilation too. src/ChangeLog addition: 2008-12-27 Aidan Kehoe <kehoea@parhasard.net> * doc.c (Fbuilt_in_symbol_file): Return a subr's filename immediately if we've found it. Check for compiled function and compiled macro docstrings in DOC too, and return them if they exist. The branch of the if statement focused on functions may have executed, but we may still want to check variable bindings; an else clause isn't appropriate.
author Aidan Kehoe <kehoea@parhasard.net>
date Sat, 27 Dec 2008 14:05:50 +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.