aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/customize.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* ; Add 2026 to copyright years.Sean Whitton2026-01-011-1/+1
|
* ; Fix a recent documentation changeEli Zaretskii2025-10-231-8/+16
| | | | | * doc/lispref/customize.texi (Variable Definitions): Restore description of 'custom-initialize-delay'. Fix indexing.
* (custom-initialize-after-file): New functionStefan Monnier2025-10-221-7/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Some global minor modes require initialization. Those that are preloaded currently abuse `custom-initialize-delay` for that, but it's suboptimal and doesn't help those that aren't preloaded. So introduce a new function to fill that need. While at it, make `define-globalized-minor-mode` use it automatically when useful. * lisp/custom.el (custom-initialize-after-file-load): New function. * lisp/tooltip.el (tooltip-mode): * lisp/paren.el (show-paren-mode): * lisp/rfn-eshadow.el (file-name-shadow-mode): * lisp/epa-hook.el (auto-encryption-mode): * lisp/minibuffer.el (minibuffer-regexp-mode, minibuffer-nonselected-mode): * lisp/electric.el (electric-indent-mode): Use it instead of `custom-initialize-delay` since the value does not depend on the runtime context. (electric-quote-mode): Don't use `custom-initialize-delay` since the default value is nil anyway. * lisp/emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Automatically add `:initialize` if needed. * lisp/emacs-lisp/eldoc.el (global-eldoc-mode): Remove `:initialize`, now provided automatically. * doc/lispref/customize.texi (Variable Definitions): * doc/lispref/modes.texi (Defining Minor Modes): Document and Suggest `custom-initialize-after-file-load` instead of `custom-initialize-delay`.
* ; Improve documentation of 'defcustom' typesEli Zaretskii2025-09-271-0/+6
| | | | | * doc/lispref/customize.texi (Simple Types): Document the 'buffer-predicate' type. (Bug#79496)
* ; Fix cross-references in Texinfo manualsEli Zaretskii2025-01-191-1/+1
|
* Revert "Revert "Use @xref more consistently; "See @ref" -> "@xref"""Eli Zaretskii2025-01-191-1/+1
| | | | | | | | This reverts commit 59167e2de8a93341cd235d83e034c00be32403f6. TRT to use reference in Texinfo is to place some punctuation character after a reference. This is common both to @ref and to @xref. So this is what should be done to fix the changeset, not to revert it.
* Revert "Use @xref more consistently; "See @ref" -> "@xref""Po Lu2025-01-191-1/+1
| | | | | This reverts commit e54b94c28cdf9699009e7691f7c8ffa5b2c7b741, which prevented building Emacs on a number of my machine(s).
* Use @xref more consistently; "See @ref" -> "@xref"Stefan Kangas2025-01-191-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/commands.texi (Using Interactive): * doc/lispref/customize.texi (Type Keywords): * doc/lispref/edebug.texi (Using Edebug, Specification List): * doc/lispref/frames.texi (Frame Layout): * doc/lispref/functions.texi (What Is a Function, Related Topics): * doc/lispref/keymaps.texi (Controlling Active Maps, Key Lookup): * doc/lispref/minibuf.texi (Completion Variables): * doc/lispref/os.texi (Terminal Input): * doc/lispref/text.texi (JSONRPC Overview): * doc/misc/calc.texi (More About Embedded Mode, Customizing Calc): * doc/misc/cc-mode.texi (Movement Commands, Auto-newlines) (Config Basics, Custom Auto-newlines): * doc/misc/gnus.texi (Email Based Diary): * doc/misc/htmlfontify.texi (Interactive, Non-interactive): (Variables): * doc/misc/idlwave.texi (Using the Shell): * doc/misc/srecode.texi (Quick Start, User Templates) (Parts of SRecode, Compound Variable Values, Template Macros): * doc/misc/tramp.texi (Inline methods, FUSE-based methods) (Predefined connection information, Remote shell setup) (Frequently Asked Questions): * doc/misc/transient.texi (Configuration, Technical Introduction): (Binding Suffix and Infix Commands, Transient State): (Prefix Slots, Predicate Slots): * doc/misc/wisent.texi (Example, Compiling a grammar, Conflicts): (Grammar Debugging, Error recovery):
* Lisp Reference Manual: Index standard symbol properties.Stephen Gildea2025-01-121-0/+4
| | | | | | | | | | | | | | * doc/lispref/symbols.texi (Standard Properties): * doc/lispref/commands.texi: * doc/lispref/customize.texi (Variable Definitions): * doc/lispref/help.texi: * doc/lispref/keymaps.texi: * doc/lispref/minibuf.texi (Minibuffer History): * doc/lispref/modes.texi (Setting Hooks): * doc/lispref/sequences.texi (Char-Tables): * doc/lispref/text.texi (Undo): * doc/lispref/variables.texi: Each standard symbol property has exactly one index entry, uniformly formatted as "(symbol property)".
* Emphasize the use of :tag for new customization typesMauro Aranda2025-01-121-5/+13
| | | | | | | * doc/lispref/customize.texi (Type Keywords): Name important use cases of the :tag keyword. (Defining New Types): Emphasize the use of the :tag keyword when using the lazy widget. (Bug#74409)
* Update copyright year to 2025Paul Eggert2025-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright".
* New value 'permanent-only' for defcustom :local keywordStefan Kangas2024-10-021-1/+4
| | | | | | | | | | | | * lisp/custom.el (custom-declare-variable): Make the :local keyword accept the symbol 'permanent-local', meaning that the variable is permanent but not marked as automatically buffer-local. (defcustom): * doc/lispref/customize.texi (Variable Definitions): Document the above change. * test/lisp/custom-tests.el (custom-tests-defcustom-:local-keyword): New test.
* ; Add 2024 to copyright yearsPo Lu2024-01-021-1/+1
|
* Fix typo and inaccuracy in the ELisp Reference manualShynur2023-04-181-3/+4
| | | | | | | | | * doc/lispref/loading.texi (Dynamic Modules): Fix a typo. * doc/lispref/customize.texi (Group Definitions): Faces are also in the 'custom-group' property of a customization group. (Bug#62887) Copyright-paperwork-exempt: yes
* Improve documentation of 'defcustom's :set keywordEli Zaretskii2023-03-301-1/+8
| | | | | | * lisp/custom.el (defcustom): * doc/lispref/customize.texi (Variable Definitions): Improve the documentation of the :set keyword in 'defcustom'.
* ; Add 2023 to copyright years.Eli Zaretskii2023-01-011-1/+1
|
* Tag themes with propertiesPhilip Kaludercic2022-10-151-2/+22
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/custom.texi (Custom Themes): Document 'theme-choose-variant'. * doc/lispref/customize.texi (Custom Themes): Document the new optional argument to 'deftheme'. (Autoload): Mention that 'deftheme' is not copied verbatim. * etc/themes/adwaita-theme.el (adwaita): Add properties. * etc/themes/deeper-blue-theme.el (deeper-blue): Add properties. * etc/themes/dichromacy-theme.el (dichromacy): Add properties. * etc/themes/light-blue-theme.el (light-blue): Add properties. * etc/themes/manoj-dark-theme.el (manoj-dark): Add properties. * etc/themes/misterioso-theme.el (misterioso): Add properties. * etc/themes/tango-dark-theme.el (tango-dark): Add properties. * etc/themes/tango-theme.el (tango): Add properties. * etc/themes/tsdh-dark-theme.el (tsdh-dark): Add properties. * etc/themes/tsdh-light-theme.el (tsdh-light): Add properties. * etc/themes/wheatgrass-theme.el (wheatgrass): Add properties. * etc/themes/whiteboard-theme.el (whiteboard): Add properties. * etc/themes/wombat-theme.el (wombat): Add properties. * etc/themes/modus-operandi-theme.el: Add properties. * etc/themes/modus-vivendi-theme.el: Add properties. * etc/themes/leuven-dark-theme.el (leuven-dark): Add properties. * etc/themes/leuven-theme.el (leuven): Add properties. * lisp/custom.el (deftheme): Allow for optional arguments to set the property list. (custom-declare-theme): Accept the same optional arguments as 'deftheme'. (theme-list-variants): Add new function. (theme-choose-variant): Add new command for switching between members of a theme family. (toggle-theme): Add an alias for 'theme-choose-variant'. * lisp/emacs-lisp/loaddefs-gen.el (loaddefs-generate--make-autoload): Handle 'defcustom's by extracting the properties. (Bug#57639)
* Make the bookmark fringe icon look like a bookmarkJim Porter2022-08-151-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | * src/fringe.c (large_circle_bits): New variable. (standard_bitmaps): Add large_circle_bits. * lisp/fringe.el (fringe-bitmaps): Add 'large-circle'. (fringe-custom-set-bitmap): New function. * lisp/cus-edit.el (widget-fringe-bitmap-prompt-value-history): New variable. (fringe-bitmap): New widget. * lisp/bookmark.el (bookmark-set-fringe-mark): Obsolete in favor of... (bookmark-fringe-mark): ... this. (bookmark-fringe-mark): Rename this fringe bitmap to... (bookmark-mark): ... and change it to look like a bookmark. (bookmark-face): Don't set the ':background' of the face. Instead, set ':distant-foreground'. (bookmark--set-fringe-mark, bookmark--remove-fringe-mark) (bookmark-store, bookmark--jump-via): Consult the 'bookmark-fringe-mark' option. * doc/lispref/customize.texi (Simple Types): Document 'fringe-bitmap' type. * doc/lispref/display.texi (Fringe Bitmaps): Mention 'large-circle'. * etc/NEWS: Announce this change (bug#56896).
* Fix issues with loading autoloaded defcustoms while boundIgnacio Casso2022-06-101-8/+8
| | | | | | | | | | | | | * doc/lispref/customize.texi (Variable Definitions) (Variable Definitions): Update documentation. * lisp/custom.el (custom-initialize-set) (custom-initialize-reset): Update doc string. (custom-initialize-changed): Use set-default-toplevel-value. This fixes issues with (let ((custom-variable ...)) (autoload-function ...)). (custom-set-default): Ditto. * src/data.c (Fdefault_boundp): Update doc string.
* New :type key for defcustomStefan Kangas2022-01-021-1/+5
| | | | | | | | | | | As compared to the old type key-sequence that deals with raw key sequences, this :type conforms to the format used by the new keymap-* functions. * lisp/wid-edit.el (key): New widget type. (Bug#52523) (widget-key-prompt-value-history): New variable. (widget-key-validate): New function. (key-sequence): Doc fix. * doc/lispref/customize.texi (Simple Types): Document above new type.
* Merge from origin/emacs-28Eli Zaretskii2022-01-011-1/+1
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 836be7a112 ; * etc/refcards/ru-refcard.tex: Update Copyright year. 86cbc6ee4a * lisp/net/tramp-sh.el: Adapt copyright year ebe8772f65 ; Minor fixes related to copyright years 23c1ee6989 ; * test/manual/etags/ETAGS.good_N: Adjust to copyright ye... 8d3fc7ec89 * src/xfaces.c (face_for_font): Make 'hash' be uintptr_t. 19dcb237b5 ; Add 2022 to copyright years. # Conflicts: # etc/NEWS # etc/refcards/ru-refcard.tex # lib/cdefs.h # lisp/erc/erc-dcc.el # lisp/erc/erc-imenu.el # lisp/erc/erc-replace.el # lisp/image-dired.el # lisp/progmodes/xref.el # m4/alloca.m4 # m4/byteswap.m4 # m4/errno_h.m4 # m4/getopt.m4 # m4/gnulib-common.m4 # m4/inttypes.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/sys_socket_h.m4
| * ; Add 2022 to copyright years.Eli Zaretskii2022-01-011-1/+1
| |
| * Revert "Use @pxref when necessary"Eli Zaretskii2021-11-241-1/+1
|/ | | | | | This reverts commit b4f47d2ee2203a9f22bebeb3d09e0fb3fce2f65e. Cleanups should not be done on the release branch: that's unnecessary risk.
* Use @pxref when necessaryRobert Pluim2021-11-241-1/+1
| | | | | | | | | | | | | | | | | * doc/lispref/customize.texi (Composite Types): * doc/lispref/edebug.texi (Specification List): * doc/lispref/variables.texi (Local Variables): * doc/misc/efaq.texi (Basic keys): (Informational files for Emacs): * doc/misc/flymake.texi (Locating a master file): * doc/misc/gnus.texi (Don't Panic): (Oort Gnus): * doc/misc/htmlfontify.texi (Non-interactive): * doc/misc/mh-e.texi (More About MH-E): * doc/misc/pcl-cvs.texi (Entering PCL-CVS): * doc/misc/tramp.texi (Remote processes): * doc/misc/vhdl-mode.texi (Indentation Calculation): (Custom Indentation Functions): Use @pxref when inside parens.
* New :type natnum for defcustomStefan Kangas2021-09-251-0/+3
| | | | | * lisp/wid-edit.el (natnum): New widget type. (Bug#15809) * doc/lispref/customize.texi (Simple Types): Document it.
* Decouple require-theme from load-themeBasil L. Contovounesios2021-03-041-1/+25
| | | | | | | | | | | | | | | | | * lisp/custom.el (require-theme): Refashion after 'require', as a function for loading only named features. Do not call load-theme (bug#45068). * etc/NEWS: Update its announcement accordingly. * doc/lispref/customize.texi (Custom Themes): Document it. * etc/themes/modus-operandi-theme.el: * etc/themes/modus-vivendi-theme.el: Remove redundant calls to 'provide'. * test/lisp/custom-tests.el (custom-tests--with-temp-dir): New macro. (custom-theme--load-path): Use it. (custom-tests-require-theme): New test.
* Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright".
* Use a widget for the face link in Customize buffersLars Ingebrigtsen2020-09-181-0/+5
| | | | | | | | | | * doc/lispref/customize.texi (Common Keywords): Document it. * lisp/cus-edit.el (custom-face-value-create): Use a widget instead of a button so that TAB works (bug#20664). * lisp/wid-edit.el (face-link): New widget. (widget-face-link-action): New action.
* Document :type-error property for customization typesMauro Aranda2020-09-041-0/+7
| | | | | | * doc/lispref/customize.texi (Type Keywords): Document :type-error, so Lisp programs can display a more correct message when the value of a user option doesn't match its type (bug#23975).
* Improve documentation for custom :optionsMauro Aranda2020-09-011-0/+8
| | | | | | * doc/lispref/customize.texi (Variable Definitions): Mention that re-evaluating a defcustom form doesn't reset custom options (bug#30101).
* Fix typo in "(elisp) Type Keywords"Basil L. Contovounesios2020-06-071-1/+1
| | | | | * doc/lispref/customize.texi (Type Keywords): Fix typo of 'choice' composite type. (Bug#41749)
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Fixes for makeinfo 4.13Glenn Morris2019-12-291-2/+1
| | | | | | * doc/lispref/customize.texi (Variable Definitions): Fix xref. * doc/lispref/internals.texi (Writing Emacs Primitives) (Module Values): Follow xref with comma.
* Rearrange NEWS, add missing documentationEli Zaretskii2019-12-281-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * etc/NEWS: Rearrange and mark entries whether documented or not. * doc/lispref/streams.texi (Output Variables): Document the new default of 'print-quoted'. * doc/lispref/keymaps.texi (Functions for Key Lookup): Document that KEYMAP arg to 'lookup-key' can also be a list. * doc/lispref/customize.texi (Variable Definitions): Document the :local keyword of 'defcustom'. * doc/lispref/numbers.texi (Float Basics): Document changes in 'logb'. * doc/lispref/hooks.texi (Standard Hooks): Document 'comint-password-function'. * doc/emacs/display.texi (Text Scale): Document text-size adjustment using the mouse wheel. * doc/emacs/frames.texi (Mouse Commands): Document image scaling with the mouse wheel. * doc/emacs/windows.texi (Window Convenience): Document 'global-tab-line-mode'. * doc/emacs/search.texi (Repeat Isearch, Symbol Search) (Isearch Yank): Document the new support for numeric arguments in Isearch commands. (Special Isearch): Document 'M-s M->' and 'M-s M-<'. (Search Customizations): Document 'isearch-lazy-count'. Improve indexing. (Not Exiting Isearch): Document the new value of 'isearch-allow-scroll'. * doc/emacs/maintaining.texi (Xref Commands): Document the new 'g' key binding. * doc/emacs/package.texi (Package Installation): Document changes in 'package-check-signature'. * doc/emacs/maintaining.texi (VC Change Log): Document 'vc-log-search'. * doc/emacs/dired.texi (Operating on Files): Document 'dired-vc-rename'.
* Document :match-inline widget elementsLars Ingebrigtsen2019-10-121-0/+11
| | | | | | * doc/lispref/customize.texi (Type Keywords): Document :match-inline (bug#8716). (Splicing into Lists): Mention :match-inline.
* * doc/lispref/customize.texi: Fix typo.Paul Eggert2019-08-311-1/+1
|
* Mention `themed-value' in Variable Definitions nodeLars Ingebrigtsen2019-08-031-2/+4
| | | | | * doc/lispref/customize.texi (Variable Definitions): Mention `themed-value' (bug#17996).
* Improve pure and side-effect-free docsBasil L. Contovounesios2019-04-221-4/+4
| | | | | | | | | | | | | | | | For discussion, see thread starting at: https://lists.gnu.org/archive/html/emacs-devel/2019-04/msg00316.html * doc/lispref/customize.texi (Composite Types): Do not overspecify :match-alternatives predicates. * doc/lispref/eval.texi (Intro Eval): Anchor definition of "side effect" for cross-referencing... * doc/lispref/functions.texi (What Is a Function): ...from here. Define what a pure function is. * doc/lispref/internals.texi (Writing Emacs Primitives): Describe currently preferred approach to marking primitives as pure and side-effect-free. * doc/lispref/symbols.texi (Standard Properties): Expand description of pure and side-effect-free properties.
* Update copyright year to 2019Paul Eggert2019-01-011-1/+1
| | | | Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
* Don't use obsolete variable 'save-place' in documentationEli Zaretskii2018-09-221-6/+5
| | | | | | * doc/lispref/customize.texi (Variable Definitions): Replace example of saveplace defcustom with a fictitious one, which will not bit-rot with time. (Bug#32741)
* Improve indexing of 'eval-defun' in ELisp manualEli Zaretskii2018-07-071-0/+1
| | | | | | | | * doc/lispref/display.texi (Defining Faces): * doc/lispref/debugging.texi (Explicit Debug): * doc/lispref/customize.texi (Variable Definitions): * doc/lispref/variables.texi (Defining Variables): Add index entries for 'eval-defun'. (Bug#32066)
* Delete description of deleted Customize functionsEli Zaretskii2018-06-151-14/+8
| | | | | | | | * doc/lispref/customize.texi (Variable Definitions): Remove the description of 'custom-initialize-safe-set' and 'custom-initialize-safe-default', which were deleted in Emacs 23.2, and replace with the description of 'custom-initialize-delay'.
* Document 'custom-group'Eli Zaretskii2018-05-041-0/+7
| | | | | * doc/lispref/customize.texi (Group Definitions): Document the 'custom-group' property.
* * doc/lispref/customize.texi (Custom Themes): Clarify .el preference.Basil L. Contovounesios2018-02-021-1/+3
| | | | | | Copyright-paperwork-exempt: yes https://lists.gnu.org/archive/html/emacs-devel/2018-01/msg00824.html.
* Update copyright year to 2018Paul Eggert2018-01-011-1/+1
| | | | Run admin/update-copyright.
* Be more consistent about "directory name" in manualPaul Eggert2017-09-091-1/+1
| | | | | This clarifies the documentation, partly in response to the discussion in Bug#27986.
* Update copyright year to 2017Paul Eggert2016-12-311-1/+1
| | | | Run admin/update-copyright.
* (Common Keywords): Correct what missing :group meansLars Ingebrigtsen2016-05-031-2/+1
| | | | | * doc/lispref/customize.texi (Common Keywords): Correct what missing :group means.
* Mention what a missing :group doesLars Ingebrigtsen2016-05-031-3/+7
| | | | | * doc/lispref/customize.texi (Common Keywords): Document that a missing :group reuses the group from the preceding item (bug#21601).
* Add some concept index entries for custom typesLars Ingebrigtsen2016-05-011-0/+3
| | | | | | | * doc/lispref/customize.texi (Composite Types): Add concept index entries for restricted-sexp, radio and choice (bug#7385). (cherry picked from commit 388bb723fa078158d3148de05e942f9c01e95dd8)
generated by cgit v1.2.1 (git 2.18.0) at 2026-03-14 16:11:45 +0000