Mercurial > hg > xemacs-beta
annotate src/scrollbar-gtk.h @ 5566:4654c01af32b
Improve the implementation, documentation of #'labels, #'flet.
lisp/ChangeLog addition:
2011-09-07 Aidan Kehoe <kehoea@parhasard.net>
* bytecomp.el:
* bytecomp.el (for-effect): Move this earlier in the file, it's
referenced in byte-compile-initial-macro-environment.
* bytecomp.el (byte-compile-initial-macro-environment):
In the byte-compile-macro-environment definition for #'labels, put
off the compiling the lambda bodies until the point where the rest
of the form is being compiled, allowing the lambda bodies to
access appropriate values for byte-compile-bound-variables, and
reducing excessive warning about free variables.
Add a byte-compile-macro-environment definition for #'flet. This
modifies byte-compile-function-environment appropriately, and
warns about bindings of functions that have macro definitions in
the current environment, about functions that have byte codes, and
about functions that have byte-compile methods (which may not do
what the user wants at runtime).
* bytecomp.el (byte-compile-funcall):
If FUNCTION is constant, call #'byte-compile-callargs-warn if
that's appropriate, giving warnings about problems with calling
functions bound with #'labels.
* cl-macs.el:
* cl-macs.el (flet):
Mention the main difference from Common Lisp, that the bindings
are dynamic, not lexical. Counsel the use of #'labels, not #'flet,
for this and other reasons. Explain the limited single use case for
#'flet. Cross-reference to bytecomp.el in a comment.
* cl-macs.el (labels):
Go into detail on which functions may be called from
where. Explain how to access the function definition of a label
within FORM. Add a comment cross-referencing to bytecomp.el.
man/ChangeLog addition:
2011-09-07 Aidan Kehoe <kehoea@parhasard.net>
* cl.texi (Function Bindings):
Move #'labels first, describe it in more detail, explaining that
it is to be preferred over #'flet, and explaining why.
Explain that dynamic bindings with #'flet will also not work when
functions are accessed through their bytecodes.
author | Aidan Kehoe <kehoea@parhasard.net> |
---|---|
date | Wed, 07 Sep 2011 16:26:45 +0100 |
parents | 308d34e9f07d |
children |
rev | line source |
---|---|
462 | 1 /* Define Gtk-specific scrollbar instance. |
2 Copyright (C) 1994, 1995 Board of Trustees, University of Illinois. | |
3 | |
4 This file is part of XEmacs. | |
5 | |
5402
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
665
diff
changeset
|
6 XEmacs is free software: you can redistribute it and/or modify it |
462 | 7 under the terms of the GNU General Public License as published by the |
5402
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
665
diff
changeset
|
8 Free Software Foundation, either version 3 of the License, or (at your |
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
665
diff
changeset
|
9 option) any later version. |
462 | 10 |
11 XEmacs is distributed in the hope that it will be useful, but WITHOUT | |
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
14 for more details. | |
15 | |
16 You should have received a copy of the GNU General Public License | |
5402
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
665
diff
changeset
|
17 along with XEmacs. If not, see <http://www.gnu.org/licenses/>. */ |
462 | 18 |
19 /* Synched up with: Not in FSF. */ | |
20 | |
21 #ifndef _XEMACS_SCROLLBAR_GTK_H_ | |
22 #define _XEMACS_SCROLLBAR_GTK_H_ | |
23 | |
24 #if defined (HAVE_GTK) && defined (HAVE_SCROLLBARS) | |
25 | |
26 #include "scrollbar.h" | |
27 | |
28 typedef struct _scrollbar_values | |
29 { | |
30 int line_increment; | |
31 int page_increment; | |
32 | |
33 int minimum; | |
34 int maximum; | |
35 | |
36 int slider_size; | |
37 int slider_position; | |
38 | |
39 int scrollbar_width, scrollbar_height; | |
40 int scrollbar_x, scrollbar_y; | |
41 } scrollbar_values; | |
42 | |
43 struct gtk_scrollbar_data | |
44 { | |
45 /* Unique scrollbar identifier and name. */ | |
46 unsigned int id; | |
47 | |
48 /* Is set if we have already set the backing_store attribute correctly */ | |
49 char backing_store_initialized; | |
50 | |
51 /* Positioning and sizing information for scrollbar and slider. */ | |
52 scrollbar_values pos_data; | |
53 | |
54 /* Pointer to the scrollbar widget this structure describes. */ | |
55 GtkWidget *widget; | |
56 | |
57 gfloat last_value; | |
58 | |
59 /* Recorded starting position for Motif-like scrollbar drags. */ | |
60 int vdrag_orig_value; | |
665 | 61 Charbpos vdrag_orig_window_start; |
462 | 62 }; |
63 | |
64 #define SCROLLBAR_GTK_DATA(i) ((struct gtk_scrollbar_data *) ((i)->scrollbar_data)) | |
65 | |
66 #define SCROLLBAR_GTK_ID(i) (SCROLLBAR_GTK_DATA (i)->id) | |
67 #define SCROLLBAR_GTK_BACKING_STORE_INITIALIZED(i) \ | |
68 (SCROLLBAR_GTK_DATA (i)->backing_store_initialized) | |
69 #define SCROLLBAR_GTK_POS_DATA(i) (SCROLLBAR_GTK_DATA (i)->pos_data) | |
70 #define SCROLLBAR_GTK_WIDGET(i) (SCROLLBAR_GTK_DATA (i)->widget) | |
71 #define SCROLLBAR_GTK_LAST_VALUE(i) SCROLLBAR_GTK_DATA (i)->last_value | |
72 | |
73 #define SCROLLBAR_GTK_VDRAG_ORIG_VALUE(i) \ | |
74 (SCROLLBAR_GTK_DATA (i)->vdrag_orig_value) | |
75 #define SCROLLBAR_GTK_VDRAG_ORIG_WINDOW_START(i) \ | |
76 (SCROLLBAR_GTK_DATA (i)->vdrag_orig_window_start) | |
77 | |
78 void gtk_update_frame_scrollbars (struct frame *f); | |
79 void gtk_set_scrollbar_pointer (struct frame *f, Lisp_Object cursor); | |
80 | |
81 #endif /* HAVE_GDK and HAVE_SCROLLBARS */ | |
82 #endif /* _XEMACS_SCROLLBAR_GTK_H_ */ |