Mercurial > hg > xemacs-beta
view src/scrollbar.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 |
line wrap: on
line source
/* Define scrollbar instance. Copyright (C) 1994, 1995 Board of Trustees, University of Illinois. Copyright (C) 2010 Ben Wing. This file is part of XEmacs. XEmacs is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. XEmacs is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with XEmacs. If not, see <http://www.gnu.org/licenses/>. */ /* Synched up with: Not in FSF. */ #ifndef INCLUDED_scrollbar_h_ #define INCLUDED_scrollbar_h_ #ifdef HAVE_SCROLLBARS struct scrollbar_instance { NORMAL_LISP_OBJECT_HEADER header; /* Used by the frame caches. */ struct scrollbar_instance *next; /* Pointer back to the mirror structure attached to. */ struct window_mirror *mirror; /* This flag indicates if the scrollbar is currently in use. */ char scrollbar_is_active; /* This flag indicates if a data parameter has changed. */ char scrollbar_instance_changed; /* A structure of auxiliary data specific to the device type. struct x_scrollbar_data is used for X window frames; defined in scrollbar-x.h */ void *scrollbar_data; }; DECLARE_LISP_OBJECT (scrollbar_instance, struct scrollbar_instance); #define XSCROLLBAR_INSTANCE(x) XRECORD (x, scrollbar_instance, struct scrollbar_instance) #define wrap_scrollbar_instance(p) wrap_record (p, scrollbar_instance) #define SCROLLBAR_INSTANCEP(x) RECORDP (x, scrollbar_instance) #define CHECK_SCROLLBAR_INSTANCE(x) CHECK_RECORD (x, scrollbar_instance) #define CONCHECK_SCROLLBAR_INSTANCE(x) CONCHECK_RECORD (x, scrollbar_instance) #define SCROLLBAR_INSTANCE_FRAME(inst) (inst->mirror->frame) void init_frame_scrollbars (struct frame *f); void init_device_scrollbars (struct device *d); void init_global_scrollbars (struct device *d); void free_frame_scrollbars (struct frame *f); void release_window_mirror_scrollbars (struct window_mirror *mir); void update_window_scrollbars (struct window *w, struct window_mirror *mirror, int active, int horiz_only); #ifdef MEMORY_USAGE_STATS Bytecount compute_all_scrollbar_instance_usage (struct scrollbar_instance * inst); #endif extern Lisp_Object Vscrollbar_width, Vscrollbar_height; extern Lisp_Object Qscrollbar_line_up; extern Lisp_Object Qscrollbar_line_down; extern Lisp_Object Qscrollbar_page_up; extern Lisp_Object Qscrollbar_page_down; extern Lisp_Object Qscrollbar_to_top; extern Lisp_Object Qscrollbar_to_bottom; extern Lisp_Object Qscrollbar_vertical_drag; extern Lisp_Object Qscrollbar_char_left; extern Lisp_Object Qscrollbar_char_right; extern Lisp_Object Qscrollbar_page_left; extern Lisp_Object Qscrollbar_page_right; extern Lisp_Object Qscrollbar_to_left; extern Lisp_Object Qscrollbar_to_right; extern Lisp_Object Qscrollbar_horizontal_drag; #endif /* HAVE_SCROLLBARS */ #endif /* INCLUDED_scrollbar_h_ */