Mercurial > hg > xemacs-beta
view lwlib/xlwscrollbar.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 | ade4c7e2c6cb |
children |
line wrap: on
line source
/* Implements a lightweight scrollbar widget. Copyright (C) 1992, 1993, 1994 Lucid, Inc. This file is part of the Lucid Widget Library. The Lucid Widget Library 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. The Lucid Widget Library 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 the Lucid Widget Library. If not, see <http://www.gnu.org/licenses/>. */ /* Created by Douglas Keller <dkeller@vnet.ibm.com> */ #ifndef INCLUDED_xlwscrollbar_h_ #define INCLUDED_xlwscrollbar_h_ #include <X11/Core.h> /* Motif-compatible resource names */ #ifndef _XmStrDefs_h_ #define XmNbackground "background" #define XmNbottomShadowColor "bottomShadowColor" #define XmNbottomShadowPixmap "bottomShadowPixmap" #define XmNforeground "foreground" #define XmNincrement "increment" #define XmNinitialDelay "initialDelay" #define XmNmaximum "maximum" #define XmNminimum "minimum" #define XmNpageIncrement "pageIncrement" #define XmNrepeatDelay "repeatDelay" #define XmNshadowThickness "shadowThickness" #define XmNborderWidth "borderWidth" #define XmNshowArrows "showArrows" #define XmNsliderSize "sliderSize" #define XmNtopShadowColor "topShadowColor" #define XmNtopShadowPixmap "topShadowPixmap" #define XmNtroughColor "troughColor" #define XmNvalue "value" #define XmNvalueChangedCallback "valueChangedCallback" #define XmNincrementCallback "incrementCallback" #define XmNdecrementCallback "decrementCallback" #define XmNpageIncrementCallback "pageIncrementCallback" #define XmNpageDecrementCallback "pageDecrementCallback" #define XmNtoTopCallback "toTopCallback" #define XmNtoBottomCallback "toBottomCallback" #define XmNdragCallback "dragCallback" #define XmNorientation "orientation" #define XmCBackground "Background" #define XmCBottomShadowColor "BottomShadowColor" #define XmCBottomShadowPixmap "BottomShadowPixmap" #define XmCTopShadowPixmap "TopShadowPixmap" #define XmCForeground "Foreground" #define XmCIncrement "Increment" #define XmCInitialDelay "InitialDelay" #define XmCMaximum "Maximum" #define XmCMinimum "Minimum" #define XmCPageIncrement "PageIncrement" #define XmCRepeatDelay "RepeatDelay" #define XmCShadowThickness "ShadowThickness" #define XmCBorderWidth "BorderWidth" #define XmCShowArrows "ShowArrows" #define XmCSliderSize "SliderSize" #define XmCTopShadowColor "TopShadowColor" #define XmCTroughColor "TroughColor" #define XmCValue "Value" #define XmCValueChangedCallback "ValueChangedCallback" #define XmCIncrementCallback "IncrementCallback" #define XmCDecrementCallback "DecrementCallback" #define XmCPageIncrementCallback "PageIncrementCallback" #define XmCPageDecrementCallback "PageDecrementCallback" #define XmCToTopCallback "ToTopCallback" #define XmCToBottomCallback "ToBottomCallback" #define XmCDragCallback "DragCallback" #define XmCOrientation "Orientation" #endif /* _XmStrDefs_h_ */ /* New resources that Motif does not have. Maybe we should use a different prefix. */ /* "knob" is obsolete; use "slider" instead. */ #define XmNknobStyle "knobStyle" #define XmCKnobStyle "KnobStyle" #define XmNsliderStyle "sliderStyle" #define XmCSliderStyle "SliderStyle" #define XmNarrowPosition "arrowPosition" #define XmCArrowPosition "ArrowPosition" #ifndef _Xm_h enum { XmCR_NONE, XmCR_VALUE_CHANGED = 2, XmCR_INCREMENT, XmCR_DECREMENT, XmCR_PAGE_INCREMENT, XmCR_PAGE_DECREMENT, XmCR_TO_TOP, XmCR_TO_BOTTOM, XmCR_DRAG }; enum { XmNO_ORIENTATION, XmVERTICAL, XmHORIZONTAL }; #endif /* ! _Xm_h */ extern WidgetClass xlwScrollBarWidgetClass; typedef struct _XlwScrollBarClassRec *XlwScrollBarWidgetClass; typedef struct _XlwScrollBarRec *XlwScrollBarWidget; typedef struct { int reason; XEvent * event; int value; int pixel; } XlwScrollBarCallbackStruct; void XlwScrollBarGetValues(Widget widget, int *value, int *sliderSize, int *increment, int *pageIncrement); void XlwScrollBarSetValues(Widget widget, int value, int sliderSize, int increment, int pageIncrement, Boolean notify); #endif /* INCLUDED_xlwscrollbar_h_ */