Function: kvspec:update

kvspec:update is a byte-compiled function defined in kvspec.el.

Signature

(kvspec:update VIEW-SPEC)

Documentation

Update current view spec according to VIEW-SPEC but don't change the view.

VIEW-SPEC is a string or t, which means recompute the current view spec. A nil value of VIEW-SPEC updates the modeline viewspec display to be current but does not recompute the viewspec itself. See
${hyperb:dir}/kotl/EXAMPLE.kotl#3b19c=042 for details on valid view specs.

Source Code

;; Defined in ~/.emacs.d/elpa/hyperbole-20260414.325/kotl/kvspec.el
(defun kvspec:update (view-spec)
  "Update current view spec according to VIEW-SPEC but don't change the view.
VIEW-SPEC is a string or t, which means recompute the current view
spec.  A nil value of VIEW-SPEC updates the modeline viewspec display
to be current but does not recompute the viewspec itself.  See
${hyperb:dir}/kotl/EXAMPLE.kotl#3b19c=042 for details on valid view specs."
  (cond ((stringp view-spec)
	 ;; Use given view-spec after removing extraneous characters.
	 (setq view-spec
	       (replace-regexp-in-string
		"[^.*~0-9abcdefgilnrsv]+" "" view-spec nil t))
	 (unless (string-match "e" view-spec)
	   ;; Force 'e' elide view spec if not there.
	   (setq view-spec
		 (if (string-match "\\([abcd]+\\)" view-spec)
		     (replace-match "\\1e" t nil view-spec)
		   (concat "e" view-spec))))
	 (setq kvspec:current view-spec))
	((or (eq view-spec t) (null kvspec:current))
	 (setq kvspec:current (kvspec:compute))))
  ;; Update display using current specs.
  (kvspec:update-modeline))