summaryrefslogtreecommitdiff
path: root/doc/lispref/customize.texi
Commit message (Collapse)AuthorAgeFilesLines
* ; 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)
* * lisp/custom.el (defcustom): Doc fix.Glenn Morris2016-01-281-1/+2
| | | | | * doc/lispref/customize.texi (Variable Definitions): Defcustom should always have a type.
* Update copyright year to 2016Paul Eggert2016-01-011-1/+1
| | | | Run admin/update-copyright.
* Quote less in manualsPaul Eggert2015-09-151-8/+8
| | | | | | | | | | The manuals often used quotes ``...'' when it is better to use @dfn or @code or capitalized words or no quoting at all. For example, there is no need for the `` and '' in “if a variable has one effect for @code{nil} values and another effect for ``non-@code{nil}'' values”. Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate unnecessary quoting like this, and to use @dfn etc. instead when called for (Bug#21472).
* Minor quoting etc. fixes to lispref manualPaul Eggert2015-04-101-1/+1
| | | | | | | | | | | | | | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Distinguish more clearly among grave accent, apostrophe, and single quote. * doc/lispref/README, doc/lispref/buffers.texi: * doc/lispref/commands.texi, doc/lispref/control.texi: * doc/lispref/customize.texi, doc/lispref/display.texi: * doc/lispref/elisp.texi, doc/lispref/files.texi: * doc/lispref/frames.texi, doc/lispref/hash.texi: * doc/lispref/help.texi, doc/lispref/internals.texi: * doc/lispref/loading.texi, doc/lispref/makefile.w32-in: * doc/lispref/markers.texi, doc/lispref/modes.texi: * doc/lispref/nonascii.texi, doc/lispref/objects.texi: * doc/lispref/os.texi, doc/lispref/positions.texi: * doc/lispref/strings.texi, doc/lispref/syntax.texi: * doc/lispref/text.texi, doc/lispref/tips.texi: * doc/lispref/two-volume-cross-refs.txt, doc/lispref/windows.texi: Use American-style double quoting in ordinary text, and quote 'like this' when single-quoting in ASCII text. Also, fix some minor spacing issues.
* Update copyright year to 2015Paul Eggert2015-01-011-1/+1
| | | | Run admin/update-copyright.
* Improve indexing on the chapter/section/subsection levels.Eli Zaretskii2014-12-231-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | doc/lispref/windows.texi (Recombining Windows): Index subject of sections. doc/lispref/variables.texi (Variables with Restricted Values) (Generalized Variables): Index subject of sections. doc/lispref/text.texi (Buffer Contents, Examining Properties) (Changing Properties, Property Search, Substitution): Index subject of sections. doc/lispref/syntax.texi (Motion and Syntax, Parsing Expressions) (Motion via Parsing, Position Parse, Control Parsing): Index subject of sections. doc/lispref/strings.texi (Predicates for Strings, Creating Strings) (Modifying Strings, Text Comparison): Index subject of sections. doc/lispref/searching.texi (Syntax of Regexps, Regexp Special) (Regexp Functions, Regexp Functions): Index subject of sections. doc/lispref/processes.texi (Subprocess Creation, Process Information): Index subject of sections. doc/lispref/positions.texi (Screen Lines): Index subject of sections. doc/lispref/nonascii.texi (Scanning Charsets, Specifying Coding Systems): Index subject of sections. doc/lispref/minibuf.texi (Text from Minibuffer, Object from Minibuffer) (Multiple Queries, Minibuffer Contents): Index subject of sections. doc/lispref/markers.texi (Predicates on Markers, Creating Markers) (Information from Markers, Moving Markers): Index subject of sections. doc/lispref/macros.texi (Defining Macros, Problems with Macros): Index subject of sections. doc/lispref/loading.texi (Loading Non-ASCII, Where Defined): Index subject of sections. doc/lispref/lists.texi (List-related Predicates, List Variables, Setcar) (Setcdr, Plist Access): Index subject of sections. doc/lispref/keymaps.texi (Controlling Active Maps, Scanning Keymaps) (Modifying Menus): Index subject of sections. doc/lispref/help.texi (Accessing Documentation, Help Functions): Index subject of sections. doc/lispref/hash.texi (Hash Access): Index subject of sections. doc/lispref/functions.texi (Core Advising Primitives) (Advising Named Functions, Porting old advices): Index subject of sections. doc/lispref/frames.texi (Creating Frames, Initial Parameters) (Position Parameters, Buffer Parameters, Minibuffers and Frames) (Pop-Up Menus, Drag and Drop): Index subject of sections. doc/lispref/files.texi (Visiting Functions, Kinds of Files) (Unique File Names): Index subject of sections. doc/lispref/display.texi (Refresh Screen, Echo Area Customization) (Warning Variables, Warning Options, Delayed Warnings) (Temporary Displays, Managing Overlays, Overlay Properties) (Finding Overlays, Size of Displayed Text, Defining Faces) (Attribute Functions, Displaying Faces, Face Remapping) (Basic Faces, Font Lookup, Fontsets, Replacing Specs) (Defining Images, Showing Images): Index subject of sections. doc/lispref/debugging.texi (Debugging, Explicit Debug) (Invoking the Debugger, Excess Open, Excess Close): Index subject of sections. doc/lispref/customize.texi (Defining New Types, Applying Customizations) (Custom Themes): Index subject of sections. doc/lispref/control.texi (Sequencing, Combining Conditions) (Processing of Errors, Cleanups): Index subject of sections. doc/lispref/compile.texi (Eval During Compile): Index subject of sections. doc/lispref/commands.texi (Using Interactive, Distinguish Interactive) (Command Loop Info, Classifying Events, Event Mod) (Invoking the Input Method): Index subject of sections. doc/lispref/buffers.texi (Buffer List, Buffer Gap): Index subject of sections. doc/lispref/backups.texi (Making Backups, Numbered Backups, Backup Names) (Reverting): Index subject of sections. doc/lispref/abbrevs.texi (Abbrev Tables, Defining Abbrevs, Abbrev Files) (Abbrev Expansion, Standard Abbrev Tables, Abbrev Properties) (Abbrev Table Properties): Index subject of sections. doc/lispref/os.texi (Time of Day, Time Conversion, Time Parsing) (Time Calculations, Idle Timers): Index subject of sections.
* Recommend not modifying :set's value arg in defcustom (bug#16755).Juanma Barranquero2014-03-191-2/+3
| | | | | | * doc/lispref/customize.texi (Variable Definitions): * lisp/custom.el (defcustom): Recommend avoiding destructive modification of the value argument of :set.
* Style fixes for floating-point doc.Paul Eggert2014-03-171-1/+1
| | | | | | | | | | | | | * commands.texi, customize.texi, display.texi, elisp.texi, files.texi: * frames.texi, hash.texi, internals.texi, keymaps.texi, lists.texi: * minibuf.texi, nonascii.texi, numbers.texi, objects.texi, os.texi: * processes.texi, streams.texi, strings.texi, text.texi: * variables.texi, windows.texi: Hyphenate "floating-point" iff it precedes a noun. Reword to avoid nouns and hyphenation when that's easy. Prefer "integer" to "integer number" and "is floating point" to "is a floating point number". Prefer "@minus{}" to "-" when it's a minus.
* More doc updates.Chong Yidong2014-01-061-7/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | * backups.texi (Making Backups): Document backup-buffer change. * commands.texi (Defining Commands): Document the interactive-form property more carefully. Document interactive-only. * compile.texi (Compiler Errors): Copyedits. Note that the details for byte-compile-warnings are in its docstring. * customize.texi (Variable Definitions): Likewise. * files.texi (Visiting Files): Copyedits. (Testing Accessibility): Mention ACLs. Move file-modes here from File Attributes. (Truenames): Move file-equal-p here from Kinds of Files. (File Attributes): Move file-newer-than-file-p here from Testing Accessibility. (Extended Attributes): New node. Add file-extended-attributes. (Changing Files): Document set-file-extended-attributes. * minibuf.texi (Minibuffer Contents): Remove obsolete function minibuffer-completion-contents. * variables.texi (Defining Variables): Note that defvar acts always on the dynamic value.
* Update copyright year to 2014 by running admin/update-copyright.Paul Eggert2014-01-011-1/+1
|
* * customize.texi (Custom Themes): Document custom-known-themes.Chong Yidong2013-12-181-0/+11
| | | | | | * custom.el (custom-available-themes): Doc fix. Fixes: debbugs:15717
* Merge from emacs-24; up to 2012-12-06T01:39:03Z!monnier@iro.umontreal.caPaul Eggert2013-01-021-5/+4
|\
generated by cgit v1.2.3 (git 2.39.1) at 2025-04-08 09:25:15 +0000