?
Current Path : /usr/share/emacs/24.3/lisp/ |
Linux gator3171.hostgator.com 4.19.286-203.ELK.el7.x86_64 #1 SMP Wed Jun 14 04:33:55 CDT 2023 x86_64 |
Current File : //usr/share/emacs/24.3/lisp/files.elc |
;ELC ;;; Compiled by mockbuild@buildfarm06-new.corp.cloudlinux.com on Fri Oct 11 10:12:50 2024 ;;; from file /builddir/build/BUILD/emacs-24.3/lisp/files.el ;;; in Emacs version 24.3 ;;; with all optimizations. ;;; This file uses dynamic docstrings, first added in Emacs 19.29. ;;; This file does not contain utf-8 non-ASCII characters, ;;; and so can be loaded in Emacs versions earlier than 23. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (byte-code "\300\301\302\303\304\305%\210\300\306\302\307\304\305%\210\310\311\312\313\314\315\304\316&\210\310\317\302\320\314\321\304\322\304\306& \210\310\323\312\324\314\315\304\301&\207" [custom-declare-group backup nil "Backups of edited data files." :group files find-file "Finding files." custom-declare-variable delete-auto-save-files t "Non-nil means delete auto-save file when a buffer is saved or killed.\n\nNote that the auto-save file will not be deleted if the buffer is killed\nwhen it has unsaved changes." :type boolean auto-save directory-abbrev-alist "Alist of abbreviations for file directories.\nA list of elements of the form (FROM . TO), each meaning to replace\nFROM with TO when it appears in a directory name. This replacement is\ndone when setting up the default directory of a newly visited file.\n\nFROM is matched against directory names anchored at the first\ncharacter, so it should start with a \"\\\\`\", or, if directory\nnames cannot have embedded newlines, with a \"^\".\n\nFROM and TO should be equivalent names, which refer to the\nsame directory. Do not use `~' in the TO strings;\nthey should be ordinary absolute directory names.\n\nUse this feature when you have directories which you normally refer to\nvia absolute symbolic links. Make TO the name of the link, and FROM\nthe name it is linked to." (repeat (cons :format "%v" :value ("\\`" . "") (regexp :tag "From") (string :tag "To"))) abbrev make-backup-files "Non-nil means make a backup of a file the first time it is saved.\nThis can be done by renaming the file or by copying.\n\nRenaming means that Emacs renames the existing file so that it is a\nbackup file, then writes the buffer into a new file. Any other names\nthat the old file had will now refer to the backup file. The new file\nis owned by you and its group is defaulted.\n\nCopying means that Emacs copies the existing file into the backup\nfile, then writes the buffer on top of the existing file. Any other\nnames that the old file had will now refer to the new (edited) file.\nThe file's owner and group are unchanged.\n\nThe choice of renaming or copying is controlled by the variables\n`backup-by-copying', `backup-by-copying-when-linked',\n`backup-by-copying-when-mismatch' and\n`backup-by-copying-when-privileged-mismatch'. See also `backup-inhibited'."] 10) #@181 Non-nil means don't make a backup, regardless of the other parameters. This variable is intended for use by making it local to a buffer. But it is local only if you make it local. (defvar backup-inhibited nil (#$ . 2887)) (byte-code "\300\301\302\303#\210\304\305\306\307\310\311\312\313&\210\304\314\306\315\310\311\312\313&\210\304\316\303\317\320\321\310\311\312\313& \210\300\316\302\303#\210\304\322\323\324\310\325\312\313&\207" [put backup-inhibited permanent-local t custom-declare-variable backup-by-copying nil "Non-nil means always use copying to create backup files.\nSee documentation of variable `make-backup-files'." :type boolean :group backup backup-by-copying-when-linked "Non-nil means use copying to create backups for files with multiple names.\nThis causes the alternate names to refer to the latest version as edited.\nThis variable is relevant only if `backup-by-copying' is nil." backup-by-copying-when-mismatch "Non-nil means create backups by copying if this preserves owner or group.\nRenaming may still be used (subject to control of other variables)\nwhen it would not result in changing the owner or group of the file;\nthat is, for files which are owned by you and whose group matches\nthe default for a new file created there by you.\nThis variable is relevant only if `backup-by-copying' is nil." :version "24.1" backup-by-copying-when-privileged-mismatch 200 "Non-nil means create backups by copying to preserve a privileged owner.\nRenaming may still be used (subject to control of other variables)\nwhen it would not result in changing the owner of the file or if the owner\nhas a user id greater than the value of this variable. This is useful\nwhen low-numbered uid's are used for special system users (such as root)\nthat must maintain ownership of certain files.\nThis variable is relevant only if `backup-by-copying' and\n`backup-by-copying-when-mismatch' are nil." (choice (const nil) integer)] 10) #@152 Predicate that looks at a file name and decides whether to make backups. Called with an absolute file name as argument, it returns t to enable backup. (defvar backup-enable-predicate 'normal-backup-enable-predicate (#$ . 4840)) (byte-code "\300\301\302\303\304\305\306\307&\210\310\301!\210\311\301\312\313#\210\300\314\313\315\304\305\306\316&\210\300\317\302\320\304\305\306\316&\210\311\317\321\322#\210\300\323\302\324\304\325\306\316&\207" [custom-declare-variable buffer-offer-save nil "Non-nil in a buffer means always offer to save buffer on exit.\nDo so even if the buffer is not visiting a file.\nAutomatically local in all buffers." :type boolean :group backup make-variable-buffer-local put permanent-local t find-file-existing-other-name "Non-nil means find a file under alternative names, in existing buffers.\nThis means if any existing buffer is visiting the file you want\nunder another name, you get the existing buffer instead of a new buffer." find-file find-file-visit-truename "Non-nil means visit a file under its truename.\nThe truename of a file is found by chasing all links\nboth at the file level and at the levels of the containing directories." safe-local-variable booleanp revert-without-query "Specify which files should be reverted without query.\nThe value is a list of regular expressions.\nIf the file name matches one of these regular expressions,\nthen `revert-buffer' reverts the file without querying\nif the file has changed on disk and you have not edited the buffer." (repeat regexp)] 8) #@235 The device number and file number of the file visited in the current buffer. The value is a list of the form (FILENUM DEVNUM). This pair of numbers uniquely identifies the file. If the buffer is visiting a new file, the value is nil. (defvar buffer-file-number nil (#$ . 6382)) (byte-code "\300\301!\210\302\301\303\304#\207" [make-variable-buffer-local buffer-file-number put permanent-local t] 4) #@68 Non-nil means that `buffer-file-number' uniquely identifies files. (defvar buffer-file-numbers-unique (byte-code "\301>?\207" [system-type (windows-nt)] 2) (#$ . 6787)) #@53 Non-nil if visited file was read-only when visited. (defvar buffer-file-read-only nil (#$ . 6963)) (byte-code "\300\301!\210\302\303\304\305\306\307\310\311\312\313& \207" [make-variable-buffer-local buffer-file-read-only custom-declare-variable small-temporary-file-directory (if (eq system-type 'ms-dos) (getenv "TMPDIR")) "The directory for writing small temporary files.\nIf non-nil, this directory is used instead of `temporary-file-directory'\nby programs that create small temporary files. This is for systems that\nhave fast storage with limited space, such as a RAM disk." :group files :initialize custom-initialize-delay :type (choice (const nil) directory)] 10) #@25 The system null device. (defvar null-device (purecopy "/dev/null") (#$ . 7643)) #@71 Regexp recognizing file names which aren't allowed by the filesystem. (defvar file-name-invalid-regexp (byte-code "\301=\203 \302 \204 \303\304!\207\305>\203 \303\306!\207\303\307!\207" [system-type ms-dos msdos-long-file-names purecopy "^\\([^A-Z[-`a-z]\\|..+\\)?:\\|[+, ;=|<>\"?*]\\|\\[\\|\\]\\|[ -]\\|\\(/\\.\\.?[^/]\\)\\|\\(/[^/.]+\\.[^/.]*\\.\\)" (ms-dos windows-nt cygwin) "^\\([^A-Z[-`a-z]\\|..+\\)?:\\|[|<>\"?* -]" "[ ]"] 2) (#$ . 7729)) (byte-code "\302\303\304\305\306\307\310\311&\210\302\312\304\313\306\307\310\314\315\316& \210\302\317\304\320\306\321\310\311\310\322& \210\323\317\324\325#\210\302\326\327\330\306\331\310\311\310\332& \210\302\333\304\334\306\335\310\311&\210\302\336\327\337\306\331\310\311&\210\323\336\324\340#\210\302\341\327\342\306\331\310\311&\210\323\341\324\340#\210\302\343\304\344\306\345\310\346&\210\302\347\350\351\306\352\310\346\315\353& \210\302\354\350\355\306\307\310\356&\210\302\357\360\361\310\356\306\362\363\364\315\365&\210\302\366\350\367\306\370\310\371&\210\302\372\350\373\306\307\310\374&\210\302\375\376\377\306\201@ \310\374&\210\302\201A \201B \201C \306\201D \310\374&\210\201E \201F \201G \304#\210\201H \304\211\203 @\201F N\203\201G N\204\323\201G \201F N#\210 A\211\204\343 *\201I \201F \201G \353#\207" [prop --dolist-tail-- custom-declare-variable file-precious-flag nil "Non-nil means protect against I/O errors while saving files.\nSome modes set this non-nil in particular buffers.\n\nThis feature works by writing the new contents into a temporary file\nand then renaming the temporary file to replace the original.\nIn this way, any I/O error in writing leaves the original untouched,\nand there is never any instant where the file is nonexistent.\n\nNote that this feature forces backups to be made by copying.\nYet, at the same time, saving a precious file\nbreaks any hard links between it and other files.\n\nThis feature is advisory: for example, if the directory in which the\nfile is being saved is not writable, Emacs may ignore a non-nil value\nof `file-precious-flag' and write directly into the file.\n\nSee also: `break-hardlink-on-save'." :type boolean :group backup break-hardlink-on-save "Non-nil means when saving a file that exists under several names\n(i.e., has multiple hardlinks), break the hardlink associated with\n`buffer-file-name' and write to a new file, so that the other\ninstances of the file are not affected by the save.\n\nIf `buffer-file-name' refers to a symlink, do not break the symlink.\n\nUnlike `file-precious-flag', `break-hardlink-on-save' is not advisory.\nFor example, if the directory in which a file is being saved is not\nitself writable, then error instead of saving in some\nhardlink-nonbreaking way.\n\nSee also `backup-by-copying' and `backup-by-copying-when-linked'." files :version "23.1" version-control "Control use of version numbers for backup files.\nWhen t, make numeric backup versions unconditionally.\nWhen nil, make them for files that have some already.\nThe value `never' means do not make them." (choice (const :tag "Never" never) (const :tag "If existing" nil) (other :tag "Always" t)) vc put safe-local-variable #[(x) "\301!\206 \302\232\207" [x booleanp never] 2] dired-kept-versions 2 "When cleaning directory, number of versions to keep." integer dired delete-old-versions "If t, delete excess backup versions silently.\nIf nil, ask confirmation. Any other value prevents any trimming." (choice (const :tag "Delete" t) (const :tag "Ask" nil) (other :tag "Leave" other)) kept-old-versions "Number of oldest versions to keep when a new numbered backup is made." integerp kept-new-versions "Number of newest versions to keep when a new numbered backup is made.\nIncludes the new backup. Must be > 0" require-final-newline "Whether to add a newline automatically at the end of the file.\n\nA value of t means do this only when the file is about to be saved.\nA value of `visit' means do this right after the file is visited.\nA value of `visit-save' means do it at both of those times.\nAny other non-nil value means ask user whether to add a newline, when saving.\nA value of nil means don't add newlines.\n\nCertain major modes set this locally to the value obtained\nfrom `mode-require-final-newline'." (choice (const :tag "When visiting" visit) (const :tag "When saving" t) (const :tag "When visiting or saving" visit-save) (const :tag "Don't add newlines" nil) (other :tag "Ask each time" ask)) editing-basics mode-require-final-newline t "Whether to add a newline at end of file, in certain major modes.\nThose modes set `require-final-newline' to this value when you enable them.\nThey do so because they are often used for files that are supposed\nto end in newlines, and the question is how to arrange that.\n\nA value of t means do this only when the file is about to be saved.\nA value of `visit' means do this right after the file is visited.\nA value of `visit-save' means do it at both of those times.\nAny other non-nil value means ask user whether to add a newline, when saving.\n\nA value of nil means do not add newlines. That is a risky choice in this\nvariable since this value is used for modes for files that ought to have\nfinal newlines. So if you set this to nil, you must explicitly check and\nadd a final newline, whenever you save a file that really needs one." (choice (const :tag "When visiting" visit) (const :tag "When saving" t) (const :tag "When visiting or saving" visit-save) (const :tag "Don't add newlines" nil) (other :tag "Ask each time" ask)) "22.1" auto-save-default "Non-nil says by default do auto-saving of every file-visiting buffer." auto-save auto-save-file-name-transforms `(("\\`/[^/]*:\\([^/]*/\\)*\\([^/]*\\)\\'" ,(concat temporary-file-directory "\\2") t)) "Transforms to apply to buffer file name before making auto-save file name.\nEach transform is a list (REGEXP REPLACEMENT UNIQUIFY):\nREGEXP is a regular expression to match against the file name.\nIf it matches, `replace-match' is used to replace the\nmatching part with REPLACEMENT.\nIf the optional element UNIQUIFY is non-nil, the auto-save file name is\nconstructed by taking the directory part of the replaced file-name,\nconcatenated with the buffer file name with all directory separators\nchanged to `!' to prevent clashes. This will not work\ncorrectly if your filesystem truncates the resulting name.\n\nAll the transforms in the list are tried, in the order they are listed.\nWhen one transform applies, its result is final;\nno further transforms are tried.\n\nThe default value is set up to put the auto-save file into the\ntemporary directory (see the variable `temporary-file-directory') for\nediting a remote file.\n\nOn MS-DOS filesystems without long names this variable is always\nignored." (repeat (list (string :tag "Regexp") (string :tag "Replacement") (boolean :tag "Uniquify"))) :initialize custom-initialize-delay "21.1" save-abbrevs "Non-nil means save word abbrevs too when files are saved.\nIf `silently', don't ask the user before saving." (choice (const t) (const nil) (const silently)) abbrev find-file-run-dired "Non-nil means allow `find-file' to visit directories.\nTo visit the directory, `find-file' runs `find-directory-functions'." find-file find-directory-functions '(cvs-dired-noselect dired-noselect) "List of functions to try in sequence to visit a directory.\nEach function is called with the directory name as the sole argument\nand should return either a buffer or nil." (hook :options (cvs-dired-noselect dired-noselect)) file-name-at-point-functions '(ffap-guess-file-name-at-point) "List of functions to try in sequence to get a file name at point.\nEach function should return either nil or a file name found at the\nlocation of point in the current buffer." (hook :options (ffap-guess-file-name-at-point)) defvaralias find-file-not-found-hooks find-file-not-found-functions (saved-value saved-variable-comment) make-obsolete-variable] 13) #@256 List of functions to be called for `find-file' on nonexistent file. These functions are called as soon as the error is detected. Variable `buffer-file-name' is already set up. The functions are called in the order given until one of them returns non-nil. (defvar find-file-not-found-functions nil (#$ . 15720)) (byte-code "\302\303\304\305#\210\306\305\211\203, @\303N\203% \304N\204% \307\304\303N#\210 A\211\204 *\310\303\304\311#\210\312\304\305\313\314\315\316\317\320\321\322\311&\210\302\323\324\305#\210\306\305\211\203n @\323N\203g \324N\204g \307\324\323N#\210 A\211\204P *\310\323\324\311#\207" [prop --dolist-tail-- defvaralias find-file-hooks find-file-hook nil (saved-value saved-variable-comment) put make-obsolete-variable "22.1" custom-declare-variable "List of functions to be called after a buffer is loaded from a file.\nThe buffer's local variables (if any) will have been processed before the\nfunctions are called." :group find-file :type hook :options (auto-insert) :version write-file-hooks write-file-functions] 13) #@744 List of functions to be called before writing out a buffer to a file. If one of them returns non-nil, the file is considered already written and the rest are not called. These hooks are considered to pertain to the visited file. So any buffer-local binding of this variable is discarded if you change the visited file name with \[set-visited-file-name], but not when you change the major mode. This hook is not run if any of the functions in `write-contents-functions' returns non-nil. Both hooks pertain to how to save a buffer to file, for instance, choosing a suitable coding system and setting mode bits. (See Info node `(elisp)Saving Buffers'.) To perform various checks or updates before the buffer is saved, use `before-save-hook'. (defvar write-file-functions nil (#$ . 16788)) (put 'write-file-functions 'permanent-local t) (defvar local-write-file-hooks nil) (byte-code "\302\303!\210\304\303\305\306#\210\307\303\310\311#\210\312\313\314\315#\210\316\315\211\203<