Docfix for kill-buffer-hook and others.
authorChong Yidong <cyd@gnu.org>
Sun, 5 Aug 2012 07:45:12 +0000 (15:45 +0800)
committerChong Yidong <cyd@gnu.org>
Sun, 5 Aug 2012 07:45:12 +0000 (15:45 +0800)
* lisp/files.el (kill-buffer-hook): Provide a defvar.

* src/term.c (Vsuspend_tty_functions, Vresume_tty_functions):
* src/frame.c (Vdelete_frame_functions):
* src/emacs.c (Vkill_emacs_hook): Doc fix.

lisp/ChangeLog
lisp/files.el
src/ChangeLog
src/emacs.c
src/frame.c
src/term.c

index 7e9da4f..71d7b50 100644 (file)
@@ -1,3 +1,7 @@
+2012-08-05  Chong Yidong  <cyd@gnu.org>
+
+       * files.el (kill-buffer-hook): Provide a defvar.
+
 2012-08-05  Glenn Morris  <rgm@gnu.org>
 
        * eshell/esh-ext.el (eshell/addpath):
index 2b4ae46..b54d3d1 100644 (file)
@@ -1514,7 +1514,11 @@ expand wildcards (if any) and replace the file with multiple files."
       (other-window 1)
       (find-alternate-file filename wildcards))))
 
-(defvar kill-buffer-hook)  ; from buffer.c
+;; Defined and used in buffer.c, but not as a DEFVAR_LISP.
+(defvar kill-buffer-hook nil
+  "Hook run when a buffer is killed.
+The buffer being killed is current while the hook is running.
+See `kill-buffer'.")
 
 (defun find-alternate-file (filename &optional wildcards)
   "Find file FILENAME, select its buffer, kill previous buffer.
index 4b60dd0..8d13944 100644 (file)
@@ -1,3 +1,9 @@
+2012-08-05  Chong Yidong  <cyd@gnu.org>
+
+       * term.c (Vsuspend_tty_functions, Vresume_tty_functions):
+       * frame.c (Vdelete_frame_functions):
+       * emacs.c (Vkill_emacs_hook): Doc fix.
+
 2012-08-04  Eli Zaretskii  <eliz@gnu.org>
 
        * xfns.c (x_set_menu_bar_lines): Fix compilation error in
index c99ed7c..223d125 100644 (file)
@@ -2424,7 +2424,7 @@ Emacs is running.  */);
               doc: /* Non-nil means Emacs is running without interactive terminal.  */);
 
   DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook,
-              doc: /* Hook to be run when `kill-emacs' is called.
+              doc: /* Hook run when `kill-emacs' is called.
 Since `kill-emacs' may be invoked when the terminal is disconnected (or
 in other similar situations), functions placed on this hook should not
 expect to be able to interact with the user.  To ask for confirmation,
index e43352d..308179e 100644 (file)
@@ -4351,7 +4351,7 @@ The pointer becomes visible again when the mouse is moved.  */);
   Vmake_pointer_invisible = Qt;
 
   DEFVAR_LISP ("delete-frame-functions", Vdelete_frame_functions,
-              doc: /* Functions to be run before deleting a frame.
+              doc: /* Functions run before deleting a frame.
 The functions are run with one arg, the frame to be deleted.
 See `delete-frame'.
 
index 803bb64..64bc88a 100644 (file)
@@ -3571,14 +3571,14 @@ This variable can be used by terminal emulator packages.  */);
 #endif
 
   DEFVAR_LISP ("suspend-tty-functions", Vsuspend_tty_functions,
-    doc: /* Functions to be run after suspending a tty.
+    doc: /* Functions run after suspending a tty.
 The functions are run with one argument, the terminal object to be suspended.
 See `suspend-tty'.  */);
   Vsuspend_tty_functions = Qnil;
 
 
   DEFVAR_LISP ("resume-tty-functions", Vresume_tty_functions,
-    doc: /* Functions to be run after resuming a tty.
+    doc: /* Functions run after resuming a tty.
 The functions are run with one argument, the terminal object that was revived.
 See `resume-tty'.  */);
   Vresume_tty_functions = Qnil;