Mercurial > emacs
view doc/lispref/hooks.texi @ 108806:511da81b16c5
Change delete-by-moving-to-trash so Lisp calls explicitly request trashing.
* src/fileio.c (Fdelete_file): Change meaning of optional arg to mean
whether to trash.
(internal_delete_file, Frename_file): Callers changed.
(delete_by_moving_to_trash): Doc fix.
(Fdelete_directory_internal): Don't move to trash.
* src/callproc.c (delete_temp_file):
* src/buffer.c (Fkill_buffer): Callers changed.
* src/lisp.h: Update prototype.
* lisp/diff.el (diff-sentinel):
* lisp/epg.el (epg--make-temp-file, epg-decrypt-string)
(epg-verify-string, epg-sign-string, epg-encrypt-string):
* lisp/jka-compr.el (jka-compr-partial-uncompress)
(jka-compr-call-process, jka-compr-write-region):
* lisp/server.el (server-sentinel): Remove optional arg from
delete-file, reverting 2010-05-03 change.
* lisp/dired.el (dired-delete-file): New arg TRASH.
(dired-internal-do-deletions): New arg TRASH. Use progress
reporter.
(dired-do-flagged-delete, dired-do-delete): Use trash.
* lisp/files.el (delete-directory): New arg TRASH.
* lisp/speedbar.el (speedbar-item-delete): Allow trashing.
* lisp/net/ange-ftp.el (ange-ftp-del-tmp-name, ange-ftp-delete-file)
(ange-ftp-rename-remote-to-remote)
(ange-ftp-rename-local-to-remote)
(ange-ftp-rename-remote-to-local, ange-ftp-load)
(ange-ftp-compress, ange-ftp-uncompress): Remove optional arg from
`delete-file'.
(ange-ftp-delete-directory): Add optional arg to `delete-file', to
allow trashing.
* lisp/net/tramp-compat.el (tramp-compat-delete-file): Rewrite to
handle new TRASH arg of `delete-file'.
* lisp/net/tramp-fish.el (tramp-fish-handle-delete-directory)
(tramp-fish-handle-delete-file)
(tramp-fish-handle-make-symbolic-link)
(tramp-fish-handle-process-file): Use null TRASH arg in
`tramp-compat-delete-file' call.
* lisp/net/tramp-ftp.el (tramp-ftp-file-name-handler): Use null TRASH
arg in `tramp-compat-delete-file' call.
* lisp/net/tramp-gvfs.el (tramp-gvfs-handle-delete-file): Rename arg.
(tramp-gvfs-handle-write-region): Use null TRASH arg in
`tramp-compat-delete-file' call.
* lisp/net/tramp-imap.el (tramp-imap-handle-delete-file): Rename arg.
(tramp-imap-do-copy-or-rename-file): Use null TRASH arg in
`tramp-compat-delete-file' call.
* lisp/net/tramp-smb.el (tramp-smb-handle-copy-file)
(tramp-smb-handle-file-local-copy, tramp-smb-handle-rename-file)
(tramp-smb-handle-write-region): Use null TRASH arg in
tramp-compat-delete-file call.
(tramp-smb-handle-delete-directory): Use tramp-compat-delete-file.
(tramp-smb-handle-delete-file): Rename arg.
* lisp/net/tramp.el (tramp-handle-delete-file): Change FORCE arg to TRASH.
(tramp-handle-make-symbolic-link, tramp-handle-load)
(tramp-do-copy-or-rename-file-via-buffer)
(tramp-do-copy-or-rename-file-directly)
(tramp-do-copy-or-rename-file-out-of-band)
(tramp-handle-process-file, tramp-handle-call-process-region)
(tramp-handle-shell-command, tramp-handle-file-local-copy)
(tramp-handle-insert-file-contents, tramp-handle-write-region)
(tramp-delete-temp-file-function): Use null TRASH arg in
tramp-compat-delete-file call.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Thu, 27 May 2010 19:30:11 -0400 |
parents | 1d1d5d9bd884 |
children | 376148b31b5e |
line wrap: on
line source
@c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1998, 2001, 2002, 2003, 2004, @c 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../../info/hooks @node Standard Hooks, Index, Standard Keymaps, Top @appendix Standard Hooks @cindex standard hooks @cindex hook variables, list of The following is a list of hook variables that let you provide functions to be called from within Emacs on suitable occasions. Most of these variables have names ending with @samp{-hook}. They are @dfn{normal hooks}, run by means of @code{run-hooks}. The value of such a hook is a list of functions; the functions are called with no arguments and their values are completely ignored. The recommended way to put a new function on such a hook is to call @code{add-hook}. @xref{Hooks}, for more information about using hooks. Every major mode defines a mode hook named @samp{@var{modename}-mode-hook}. The major mode command runs this normal hook with @code{run-mode-hooks} as the very last thing it does. @xref{Mode Hooks}. Most minor modes have mode hooks too. Mode hooks are omitted in the list below. The variables whose names end in @samp{-hooks} or @samp{-functions} are usually @dfn{abnormal hooks}; their values are lists of functions, but these functions are called in a special way (they are passed arguments, or their values are used). The variables whose names end in @samp{-function} have single functions as their values. A special feature allows you to specify expressions to evaluate if and when a file is loaded (@pxref{Hooks for Loading}). That feature is not exactly a hook, but does a similar job. @c We need to xref to where each hook is documented or else document @c it here. @table @code @item abbrev-expand-functions @xref{Abbrev Expansion}. @item activate-mark-hook @xref{The Mark}. @item after-change-functions @xref{Change Hooks}. @item after-change-major-mode-hook @xref{Mode Hooks}. @item after-init-hook @xref{Init File}. @item after-insert-file-functions @xref{Format Conversion}. @item after-make-frame-functions @xref{Creating Frames}. @item after-revert-hook @xref{Reverting}. @item after-save-hook @xref{Saving Buffers}. @item auto-fill-function @xref{Auto Filling}. @item auto-save-hook @xref{Auto-Saving}. @item before-change-functions @xref{Change Hooks}. @item before-hack-local-variables-hook @xref{File Local Variables}. @item before-init-hook @xref{Init File}. @item before-make-frame-hook @xref{Creating Frames}. @item before-revert-hook @xref{Reverting}. @item before-save-hook @xref{Saving Buffers}. @item blink-paren-function @xref{Blinking}. @item buffer-access-fontify-functions @xref{Lazy Properties}. @item calendar-initial-window-hook @iftex @inforef{Calendar Customizing,, emacs-xtra}. @end iftex @ifnottex @xref{Calendar Customizing,,, emacs}. @end ifnottex @item calendar-load-hook @iftex @inforef{Calendar Customizing,, emacs-xtra}. @end iftex @ifnottex @xref{Calendar Customizing,,, emacs}. @end ifnottex @item calendar-today-invisible-hook @iftex @inforef{Calendar Customizing,, emacs-xtra}. @end iftex @ifnottex @xref{Calendar Customizing,,, emacs}. @end ifnottex @item calendar-today-visible-hook @iftex @inforef{Calendar Customizing,, emacs-xtra}. @end iftex @ifnottex @xref{Calendar Customizing,,, emacs}. @end ifnottex @item change-major-mode-hook @xref{Creating Buffer-Local}. @item command-line-functions @xref{Command-Line Arguments}. @item comment-indent-function @xref{Options for Comments,, Options Controlling Comments, emacs, the GNU Emacs Manual}. @item compilation-finish-functions Functions to call when a compilation process finishes. @item custom-define-hook Hook called after defining each customize option. @item deactivate-mark-hook @xref{The Mark}. @item delete-frame-functions Functions to call when Emacs deletes a frame. @xref{Deleting Frames}. @item delete-terminal-functions Functions to call when Emacs deletes a terminal. @xref{Multiple Terminals}. @item desktop-after-read-hook Normal hook run after a successful @code{desktop-read}. May be used to show a buffer list. @xref{Saving Emacs Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}. @item desktop-no-desktop-file-hook Normal hook run when @code{desktop-read} can't find a desktop file. May be used to show a dired buffer. @xref{Saving Emacs Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}. @item desktop-save-hook Normal hook run before the desktop is saved in a desktop file. This is useful for truncating history lists, for example. @xref{Saving Emacs Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}. @item diary-hook List of functions called after the display of the diary. Can be used for appointment notification. @item diary-list-entries-hook @iftex @inforef{Fancy Diary Display,, emacs-xtra}. @end iftex @ifnottex @xref{Fancy Diary Display,,, emacs}. @end ifnottex @item diary-mark-entries-hook @iftex @inforef{Fancy Diary Display,, emacs-xtra}. @end iftex @ifnottex @xref{Fancy Diary Display,,, emacs}. @end ifnottex @item diary-nongregorian-listing-hook @iftex @inforef{Non-Gregorian Diary,, emacs-xtra}. @end iftex @ifnottex @xref{Non-Gregorian Diary,,, emacs}. @end ifnottex @item diary-nongregorian-marking-hook @iftex @inforef{Non-Gregorian Diary,, emacs-xtra}. @end iftex @ifnottex @xref{Non-Gregorian Diary,,, emacs}. @end ifnottex @item diary-print-entries-hook @iftex @inforef{Diary Display,, emacs-xtra}. @end iftex @ifnottex @xref{Diary Display,,, emacs}. @end ifnottex @item disabled-command-function @xref{Disabling Commands}. @item echo-area-clear-hook @xref{Echo Area Customization}. @item emacs-startup-hook @xref{Init File}. @item find-file-hook @xref{Visiting Functions}. @item find-file-not-found-functions @xref{Visiting Functions}. @item first-change-hook @xref{Change Hooks}. @item font-lock-beginning-of-syntax-function @xref{Syntactic Font Lock}. @item font-lock-fontify-buffer-function @xref{Other Font Lock Variables}. @item font-lock-fontify-region-function @xref{Other Font Lock Variables}. @item font-lock-mark-block-function @xref{Other Font Lock Variables}. @item font-lock-syntactic-face-function @xref{Syntactic Font Lock}. @item font-lock-unfontify-buffer-function @xref{Other Font Lock Variables}. @item hack-local-variables-hook @xref{File Local Variables}. @item font-lock-unfontify-region-function @xref{Other Font Lock Variables}. @item kbd-macro-termination-hook @xref{Keyboard Macros}. @item kill-buffer-hook @xref{Killing Buffers}. @item kill-buffer-query-functions @xref{Killing Buffers}. @item kill-emacs-hook @xref{Killing Emacs}. @item kill-emacs-query-functions @xref{Killing Emacs}. @item lisp-indent-function @item mail-setup-hook @xref{Mail Mode Misc,, Mail Mode Miscellany, emacs, the GNU Emacs Manual}. @item menu-bar-update-hook @xref{Menu Bar}. @item minibuffer-setup-hook @xref{Minibuffer Misc}. @item minibuffer-exit-hook @xref{Minibuffer Misc}. @item mouse-position-function @xref{Mouse Position}. @item occur-hook @item post-command-hook @xref{Command Overview}. @item pre-command-hook @xref{Command Overview}. @item resume-tty-functions @xref{Suspending Emacs}. @item scheme-indent-function @item suspend-hook @xref{Suspending Emacs}. @item suspend-resume-hook @xref{Suspending Emacs}. @item suspend-tty-functions @xref{Suspending Emacs}. @item temp-buffer-setup-hook @xref{Temporary Displays}. @item temp-buffer-show-function @xref{Temporary Displays}. @item temp-buffer-show-hook @xref{Temporary Displays}. @item term-setup-hook @xref{Terminal-Specific}. @item window-configuration-change-hook @xref{Window Hooks}. @item window-scroll-functions @xref{Window Hooks}. @item window-setup-hook @xref{Window Systems}. @item window-size-change-functions @xref{Window Hooks}. @item write-contents-functions @xref{Saving Buffers}. @item write-file-functions @xref{Saving Buffers}. @item write-region-annotate-functions @xref{Format Conversion}. @end table @ignore arch-tag: 55fd0296-d906-4551-b300-979d3846aa88 @end ignore