?
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/bookmark.elc |
;ELC ;;; Compiled by mockbuild@buildfarm06-new.corp.cloudlinux.com on Fri Oct 11 10:06:11 2024 ;;; from file /builddir/build/BUILD/emacs-24.3/lisp/bookmark.el ;;; in Emacs version 24.3.1 ;;; 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!\210\302\303\304\305\306\307%\210\310\311\304\312\313\314\306\303&\210\310\315\316\317\313\320\306\303&\207" [require pp custom-declare-group bookmark nil "Setting, annotation and jumping to bookmarks." :group matching custom-declare-variable bookmark-use-annotations "If non-nil, saving a bookmark queries for an annotation in a buffer." :type boolean bookmark-save-flag t "Controls when Emacs saves bookmarks to a file.\n--> nil means never save bookmarks, except when `bookmark-save' is\n explicitly called (\\[bookmark-save]).\n--> t means save bookmarks when Emacs is killed.\n--> Otherwise, it should be a number that is the frequency with which\n the bookmark list is saved (i.e.: the number of times which\n Emacs's bookmark list may be modified before it is automatically\n saved.). If it is a number, Emacs will also automatically save\n bookmarks when it is killed.\n\nTherefore, the way to get it to save every time you make or delete a\nbookmark is to set this variable to 1 (or 0, which produces the same\nbehavior.)\n\nTo specify the file in which to save them, modify the variable\n`bookmark-default-file', which is `~/.emacs.bmk' by default." (choice (const nil) integer (other t))] 8) #@52 The `.emacs.bmk' file used to be called this name. (defconst bookmark-old-default-file "~/.emacs-bkmrks" (#$ . 1793)) #@39 Old name for `bookmark-default-file'. (defvar bookmark-file nil (#$ . 1917)) (byte-code "\300\301\302\303\304\305\306\307&\210\300\310\311\312\304\313\306\307&\210\300\314\315\316\304\317\306\307&\210\300\320\315\321\304\317\306\307&\210\300\322\315\323\304\317\306\307&\207" [custom-declare-variable bookmark-default-file (if bookmark-file bookmark-file (locate-user-emacs-file "bookmarks" ".emacs.bmk")) "File in which to save bookmarks by default." :type file :group bookmark bookmark-version-control 'nospecial "Whether or not to make numbered backups of the bookmark file.\nIt can have four values: t, nil, `never', or `nospecial'.\nThe first three have the same meaning that they do for the\nvariable `version-control'; the value `nospecial' (the default) means\njust use the value of `version-control'." (choice (const :tag "If existing" nil) (const :tag "Never" never) (const :tag "Use value of option `version-control'" nospecial) (other :tag "Always" t)) bookmark-completion-ignore-case t "Non-nil means bookmark functions ignore case in completion." boolean bookmark-sort-flag "Non-nil means that bookmarks will be displayed sorted by bookmark name.\nOtherwise they will be displayed in LIFO order (that is, most\nrecently set ones come first, oldest ones come last)." bookmark-automatically-show-annotations "Non-nil means show annotations when jumping to a bookmark."] 8) #@54 Number of lines used for the *Bookmark List* header. (defconst bookmark-bmenu-header-height 2 (#$ . 3313)) #@104 Number of columns (chars) used for the *Bookmark List* marks column, including the annotations column. (defconst bookmark-bmenu-marks-width 2 (#$ . 3427)) (byte-code "\300\301\302\303\304\305\306\307&\210\300\310\311\312\304\313\306\307&\210\300\314\315\316\304\305\306\307&\210\300\317\320\321\306\307\304\305&\210\322\323\324\325\306\307\326\327&\210\330\331!\204A \331\332M\210\330\333!\204L \331\333\334\"\210\300\207" [custom-declare-variable bookmark-bmenu-file-column 30 "Column at which to display filenames in a buffer listing bookmarks.\nYou can toggle whether files are shown with \\<bookmark-bmenu-mode-map>\\[bookmark-bmenu-toggle-filenames]." :type integer :group bookmark bookmark-bmenu-toggle-filenames t "Non-nil means show filenames when listing bookmarks.\nA non-nil value may result in truncated bookmark names." boolean bookmark-menu-length 70 "Maximum length of a bookmark name displayed on a popup menu." bookmark-search-delay 0.2 "Time before `bookmark-bmenu-search' updates the display." custom-declare-face bookmark-menu-heading ((t (:inherit font-lock-type-face))) "Face used to highlight the heading in bookmark menu buffers." :version "22.1" fboundp defalias fset frame-height screen-height] 8) #@279 Keymap containing bindings to bookmark functions. It is not bound to any key by default: to bind it so that you have a bookmark prefix, just use `global-set-key' and bind a key of your choice to `bookmark-map'. All interactive bookmark functions have a binding in this keymap. (defvar bookmark-map (byte-code "\301 \302\303\304#\210\302\305\304#\210\302\306\307#\210\302\310\307#\210\302\311\312#\210\302\313\314#\210\302\315\316#\210\302\317\320#\210\302\321\322#\210\302\323\324#\210\302\325\326#\210\302\327\330#\210\302\331\332#\210)\207" [map make-sparse-keymap define-key "x" bookmark-set "m" "j" bookmark-jump "g" "o" bookmark-jump-other-window "i" bookmark-insert "e" edit-bookmarks "f" bookmark-insert-location "r" bookmark-rename "d" bookmark-delete "l" bookmark-load "w" bookmark-write "s" bookmark-save] 4) (#$ . 4663)) #@1322 Association list of bookmarks and their records. Bookmark functions update the value automatically. You probably do NOT want to change the value yourself. The value is an alist with entries of the form (BOOKMARK-NAME . PARAM-ALIST) or the deprecated form (BOOKMARK-NAME PARAM-ALIST). BOOKMARK-NAME is the name you gave to the bookmark when creating it. PARAM-ALIST is an alist of bookmark information. The order of the entries in PARAM-ALIST is not important. The possible entries are described below. An entry with a key but null value means the entry is not used. (filename . FILENAME) (position . POS) (front-context-string . STR-AFTER-POS) (rear-context-string . STR-BEFORE-POS) (handler . HANDLER) (annotation . ANNOTATION) FILENAME names the bookmarked file. POS is the bookmarked buffer position (position in the file). STR-AFTER-POS is buffer text that immediately follows POS. STR-BEFORE-POS is buffer text that immediately precedes POS. ANNOTATION is a string that describes the bookmark. See options `bookmark-use-annotations' and `bookmark-automatically-show-annotations'. HANDLER is a function that provides the bookmark-jump behavior for a specific kind of bookmark. This is the case for Info bookmarks, for instance. HANDLER must accept a bookmark as argument. (defvar bookmark-alist nil (#$ . 5519)) #@81 Non-nil if and only if bookmarks have been loaded from `bookmark-default-file'. (defvar bookmarks-already-loaded nil (#$ . 6886)) #@140 Name of bookmark most recently used in the current file. It is buffer local, used to make moving a bookmark forward through a file easier. (defvar bookmark-current-bookmark nil (#$ . 7023)) (make-variable-buffer-local 'bookmark-current-bookmark) #@67 Number of modifications to bookmark list since it was last saved. (defvar bookmark-alist-modification-count 0 (#$ . 7275)) #@70 Length of the context strings recorded on either side of a bookmark. (defvar bookmark-search-size 16 (#$ . 7404)) #@212 The buffer in which a bookmark is currently being set or renamed. Functions that insert strings into the minibuffer use this to know the source buffer for that information; see `bookmark-yank-word' for example. (defvar bookmark-current-buffer nil (#$ . 7525)) #@117 The next point from which to pull source text for `bookmark-yank-word'. This point is in `bookmark-current-buffer'. (defvar bookmark-yank-point 0 (#$ . 7792)) #@56 Non nil make `bookmark-bmenu-search' quit immediately. (defvar bookmark-quit-flag nil (#$ . 7957)) #@67 Run BODY while preserving the buffer's `buffer-modified-p' state. (defalias 'with-buffer-modified-unmodified '(macro . #[(&rest body) "\302\303!\304\305BC\306\307 B\310DEE)\207" [was-modified body make-symbol "was-modified" let ((buffer-modified-p)) unwind-protect progn set-buffer-modified-p] 6 (#$ . 8062)])) #@99 Return the name of BOOKMARK-RECORD. BOOKMARK-RECORD is, e.g., one element from `bookmark-alist'. (defalias 'bookmark-name-from-full-record #[(bookmark-record) "@\207" [bookmark-record] 1 (#$ . 8382)]) #@46 Return a list of all current bookmark names. (defalias 'bookmark-all-names #[nil "\301 \210\302\303\"\207" [bookmark-alist bookmark-maybe-load-default-file mapcar bookmark-name-from-full-record] 3 (#$ . 8591)]) #@290 Return the bookmark record corresponding to BOOKMARK-NAME-OR-RECORD. If BOOKMARK-NAME-OR-RECORD is a string, look for the corresponding bookmark record in `bookmark-alist'; return it if found, otherwise error. Else if BOOKMARK-NAME-OR-RECORD is already a bookmark record, just return it. (defalias 'bookmark-get-bookmark #[(bookmark-name-or-record &optional noerror) ":\203 \207;\205 \304 \n#\206 ?\205 \305\306\"\207" [bookmark-name-or-record bookmark-alist bookmark-completion-ignore-case noerror assoc-string error "Invalid bookmark %s"] 4 (#$ . 8810)]) #@129 Return the record portion of the entry for BOOKMARK-NAME-OR-RECORD in `bookmark-alist' (that is, all information but the name). (defalias 'bookmark-get-bookmark-record #[(bookmark-name-or-record) "\303!A\211A\204 \211@@):\203 @\202 )\207" [bookmark-name-or-record alist x bookmark-get-bookmark] 3 (#$ . 9385)]) #@48 Set BOOKMARK-NAME-OR-RECORD's name to NEWNAME. (defalias 'bookmark-set-name #[(bookmark-name-or-record newname) "\302! \240\207" [bookmark-name-or-record newname bookmark-get-bookmark] 2 (#$ . 9711)]) #@70 Return the property PROP of BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-prop-get #[(bookmark-name-or-record prop) "\302 !\236A\207" [prop bookmark-name-or-record bookmark-get-bookmark-record] 3 (#$ . 9919)]) #@58 Set the property PROP of BOOKMARK-NAME-OR-RECORD to VAL. (defalias 'bookmark-prop-set #[(bookmark-name-or-record prop val) "\304 !\236\211\203 \n\241\202 \304 !BC\244)\207" [prop bookmark-name-or-record cell val bookmark-get-bookmark-record] 4 (#$ . 10151)]) #@67 Return the annotation of BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-get-annotation #[(bookmark-name-or-record) "\301\302\"\207" [bookmark-name-or-record bookmark-prop-get annotation] 3 (#$ . 10423)]) #@55 Set the annotation of BOOKMARK-NAME-OR-RECORD to ANN. (defalias 'bookmark-set-annotation #[(bookmark-name-or-record ann) "\302\303 #\207" [bookmark-name-or-record ann bookmark-prop-set annotation] 4 (#$ . 10648)]) #@70 Return the full filename of BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-get-filename #[(bookmark-name-or-record) "\301\302\"\207" [bookmark-name-or-record bookmark-prop-get filename] 3 (#$ . 10869)]) #@63 Set the full filename of BOOKMARK-NAME-OR-RECORD to FILENAME. (defalias 'bookmark-set-filename #[(bookmark-name-or-record filename) "\302\301 #\207" [bookmark-name-or-record filename bookmark-prop-set] 4 (#$ . 11093)]) #@79 Return the position (i.e.: point) of BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-get-position #[(bookmark-name-or-record) "\301\302\"\207" [bookmark-name-or-record bookmark-prop-get position] 3 (#$ . 11319)]) #@72 Set the position (i.e.: point) of BOOKMARK-NAME-OR-RECORD to POSITION. (defalias 'bookmark-set-position #[(bookmark-name-or-record position) "\302\301 #\207" [bookmark-name-or-record position bookmark-prop-set] 4 (#$ . 11552)]) #@77 Return the front-context-string of BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-get-front-context-string #[(bookmark-name-or-record) "\301\302\"\207" [bookmark-name-or-record bookmark-prop-get front-context-string] 3 (#$ . 11787)]) #@68 Set the front-context-string of BOOKMARK-NAME-OR-RECORD to STRING. (defalias 'bookmark-set-front-context-string #[(bookmark-name-or-record string) "\302\303 #\207" [bookmark-name-or-record string bookmark-prop-set front-context-string] 4 (#$ . 12042)]) #@76 Return the rear-context-string of BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-get-rear-context-string #[(bookmark-name-or-record) "\301\302\"\207" [bookmark-name-or-record bookmark-prop-get rear-context-string] 3 (#$ . 12302)]) #@67 Set the rear-context-string of BOOKMARK-NAME-OR-RECORD to STRING. (defalias 'bookmark-set-rear-context-string #[(bookmark-name-or-record string) "\302\303 #\207" [bookmark-name-or-record string bookmark-prop-set rear-context-string] 4 (#$ . 12554)]) #@74 Return the handler function for BOOKMARK-NAME-OR-RECORD, or nil if none. (defalias 'bookmark-get-handler #[(bookmark-name-or-record) "\301\302\"\207" [bookmark-name-or-record bookmark-prop-get handler] 3 (#$ . 12811)]) #@42 The history list for bookmark functions. (defvar bookmark-history nil (#$ . 13037)) #@255 Prompting with PROMPT, read a bookmark name in completion. PROMPT will get a ": " stuck on the end no matter what, so you probably don't want to include one yourself. Optional second arg DEFAULT is a string to return if the user enters the empty string. (defalias 'bookmark-completing-read #[(prompt &optional default) "\306 \210<\203 \307\310 \n\203 \311\312 \313\"\202 \312 #\207 \203+ \314\315 \"\202, \316P\317 \320\321\322\321\323&\211\324\230\203C \202E ,\207" [last-nonmenu-event prompt bookmark-sort-flag bookmark-completion-ignore-case completion-ignore-case default bookmark-maybe-load-default-file bookmark-menu-popup-paned-menu t sort bookmark-all-names string-lessp format " (%s): " ": " completing-read #[(string pred action) "\304=\203 \305\207\306 \n$\207" [action bookmark-alist string pred metadata (metadata (category . bookmark)) complete-with-action] 5] nil 0 bookmark-history "" str] 8 (#$ . 13128)]) #@215 Put STRING into the bookmark prompt history, if caller non-interactive. We need this because sometimes bookmark functions are invoked from menus, so `completing-read' never gets a chance to set `bookmark-history'. (defalias 'bookmark-maybe-historicize-string '(macro . #[(string) "\301\302\303\304\305\306BBEE\207" [string or (called-interactively-p 'interactive) setq bookmark-history cons (bookmark-history)] 7 (#$ . 14078)])) #@920 A function that should be called to create a bookmark record. Modes may set this variable buffer-locally to enable bookmarking of locations that should be treated specially, such as Info nodes, news posts, images, pdf documents, etc. The function will be called with no arguments. It should signal a user error if it is unable to construct a record for the current location. The returned record should be a cons cell of the form (NAME . ALIST) where ALIST is as described in `bookmark-alist' and may typically contain a special cons (handler . HANDLER-FUNC) which specifies the handler function that should be used instead of `bookmark-default-handler' to open this bookmark. See the documentation for `bookmark-alist' for more. NAME is a suggested name for the constructed bookmark. It can be nil in which case a default heuristic will be used. The function can also equivalently just return ALIST without NAME. (defvar bookmark-make-record-function 'bookmark-make-record-default (#$ . 14515)) #@71 Return a new bookmark record (NAME . ALIST) for the current location. (defalias 'bookmark-make-record #[nil " \303 \304\305\306\307\310\311 \304\"\n\312 D\"!\"#\210 @;\203! \2024 @\203* \306 B \n\2061 \312 \240\210 )\207" [bookmark-make-record-function record bookmark-current-bookmark bookmark-prop-set defaults delq nil delete-dups append bookmark-prop-get bookmark-buffer-name] 10 (#$ . 15522)]) #@202 Store the bookmark NAME with data ALIST. If NO-OVERWRITE is non-nil and another bookmark of the same name already exists in `bookmark-alist', record the new bookmark without throwing away the old one. (defalias 'bookmark-store #[(name alist no-overwrite) "\306 \210\307!\310\311 G\312 $\210\n\204# \313 \314\"\203# \313 !\241\210\202) B\fB T\315 \2038 \316 \210 \317 )\207" [name stripped-name no-overwrite alist bookmark-alist bookmark-current-bookmark bookmark-maybe-load-default-file copy-sequence set-text-properties 0 nil bookmark-get-bookmark noerror bookmark-time-to-save-p bookmark-save bookmark-bmenu-surreptitiously-rebuild-list bookmark-alist-modification-count] 5 (#$ . 15933)]) #@604 Return the record describing the location of a new bookmark. Point should be at the buffer in which the bookmark is being set, and normally should be at the position where the bookmark is desired, but see the optional arguments for other possibilities. If NO-FILE is non-nil, then only return the subset of the record that pertains to the location within the buffer, leaving off the part that records the filename. If NO-CONTEXT is non-nil, do not include the front- and rear-context strings in the record -- the position is enough. If POSN is non-nil, record POSN as the point instead of `(point)'. (defalias 'bookmark-make-record-default #[(&optional no-file no-context posn) "\304?\205 \305\306 BC ?\205! \307d`Z\nY\205 \310``\n\\\"BC ?\2057 \311`eZ\nY\2055 \310``\nZ\"BC\312\206= `BC$\207" [no-file no-context bookmark-search-size posn append filename bookmark-buffer-file-name front-context-string buffer-substring-no-properties rear-context-string position] 8 (#$ . 16643)]) #@97 The current version of the format used by bookmark files. You should never need to change this. (defconst bookmark-file-format-version 1 (#$ . 17637)) #@68 This string marks the end of the version stamp in a bookmark file. (defconst bookmark-end-of-version-stamp-marker "-*- End Of Bookmark File Format Version Stamp -*-\n" (#$ . 17794)) #@211 Return a `bookmark-alist' (in any format) from the current buffer. The buffer must of course contain bookmark format information. Does not care from where in the buffer it is called, and does not affect point. (defalias 'bookmark-alist-from-buffer #[nil "\212eb\210\301\302\303#\203 \304p!\202&