Mercurial > hg > xemacs-beta
view lisp/glade.el @ 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
;;; glade.el --- Import libglade functions into XEmacs ;; Copyright (C) 2000 Free Software Foundation ;; Maintainer: William Perry <wmperry@gnu.org> ;; Keywords: extensions, dumped ;; 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 ;;; Commentary: ;; This file is dumped with XEmacs (if glade was detected) (eval-and-compile (require 'gtk-ffi)) (globally-declare-fboundp '(gtk-import-function-internal gtk-call-function)) (gtk-import-function none glade_init) (gtk-import-function none glade_gnome_init) (gtk-import-function none glade_bonobo_init) (gtk-import-function none glade_load_module (GtkString . module)) (gtk-import-function GtkType glade_xml_get_type) (gtk-import-function GtkObject glade_xml_new (GtkString . filename) (GtkString . root)) (gtk-import-function GladeXML glade_xml_new_with_domain (GtkString . filename) (GtkString . root) (GtkString . domain)) (gtk-import-function GladeXML glade_xml_new_from_memory (GtkString . buffer) (gint . size) (GtkString . root) (GtkString . domain)) (gtk-import-function gboolean glade_xml_construct (GladeXML . self) (GtkString . filename) (GtkString . root) (GtkString . domain)) (gtk-import-function GtkWidget glade_xml_get_widget (GladeXML . xml) (GtkString . name)) (gtk-import-function GtkWidget glade_xml_get_widget_by_long_name (GladeXML . xml) (GtkString . longname)) (gtk-import-function GtkString glade_get_widget_name (GtkWidget . widget)) (gtk-import-function GtkString glade_get_widget_long_name (GtkWidget . widget)) (gtk-import-function GladeXML glade_get_widget_tree (GtkWidget . widget))