summaryrefslogtreecommitdiff
path: root/doc/emacs/custom.texi
Commit message (Collapse)AuthorAgeFilesLines
* ; * doc/emacs/custom.texi (Changing a Variable): Update example (bug#68279).Eli Zaretskii2024-01-061-2/+3
|
* ; Add 2024 to copyright yearsPo Lu2024-01-021-1/+1
|
* * doc/emacs/custom.texi (Modifier Keys): Fix markup (bug#68164).Eli Zaretskii2023-12-311-1/+1
| | | | Suggested by Jens Quade <jq@qdevelop.de>.
* Fix example in Emacs user manualEli Zaretskii2023-11-271-2/+2
| | | | | * doc/emacs/custom.texi (Init Rebinding): Fix syntax of example. Reported by silarakta <silarakta@protonmail.com>. (Bug#67474)
* Minor connection-local variables fixesMichael Albinus2023-10-231-0/+4
| | | | | | | * doc/emacs/custom.texi (Connection Variables): Warn about specifying the same variable twice. * lisp/files-x.el (connection-local-get-profiles): Normalize criteria.
* ; * doc/emacs/custom.texi (Early Init File): Improve indexing.Eli Zaretskii2023-09-301-0/+1
|
* ; Fix doc typos (Bug#65868)shynur2023-09-111-1/+1
|
* ; Better documentation of HOME on MS-WindowsEli Zaretskii2023-07-301-1/+6
| | | | | | | * doc/emacs/custom.texi (Find Init): Add footnote about HOME on MS-Windows. (Bug#64871) (cherry picked from commit d59630e591cd49780e6554d1025c1879bb89680b)
* ; Fix last change.Eli Zaretskii2023-07-141-4/+4
|
* Improve documentation of 'enable-local-variables' in Emacs manualYugaEgo2023-07-141-3/+5
| | | | | * doc/emacs/custom.texi (Safe File Variables): Document ':all'. (Bug#64621)
* Add index entry for fallback modesRobert Pluim2023-04-191-0/+1
| | | | | * doc/emacs/custom.texi (Specifying File Variables): Add index for 'fallback modes'.
* ; * doc/emacs/custom.texi (Init Rebinding): Fix wording in last change.Eli Zaretskii2023-01-211-23/+26
|
* ; Reword user documentation on binding keys in LispPanagiotis Koutsourakis2023-01-211-10/+36
| | | | | * doc/emacs/custom.texi (Init Rebinding): Move the description of 'kbd' farther down. (Bug#60859)
* ; Add 2023 to copyright years.Eli Zaretskii2023-01-011-1/+1
|
* Document 'use-package' in the 2 main manualsEli Zaretskii2023-01-011-0/+22
| | | | | | * doc/emacs/custom.texi (Init Examples): * doc/lispref/loading.texi (Named Features): Document 'use-package' and its most important features.
* ; Improve documentation of "C-x @"Eli Zaretskii2022-12-231-1/+5
| | | | | | | | * doc/emacs/custom.texi (Modifier Keys): Document how to enter Shift, Control, and Meta using "C-x @". * lisp/simple.el (function-key-map): Add commentary to "C-x @" bindings to make them easier to discover.
* Merge from origin/emacs-28Stefan Kangas2022-11-171-3/+3
|\ | | | | | | | | | | | | 0636e1066b ; Don't unnecessarily use non-ASCII characters in Texinfo # Conflicts: # doc/emacs/custom.texi
| * ; Don't unnecessarily use non-ASCII characters in TexinfoEli Zaretskii2022-11-161-5/+5
| | | | | | | | | | * doc/emacs/custom.texi (Init Rebinding, Examining, Keymaps): Use Texinfo directives instead of literal non-ASCII characters.
| * Explain how to bind keys to non-ASCII sequencesRobert Pluim2022-11-141-0/+16
| | | | | | | | | | * doc/emacs/custom.texi (Init Rebinding): Explain how to use `kbd' when binding keys to non-ASCII sequences.
* | Improve and extend documentation of ElDocEli Zaretskii2022-10-211-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/emacs-lisp/eldoc.el (eldoc-documentation-strategy) (eldoc-documentation-enthusiast) (eldoc-documentation-compose-eagerly) (eldoc-documentation-compose, eldoc-documentation-default) (eldoc-minibuffer-message, eldoc-idle-delay) (eldoc-print-after-edit) (eldoc-echo-area-display-truncation-message) (eldoc-echo-area-use-multiline-p) (eldoc-echo-area-prefer-doc-buffer): Doc string fixes. * doc/emacs/emacs.texi (Top): * doc/emacs/programs.texi (Documentation, Programming Language Doc): Rename "Lisp Doc" to "Programming Language Doc", including in parent menus. All references changed. (Programming Language Doc): Formerly "Lisp Doc". Rewrite to not be specific to Emacs Lisp. Improve markup and wording. Document more commands and variables. * doc/emacs/maintaining.texi (Maintaining): Improve indexing.
* | Merge from origin/emacs-28Stefan Kangas2022-10-161-0/+18
|\| | | | | | | | | | | | | | | | | | | | | 067361f3a2 ; Improve documentation of 'C-M-i' fdb6f7cf26 ; Fix documentation of 'comp-enable-subr-trampolines' be30369e01 ; Avoid incorrect indentation in an @example. 4bd3dd505e Document how to control where the *.eln files are written b7d7c2d9e9 Add cross-reference to alternative syntaxes for Unicode # Conflicts: # doc/emacs/custom.texi
| * Add cross-reference to alternative syntaxes for UnicodeRobert Pluim2022-10-141-0/+6
| | | | | | | | | | | | | | | | These alternative syntaxes allow you to specify Unicode codepoints using only ASCII, which helps avoid decoding issues. * doc/emacs/custom.texi (Init Non-ASCII): Add cross reference to "General Escape Syntax" in the Emacs Lisp Reference Manual.
* | Tag themes with propertiesPhilip Kaludercic2022-10-151-0/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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)
* | Revert "Add new command 'toggle-theme'"Philip Kaludercic2022-09-111-5/+0
| | | | | | | | This reverts commit f31b9d86a67f1b3fd70339f277dff52478890351.
* | Add new command 'toggle-theme'Philip Kaludercic2022-09-111-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/custom.texi (Custom Themes): Mention it. * etc/themes/leuven-dark-theme.el (leuven-dark): Add dual theme. * etc/themes/leuven-theme.el (leuven): Add dual theme. * etc/themes/tango-dark-theme.el (tango-dark): Add dual theme. * etc/themes/tango-theme.el (tango): Add dual theme. * etc/themes/tsdh-dark-theme.el (tsdh-dark): Add dual theme. * etc/themes/tsdh-light-theme.el (tsdh-light): Add dual theme. * lisp/cus-theme.el (describe-theme-1): Say if a theme has a dual. * lisp/custom.el (toggle-theme): Add new command.
* | Improve explanation of init file in FAQStefan Kangas2022-08-251-0/+2
| | | | | | | | | | | | | | | | | | * doc/misc/efaq.texi (Setting up a customization file): Improve and update section to reflect current behavior. Add cross-references back to this section. * doc/emacs/custom.texi (Init File): Add comment to remind about also updating the FAQ. Ref: https://lists.gnu.org/r/emacs-devel/2022-08/msg01056.html
* | Merge from origin/emacs-28Stefan Kangas2022-08-071-0/+3
|\| | | | | | | | | | | | | | | | | 7ffcba4213 * etc/PROBLEMS: Problems with Alacritty and Emoji. (Bug#5... df95118e83 Link from (emacs)Init Syntax to (elisp)Introduction 7793cf0c3d Don't mention removed XEmacs support in reftex manual 3d1cf1b47a Don't mention removed XEmacs support in idlwave manual 7ff60c62a9 ; * admin/make-tarball.txt: Fix last change. 2fd5590d0c ; * lisp/play/fortune.el (fortune-ask-file): Doc fix.
| * Link from (emacs)Init Syntax to (elisp)IntroductionYugaEgo2022-08-061-0/+3
| | | | | | | | * doc/emacs/custom.texi (Init Syntax): Link to the ELisp manual (Bug#56870)
* | Add support for user-customizable iconsLars Ingebrigtsen2022-07-281-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/custom.texi (Specific Customization): Mention it. * doc/emacs/display.texi (Icons): New node. * doc/lispref/display.texi (Icons): New node. * lisp/button.el (buttonize): (button--properties, buttonize-region): Allow not overriding faces. * lisp/cus-edit.el (custom-save-all): Save icons. (custom-icon): New widget. (custom-icon-value-create, custom-toggle-hide-icon) (custom--icons-widget-value, custom-icon-set): Helper functions for the widget. (customize-icon): Main command. (custom-icon-state-set, custom-icon-state): Helper functions. (custom-theme-set-icons): Function to be used by theme writers. (custom-set-icons): Function to be used in .emacs. (custom-save-icons): New function. * lisp/custom.el (custom-push-theme): Add icons. * lisp/emacs-lisp/icons.el: New file. * test/lisp/emacs-lisp/icons-tests.el: Add some tests.
* | Fix previous description of fallback orderLars Ingebrigtsen2022-04-191-9/+6
| | | | | | | | | | * doc/emacs/custom.texi (Specifying File Variables): Document fallback mode order.
* | Document how to specify fallback modesLars Ingebrigtsen2022-04-191-0/+25
| | | | | | | | | | * doc/emacs/custom.texi (Specifying File Variables): Document fallback mode order.
* | Add a mechanism for querying before executing a commandLars Ingebrigtsen2022-02-141-0/+16
| | | | | | | | | | | | | | | | | | | | | | * doc/emacs/custom.texi (Disabling): Document it. * doc/lispref/commands.texi (Disabling Commands): Document the low-level stuff. * lisp/simple.el (command-execute): Respect the `(query ...)' value for `disabled'. (command-execute--query): New function. (command-query): New function.
* | Add a new macro `setopt'Lars Ingebrigtsen2022-02-131-3/+18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/custom.texi (Examining): Mention it. (Init Syntax): Ditto. * doc/emacs/windows.texi (Window Choice): Adjust example. * doc/lispref/windows.texi (Choosing Window Options): Adjust examples. * doc/lispref/variables.texi (Setting Variables): Document setopt. * doc/misc/eudc.texi (Emacs-only Configuration): Adjust examples. * lisp/cus-edit.el (setopt): New macro.
* | 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
| |
* | Merge from origin/emacs-28Stefan Kangas2021-12-041-5/+3
|\| | | | | | | | | | | | | | | | | | | | | 745a732ae4 ; Further author fixes in authors.el bef17bca21 * src/dosfns.c (Fint86): Doc fix; don't use obsolete names. bc55dc04af * doc/misc/erc.texi (Keystroke Summary): Fix doc for TAB. ef4d216eb3 Remove reference to variable obsolete since 24.1 7282e492d5 * doc/misc/efaq.texi (New in Emacs 28): New node. eafcccd38f ; FAQ: Normalize references to the NEWS.NN file c006c490eb ; * doc/misc/efaq.texi (Latest version of Emacs): Update v... 9fbc4fa0e7 Add Tramp version integrated in Emacs 28.1
| * Remove reference to variable obsolete since 24.1Stefan Kangas2021-12-031-5/+3
| | | | | | | | | | | | * doc/emacs/custom.texi (Minibuffer Maps, Minibuffer Maps): Remove reference to variable 'minibuffer-local-filename-must-match-map', obsolete since 24.1.
| * ; * doc/emacs/custom.texi (Connection Variables): Fix typo. Don't mergeMichael Albinus2021-10-291-1/+1
| |
* | Audit the Emacs manual for keymap-*-related changesLars Ingebrigtsen2021-11-301-3/+2
| | | | | | | | | | | | | | | | * doc/emacs/programs.texi (Other C Commands): * doc/emacs/msdos-xtra.texi (MS-DOS Keyboard): * doc/emacs/custom.texi (Init Examples): * doc/emacs/abbrevs.texi (Editing Abbrevs): Change some examples to use keymap-* functions.
* | Start adjusting the manuals to talk about the keymap-* functionsLars Ingebrigtsen2021-11-161-96/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/dired.el (dired--make-directory-clickable): * doc/lispref/keymaps.texi (Keymaps): (Key Sequences): (Prefix Keys): (Active Keymaps): (Key Lookup): (Functions for Key Lookup): (Changing Key Bindings): (Key Binding Commands): (Tool Bar): * doc/lispref/commands.texi (Interactive Codes): (Event Examples): (Event Mod): * doc/emacs/kmacro.texi (Save Keyboard Macro): * doc/emacs/custom.texi (Keymaps): (Keymaps): (Minibuffer Maps): (Rebinding): (Init Rebinding): (Modifier Keys): (Mouse Buttons): (Init Examples): (Init Non-ASCII): Adjust the documentation to remove description of the old syntaxes, and use the new keymap-* functions. * doc/lispref/keymaps.texi (Low-Level Key Binding): New node that describes `define-key' and the old key syntaxes.
* | Expand connection-local variables example in doc/emacs/custom.texiJim Porter2021-10-301-7/+14
| | | | | | | | | | * doc/emacs/custom.texi (Per-Connection Local Variables): Expand the example to include setting 'system-uses-terminfo'.
* | Double the default value of kill-ring-maxStefan Kangas2021-10-141-1/+1
|/ | | | | | | | | | | | | | * lisp/simple.el (kill-ring-max): Double the default to 120. * lisp/menu-bar.el (yank-menu-length): Doc fix. (yank-menu-max-items): New variable. (menu-bar-update-yank-menu): Don't display more than 'yank-menu-max-items' in the yank menu. * doc/emacs/custom.texi (Changing a Variable): * doc/emacs/killing.texi (Kill Ring): * doc/lispintro/emacs-lisp-intro.texi (kill-new function): * doc/lispref/text.texi (Internals of Kill Ring): Doc fix to use the new value.
* Doc fix: mode name in local variables needs no suffixStefan Kangas2021-09-261-2/+3
| | | | | * doc/emacs/custom.texi (Specifying File Variables): Clarify that a mode name does not need the "-mode" suffix. (Bug#50801)
* Revert "; Fix capitalization of F1..F12 keys in docs"Stefan Kangas2021-09-251-1/+1
| | | | | | | This reverts commit fe5b20410f68546821e6c87577d7f826167491dc. This change was not correct; these are Lisp symbols that should be in lower-case. Problem reported by Mattias EngdegÄrd <mattiase@acm.org>.
* ; Fix capitalization of F1..F12 keys in docsStefan Kangas2021-09-251-1/+1
| | | | | | | | * doc/emacs/custom.texi (Function Keys): * doc/misc/edt.texi (Unix): * doc/misc/idlwave.texi (Custom Expression Examination): * doc/misc/viper.texi (Improved Search, Vi Macros): Fix capitalization of F1..F12 keys.
* Clarify use of early-init fileEli Zaretskii2021-09-161-3/+3
| | | | | | * doc/emacs/custom.texi (Early Init File): Clarify that using the early-init file should be reserved to cases where it is absolutely necessary. (Bug#50491)
* Fix typo in previous custom.texi changeLars Ingebrigtsen2021-08-301-3/+3
| | | | | * doc/emacs/custom.texi (Init Syntax): Fix typo in previous change -- it's customize-set-variable.
* Mention `set-variable' in the Init Syntax Emacs manual nodeLars Ingebrigtsen2021-08-291-8/+21
| | | | | | * doc/emacs/custom.texi (Init Syntax): Mention set-variable (bug#50248). (Init Examples): Add an example.
* ; * doc/emacs/custom.texi (Minibuffer Maps): Fix wording.Eli Zaretskii2021-08-211-1/+1
|
* Document how to get rid of completion on `SPC' and `?'Lars Ingebrigtsen2021-08-201-0/+11
| | | | | * doc/emacs/custom.texi (Minibuffer Maps): Mention how to get rid of completion on `SPC' and `?' (bug#16528).