annotate src/s/README @ 5090:0ca81354c4c7

Further frame-geometry cleanups -------------------- ChangeLog entries follow: -------------------- man/ChangeLog addition: 2010-03-03 Ben Wing <ben@xemacs.org> * internals/internals.texi (Intro to Window and Frame Geometry): * internals/internals.texi (The Paned Area): * internals/internals.texi (The Displayable Area): Update to make note of e.g. the fact that the bottom gutter is actually above the minibuffer. src/ChangeLog addition: 2010-03-03 Ben Wing <ben@xemacs.org> * emacs.c: * emacs.c (assert_equal_failed): * lisp.h: * lisp.h (assert_equal): New fun assert_equal, asserting that two values == each other, and printing out both values upon failure. * frame-gtk.c (gtk_initialize_frame_size): * frame-impl.h: * frame-impl.h (FRAME_TOP_INTERNAL_BORDER_START): * frame-impl.h (FRAME_BOTTOM_INTERNAL_BORDER_START): * frame-impl.h (FRAME_LEFT_INTERNAL_BORDER_START): * frame-impl.h (FRAME_PANED_TOP_EDGE): * frame-impl.h (FRAME_NONPANED_SIZE): * frame-x.c (x_initialize_frame_size): * frame.c: * gutter.c (get_gutter_coords): * gutter.c (calculate_gutter_size): * gutter.h: * gutter.h (WINDOW_REAL_TOP_GUTTER_BOUNDS): * gutter.h (FRAME_TOP_GUTTER_BOUNDS): * input-method-xlib.c: * input-method-xlib.c (XIM_SetGeometry): * redisplay-output.c (clear_left_border): * redisplay-output.c (clear_right_border): * redisplay-output.c (redisplay_output_pixmap): * redisplay-output.c (redisplay_clear_region): * redisplay-output.c (redisplay_clear_top_of_window): * redisplay-output.c (redisplay_clear_to_window_end): * redisplay-xlike-inc.c (XLIKE_clear_frame): * redisplay.c: * redisplay.c (UPDATE_CACHE_RETURN): * redisplay.c (pixel_to_glyph_translation): * toolbar.c (update_frame_toolbars_geometry): * window.c (Fwindow_pixel_edges): Get rid of some redundant macros. Consistently use the FRAME_TOP_*_START, FRAME_RIGHT_*_END, etc. format. Rename FRAME_*_BORDER_* to FRAME_*_INTERNAL_BORDER_*. Comment out FRAME_BOTTOM_* for gutters and the paned area due to the uncertainty over where the paned area actually begins. (Eventually we should probably move the gutters outside the minibuffer so that the paned area is contiguous.) Use FRAME_PANED_* more often in the code to make things clearer. Update the diagram to show that the bottom gutter is inside the minibuffer (!) and that there are "junk boxes" when you have left and/or right gutters (dead boxes that are mistakenly left uncleared, unlike the corresponding scrollbar dead boxes). Update the text appropriately to cover the bottom gutter position, etc. Rewrite gutter-geometry code to use the FRAME_*_GUTTER_* in place of equivalent expressions referencing other frame elements, to make the code more portable in case we move around the gutter location. Cleanup FRAME_*_GUTTER_BOUNDS() in gutter.h. Add some #### GEOM! comments where I think code is incorrect -- typically, it wasn't fixed up properly when the gutter was added. Some cosmetic changes.
author Ben Wing <ben@xemacs.org>
date Wed, 03 Mar 2010 05:07:47 -0600
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.