%PDF- %PDF-
Direktori : /usr/local/share/emacs/27.2/lisp/ |
Current File : //usr/local/share/emacs/27.2/lisp/bookmark.elc |
;ELC ;;; Compiled ;;; in Emacs version 27.2 ;;; 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\300\302!\210\303\304\305\306\307\310%\210\311\312\313\314\315DD\316\317\320%\210\311\321\313\314\322DD\323\317\324%\210\325\326\327\305#\210\330\211\203P \211@\326N\203I \327N\204I \331\327\326N#\210A\266\202\202/ \210\332\326\327\333#\210\325\334\327\305#\210\330\211\203 \211@\334N\203x \327N\204x \331\327\334N#\210A\266\202\202^ \210\332\334\327\333#\210\311\327\313\314\335DD\336\317\337%\210\311\340\313\314\341DD\342\343\333\317\320\307\304& \210\311\344\313\314\345DD\346\317\347%\210\311\350\313\314\351DD\352\317\320%\210\311\353\313\314\354DD\355\317\320%\210\311\356\313\314\357DD\360\317\320%\207" [require pp text-property-search custom-declare-group bookmark nil "Setting, annotation and jumping to bookmarks." :group matching custom-declare-variable bookmark-use-annotations funcall function #[0 "\300\207" [nil] 1] "If non-nil, setting a bookmark queries for an annotation in a buffer." :type boolean bookmark-save-flag #[0 "\300\207" [t] 1] "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'." (choice (const nil) integer (other t)) defvaralias bookmark-old-default-file bookmark-default-file (saved-value saved-variable-comment) put make-obsolete-variable "27.1" bookmark-file #[0 "\300\301\302\"\207" [locate-user-emacs-file "bookmarks" ".emacs.bmk"] 3] "File in which to save bookmarks by default." file bookmark-watch-bookmark-file #[0 "\300\207" [t] 1] "If non-nil watch the default bookmark file.\nIf this file has changed on disk since it was last loaded, query the user\nwhether to load it again. If the value is `silent' reload without querying.\nThis file defaults to `bookmark-default-file'. But during an Emacs session,\n`bookmark-load' and `bookmark-save' can redefine the current default file." :version bookmark-version-control #[0 "\300\207" [nospecial] 1] "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 #[0 "\300\207" [t] 1] "Non-nil means bookmark functions ignore case in completion." bookmark-sort-flag #[0 "\300\207" [t] 1] "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 #[0 "\300\207" [t] 1] "Non-nil means show annotations when jumping to a bookmark."] 10) #@40 Name of buffer used for Bookmark List. (defconst bookmark-bmenu-buffer "*Bookmark List*" (#$ . 3878)) (byte-code "\300\301\302\303\304DD\305\306\307\310\311&\207" [custom-declare-variable bookmark-bmenu-use-header-line funcall function #[0 "\300\207" [t] 1] "Non-nil means to use an immovable header line.\nThis is as opposed to inline text at the top of the buffer." :version "24.4" :type boolean] 8) #@127 Number of lines used for the *Bookmark List* header. (This is only significant when `bookmark-bmenu-use-header-line' is nil.) (defconst bookmark-bmenu-inline-header-height 2 (#$ . 4288)) #@108 Number of columns (chars) used for the *Bookmark List* marks column. This includes the annotations column. (defconst bookmark-bmenu-marks-width 2 (#$ . 4482)) (byte-code "\300\301\302\303\304DD\305\306\307%\210\300\310\302\303\311DD\312\306\313%\210\314\315\316\317#\210\300\320\302\303\321DD\322\306\307%\210\300\323\302\303\324DD\325\306\326%\210\314\327\330\331\332\333%\207" [custom-declare-variable bookmark-bmenu-file-column funcall function #[0 "\300\207" [30] 1] "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 bookmark-bmenu-toggle-filenames #[0 "\300\207" [t] 1] "Non-nil means show filenames when listing bookmarks.\nA non-nil value may result in truncated bookmark names." boolean custom-declare-face bookmark-menu-bookmark ((t (:weight bold))) "Face used to highlight bookmark names in bookmark menu buffers." bookmark-menu-length #[0 "\300\207" [70] 1] "Maximum length of a bookmark name displayed on a popup menu." bookmark-search-delay #[0 "\300\207" [0.2] 1] "Time before `bookmark-bmenu-search' updates the display." number bookmark-menu-heading ((t (:inherit font-lock-type-face))) "Face used to highlight the heading in bookmark menu buffers." :version "22.1"] 6) #@288 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 variable `bookmark-map'. All interactive bookmark functions have a binding in this keymap. (defvar bookmark-map (byte-code "\300 \301\302\303#\210\301\304\303#\210\301\305\306#\210\301\307\310#\210\301\311\310#\210\301\312\313#\210\301\314\315#\210\301\316\317#\210\301\320\321#\210\301\322\323#\210\301\324\325#\210\301\326\327#\210\301\330\331#\210\301\332\333#\210\301\334\335#\210\211\207" [make-sparse-keymap define-key "x" bookmark-set "m" "M" bookmark-set-no-overwrite "j" bookmark-jump "g" "o" bookmark-jump-other-window "5" bookmark-jump-other-frame "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] 5) (#$ . 5818)) #@1618 Association list of bookmark names and their parameters. Bookmark functions update the value automatically. You probably do NOT want to change the value yourself. The value is an alist with bookmarks 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 default entries are described below. An entry with a key but null value means the entry is not used. (filename . FILENAME) (buf . BUFFER-OR-NAME) (position . POS) (front-context-string . STR-AFTER-POS) (rear-context-string . STR-BEFORE-POS) (handler . HANDLER) (annotation . ANNOTATION) FILENAME names the bookmarked file. BUFFER-OR-NAME is a buffer or the name of a buffer that is used if FILENAME is not defined or it refers to a non-existent file. POS is the bookmarked buffer position. 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 instead of the default `bookmark-default-handler'. This is the case for Info bookmarks, for instance. HANDLER must accept a bookmark as its single argument. A function `bookmark-make-record-function' may define additional entries in PARAM-LIST that can be used by HANDLER. (defvar bookmark-alist nil (#$ . 6776)) (byte-code "\300\301\302\303#\210\304\211\203( \211@\301N\203! \302N\204! \305\302\301N#\210A\266\202\202 \210\306\301\302\307#\207" [defvaralias bookmarks-already-loaded bookmark-bookmarks-timestamp nil (saved-value saved-variable-comment) put make-obsolete-variable "27.1"] 7) #@194 Timestamp of current default bookmark file. The value is actually (FILE . MODTIME), where FILE is a bookmark file that defaults to `bookmark-default-file' and MODTIME is its modification time. (defvar bookmark-bookmarks-timestamp nil (#$ . 8725)) #@62 The coding-system of the last loaded or saved bookmark file. (defvar bookmark-file-coding-system nil (#$ . 8978)) #@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 (#$ . 9099)) (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 (#$ . 9351)) #@70 Length of the context strings recorded on either side of a bookmark. (defvar bookmark-search-size 16 (#$ . 9480)) #@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 (#$ . 9601)) #@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 (#$ . 9868)) #@58 Non-nil means `bookmark-bmenu-search' quits immediately. (defvar bookmark-quit-flag nil (#$ . 10033)) (make-obsolete-variable 'bookmark-quit-flag "no longer used" "27.1") #@84 Run BODY while preserving the buffer's `buffer-modified-p' state. (fn &rest BODY) (defalias 'with-buffer-modified-unmodified '(macro . #[128 "\300\301!\302\303BC\304\305B\306DEE\207" [make-symbol "was-modified" let ((buffer-modified-p)) unwind-protect progn set-buffer-modified-p] 8 (#$ . 10210)])) #@120 Return the name of BOOKMARK-RECORD. BOOKMARK-RECORD is, e.g., one element from `bookmark-alist'. (fn BOOKMARK-RECORD) (defalias 'bookmark-name-from-full-record #[257 "\211@\207" [] 2 (#$ . 10520)]) #@46 Return a list of all current bookmark names. (defalias 'bookmark-all-names #[0 "\301 \210\302\303\"\207" [bookmark-alist bookmark-maybe-load-default-file mapcar bookmark-name-from-full-record] 3 (#$ . 10725)]) #@422 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. If optional argument NOERROR is non-nil, return nil instead of signaling an error. Else if BOOKMARK-NAME-OR-RECORD is already a bookmark record, just return it. (fn BOOKMARK-NAME-OR-RECORD &optional NOERROR) (defalias 'bookmark-get-bookmark #[513 ":\203 \207;\205 \302 #\206 \211?\205 \303\304\"\207" [bookmark-alist bookmark-completion-ignore-case assoc-string error "Invalid bookmark %s"] 6 (#$ . 10943)]) #@158 Return the record portion of BOOKMARK-NAME-OR-RECORD in `bookmark-alist'. In other words, return all information but the name. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-bookmark-record #[257 "\300!A\211A\204 \211@@:\203 \211@\202 \211\207" [bookmark-get-bookmark] 3 (#$ . 11581)]) #@86 Set BOOKMARK-NAME-OR-RECORD's name to NEWNAME. (fn BOOKMARK-NAME-OR-RECORD NEWNAME) (defalias 'bookmark-set-name #[514 "\300!\240\207" [bookmark-get-bookmark] 4 (#$ . 11884)]) #@105 Return the property PROP of BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD PROP) (defalias 'bookmark-prop-get #[514 "\211\300!\236A\207" [bookmark-get-bookmark-record] 5 (#$ . 12070)]) #@97 Set the property PROP of BOOKMARK-NAME-OR-RECORD to VAL. (fn BOOKMARK-NAME-OR-RECORD PROP VAL) (defalias 'bookmark-prop-set #[771 "\300!\236\211\203 \211\241\202 \300!BC\244\207" [bookmark-get-bookmark-record] 7 (#$ . 12285)]) #@97 Return the annotation of BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-annotation #[257 "\300\301\"\207" [bookmark-prop-get annotation] 4 (#$ . 12527)]) #@89 Set the annotation of BOOKMARK-NAME-OR-RECORD to ANN. (fn BOOKMARK-NAME-OR-RECORD ANN) (defalias 'bookmark-set-annotation #[514 "\300\301#\207" [bookmark-prop-set annotation] 6 (#$ . 12736)]) #@100 Return the full filename of BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-filename #[257 "\300\301\"\207" [bookmark-prop-get filename] 4 (#$ . 12938)]) #@102 Set the full filename of BOOKMARK-NAME-OR-RECORD to FILENAME. (fn BOOKMARK-NAME-OR-RECORD FILENAME) (defalias 'bookmark-set-filename #[514 "\300\301#\207" [bookmark-prop-set filename] 6 (#$ . 13147)]) #@109 Return the position (i.e.: point) of BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-position #[257 "\300\301\"\207" [bookmark-prop-get position] 4 (#$ . 13358)]) #@111 Set the position (i.e.: point) of BOOKMARK-NAME-OR-RECORD to POSITION. (fn BOOKMARK-NAME-OR-RECORD POSITION) (defalias 'bookmark-set-position #[514 "\300\301#\207" [bookmark-prop-set position] 6 (#$ . 13576)]) #@107 Return the front-context-string of BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-front-context-string #[257 "\300\301\"\207" [bookmark-prop-get front-context-string] 4 (#$ . 13796)]) #@105 Set the front-context-string of BOOKMARK-NAME-OR-RECORD to STRING. (fn BOOKMARK-NAME-OR-RECORD STRING) (defalias 'bookmark-set-front-context-string #[514 "\300\301#\207" [bookmark-prop-set front-context-string] 6 (#$ . 14036)]) #@106 Return the rear-context-string of BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-rear-context-string #[257 "\300\301\"\207" [bookmark-prop-get rear-context-string] 4 (#$ . 14274)]) #@104 Set the rear-context-string of BOOKMARK-NAME-OR-RECORD to STRING. (fn BOOKMARK-NAME-OR-RECORD STRING) (defalias 'bookmark-set-rear-context-string #[514 "\300\301#\207" [bookmark-prop-set rear-context-string] 6 (#$ . 14511)]) #@104 Return the handler function for BOOKMARK-NAME-OR-RECORD, or nil if none. (fn BOOKMARK-NAME-OR-RECORD) (defalias 'bookmark-get-handler #[257 "\300\301\"\207" [bookmark-prop-get handler] 4 (#$ . 14746)]) #@42 The history list for bookmark functions. (defvar bookmark-history nil (#$ . 14956)) #@330 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 arg DEFAULT is a string to return if the user input is empty. If DEFAULT is nil then return empty string for empty input. (fn PROMPT &optional DEFAULT) (defalias 'bookmark-completing-read #[513 "\304 \210<\203 \305\306 \203 \307\310 \311\"\202 \310 #\207\n\211\312\232?\205% \211\2031 \313\314\"\2022 \315P\316\317\320\321\320\322&)\207" [last-nonmenu-event bookmark-sort-flag bookmark-completion-ignore-case completion-ignore-case bookmark-maybe-load-default-file bookmark-menu-popup-paned-menu t sort bookmark-all-names string-lessp "" format " (%s): " ": " completing-read #[771 "\211\301=\203 \302\207\303$\207" [bookmark-alist metadata (metadata (category . bookmark)) complete-with-action] 8 "\n\n(fn STRING PRED ACTION)"] nil 0 bookmark-history] 12 (#$ . 15047)]) #@228 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'. (fn STRING) (defalias 'bookmark-maybe-historicize-string '(macro . #[257 "\300\301\302\303\304\305BBEE\207" [or (called-interactively-p 'interactive) setq bookmark-history cons (bookmark-history)] 8 (#$ . 16020)])) #@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 (#$ . 16458)) #@71 Return a new bookmark record (NAME . ALIST) for the current location. (defalias 'bookmark-make-record #[0 " \211@;\204 \211@\203 \302B\262\211 \206 \303 \240\210\304\305\306\302\307\310\311\305\" @\303 E\"!\"#\210\211\207" [bookmark-make-record-function bookmark-current-bookmark nil bookmark-buffer-name bookmark-prop-set defaults delq delete-dups append bookmark-prop-get] 12 (#$ . 17465)]) #@232 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. (fn NAME ALIST NO-OVERWRITE) (defalias 'bookmark-store #[771 "\303 \210\304!\305\306G\307$\210\204\"