File: files.el.html
Defines most of Emacs's file- and directory-handling functions, including basic file visiting, backup generation, link handling, ITS-id version control, load- and write-hook handling, and the like.
Defined variables (138)
abbreviated-home-dir | Regexp matching the user’s homedir at the beginning of file name. |
after-revert-hook | Normal hook for ‘revert-buffer’ to run after reverting. |
after-save-hook | Normal hook that is run after a buffer is saved to its file. |
after-set-visited-file-name-hook | Normal hook run just after setting visited file name of current buffer. |
auto-mode-alist | Alist of file name patterns vs corresponding major mode functions. |
auto-mode-case-fold | Non-nil means to try second pass through ‘auto-mode-alist’. |
auto-mode-interpreter-regexp | Regexp matching interpreters, for file mode determination. |
auto-save--timer | Timer for ‘auto-save-visited-mode’. |
auto-save-default | Non-nil says by default do auto-saving of every file-visiting buffer. |
auto-save-file-name-transforms | Transforms to apply to buffer file name before making auto-save file name. |
auto-save-hook | Normal hook run just before auto-saving. |
auto-save-visited-interval | Interval in seconds for ‘auto-save-visited-mode’. |
auto-save-visited-mode | Non-nil if Auto-Save-Visited mode is enabled. |
auto-save-visited-mode-hook | Hook run after entering or leaving ‘auto-save-visited-mode’. |
auto-save-visited-predicate | Predicate function for ‘auto-save-visited-mode’. |
backup-by-copying | Non-nil means always use copying to create backup files. |
backup-by-copying-when-linked | Non-nil means use copying to create backups for files with multiple names. |
backup-by-copying-when-mismatch | Non-nil means create backups by copying if this preserves owner or group. |
backup-by-copying-when-privileged-mismatch | Non-nil means create backups by copying to preserve a privileged owner. |
backup-directory-alist | Alist of file name patterns and backup directory names. |
backup-enable-predicate | Predicate that looks at a file name and decides whether to make backups. |
backup-inhibited | If non-nil, backups will be inhibited. |
before-hack-local-variables-hook | Normal hook run before setting file-local variables. |
before-revert-hook | Normal hook for ‘revert-buffer’ to run before reverting. |
before-save-hook | Normal hook that is run before a buffer is saved to its file. |
break-hardlink-on-save | Whether to allow breaking hardlinks when saving files. |
buffer-auto-revert-by-notification | Whether a buffer can rely on notification in Auto-Revert mode. |
buffer-file-number | The inode number and the device of the file visited in the current buffer. |
buffer-file-numbers-unique | Non-nil means that ‘buffer-file-number’ uniquely identifies files. |
buffer-file-read-only | Non-nil if visited file was read-only when visited. |
buffer-offer-save | Non-nil in a buffer means always offer to save buffer on exiting Emacs. |
buffer-save-without-query | Non-nil means ‘save-some-buffers’ should save this buffer without asking. |
buffer-stale-function | Function to check whether a buffer needs reverting. |
byte-count-to-string-function | Function that turns a number of bytes into a human-readable string. |
cache-long-line-scans | Non-nil means that Emacs should use caches in attempt to speedup buffer scans. |
cd-path | Value of the CDPATH environment variable, as a list. |
change-major-mode-with-file-name | Non-nil means C-x C-w should set the major mode from the file name. |
confirm-kill-emacs | How to ask for confirmation when leaving Emacs. |
confirm-kill-processes | Non-nil if Emacs should confirm killing processes on exit. |
confirm-nonexistent-file-or-buffer | Whether confirmation is requested before visiting a new file or buffer. |
copy-directory-create-symlink | This option influences the handling of symbolic links in ‘copy-directory’. |
delete-old-versions | If t, delete excess backup versions silently. |
dir-local-variables-alist | Alist of directory-local variable settings in the current buffer. |
dir-locals-class-alist | Alist mapping directory-local variable classes (symbols) to variable lists. |
dir-locals-directory-cache | List of cached directory roots for directory-local variable classes. |
dir-locals-file | File that contains directory-local variables. |
directory-abbrev-alist | Alist of abbreviations for file directories. |
directory-files-no-dot-files-regexp | Regexp matching any file name except "." and "..". |
directory-free-space-args | Options to use when running ‘directory-free-space-program’. |
directory-free-space-program | Program to get the amount of free space on a file system. |
directory-listing-before-filename-regexp | Regular expression to match up to the file name in a directory listing. |
dired-kept-versions | When cleaning directory, number of versions to keep. |
enable-dir-local-variables | Non-nil means enable use of directory-local variables. |
enable-local-eval | Control processing of the "variable" ‘eval’ in a file’s local variables. |
enable-local-variables | Control use of local variables in files you visit. |
enable-remote-dir-locals | Non-nil means dir-local variables will be applied to remote files. |
file-auto-mode-skip | Regexp of lines to skip when looking for file-local settings. |
file-has-changed-p--hash-table | Internal variable used by ‘file-has-changed-p’. |
file-local-variables-alist | Alist of file-local variable settings in the current buffer. |
file-name-at-point-functions | List of functions to try in sequence to get a file name at point. |
file-name-history | History list of file names entered in the minibuffer. |
file-name-invalid-regexp | Regexp recognizing file names that aren’t allowed by the filesystem. |
file-name-version-regexp | Regular expression matching the backup/version part of a file name. |
file-precious-flag | Non-nil means protect against I/O errors while saving files. |
file-preserve-symlinks-on-save | If non-nil, saving a buffer visited via a symlink won’t overwrite the symlink. |
find-directory-functions | List of functions to try in sequence to visit a directory. |
find-file-existing-other-name | Non-nil means find a file under alternative names, in existing buffers. |
find-file-hook | List of functions to be called after a buffer is loaded from a file. |
find-file-hooks | List of functions to be called after a buffer is loaded from a file. |
find-file-literally | Non-nil if this buffer was made by ‘find-file-literally’ or equivalent. |
find-file-not-found-functions | List of functions to be called for ‘find-file’ on nonexistent file. |
find-file-run-dired | Non-nil means allow ‘find-file’ to visit directories. |
find-file-suppress-same-file-warnings | Non-nil means suppress warning messages for symlinked files. |
find-file-visit-truename | Non-nil means visiting a file uses its truename as the visited-file name. |
find-file-wildcards | Non-nil means file-visiting commands should handle wildcards. |
find-sibling-rules | Rules for finding "sibling" files. |
hack-local-variables-hook | Normal hook run after processing a file’s local variables specs. |
ignored-local-variable-values | List of variable-value pairs that should always be ignored. |
ignored-local-variables | Variables to be ignored in a file’s local variable spec. |
inhibit-local-variables-ignore-case | Non-nil means ‘inhibit-local-variables-p’ ignores case. |
inhibit-local-variables-regexps | List of regexps matching file names in which to ignore local variables. |
inhibit-local-variables-suffixes | List of regexps matching suffixes to remove from file names. |
insert-directory-program | Absolute or relative name of the ‘ls’-like program. |
interpreter-mode-alist | Alist mapping interpreter names to major modes. |
kept-new-versions | Number of newest versions to keep when a new numbered backup is made. |
kept-old-versions | Number of oldest versions to keep when a new numbered backup is made. |
kill-buffer-hook | Hook run when a buffer is killed. |
kill-emacs-query-functions | Functions to call with no arguments to query about killing Emacs. |
large-file-warning-threshold | Maximum size of file above which a confirmation is requested. |
list-directory-brief-switches | Switches for ‘list-directory’ to pass to ‘ls’ for brief listing. |
list-directory-verbose-switches | Switches for ‘list-directory’ to pass to ‘ls’ for verbose listing. |
local-enable-local-variables | Like ‘enable-local-variables’, except for major mode in a -*- line. |
locate-dominating-stop-dir-regexp | Regexp of directory names that stop the search in ‘locate-dominating-file’. |
lock-file-mode | Non-nil if Lock-File mode is enabled. |
lock-file-mode-hook | Hook run after entering or leaving ‘lock-file-mode’. |
lock-file-name-transforms | Transforms to apply to buffer file name before making a lock file name. |
magic-fallback-mode-alist | Like ‘magic-mode-alist’ but has lower priority than ‘auto-mode-alist’. |
magic-mode-alist | Alist of buffer beginnings vs. corresponding major mode functions. |
magic-mode-regexp-match-limit | Upper limit on ‘magic-mode-alist’ regexp matches. |
major-mode-remap-alist | Alist mapping file-specified mode to actual mode. |
make-backup-file-name-function | A function that ‘make-backup-file-name’ uses to create backup file names. |
make-backup-files | Non-nil means make a backup of a file the first time it is saved. |
mode-require-final-newline | Whether to add a newline at end of file, in certain major modes. |
mounted-file-systems | File systems that ought to be mounted. |
null-device | The system null device. |
out-of-memory-warning-percentage | Warn if file size exceeds this percentage of available free memory. |
permanently-enabled-local-variables | A list of file-local variables that are always enabled. |
query-about-changed-file | If non-nil, query the user when re-visiting a file that has changed. |
remote-file-name-inhibit-auto-save-visited | When nil, ‘auto-save-visited-mode’ will auto-save remote files. |
remote-file-name-inhibit-cache | Whether to use the remote file-name cache for read access. |
remote-file-name-inhibit-locks | Whether to use file locks for remote files. |
remote-shell-program | Program to use to execute commands on a remote host (i.e. ssh). |
require-final-newline | Whether to add a newline automatically at the end of the file. |
revert-buffer-function | Function to use to revert this buffer. |
revert-buffer-in-progress-p | Non-nil if a ‘revert-buffer’ operation is in progress, nil otherwise. |
revert-buffer-insert-file-contents-function | Function to use to insert contents when reverting this buffer. |
revert-buffer-quick-short-answers | How much confirmation to be done by the ‘revert-buffer-quick’ command. |
revert-buffer-with-fine-grain-max-seconds | Maximum time that ‘revert-buffer-with-fine-grain’ should use. |
revert-without-query | Specify which files should be reverted without query. |
safe-local-eval-forms | Expressions that are considered safe in an ‘eval:’ local variable. |
safe-local-variable-values | List of variable-value pairs that are considered safe. |
save-abbrevs | Non-nil means save word abbrevs too when files are saved. |
save-buffer-coding-system | If non-nil, use this coding system for saving the buffer. |
save-silently | If non-nil, avoid messages when saving files. |
save-some-buffers-action-alist | ACTION-ALIST argument used in call to ‘map-y-or-n-p’. |
save-some-buffers-default-predicate | Default predicate for ‘save-some-buffers’. |
save-some-buffers-functions | Functions to be run by ‘save-some-buffers’ after saving the buffers. |
set-auto-mode--last | Remember the mode we have set via ‘set-auto-mode-0’. |
small-temporary-file-directory | The directory for writing small temporary files. |
trash-directory | Directory for ‘move-file-to-trash’ to move files and directories to. |
untrusted-content | Non-nil means that current buffer originated from an untrusted source. |
user-emacs-directory-warning | Non-nil means warn if unable to access or create ‘user-emacs-directory’. |
version-control | Control use of version numbers for backup files. |
view-read-only | Non-nil means buffers visiting files read-only do so in view mode. |
write-contents-functions | List of functions to be called before writing out a buffer to a file. |
write-contents-hooks | List of functions to be called before writing out a buffer to a file. |
write-file-functions | List of functions to be called before saving a buffer to a file. |
write-file-hooks | List of functions to be called before saving a buffer to a file. |