mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-07 08:00:48 -08:00
Code Issues Projects Releases Wiki Activity
165763 commits 243 branches 194 tags 753 MiB
Commit graph

177 commits

Author SHA1 Message Date
shynur
d11d81dfcc ; Fix doc typos (Bug#65868) 2023-09-11 17:16:23 +02:00
Eli Zaretskii
d172cd5985 ; * doc/lispref/keymaps.texi (Modifying Menus): Add cross-references. 2023-07-18 16:17:15 +03:00
Eli Zaretskii
927e8b470f ; * doc/lispref/keymaps.texi (Extended Menu Items): Add @pxref. 2023-07-18 15:57:01 +03:00
Eli Zaretskii
40f84e906f ; * doc/lispref/keymaps.texi (Key Binding Commands): Fix typo. 2023-07-07 09:59:52 +03:00
Eli Zaretskii
a30ebe7a55 ; Improve documentation of key-binding commands 
* doc/lispref/keymaps.texi (Key Binding Commands): Improve the
documentation of arguments expected by key binding commands.

* lisp/keymap.el (keymap-set, keymap-global-set)
(keymap-local-set, keymap-global-unset, keymap-local-unset)
(keymap-unset, key-parse): Doc fixes.
 2023-07-06 11:42:01 +03:00
Eli Zaretskii
aa030698ce ; Fix typos in documented names of keymap-* functions 
* doc/lispref/keymaps.texi (Functions for Key Lookup): Fix typos
in function names.  (Bug#64434)
 2023-07-03 15:12:12 +03:00
Eli Zaretskii
38cdfcb212 ; Fix description of new 'keymap-*' functions 
* doc/lispref/keymaps.texi (Prefix Keys): Fix example (bug#62673).
(Functions for Key Lookup): Clarify the possible values of KEYMAP
argument of 'keymap-lookup'.
(Active Keymaps): Fix typo in function name; add cross-reference.
 2023-04-05 11:31:15 +03:00
Robert Pluim
4a6eefb93a Expand defvar-keymap documentation 
* doc/lispref/keymaps.texi (Creating Keymaps): Describe the :repeat keyword.
 2023-03-21 10:57:39 +01:00
Robert Pluim
6bf441ff11 Warn package authors away from keymap-unset with REMOVE 
* doc/lispref/keymaps.texi (Changing Key Bindings): Ask package
authors to not use the REMOVE argument to `keymap-unset'.
 2023-03-20 16:21:36 +01:00
Eli Zaretskii
e388a77cf0 ; Minor copyedits of recent changes in ELisp reference manual 
* doc/lispref/keymaps.texi (Changing Key Bindings): Fix wording
and markup.
 2023-03-18 15:54:35 +02:00
Robert Pluim
e8cee15f78 ; Fix markup in previous change 2023-03-17 14:25:39 +01:00
Robert Pluim
e4a7d0cd6e Document `keymap-unset' in lispref 
* doc/lispref/keymaps.texi (Changing Key Bindings): Document
keymap-unset.
 2023-03-17 14:18:10 +01:00
Robert Pluim
8904a26a9d Improve `keymap-set-after' documentation 
* doc/lispref/keymaps.texi (Changing Key Bindings): Mention `key-valid-p'
(Modifying Menus): Correct description of KEY arg.
 2023-01-20 15:14:44 +01:00
Eli Zaretskii
cae528457c ; Add 2023 to copyright years. 2023-01-01 05:31:12 -05:00
Eli Zaretskii
3c5a41b200 ; * doc/lispref/keymaps.texi (Searching Keymaps): Fix a typo (bug#59886). 2022-12-10 15:06:27 +02:00
Lars Ingebrigtsen
87e4922cee Document :vert-only tool bar property 
* doc/lispref/keymaps.texi (Tool Bar): Document what :vert-only
does (bug#51049).  This is not what it was intended to do -- but
what it intended to do didn't really make that much sense either,
so perhaps the prop should just be renamed :image-only?
 2022-09-12 12:57:34 +02:00
Robert Pluim
bf47851e08 Signal error on duplicate key definitions 
* lisp/keymap.el (define-keymap, defvar-keymap): Signal error if the
same key is specified twice.  (Bug#56873)

* doc/lispref/keymaps.texi (Creating Keymaps): Document error
signaling behaviour.

* test/src/keymap-tests.el (keymap-test-duplicate-definitions): Test
duplicate definition detection.
 2022-08-02 14:29:43 +02:00
Stefan Kangas
d9bd334ef3 Merge from origin/emacs-28 
eb11dae499 Improve documentation of column-related functions
c95a34c960 * src/macfont.m (macfont_open): Initialize font->space_wid...
31a6a37d45 Improve indexing of keymap variables
 2022-07-31 06:30:25 +02:00
Eli Zaretskii
31a6a37d45 Improve indexing of keymap variables 
* doc/lispref/maps.texi (Standard Keymaps):
* doc/lispref/display.texi (Button Buffer Commands)
(Button Properties):
* doc/lispref/keymaps.texi (Translation Keymaps): Improve indexing
of keymaps.  (Bug#56816)
 2022-07-30 09:32:48 +03:00
Eli Zaretskii
e93aa8d586 ; Improve documentation of 'set-transient-map' changes 
* lisp/subr.el (set-transient-map-timeout, set-transient-map): Doc
fixes.

* etc/NEWS: Improve wording of the 'set-transient-map' entry.

* doc/lispref/keymaps.texi (Controlling Active Maps): Fix wording
and passive tense, and improve indexing.  (Bug#21634)
 2022-07-07 09:29:51 +03:00
Juri Linkov
0e99046d62 Add new args MESSAGE and TIMEOUT to set-transient-map (bug#21634) 
* lisp/subr.el (set-transient-map): Add new args MESSAGE and TIMEOUT.
(set-transient-map-timeout, set-transient-map-timer): New variables.

* lisp/international/emoji.el (emoji-zoom-increase):
* lisp/indent.el (indent-rigidly):
* lisp/face-remap.el (text-scale-adjust, global-text-scale-adjust):
Use the arg MESSAGE of set-transient-map.

* doc/lispref/keymaps.texi (Controlling Active Maps): Mention new args
MESSAGE and TIMEOUT of set-transient-map.
 2022-07-06 20:39:41 +03:00
Stefan Kangas
616d3c24e2 Document using make-composed-keymap with defvar-keymap 
* doc/lispref/keymaps.texi (Inheritance and Keymaps): Document
using 'make-composed-keymap' with 'defvar-keymap'.

* lisp/help-mode.el (help-mode-map): Use defvar-keymap to make this
code match the above documentation change.
 2022-07-04 18:19:53 +02:00
Lars Ingebrigtsen
0dc75daf11 Filter out NS non-key events from `where-is-internal' 
* doc/lispref/keymaps.texi (Scanning Keymaps): Document it.
* lisp/keymap.el (make-non-key-event): New function.

* lisp/term/common-win.el (x-setup-function-keys): Mark ns events
as not being keys (bug#55940).

* src/keymap.c (Fwhere_is_internal): Filter out key sequences that
are marked as being non-keys.
 2022-06-18 14:06:30 +02:00
Paul Eggert
734f0f68a4 Use "@code{nil}" in documentation 2022-04-18 13:19:14 -07:00
Eli Zaretskii
dcd76bd48d Merge from origin/emacs-28 
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
 2022-01-01 07:03:03 -05:00
Eli Zaretskii
19dcb237b5 ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
Eli Zaretskii
f6e383c8bb Fix documentation of 'define-keymap' 
* doc/lispref/keymaps.texi (Creating Keymaps)
(Changing Key Bindings): Fix typos, improve wording.
 2021-12-29 19:45:06 +02:00
Eli Zaretskii
1915c19131 Fix recent changes in 'keymap-lookup' documentation 
* doc/lispref/keymaps.texi (Functions for Key Lookup): Improve
wording, correct typos.
 2021-12-29 19:30:23 +02:00
Lars Ingebrigtsen
0d5bda36fb Document keymap-set-after in Modifying Menus in lispref 
* doc/lispref/keymaps.texi (Modifying Menus): Document
keymap-set-after (bug#52819).
 2021-12-29 17:20:08 +01:00
Lars Ingebrigtsen
2970dbaa32 Document `keymap-lookup' in the lipsref manual 
* doc/lispref/keymaps.texi (Functions for Key Lookup): Document
`keymap-lookup' instead of `lookup-key' (bug#52820).
 2021-12-29 17:11:31 +01:00
Lars Ingebrigtsen
ef344cc55c Move define-keymap manual entry to Creating Keymaps 
* doc/lispref/keymaps.texi (Creating Keymaps)
(Changing Key Bindings): Move `define-keymap'/`defvar-keymap' to
the Creating Keymaps node.
 2021-12-29 16:56:16 +01:00
Stefan Kangas
cf6dc1838a ; Fix spelling; be consistent with "key binding" (Bug#52674) 2021-12-21 11:19:04 +01:00
Lars Ingebrigtsen
1efc14561d Edit the lispref manual for define-key/keymap-set fallout 
* doc/lispref/variables.texi (Tips for Defining):
* doc/lispref/text.texi (Clickable Text):
* doc/lispref/modes.texi (Derived Modes):
(Example Major Modes):
* doc/lispref/loading.texi (Autoload):
(Hooks for Loading):
* doc/lispref/keymaps.texi (Creating Keymaps):
(Inheritance and Keymaps):
(Controlling Active Maps):
(Changing Key Bindings):
(Low-Level Key Binding):
(Remapping Commands):
(Translation Keymaps):
(Key Binding Commands):
* doc/lispref/help.texi (Help Functions):
* doc/lispref/display.texi (Abstract Display Example):
* doc/lispref/commands.texi (Interactive Codes):
(Keyboard Events):
(Misc Events):
(Classifying Events):
(Strings of Events): Prefer `keymap-set' instead of `define-key'
most places, and use `defvar-keymap' in some of the examples.
 2021-11-29 23:55:00 +01:00
Eli Zaretskii
4f47f10d9f Put back documentation of legacy keymap functions 
* doc/lispref/keymaps.texi (Low-Level Key Binding): Reinstate
documentation of legacy commands and functions.
 2021-11-16 19:14:04 +02:00
Eli Zaretskii
9e2f59132d Minor copyedits of recent documentation changes 
* doc/lispref/keymaps.texi (Low-Level Key Binding): Minor changes
in wording and markup.
 2021-11-16 16:17:10 +02:00
Lars Ingebrigtsen
331366395e Start adjusting the manuals to talk about the keymap-* functions 
* 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.
 2021-11-16 08:26:24 +01:00
Lars Ingebrigtsen
e36d3fc452 Support a new ["..."] key binding syntax 
* doc/lispref/keymaps.texi (Key Sequences):
(Changing Key Bindings): Document the various key syntaxes.

* lisp/emacs-lisp/byte-opt.el (byte-optimize-define-key)
(byte-optimize-define-keymap)
(byte-optimize-define-keymap--define): New functions to check and
expand ["..."] syntax at compile time.

* src/keymap.c (Fdefine_key): Understand the ["..."] syntax.
(syms_of_keymap): Define `kbd' symbols.
 2021-10-17 20:51:31 +02:00
Lars Ingebrigtsen
4c468c6b3c Add new function 'kbd-valid-p' 
* doc/lispref/keymaps.texi (Key Sequences): New function
'kbd-valid-p'.

* lisp/subr.el (kbd-valid-p): Document it.
 2021-10-16 17:50:40 +02:00
Lars Ingebrigtsen
74d3a1e7d6 Allow :keys in menus to be computed dynamically 
* doc/lispref/keymaps.texi (Extended Menu Items): Document it
(bug#28930).

* src/keyboard.c (parse_menu_item): Allow :keys to be a function.
 2021-10-11 13:15:41 +02:00
Lars Ingebrigtsen
4103123806 Change the call convention for `defvar-keymap' 
* doc/lispref/keymaps.texi (Changing Key Bindings): Adjust
documentation.

* lisp/simple.el (special-mode-map):
* lisp/net/shr.el (shr-map):
* lisp/net/eww.el (eww-link-keymap):
(eww-mode-map):
(eww-submit-map):
(eww-textarea-map):
(eww-bookmark-mode-map):
(eww-history-mode-map):
(eww-buffers-mode-map):
* lisp/gnus/message.el (message-mode-map):
* lisp/gnus/gnus-html.el (gnus-html-image-map):
* lisp/gnus/gnus-eform.el (gnus-edit-form-mode-map):
* lisp/gnus/gnus-dired.el (gnus-dired-mode-map):
* lisp/gnus/gnus-bookmark.el (gnus-bookmark-bmenu-mode-map):
Adjust usage of `defvar-keymap'.

* lisp/subr.el (define-keymap, define-keymap--define): Change how
these functions call each other.
(defvar-keymap): Change interface to be more like `define-keymap'.

* lisp/emacs-lisp/lisp-mode.el (lisp-indent--defvar-keymap): Remove.
(lisp-indent-function): Don't use it.
 2021-10-05 10:34:37 +02:00
Lars Ingebrigtsen
7b409dfe96 Remove :copy from define-keymap 
* doc/lispref/keymaps.texi (Changing Key Bindings): Update
documentation.

* lisp/subr.el (define-keymap):
(define-keymap--define): Remove :copy from the signature.

* lisp/net/eww.el (eww-link-keymap): Use :parent.
 2021-10-04 16:37:30 +02:00
Lars Ingebrigtsen
192f9357f2 Add 'define-keymap' and 'defvar-keymap' 
* doc/lispref/keymaps.texi (Changing Key Bindings): Document
define-keymap and defvar-keymap.

* lisp/subr.el (define-keymap): New function.
(define-keymap--define): New function.
(defvar-keymap): New macro.

* lisp/emacs-lisp/lisp-mode.el (lisp-indent--defvar-keymap): New
function.
(lisp-indent-function): Use it to indent defvar-keymap.
 2021-10-04 10:15:11 +02:00
Glenn Morris
6dabbddb5f Merge from origin/emacs-27 
7d5b973959 (origin/emacs-27) * doc/misc/cl.texi (For Clauses): Minor ...
4570781f8d ; * doc/lispref/files.texi (Directory Names): Add missing ...
1b52fd538d Minor update for make-tarball.txt
8efb8491b2 * doc/misc/cl.texi (Iteration Clauses): fix `never' clause...
0873134682 ; Fix Texinfo in last change to minibuf.texi.
cad8913c89 Improve filling-related documentation
2b7eed23eb ; * doc/lispref/keymaps.texi (Easy Menu): Fix typo.
47fc92cefc Fix reference to "yanking" in the main Emacs manual
1789dcdb35 Improve documentation of 'map-y-or-n-p'
 2021-04-25 09:16:09 -07:00
Philipp Stephani
2b7eed23eb ; * doc/lispref/keymaps.texi (Easy Menu): Fix typo. 2021-04-17 23:13:57 +02:00
Filipp Gunbin
468a00f380 * doc/lispref/keymaps.texi (Translation Keymaps): Fix small misprint 2021-04-13 20:07:20 +03:00
Stefan Kangas
a1c84b4308 Remove several references to Emacs 22 and earlier 
* admin/charsets/mapfiles/README:
* doc/emacs/custom.texi (Saving Customizations):
* doc/lispintro/emacs-lisp-intro.texi (Simple Extension):
* doc/misc/efaq-w32.texi (Location of init file):
* doc/misc/gnus-faq.texi (FAQ 1-3):
* doc/misc/gnus.texi (Top, Various, Image Enhancements):
* lisp/erc/erc-menu.el (menu):
* lisp/progmodes/cfengine.el (cfengine-fill-paragraph):
Remove some references to Emacs 22 and earlier.

* doc/lispref/buffers.texi:
* doc/lispref/eval.texi:
* doc/lispref/files.texi:
* doc/lispref/keymaps.texi:
* doc/lispref/loading.texi:
* doc/lispref/minibuf.texi:
* doc/lispref/positions.texi:
* doc/lispref/variables.texi: Remove comments about "Emacs 19
specific" features.
 2021-03-10 05:45:47 +01:00
Lars Ingebrigtsen
21e475ea0c Remove the 'M-o' ('facemap-keymap') binding experimentally 
* doc/lispref/maps.texi (Standard Keymaps):
* doc/lispref/keymaps.texi (Prefix Keys): Remove mentions.

* etc/facemenu-removal.txt: New temporary file.

* lisp/loadup.el: Don't load facemenu.el.
(removed-facemenu-command): New command.
(facemenu-keymap-restore): New function.

* lisp/textmodes/text-mode.el (center-paragraph): Remove binding.
(center-line): Remove binding.
 2021-02-10 19:38:18 +01:00
Lars Ingebrigtsen
3bbec2eb2b Fix up example in the Modifying Menus node in the lispref manual 
* doc/lispref/keymaps.texi (Modifying Menus): Make the second
example more regular (bug#14257).
 2021-01-20 04:17:41 +01:00
Paul Eggert
ba05d005e5 Update copyright year to 2021 
Run "TZ=UTC0 admin/update-copyright".
 2021-01-01 01:13:56 -08:00
Paul Eggert
8c1fe1e5ef Update copyright year to 2021 
Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
 2021-01-01 00:32:32 -08:00