Mercurial > hg > xemacs-beta
view src/sysdep.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
/* System-dependent prototypes Copyright (C) 1985, 1993, 1994 Free Software Foundation, Inc. Copyright (C) 2001, 2002 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: FSF 19.30. Split out of sysdep.c/emacs.c. */ #ifndef INCLUDED_sysdep_h_ #define INCLUDED_sysdep_h_ #include <setjmp.h> #ifdef PDUMP int pdump_read_file (char **pdump_start_pos, size_t *pdump_length); #endif int eight_bit_tty (struct device *d); void stuff_char (struct console *con, int c); void init_baud_rate (struct device *d); void set_exclusive_use (int fd); void set_descriptor_non_blocking (int fd); int get_pty_max_bytes (int fd); Ibyte get_eof_char (int fd); /* Wait for subprocess with process id `pid' to terminate and make sure it will get eliminated (not remain forever as a zombie) */ void wait_for_termination (int pid); /* flush any pending output * (may flush input as well; it does not matter the way we use it) */ void flush_pending_output (int channel); void child_setup_tty (int out); /* Suspend the Emacs process; give terminal to its superior. */ void sys_suspend (void); /* Suspend a process if possible; give terminal to its superior. */ void sys_suspend_process (int process); void request_sigio (void); void unrequest_sigio (void); BEGIN_C_DECLS #ifndef WIN32_NATIVE extern char **environ; #endif void stop_interrupts (void); void start_interrupts (void); MODULE_API void slow_down_interrupts (void); MODULE_API void speed_up_interrupts (void); void init_poll_for_quit (void); END_C_DECLS /* Used so that signals can break out of system calls that aren't naturally interruptible. */ extern JMP_BUF break_system_call_jump; extern volatile int can_break_system_calls; /* Call these functions if you want to change some terminal parameter -- reset the console, change the parameter, and init it again. */ void init_one_console (struct console *c); void reset_one_console (struct console *c); void init_one_device (struct device *d); void reset_one_device (struct device *d); /* Prepare all terminals for exiting Emacs; move the cursor to the bottom of the frame, turn off special modes, etc. Called at exit. This calls reset_one_console() on all consoles and does some other stuff (e.g. fix the foreground pgroup). */ void reset_all_consoles (void); /* Call these functions if you are going to temporarily exit back to the shell (e.g. when suspending). This calls reset_one_console() on the initial console and does some other stuff (e.g. fix the foreground pgroup). */ void reset_initial_console (void); void reinit_initial_console (void); /* We muck around with our process group. This function needs to be called at startup. The rest of the mucking is done as part of the functions reset_all_consoles(), reset_initial_console(), and reinit_initial_console(). */ void init_process_group (void); void munge_tty_process_group (void); void unmunge_tty_process_group (void); void disconnect_controlling_terminal (void); /* Return nonzero if safe to use tabs in output. At the time this is called, init_sys_modes has not been done yet. */ int tabs_safe_p (struct device *d); /* Get terminal size from system. If zero or a negative number is stored, the value is not valid. */ void get_tty_device_size (struct device *d, int *widthp, int *heightp); /* Set the logical window size associated with descriptor FD */ int set_window_size (int fd, int height, int width); /* Set up the proper status flags for use of a pty. */ void setup_pty (int fd); /* Return the address of the start of the text segment prior to unexec. */ char *start_of_text (void); /* Return the address of the start of the data segment prior to unexec. */ void *start_of_data (void); /* Get_system_name returns as its value a string for system-name to return. */ void init_system_name (void); #ifdef WIN32_NATIVE void *sbrk (unsigned long increment); #endif Bytecount total_data_usage (void); #endif /* INCLUDED_sysdep_h_ */