mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-11-30 08:09:04 +00:00
959 lines
40 KiB
EmacsLisp
959 lines
40 KiB
EmacsLisp
;;; cus-start.el --- define customization properties of builtins -*- lexical-binding:t -*-
|
||
|
||
;; Copyright (C) 1997, 1999-2023 Free Software Foundation, Inc.
|
||
|
||
;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
|
||
;; Keywords: internal
|
||
;; Package: emacs
|
||
|
||
;; This file is part of GNU Emacs.
|
||
|
||
;; GNU Emacs is free software: you can redistribute it and/or modify
|
||
;; it under the terms of the GNU General Public License as published by
|
||
;; the Free Software Foundation, either version 3 of the License, or
|
||
;; (at your option) any later version.
|
||
|
||
;; GNU Emacs is distributed in the hope that it will be useful,
|
||
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;; GNU General Public License for more details.
|
||
|
||
;; You should have received a copy of the GNU General Public License
|
||
;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|
||
|
||
;;; Commentary:
|
||
|
||
;; This file adds customize support for built-in variables.
|
||
|
||
;; While dumping Emacs, this file is loaded, but it only records
|
||
;; the standard values; it does not do the rest of the job.
|
||
;; Later on, if the user makes a customization buffer,
|
||
;; this file is loaded again with (require 'cus-start);
|
||
;; then it does the whole job.
|
||
|
||
;;; Code:
|
||
|
||
(defun minibuffer-prompt-properties--setter (symbol value)
|
||
(set-default symbol value)
|
||
(if (memq 'cursor-intangible value)
|
||
(add-hook 'minibuffer-setup-hook #'cursor-intangible-mode)
|
||
;; Removing it is a bit trickier since it could have been added by someone
|
||
;; else as well, so let's just not bother.
|
||
))
|
||
|
||
;; Elements of this list have the form:
|
||
;; SYMBOL GROUP TYPE VERSION REST...
|
||
;; SYMBOL is the name of the variable.
|
||
;; GROUP is the custom group to which it belongs (may also be a list
|
||
;; of groups)
|
||
;; TYPE is the defcustom :type.
|
||
;; VERSION is the defcustom :version (or nil).
|
||
;; REST is a set of :KEYWORD VALUE pairs. Accepted :KEYWORDs are:
|
||
;; :standard - standard value for SYMBOL (else use current value)
|
||
;; :set - custom-set property
|
||
;; :risky - risky-local-variable property
|
||
;; :safe - safe-local-variable property
|
||
;; :tag - custom-tag property
|
||
(let (standard
|
||
native-p prop propval
|
||
;; This function turns a value
|
||
;; into an expression which produces that value.
|
||
(quoter (lambda (sexp)
|
||
;; FIXME: We'd like to use macroexp-quote here, but cus-start
|
||
;; is loaded too early in loadup.el for that.
|
||
(if (or (memq sexp '(t nil))
|
||
(keywordp sexp)
|
||
(and (listp sexp)
|
||
(memq (car sexp) '(lambda)))
|
||
(stringp sexp)
|
||
(numberp sexp))
|
||
sexp
|
||
(list 'quote sexp))))
|
||
(cursor-type-types
|
||
'(choice
|
||
(const :tag "Frame default" t)
|
||
(const :tag "Filled box" box)
|
||
(cons :tag "Box with specified size"
|
||
(const box) integer)
|
||
(const :tag "Hollow cursor" hollow)
|
||
(const :tag "Vertical bar" bar)
|
||
(cons :tag "Vertical bar with specified height"
|
||
(const bar) integer)
|
||
(const :tag "Horizontal bar" hbar)
|
||
(cons :tag "Horizontal bar with specified width"
|
||
(const hbar) integer)
|
||
(const :tag "None "nil))))
|
||
(pcase-dolist
|
||
(`(,symbol ,group ,type ,version . ,rest)
|
||
`(;; alloc.c
|
||
(gc-cons-threshold alloc integer)
|
||
(gc-cons-percentage alloc float)
|
||
(garbage-collection-messages alloc boolean)
|
||
;; buffer.c
|
||
(cursor-type display ,cursor-type-types)
|
||
(mode-line-format mode-line sexp) ;Hard to do right.
|
||
(major-mode internal function)
|
||
(case-fold-search matching boolean)
|
||
(fill-column fill integer)
|
||
(left-margin fill integer)
|
||
(tab-width editing-basics integer)
|
||
(ctl-arrow display boolean)
|
||
(truncate-lines display boolean)
|
||
(word-wrap display boolean)
|
||
(word-wrap-by-category
|
||
display boolean "28.1"
|
||
:set (lambda (symbol value)
|
||
(set-default symbol value)
|
||
(when value (require 'kinsoku))))
|
||
(selective-display-ellipses display boolean)
|
||
(indicate-empty-lines fringe boolean)
|
||
(indicate-buffer-boundaries
|
||
fringe
|
||
(choice
|
||
(const :tag "No indicators" nil)
|
||
(const :tag "On left, with arrows" left)
|
||
(const :tag "On right, with arrows" right)
|
||
(set :tag "Pick your own design"
|
||
:value ((t . nil))
|
||
:format "%{%t%}:\n%v\n%d"
|
||
:doc "You can specify a default and then override it \
|
||
for individual indicators.
|
||
Leaving \"Default\" unchecked is equivalent with specifying a default of
|
||
\"Do not show\"."
|
||
(choice :tag "Default"
|
||
:value (t . nil)
|
||
(const :tag "Do not show" (t . nil))
|
||
(const :tag "On the left" (t . left))
|
||
(const :tag "On the right" (t . right)))
|
||
(choice :tag "Top"
|
||
:value (top . left)
|
||
(const :tag "Do not show" (top . nil))
|
||
(const :tag "On the left" (top . left))
|
||
(const :tag "On the right" (top . right)))
|
||
(choice :tag "Bottom"
|
||
:value (bottom . left)
|
||
(const :tag "Do not show" (bottom . nil))
|
||
(const :tag "On the left" (bottom . left))
|
||
(const :tag "On the right" (bottom . right)))
|
||
(choice :tag "Up arrow"
|
||
:value (up . left)
|
||
(const :tag "Do not show" (up . nil))
|
||
(const :tag "On the left" (up . left))
|
||
(const :tag "On the right" (up . right)))
|
||
(choice :tag "Down arrow"
|
||
:value (down . left)
|
||
(const :tag "Do not show" (down . nil))
|
||
(const :tag "On the left" (down . left))
|
||
(const :tag "On the right" (down . right))))
|
||
(other :tag "On left, no arrows" t)))
|
||
(scroll-up-aggressively windows
|
||
(choice (const :tag "off" nil) float)
|
||
"21.1")
|
||
(scroll-down-aggressively windows
|
||
(choice (const :tag "off" nil) float)
|
||
"21.1")
|
||
(line-spacing display (choice (const :tag "none" nil) number)
|
||
"22.1")
|
||
(cursor-in-non-selected-windows
|
||
cursor ,cursor-type-types nil
|
||
:tag "Cursor In Non-selected Windows"
|
||
:set (lambda (symbol value)
|
||
(set-default symbol value)
|
||
(force-mode-line-update t)))
|
||
(transient-mark-mode editing-basics boolean nil
|
||
:standard (not noninteractive)
|
||
:initialize custom-initialize-delay
|
||
:set custom-set-minor-mode)
|
||
(bidi-paragraph-direction
|
||
paragraphs
|
||
(choice
|
||
(const :tag "Left to Right" left-to-right)
|
||
(const :tag "Right to Left" right-to-left)
|
||
(const :tag "Dynamic, according to paragraph text" nil))
|
||
"24.1")
|
||
(delete-auto-save-files auto-save boolean)
|
||
(kill-buffer-delete-auto-save-files auto-save boolean "28.1")
|
||
;; callint.c
|
||
(mark-even-if-inactive editing-basics boolean)
|
||
;; callproc.c
|
||
(shell-file-name execute file)
|
||
(exec-path execute
|
||
(repeat (choice (const :tag "default directory" nil)
|
||
(directory :format "%v")))
|
||
nil
|
||
:standard
|
||
(mapcar (lambda (f)
|
||
(if f (directory-file-name f)
|
||
"."))
|
||
(append (parse-colon-path (getenv "PATH"))
|
||
(list exec-directory))))
|
||
(exec-suffixes execute (repeat string))
|
||
;; charset.c
|
||
(charset-map-path installation
|
||
(repeat (directory :format "%v")))
|
||
;; coding.c
|
||
(inhibit-eol-conversion mule boolean)
|
||
(enable-character-translation mule boolean)
|
||
(eol-mnemonic-undecided mule string)
|
||
;; startup.el fiddles with the values. IMO, would be
|
||
;; simpler to just use #ifdefs in coding.c.
|
||
(eol-mnemonic-unix mule string nil
|
||
:standard
|
||
(if (memq system-type '(ms-dos windows-nt))
|
||
"(Unix)" ":"))
|
||
(eol-mnemonic-dos mule string nil
|
||
:standard
|
||
(if (memq system-type '(ms-dos windows-nt))
|
||
"\\" "(DOS)"))
|
||
(eol-mnemonic-mac mule string nil
|
||
:standard "(Mac)")
|
||
(file-coding-system-alist
|
||
mule
|
||
(alist
|
||
:key-type (regexp :tag "File regexp")
|
||
:value-type (choice
|
||
:value (undecided . undecided)
|
||
(cons :tag "Encoding/decoding pair"
|
||
:value (undecided . undecided)
|
||
(coding-system :tag "Decoding")
|
||
(coding-system :tag "Encoding"))
|
||
(coding-system
|
||
:tag "Single coding system"
|
||
:value undecided
|
||
:match (lambda (widget value)
|
||
(and value (not (functionp value)))))
|
||
(function :value ignore))))
|
||
;; dired.c
|
||
(completion-ignored-extensions dired
|
||
(repeat (string :format "%v")))
|
||
;; dispnew.c
|
||
(baud-rate display integer)
|
||
(inverse-video display boolean)
|
||
(visible-bell display boolean)
|
||
(no-redraw-on-reenter display boolean)
|
||
|
||
;; doc.c
|
||
(text-quoting-style display
|
||
(choice
|
||
(const :tag "Prefer \\=‘curved\\=’ quotes, if possible" nil)
|
||
(const :tag "\\=‘Curved\\=’ quotes" curved)
|
||
(const :tag "\\='Straight\\=' quotes" straight)
|
||
(const :tag "\\=`Grave\\=' quotes (no translation)" grave)))
|
||
|
||
;; dosfns.c
|
||
(dos-display-scancodes display boolean)
|
||
(dos-hyper-key keyboard integer)
|
||
(dos-super-key keyboard integer)
|
||
(dos-keypad-mode keyboard integer)
|
||
|
||
;; editfns.c
|
||
(user-full-name mail string)
|
||
;; emacs.c
|
||
(report-emacs-bug-address emacsbug string)
|
||
;; eval.c
|
||
(max-lisp-eval-depth limits integer)
|
||
(max-mini-window-height limits
|
||
(choice (const :tag "quarter screen" nil)
|
||
number) "23.1")
|
||
(debug-on-error debug
|
||
(choice (const :tag "off")
|
||
(repeat :menu-tag "When"
|
||
:value (nil)
|
||
(symbol :format "%v"))
|
||
(const :tag "always" t)))
|
||
(debug-ignored-errors debug (repeat (choice symbol regexp)))
|
||
(debug-on-quit debug boolean)
|
||
(debug-on-signal debug boolean)
|
||
(debugger-stack-frame-as-list debugger boolean "26.1")
|
||
;; fileio.c
|
||
(delete-by-moving-to-trash auto-save boolean "23.1")
|
||
(auto-save-visited-file-name auto-save boolean)
|
||
;; filelock.c
|
||
(create-lockfiles files boolean "24.3")
|
||
(temporary-file-directory
|
||
;; Darwin section added 24.1, does not seem worth :version bump.
|
||
files directory nil
|
||
:standard
|
||
(file-name-as-directory
|
||
;; FIXME ? Should there be Ftemporary_file_directory to do this
|
||
;; more robustly (cf set_local_socket in emacsclient.c).
|
||
;; It could be used elsewhere, eg Fcall_process_region,
|
||
;; server-socket-dir. See bug#7135.
|
||
(cond ((memq system-type '(ms-dos windows-nt))
|
||
(or (getenv "TEMP") (getenv "TMPDIR") (getenv "TMP")
|
||
"c:/temp"))
|
||
((eq system-type 'darwin)
|
||
(or (getenv "TMPDIR") (getenv "TMP") (getenv "TEMP")
|
||
;; See bug#7135.
|
||
(let* (file-name-handler-alist
|
||
(default-directory "/")
|
||
(tmp (ignore-errors
|
||
(shell-command-to-string
|
||
"getconf DARWIN_USER_TEMP_DIR"))))
|
||
(and (stringp tmp)
|
||
(setq tmp (replace-regexp-in-string
|
||
"\n\\'" "" tmp))
|
||
;; Handles "getconf: Unrecognized variable..."
|
||
(file-directory-p tmp)
|
||
tmp))
|
||
"/tmp"))
|
||
(t
|
||
(or (getenv "TMPDIR") (getenv "TMP") (getenv "TEMP")
|
||
"/tmp"))))
|
||
:initialize custom-initialize-delay)
|
||
;; fns.c
|
||
(use-dialog-box menu boolean "21.1")
|
||
(use-file-dialog menu boolean "22.1")
|
||
(use-short-answers menu boolean "28.1")
|
||
(focus-follows-mouse
|
||
frames (choice
|
||
(const :tag "Off" :value nil)
|
||
(const :tag "On" :value t)
|
||
(const :tag "Auto-raise" :value auto-raise)) "26.1")
|
||
;; fontset.c
|
||
;; FIXME nil is the initial value, fontset.el setqs it.
|
||
(vertical-centering-font-regexp display
|
||
(choice (const nil) regexp))
|
||
;; frame.c
|
||
(default-frame-alist frames
|
||
(repeat (cons :format "%v"
|
||
(symbol :tag "Parameter")
|
||
(sexp :tag "Value"))))
|
||
(mouse-highlight mouse (choice (const :tag "disabled" nil)
|
||
(const :tag "always shown" t)
|
||
(other :tag "hidden by keypress" 1))
|
||
"22.1")
|
||
(make-pointer-invisible mouse boolean "23.2")
|
||
(resize-mini-frames
|
||
frames (choice
|
||
(const :tag "Never" nil)
|
||
(const :tag "Fit mini frame to buffer" t)
|
||
(function :tag "User-defined function"))
|
||
"27.2")
|
||
(menu-bar-mode frames boolean nil
|
||
;; FIXME?
|
||
;; :initialize custom-initialize-default
|
||
:set custom-set-minor-mode)
|
||
(tab-bar-mode tab-bar boolean nil
|
||
;; :initialize custom-initialize-default
|
||
:set custom-set-minor-mode)
|
||
(tool-bar-mode (frames mouse) boolean nil
|
||
;; :initialize custom-initialize-default
|
||
:set custom-set-minor-mode)
|
||
(frame-resize-pixelwise frames boolean "24.4")
|
||
(frame-inhibit-implied-resize frames
|
||
(choice
|
||
(const :tag "Never" nil)
|
||
(const :tag "Always" t)
|
||
(repeat (symbol :tag "Parameter")))
|
||
"27.1")
|
||
(iconify-child-frame frames
|
||
(choice
|
||
(const :tag "Do nothing" nil)
|
||
(const :tag "Iconify top level frame instead" iconify-top-level)
|
||
(const :tag "Make frame invisible instead" make-invisible)
|
||
(const :tag "Iconify" t))
|
||
"26.1")
|
||
(tooltip-reuse-hidden-frame tooltip boolean "26.1")
|
||
(use-system-tooltips tooltip boolean "29.1")
|
||
;; fringe.c
|
||
(overflow-newline-into-fringe fringe boolean)
|
||
;; image.c
|
||
(imagemagick-render-type image integer "24.1")
|
||
;; indent.c
|
||
(indent-tabs-mode indent boolean)
|
||
;; keyboard.c
|
||
(meta-prefix-char keyboard character)
|
||
(auto-save-interval auto-save integer)
|
||
(auto-save-no-message auto-save boolean "27.1")
|
||
(auto-save-timeout auto-save (choice (const :tag "off" nil)
|
||
(integer :format "%v")))
|
||
(echo-keystrokes minibuffer number)
|
||
(polling-period keyboard float)
|
||
(double-click-time mouse (restricted-sexp
|
||
:match-alternatives (integerp 'nil 't)))
|
||
(double-click-fuzz mouse integer "22.1")
|
||
(help-char keyboard character)
|
||
(help-event-list keyboard (repeat (sexp :format "%v")))
|
||
(menu-prompting menu boolean)
|
||
(select-active-regions killing
|
||
(choice (const :tag "always" t)
|
||
(const :tag "only shift-selection or mouse-drag" only)
|
||
(const :tag "off" nil))
|
||
"24.1")
|
||
(debug-on-event debug
|
||
(choice (const :tag "None" nil)
|
||
(const :tag "When sent SIGUSR1" sigusr1)
|
||
(const :tag "When sent SIGUSR2" sigusr2))
|
||
"24.1")
|
||
(translate-upper-case-key-bindings keyboard boolean "29.1")
|
||
;; This is not good news because it will use the wrong
|
||
;; version-specific directories when you upgrade. We need
|
||
;; customization of the front of the list, maintaining the
|
||
;; standard value intact at the back.
|
||
;;(load-path environment
|
||
;; (repeat (choice :tag "[Current dir?]"
|
||
;; :format "%[Current dir?%] %v"
|
||
;; (const :tag " current dir" nil)
|
||
;; (directory :format "%v"))))
|
||
(load-prefer-newer lisp boolean "24.4")
|
||
(record-all-keys keyboard boolean)
|
||
;; minibuf.c
|
||
(minibuffer-follows-selected-frame
|
||
minibuffer (choice (const :tag "Always" t)
|
||
(const :tag "When used" hybrid)
|
||
(const :tag "Never" nil))
|
||
"28.1")
|
||
(enable-recursive-minibuffers minibuffer boolean)
|
||
(history-length minibuffer
|
||
(choice (const :tag "Infinite" t) integer)
|
||
"24.5") ; 30 -> 100
|
||
(history-delete-duplicates minibuffer boolean "22.1")
|
||
(read-buffer-completion-ignore-case minibuffer boolean "23.1")
|
||
|
||
(minibuffer-prompt-properties
|
||
minibuffer
|
||
(list
|
||
(checklist :inline t
|
||
(const :tag "Read-Only"
|
||
:doc "Prevent prompt from being modified"
|
||
:format "%t%n%h"
|
||
:inline t
|
||
(read-only t))
|
||
(const :tag "Don't Enter"
|
||
:doc "Prevent point from ever entering prompt"
|
||
:format "%t%n%h"
|
||
:inline t
|
||
(cursor-intangible t)))
|
||
(repeat :inline t
|
||
:tag "Other Properties"
|
||
(list :inline t
|
||
:format "%v"
|
||
(symbol :tag "Property")
|
||
(sexp :tag "Value"))))
|
||
"21.1"
|
||
:set minibuffer-prompt-properties--setter)
|
||
(minibuffer-auto-raise minibuffer boolean)
|
||
(read-minibuffer-restore-windows minibuffer boolean "28.1")
|
||
;; options property set at end
|
||
(read-buffer-function minibuffer
|
||
(choice (const nil)
|
||
function))
|
||
;; msdos.c
|
||
(dos-unsupported-char-glyph display integer)
|
||
;; nsterm.m
|
||
(ns-control-modifier
|
||
ns
|
||
(choice (const :tag "No modifier" none)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"23.1")
|
||
(ns-right-control-modifier
|
||
ns
|
||
(choice (const :tag "No modifier (work as control)" none)
|
||
(const :tag "Use the value of ns-control-modifier"
|
||
left)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"24.1")
|
||
(ns-command-modifier
|
||
ns
|
||
(choice (const :tag "No modifier (work as layout switch)" none)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"23.1")
|
||
(ns-right-command-modifier
|
||
ns
|
||
(choice (const :tag "No modifier (work as layout switch)" none)
|
||
(const :tag "Use the value of ns-command-modifier"
|
||
left)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"24.1")
|
||
(ns-alternate-modifier
|
||
ns
|
||
(choice (const :tag "No modifier (work as alternate/option)" none)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"23.1")
|
||
(ns-right-alternate-modifier
|
||
ns
|
||
(choice (const :tag "No modifier (work as alternate/option)" none)
|
||
(const :tag "Use the value of ns-alternate-modifier"
|
||
left)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"23.3")
|
||
(ns-function-modifier
|
||
ns
|
||
(choice (const :tag "No modifier (work as function)" none)
|
||
(const control) (const meta)
|
||
(const alt) (const hyper)
|
||
(const super)
|
||
(plist :key-type (choice (const :ordinary)
|
||
(const :function)
|
||
(const :mouse))
|
||
:value-type (choice (const control)
|
||
(const meta)
|
||
(const alt)
|
||
(const hyper)
|
||
(const super)
|
||
(const :tag "No modifier"
|
||
none))))
|
||
"23.1")
|
||
(ns-antialias-text ns boolean "23.1")
|
||
(ns-auto-hide-menu-bar ns boolean "24.1")
|
||
(ns-confirm-quit ns boolean "25.1")
|
||
(ns-use-native-fullscreen ns boolean "24.4")
|
||
(ns-use-fullscreen-animation ns boolean "25.1")
|
||
(ns-use-srgb-colorspace ns boolean "24.4")
|
||
(ns-scroll-event-delta-factor ns float "29.1")
|
||
;; process.c
|
||
(delete-exited-processes processes-basics boolean)
|
||
(process-error-pause-time processes-basics integer "29.1")
|
||
;; syntax.c
|
||
(parse-sexp-ignore-comments editing-basics boolean)
|
||
(words-include-escapes editing-basics boolean)
|
||
(open-paren-in-column-0-is-defun-start editing-basics boolean
|
||
"21.1")
|
||
;; term.c
|
||
(visible-cursor cursor boolean "22.1")
|
||
;; terminal.c
|
||
(ring-bell-function display
|
||
(choice
|
||
(const :tag "Default" nil)
|
||
(const :tag "Silent" ignore)
|
||
function))
|
||
;; undo.c
|
||
(undo-limit undo integer "27.1")
|
||
(undo-strong-limit undo integer "27.1")
|
||
(undo-outer-limit undo
|
||
(choice integer
|
||
(const :tag "No limit"
|
||
:format "%t\n%d"
|
||
:doc
|
||
"With this choice, \
|
||
the undo info for the current command never gets discarded.
|
||
This should only be chosen under exceptional circumstances,
|
||
since it could result in memory overflow and make Emacs crash."
|
||
nil))
|
||
"27.1")
|
||
;; window.c
|
||
(temp-buffer-show-function windows (choice (const nil) function))
|
||
(next-screen-context-lines windows integer)
|
||
(scroll-preserve-screen-position
|
||
windows (choice
|
||
(const :tag "Off" :value nil)
|
||
(const :tag "Full screen" :value t)
|
||
(other :tag "Always" 1))
|
||
"22.1")
|
||
(recenter-redisplay
|
||
windows (choice
|
||
(const :tag "Never" :value nil)
|
||
(const :tag "Only on ttys" :value tty)
|
||
(other :tag "Always" t))
|
||
"23.1")
|
||
(window-combination-resize windows boolean "24.1")
|
||
(window-combination-limit
|
||
windows (choice
|
||
(const :tag "Never" :value nil)
|
||
(const :tag "If requested via buffer display alist"
|
||
:value window-size)
|
||
(const :tag "With Temp Buffer Resize mode"
|
||
:value temp-buffer-resize)
|
||
(const :tag "For temporary buffers"
|
||
:value temp-buffer)
|
||
(const :tag "For buffer display"
|
||
:value display-buffer)
|
||
(other :tag "Always" :value t))
|
||
"26.1")
|
||
(fast-but-imprecise-scrolling scrolling boolean "25.1")
|
||
(window-resize-pixelwise windows boolean "24.4")
|
||
;; xdisp.c
|
||
;; The whitespace group is for whitespace.el.
|
||
(show-trailing-whitespace editing-basics boolean nil
|
||
:safe booleanp)
|
||
(mode-line-compact
|
||
mode-line
|
||
(choice (const :tag "Never" :value nil)
|
||
(const :tag "Only if wider than window" :value long)
|
||
(const :tag "Always" :value t))
|
||
"28.1")
|
||
(scroll-step windows integer)
|
||
(scroll-conservatively windows integer)
|
||
(scroll-margin windows integer)
|
||
(maximum-scroll-margin windows float "26.1")
|
||
(hscroll-margin windows integer "22.1")
|
||
(hscroll-step windows
|
||
(choice (const :tag "Center horizontally" nil)
|
||
number) "22.1")
|
||
(truncate-partial-width-windows
|
||
display
|
||
(choice (integer :tag "Truncate if narrower than")
|
||
(const :tag "Respect `truncate-lines'" nil)
|
||
(other :tag "Truncate if not full-width" t))
|
||
"23.1")
|
||
(make-cursor-line-fully-visible
|
||
windows
|
||
(choice
|
||
(const :tag "Make cursor always fully visible" t)
|
||
(const :tag "Allow cursor to be partially-visible" nil)
|
||
(function :tag "User-defined function")))
|
||
(mode-line-in-non-selected-windows mode-line boolean "22.1")
|
||
(line-number-display-limit display
|
||
(choice integer
|
||
(const :tag "No limit" nil)))
|
||
(line-number-display-limit-width display integer "22.1")
|
||
(highlight-nonselected-windows display boolean)
|
||
(message-log-max debug (choice (const :tag "Disable" nil)
|
||
(integer :menu-tag "lines"
|
||
:format "%v")
|
||
(other :tag "Unlimited" t))
|
||
"24.3")
|
||
(unibyte-display-via-language-environment mule boolean)
|
||
(blink-cursor-alist cursor alist "22.1")
|
||
(overline-margin display integer "22.1")
|
||
(underline-minimum-offset display integer "23.1")
|
||
(mouse-autoselect-window
|
||
display (choice
|
||
(const :tag "Off" :value nil)
|
||
(const :tag "Immediate" :value t)
|
||
(number :tag "Delay by secs" :value 0.5)) "22.1")
|
||
(tool-bar-style
|
||
frames (choice
|
||
(const :tag "Images" :value image)
|
||
(const :tag "Text" :value text)
|
||
(const :tag "Both" :value both)
|
||
(const :tag "Both-horiz" :value both-horiz)
|
||
(const :tag "Text-image-horiz" :value text-image-horiz)
|
||
(const :tag "System default" :value nil)) "24.1")
|
||
(tool-bar-max-label-size frames integer "24.1")
|
||
(tab-bar-position
|
||
tab-bar (choice
|
||
(const :tag "Tab bar above tool bar" nil)
|
||
(const :tag "Tab bar below tool bar" t))
|
||
"27.1"
|
||
:set (lambda (sym val)
|
||
(set-default sym val)
|
||
;; Redraw the bars:
|
||
(tab-bar-mode -1)
|
||
(tab-bar-mode 1)))
|
||
(auto-hscroll-mode scrolling
|
||
(choice
|
||
(const :tag "Don't scroll automatically"
|
||
:value nil)
|
||
(const :tag "Scroll the entire window"
|
||
:value t)
|
||
(const :tag "Scroll only the current line"
|
||
:value current-line))
|
||
"26.1")
|
||
(void-text-area-pointer cursor
|
||
(choice
|
||
(const :tag "Standard (text pointer)" :value nil)
|
||
(const :tag "Arrow" :value arrow)
|
||
(const :tag "Text pointer" :value text)
|
||
(const :tag "Hand" :value hand)
|
||
(const :tag "Vertical dragger" :value vdrag)
|
||
(const :tag "Horizontal dragger" :value hdrag)
|
||
(const :tag "Same as mode line" :value modeline)
|
||
(const :tag "Hourglass" :value hourglass)))
|
||
(display-hourglass cursor boolean)
|
||
(hourglass-delay cursor number)
|
||
(resize-mini-windows
|
||
windows (choice
|
||
(const :tag "Off" :value nil)
|
||
(const :tag "Fit" :value t)
|
||
(const :tag "Grow only" :value grow-only))
|
||
"25.1")
|
||
(display-raw-bytes-as-hex display boolean "26.1")
|
||
(display-line-numbers
|
||
display-line-numbers
|
||
(choice
|
||
(const :tag "Off" :value nil)
|
||
(const :tag "Absolute line numbers"
|
||
:value t)
|
||
(const :tag "Relative line numbers"
|
||
:value relative)
|
||
(const :tag "Visually relative line numbers"
|
||
:value visual))
|
||
"26.1")
|
||
(display-line-numbers-width
|
||
display-line-numbers
|
||
(choice
|
||
(const :tag "Dynamically computed"
|
||
:value nil)
|
||
(integer :menu-tag "Fixed number of columns"
|
||
:value 2
|
||
:format "%v"))
|
||
"26.1")
|
||
(display-line-numbers-current-absolute
|
||
display-line-numbers
|
||
(choice
|
||
(const :tag "Display actual number of current line"
|
||
:value t)
|
||
(const :tag "Display zero as number of current line"
|
||
:value nil))
|
||
"26.1")
|
||
(display-line-numbers-widen
|
||
display-line-numbers
|
||
(choice
|
||
(const :tag "Disregard narrowing when calculating line numbers"
|
||
:value t)
|
||
(const :tag "Count lines from beginning of narrowed region"
|
||
:value nil))
|
||
"26.1")
|
||
(display-line-numbers-major-tick
|
||
display-line-numbers
|
||
(choice
|
||
(const :tag "No line" 0)
|
||
(integer :tag "Multiples of"
|
||
:value 10))
|
||
"27.1")
|
||
(display-line-numbers-minor-tick
|
||
display-line-numbers
|
||
(choice
|
||
(const :tag "No line" 0)
|
||
(integer :tag "Multiples of"
|
||
:value 5))
|
||
"27.1")
|
||
|
||
(display-fill-column-indicator
|
||
display-fill-column-indicator
|
||
boolean
|
||
"27.1"
|
||
:safe booleanp)
|
||
(display-fill-column-indicator-column
|
||
display-fill-column-indicator
|
||
(choice
|
||
(const :tag "Use fill-column variable"
|
||
:value t)
|
||
(const :tag "Fixed column number"
|
||
:value 70
|
||
:format "%v")
|
||
integer)
|
||
"27.1"
|
||
:safe (lambda (value) (or (booleanp value) (integerp value))))
|
||
(display-fill-column-indicator-character
|
||
display-fill-column-indicator
|
||
(choice
|
||
(character :tag "Use U+2502 to indicate fill column"
|
||
:value ?│)
|
||
(character :tag "Use | to indicate fill column"
|
||
:value ?|)
|
||
(const :tag "If possible, use U+2502 to indicate fill column, otherwise use |"
|
||
:value nil)
|
||
character)
|
||
"27.1"
|
||
:safe (lambda (value) (or (characterp value) (null value))))
|
||
(composition-break-at-point display boolean "29.1")
|
||
;; xfaces.c
|
||
(scalable-fonts-allowed
|
||
display (choice (const :tag "Don't allow scalable fonts" nil)
|
||
(const :tag "Allow any scalable font" t)
|
||
(repeat regexp))
|
||
"22.1")
|
||
;; xfns.c
|
||
(x-bitmap-file-path installation
|
||
(repeat (directory :format "%v")))
|
||
(x-gtk-use-old-file-dialog menu boolean "22.1")
|
||
(x-gtk-show-hidden-files menu boolean "22.1")
|
||
(x-gtk-file-dialog-help-text menu boolean "22.1")
|
||
(x-gtk-use-system-tooltips tooltip boolean "23.3")
|
||
;; xterm.c
|
||
(x-use-underline-position-properties display boolean "22.1")
|
||
(x-underline-at-descent-line display boolean "22.1")
|
||
(x-stretch-cursor display boolean "21.1")
|
||
(scroll-bar-adjust-thumb-portion windows boolean "24.4")
|
||
(x-scroll-event-delta-factor mouse float "29.1")
|
||
(x-gtk-use-native-input keyboard boolean "29.1")
|
||
(x-dnd-disable-motif-drag dnd boolean "29.1")
|
||
(x-auto-preserve-selections x
|
||
(choice (const :tag "Always preserve selections" t)
|
||
(repeat symbol))
|
||
"29.1")
|
||
;; xselect.c
|
||
(x-select-enable-clipboard-manager killing boolean "24.1")
|
||
;; xsettings.c
|
||
(font-use-system-font font-selection boolean "23.2")
|
||
;; haikuterm.c
|
||
(haiku-debug-on-fatal-error debug boolean "29.1")
|
||
;; haikufns.c
|
||
(haiku-use-system-tooltips tooltip boolean "29.1")))
|
||
(setq ;; If we did not specify any standard value expression above,
|
||
;; use the current value as the standard value.
|
||
standard (if (setq prop (memq :standard rest))
|
||
(cadr prop)
|
||
(if (default-boundp symbol)
|
||
(funcall quoter (default-value symbol))))
|
||
;; Don't complain about missing variables which are
|
||
;; irrelevant to this platform.
|
||
native-p (save-match-data
|
||
(cond
|
||
((string-match "\\`dos-" (symbol-name symbol))
|
||
(eq system-type 'ms-dos))
|
||
((string-match "\\`w32-" (symbol-name symbol))
|
||
(eq system-type 'windows-nt))
|
||
((string-match "\\`ns-" (symbol-name symbol))
|
||
(featurep 'ns))
|
||
((string-match "\\`haiku-" (symbol-name symbol))
|
||
(featurep 'haiku))
|
||
((eq symbol 'process-error-pause-time)
|
||
(not (eq system-type 'ms-dos)))
|
||
((eq symbol 'x-gtk-use-native-input)
|
||
(and (featurep 'x)
|
||
(featurep 'gtk)))
|
||
((string-match "\\`x-.*gtk" (symbol-name symbol))
|
||
(featurep 'gtk))
|
||
((string-match "clipboard-manager" (symbol-name symbol))
|
||
(boundp 'x-select-enable-clipboard-manager))
|
||
((or (equal "scroll-bar-adjust-thumb-portion"
|
||
(symbol-name symbol))
|
||
(equal "x-scroll-event-delta-factor"
|
||
(symbol-name symbol))
|
||
(equal "x-dnd-disable-motif-drag"
|
||
(symbol-name symbol))
|
||
(equal "x-auto-preserve-selections"
|
||
(symbol-name symbol)))
|
||
(featurep 'x))
|
||
((string-match "\\`x-" (symbol-name symbol))
|
||
(fboundp 'x-create-frame))
|
||
((string-match "selection" (symbol-name symbol))
|
||
(fboundp 'x-selection-exists-p))
|
||
((string-match "fringe" (symbol-name symbol))
|
||
(boundp 'fringe-bitmaps))
|
||
((string-match "\\`imagemagick" (symbol-name symbol))
|
||
(fboundp 'imagemagick-types))
|
||
((equal "font-use-system-font" (symbol-name symbol))
|
||
(featurep 'system-font-setting))
|
||
;; Conditioned on x-create-frame, because that's
|
||
;; the condition for loadup.el to preload tool-bar.el.
|
||
((string-match "tool-bar-" (symbol-name symbol))
|
||
(fboundp 'x-create-frame))
|
||
((string-match "tab-bar-" (symbol-name symbol))
|
||
(fboundp 'x-create-frame))
|
||
((equal "vertical-centering-font-regexp"
|
||
(symbol-name symbol))
|
||
;; Any function from fontset.c will do.
|
||
(fboundp 'new-fontset))
|
||
(t t))))
|
||
(if (not (boundp symbol))
|
||
;; If variables are removed from C code, give an error here!
|
||
(and native-p
|
||
(message "Note, built-in variable `%S' not bound" symbol))
|
||
;; Save the standard value, unless we already did.
|
||
(or (get symbol 'standard-value)
|
||
(put symbol 'standard-value (list standard)))
|
||
;; We need these properties independent of whether cus-start is loaded.
|
||
(if (setq prop (memq :safe rest))
|
||
(put symbol 'safe-local-variable (cadr prop)))
|
||
(if (setq prop (memq :risky rest))
|
||
(put symbol 'risky-local-variable (cadr prop)))
|
||
(if (setq prop (memq :set rest))
|
||
(put symbol 'custom-set (cadr prop)))
|
||
;; This is used by describe-variable.
|
||
(if version (put symbol 'custom-version version))
|
||
;; Don't re-add to custom-delayed-init-variables post-startup.
|
||
(unless after-init-time
|
||
;; Note this is the _only_ initialize property we handle.
|
||
(if (eq (cadr (memq :initialize rest)) #'custom-initialize-delay)
|
||
;; These vars are defined early and should hence be initialized
|
||
;; early, even if this file happens to be loaded late. so add them
|
||
;; to the end of custom-delayed-init-variables. Otherwise,
|
||
;; auto-save-file-name-transforms will appear in customize-rogue.
|
||
(add-to-list 'custom-delayed-init-variables symbol 'append)))
|
||
;; If this is NOT while dumping Emacs, set up the rest of the
|
||
;; customization info. This is the stuff that is not needed
|
||
;; until someone does M-x customize etc.
|
||
(unless dump-mode
|
||
;; Add it to the right group(s).
|
||
(if (listp group)
|
||
(dolist (g group)
|
||
(custom-add-to-group g symbol 'custom-variable))
|
||
(custom-add-to-group group symbol 'custom-variable))
|
||
;; Set the type.
|
||
(put symbol 'custom-type type)
|
||
(while rest
|
||
(setq prop (car rest)
|
||
propval (cadr rest)
|
||
rest (nthcdr 2 rest))
|
||
(cond ((memq prop '(:standard :risky :safe :set))) ; handled above
|
||
((eq prop :tag)
|
||
(put symbol 'custom-tag propval))))))))
|
||
|
||
(custom-add-to-group 'font-lock 'open-paren-in-column-0-is-defun-start
|
||
'custom-variable)
|
||
|
||
;; Record cus-start as loaded if we have set up all the info that we can.
|
||
;; Don't record it as loaded if we have only set up the standard values
|
||
;; and safe/risky properties.
|
||
(unless dump-mode
|
||
(provide 'cus-start))
|
||
|
||
;;; cus-start.el ends here
|