aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Remove comment about commandscratch/commandLars Ingebrigtsen2021-02-141-6/+0
|
* Experiment with a mode-base `declare'Lars Ingebrigtsen2021-02-131-0/+3
|
* Change command to interactive ... modesLars Ingebrigtsen2021-02-132-14/+18
|
* Add support for marking autoloads with modes and also declare completionLars Ingebrigtsen2021-02-122-0/+10
|
* Make it possible to have derived modes be non-interactiveLars Ingebrigtsen2021-02-111-0/+5
|
* Add support for the new `command' special formLars Ingebrigtsen2021-02-111-0/+18
|
* Remove the 'M-o' ('facemap-keymap') binding experimentallyLars Ingebrigtsen2021-02-102-9/+0
| | | | | | | | | | | | | | * 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.
* Allow exit-minibuffer to be called from Lisp code. Fixes bug #46373Alan Mackenzie2021-02-091-1/+1
| | | | | | | | | * lisp/minibuffer.el (exit-minibuffer): Throw the error "Not in most nested minibuffer" only when the current buffer is a minibuffer (thus the command came directly from a key binding). * doc/lispref/minibuf.texi (Minibuffer Commands): Change the documentation accordingly.
* Move line-number-at-pos to CLars Ingebrigtsen2021-02-071-10/+8
| | | | | | | | | | | | | * doc/lispref/positions.texi (Text Lines): Revert previous change. * lisp/simple.el (line-number-at-pos): Remove definition. * lisp/simple.el (count-lines): Revert back to using `forward-line', because there seems to be a disagreement on how lines should be counted in a region... * src/fns.c (Fline_number_at_pos): Rename from Fline_number_at_position and adjust parameter list.
* Add a new function 'line-number-at-position'Lars Ingebrigtsen2021-02-071-8/+10
| | | | | | | | | * doc/lispref/positions.texi (Text Lines): Document it. * lisp/simple.el (count-lines): Use it. (line-number-at-pos): Ditto. * src/fns.c (Fline_number_at_position): New function (bug#22763).
* Clarify that #s(hash-table ...) doesn't always create a new hash tableLars Ingebrigtsen2021-02-072-9/+15
| | | | | | | | * doc/lispref/hash.texi (Creating Hash): Note that the printed representation doesn't necessarily create a new table (bug#23417). * doc/lispref/lists.texi (Rearrangement): Link to Self-Evaluating Forms to further expand upon immutability.
* Permit zero value for 'child-frame-border-width' parameter (Bug#46184)Martin Rudalics2021-02-061-0/+2
| | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/frames.texi (Layout Parameters): Update entry on 'child-frame-border-width' parameter. * src/frame.c (make_frame): Init child_frame_border_width to -1. (Fframe_child_frame_border_width): Return internal border width if child frame border width parameter is nil. (gui_report_frame_params): Report nil as child frame border width parameter if the frame value is negative. * src/frame.h (FRAME_INTERNAL_BORDER_WIDTH): Return value of child frame border width only if it is not negative. * src/xfns.c (Fx_create_frame): Default child frame border to -1 when recording it in its frame slot via gui_default_parameter. * src/nsfns.m (ns_set_child_frame_border_width): Handle nil ARG. (Fx_create_frame): Default child frame border width parameter to nil. * src/w32fns.c (w32_set_child_frame_border_width): Handle nil ARG. (Fx_create_frame): Default child frame border width parameter to nil. * src/xfns.c (x_set_child_frame_border_width): Handle nil ARG. (Fx_create_frame): Default child frame border width parameter to nil.
* Merge from origin/emacs-27Glenn Morris2021-02-061-4/+5
|\ | | | | | | | | | | | | | | | | | | 8ad48a0bdd (origin/emacs-27) Improve doc string of 'text-scale-adjust' 7a25ff767d Clarify the indent-rigidly doc string 6c5ddf0e0b Fix two small tab bar issues c71e08eba9 Fix last change in syntax.texi # Conflicts: # lisp/indent.el
| * Fix last change in syntax.texiEli Zaretskii2021-02-051-4/+5
| | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Fix wording in last change. (Bug#46274)
| * Correct the lispref manual about flushing ppss infoLars Ingebrigtsen2021-02-051-4/+4
| | | | | | | | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Correct the information about flushing the state by copying the text from the doc string (bug#46274). (cherry picked from commit ff701ce2b261acce1dfcd1fe137268d87d5eab35)
| * Clarify the "Sentinels" node in the lispref manualLars Ingebrigtsen2021-02-041-1/+5
| | | | | | | | | | | | | | * doc/lispref/processes.texi (Sentinels): Mention "run" and that the strings can be anything (bug#30461). (cherry picked from commit 859a4cb6b22f75a3456e29d08fcfe9b8940fbe8b)
* | Correct the lispref manual about flushing ppss infoLars Ingebrigtsen2021-02-051-4/+4
| | | | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Correct the information about flushing the state by copying the text from the doc string (bug#46274).
* | Allow a :variable keyword in define-globalized-minor-modeLars Ingebrigtsen2021-02-041-0/+5
| | | | | | | | | | | | | | * doc/lispref/modes.texi (Defining Minor Modes): Document it. * lisp/emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Allow specifying a :variable to be used if the underlying mode has a divergent variable to store the state (bug#29081).
* | Clarify the "Sentinels" node in the lispref manualLars Ingebrigtsen2021-02-041-1/+5
| | | | | | | | | | * doc/lispref/processes.texi (Sentinels): Mention "run" and that the strings can be anything (bug#30461).
* | Allow the caller to specify own face on suffix in annotation-functionJuri Linkov2021-01-301-5/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/minibuffer.el (completion--insert-strings): Don't add 'completions-annotations' face when the caller specified own face in annotation-function. Remove no-op code for 'unless prefix' branch. (completion-metadata, completion-extra-properties): Update docs of affixation-function. Suggested by Clemens <clemera@posteo.net> (bug#45780) * test/lisp/minibuffer-tests.el: Rename package name from completion-tests.el to minibuffer-tests.el. Add new test completion--insert-strings-faces. * doc/lispref/minibuf.texi (Completion Variables) (Programmed Completion): Update descriptions of annotation-function and affixation-function.
* | Improve :foreground description in the manualLars Ingebrigtsen2021-01-301-1/+1
| | | | | | | | | | * doc/lispref/frames.texi (Font and Color Parameters): Make the description less confusing (bug#38710).
* | Describe pointer shapes in the manualLars Ingebrigtsen2021-01-291-4/+25
| | | | | | | | | | * doc/lispref/frames.texi (Pointer Shape): Describe what the typical pointer shapes are (and add `nhdrag') (bug#39246).
* | Merge from origin/emacs-27Glenn Morris2021-01-271-2/+15
|\ \ | |/ | | | | 3443a1c698 Fix last change
| * Fix last changeEli Zaretskii2021-01-231-2/+15
| | | | | | | | | | | | | | * doc/lispref/text.texi (Undo): Add a cross-reference to the description of 'undo-amalgamate-change-group'. (Atomic Changes): Expand and improve the description of 'undo-amalgamate-change-group'. (Bug#42303)
| * Mention undo-amalgamate-change-group in the lispref manualLars Ingebrigtsen2021-01-231-0/+5
| | | | | | | | | | | | | | * doc/lispref/text.texi (Atomic Changes): Mention undo-amalgamate-change-group (bug#42303). (cherry picked from commit ba25a82855a2c03c25fec83f3056c166b692e94f)
* | Fix typos and punctuationEli Zaretskii2021-01-261-5/+5
| | | | | | | | | | | | | | * src/w32fns.c: * src/frame.h: * doc/lispref/frames.texi (Frame Layout): * etc/NEWS: Fix typos and punctuation in recent changes.
* | Add distinct controls for child frames' borders (Bug#45620)Alexander Miller2021-01-261-3/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The background of the 'child-frame-border' face instead of the 'internal-border' face now controls the color of child frames' borders. The 'child-frame-border-width' frame parameter is now used for the width of child frames' borders instead of internal-border-width', though we still fall back on using the latter if the former is not set. * doc/lispref/frames.texi (Frame Layout): Mention 'child-frame-border' and 'child-frame-border-width'. (Layout Parameters): Mention 'child-frame-border-width'. * etc/NEWS: Mention new face 'child-frame-border' and frame parameter 'child-frame-border-width'. * lisp/faces.el (child-frame-border): New face. * src/dispextern.h (enum face_id): Add CHILD_FRAME_BORDER_FACE_ID. * src/frame.c (Fframe_child_frame_border_width): New function. (gui_report_frame_params): Add entry for Qchild_frame_border_width. * src/frame.h (struct frame): New slot child_frame_border_width. (FRAME_CHILD_FRAME_BORDER_WIDTH): New inlined function. * src/nsfns.m (ns_set_child_frame_border_width): New function. (Fx_create_frame): Handle Qchild_frame_border_width parameter. (ns_frame_parm_handlers): Add ns_set_child_frame_border_width. * src/nsterm.m (ns_clear_under_internal_border): Handle CHILD_FRAME_BORDER_FACE_ID. * src/w32fns.c (w32_clear_under_internal_border): Handle CHILD_FRAME_BORDER_FACE_ID. (w32_set_internal_border_width): New function. (Fx_create_frame): Handle Qchild_frame_border_width parameter. (w32_frame_parm_handlers): Add w32_set_child_frame_border_width. * src/xfaces.c (lookup_basic_face, realize_basic_faces): Handle CHILD_FRAME_BORDER_FACE_ID. * src/xfns.c (x_set_child_frame_border_width): New function. (Fx_create_frame): Handle Qchild_frame_border_width parameter. (x_frame_parm_handlers): Add x_set_child_frame_border_width. * src/xterm.c (x_clear_under_internal_border) (x_after_update_window_line): Handle CHILD_FRAME_BORDER_FACE_ID.
* | Add a mechanism for buffer-local thing-at-pointsLars Ingebrigtsen2021-01-231-0/+19
| | | | | | | | | | | | | | * doc/lispref/text.texi (Buffer Contents): Document it. * lisp/thingatpt.el (thing-at-point-provider-alist): New variable. (thing-at-point): Use it.
* | Mention undo-amalgamate-change-group in the lispref manualLars Ingebrigtsen2021-01-221-0/+5
| | | | | | | | | | * doc/lispref/text.texi (Atomic Changes): Mention undo-amalgamate-change-group (bug#42303).
* | Fix up example in the Modifying Menus node in the lispref manualLars Ingebrigtsen2021-01-201-3/+2
| | | | | | | | | | * doc/lispref/keymaps.texi (Modifying Menus): Make the second example more regular (bug#14257).
* | Mention that the mouse will switch on transient-mark-mode in manualLars Ingebrigtsen2021-01-201-1/+3
| | | | | | | | | | * doc/lispref/markers.texi (The Mark): Mention that the mouse will enable the `(only)' transient mark mode (bug#14945).
* | Add a bit more clarification around standard error processes.Philipp Stephani2021-01-171-1/+26
| | | | | | | | | | | | | | * doc/lispref/processes.texi (Asynchronous Processes): Document how to obtain the standard error process that Emacs creates. (Accepting Output): Add an example how to wait for standard error in case Emacs has created a standard error process.
* | * lisp/emacs-lisp/pcase.el: Add support for `not` to `pred`Stefan Monnier2021-01-161-2/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | (pcase--split-pred, pcase--funcall): Adjust for `not`. (pcase--get-macroexpander): New function. (pcase--edebug-match-macro, pcase--make-docstring) (pcase--macroexpand): Use it. * lisp/emacs-lisp/radix-tree.el (radix-tree-leaf): Use it! * doc/lispref/control.texi (The @code{pcase} macro): Document it. * lisp/emacs-lisp/ert.el (ert--explain-equal-rec): Remove redundant test.
* | Make libraries works with xterm-mouse-mode.Jared Finder2021-01-151-2/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Change calls from 'read-event' to 'read-key' in libraries expecting mouse events. Do this only when 'xterm-mouse-mode' is enabled. That way those libraries read decoded mouse events instead of the underlying escape sequence. Add a parameter to 'read-key' that avoids running any of the unbound fallbacks in 'read-key-sequence' so the libraries can read mouse button-down events. For backward compatibility purposes, the above logic is contained in a new internal-only function: 'read--potential-mouse-event'. * doc/lispref/commands.texi (Reading One Event): Document new parameter to 'read-key'. Mention that non-character events on terminals need 'read-key'. * lisp/subr.el (read-key-full-map): Add new keymap used by 'read-key'. (read-key): Add new parameter 'fallbacks-disabled' to prevent running any of the unbound fallbacks normally run by 'read-key-sequence'. (read--potential-mouse-event): Add new function that calls 'read-key' or 'read-event' depending on if 'xterm-mouse-mode' is set. * lisp/foldout.el (foldout-mouse-swallow-events): * lisp/isearch.el (isearch-pre-command-hook): * lisp/mouse-drag.el (mouse-drag-throw, mouse-drag-drag): * lisp/mouse.el (mouse-drag-secondary): * lisp/ruler-mode.el (ruler-mode-mouse-grab-any-column) (ruler-mode-mouse-drag-any-column-iteration): * lisp/strokes.el (strokes-read-stroke, strokes-read-complex-stroke): * lisp/textmodes/artist.el (artist-mouse-draw-continously) (artist-mouse-draw-poly, artist-mouse-draw-2points): * lisp/vc/ediff-wind.el (ediff-get-window-by-clicking): * lisp/wid-edit.el (widget-button--check-and-call-button) (widget-button-click): Call 'read--potential-mouse-event' instead of 'read-event'. * lisp/wid-edit.el (widget-key-sequence-read-event): Call 'read-key' with 'fallbacks-disabled' set instead of 'read-event'. Unlike above changes, this is unconditionally applied so it works for function keys too. Apply 'local-function-key-map' instead of 'function-key-map' as that contains the full terminal translations. * lisp/vc/ediff.el (ediff-windows): Use 'display-mouse-p' to check if a mouse is available. * src/lread.c (Fread_event): Recommend 'read-key' in docstring for 'read-event' for non-character events.
* | Merge from origin/emacs-27Glenn Morris2021-01-141-1/+1
|\ \ | |/ | | | | | | | | | | 149d64bbb2 * doc/misc/tramp.texi (Quick Start Guide): Fix thinko. 97747e6fb9 Tell people how to remove fontconfig customizations 33d0c603c6 ; * doc/lispref/modes.texi (SMIE Indentation Example): Fix... 03080b5545 Remove extraneous closing paren
| * ; * doc/lispref/modes.texi (SMIE Indentation Example): Fix previous commitSimen Heggestøyl2021-01-051-2/+2
| |
| * Remove extraneous closing parenSimen Heggestøyl2021-01-041-1/+1
| | | | | | | | | | * doc/lispref/modes.texi (SMIE Indentation Example): Remove extraneous closing paren.
* | Add a new variable `inhibit-interaction'Lars Ingebrigtsen2021-01-123-0/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/elisp.texi (Top): Add a link. * doc/lispref/errors.texi (Standard Errors): Mention the new error. * doc/lispref/minibuf.texi (Minibuffers): Add a link. (Inhibiting Interaction): New node. * src/data.c (syms_of_data): Define the `inhibited-interaction' error. * src/lisp.h: Export the barfing function. * src/lread.c (Fread_char, Fread_event, Fread_char_exclusive): Barf if inhibited. * src/minibuf.c (barf_if_interaction_inhibited): New function. (Fread_from_minibuffer, Fread_no_blanks_input): Barf if inhibited. (syms_of_minibuf): Define the `inhibit-interaction' variable.
* | Fix incompleteness in the implementation of minibuffer-follows-selected-frameAlan Mackenzie2021-01-101-9/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In particular, add a new value to the variable, and fix several bugs apparent with the implementation up till now. * doc/emacs/mini.texi (Basic Minibuffer): Add a description of the new non-nil, non-t value of minibuffer-follows-selected-frame. * doc/emacs/trouble.texi (Quitting): Add a description of how C-g handles recursive minibuffers when typed in one which isn't the most nested. * doc/lispref/minibuf.texi (Intro to Minibuffers): Add an @dfn for "active minibuffer". (Minibuffer Commands): Document that exit-minibuffer throws an error when not invoked from the innermost Minibuffer. (Recursive Mini): Amend the description of the visibility of outer level minibuffers. (Minibuffer Misc): In the description of the minibuffer hooks, replace "the minibuffer" with "a minibuffer". * etc/NEWS (Entry announcing minibuffer-follows-selected-frame): Add a description of the new non-nil, non-t value. * lisp/cus-start.el (top level): make the customize entry for minibuffer-follows-selected-frame a choice between three entries. * lisp/minibuffer.el (exit-minibuffer): throw an error when we're not in the most nested minibuffer. (top level): Bind C-g to abort-minibuffers in minibuffer-local-map. * lisp/window.el (window-deletable-p): return the symbol `frame' when (amongst other things) minibuffer-follows-selected-frame is t. * src/eval.c (internal_catch): Add a mechanism to (throw 'exit t) repeatedly when the throw currently being processed doesn't terminate the current minibuffer. * src/lisp.h (this_minibuffer_depth): New extern declaration (minibuf_level): extern declaration moved here from window.h. * src/minibuf.c (minibuffer_follows_frame, minibuf_stays_put) (minibuf_moves_frame_when_opened): New and amended functions to query the value of minibuffer-follows-selected-frame. (choose_minibuf_frame): check (minibuf > 1) in place of (minibufer > 0) at a particular place. At another place, check that an alleged frame is so and is live. Before selecting a non-miniwindow on a different frame, ensure it really is a different frame. (move_minibuffer_onto_frame): Stack up all recursive minibuffers on the target frame. Check the minibuf_window isn't in the old frame before setting that frame's miniwindow to an inactive minibuffer. (Finnermost_minibuffer_p, Fabort_minibuffers): New primitives. (this_minibuffer_depth): New function. (read_minibuf): Record the calling frame in a variable, and switch back to it after the recursive edit has terminated normally, using select-frame-set-input-focus. Stack up all the recursive minibuffers on the miniwindow where a new minibuffer is being opened. After the recursive edit, switch the selected window away from the expired minibuffer's window. (nth_minibuffer): New function. (minibuffer-follows-selected-frame): Change from a DEFVAR_BOOL to a DEFVAR_LISP. * src/window.c (decode_next_window_args): Set *minibuf to w's mini-window's content when that content is a minibuffer. * src/window.h (minibuf_level) Declaration moved from here to lisp.h.
* | Add support for flat buttonsPedro Andres Aranda Gutierrez2021-01-101-8/+9
| | | | | | | | | | | | | | * src/xfaces.c (Finternal_set_lisp_face_attribute): (realize_gui_face): Add support for `flat-button' (bug#45735). Copyright-paperwork-exempt: yes
* | Add a display-buffer window selection function that's more like XEmacsLars Ingebrigtsen2021-01-071-0/+6
| | | | | | | | | | | | | | | | | | | | * doc/lispref/windows.texi (Buffer Display Action Functions): Document it. * lisp/window.el (display-buffer--action-function-custom-type): Add. (display-buffer): Mention it. (display-buffer-use-least-recent-window): New function (bug#45688). * src/window.c (Fwindow_bump_use_time): New function.
* | Pretty-print keys without <> around modifiers (bug#45536)Mattias Engdegård2021-01-053-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Be consistent when pretty-printing keys: put modifiers outside <>, thus the more logical C-M-<return> instead of <C-M-return>. * src/keymap.c (Fsingle_key_description): Skip modifier prefix before adding <>. * doc/lispref/help.texi (Describing Characters): Update example. * doc/lispref/debugging.texi (Backtraces): * doc/lispref/minibuf.texi (Text from Minibuffer): Use @kbd instead of @key. * etc/NEWS: Announce the change. * test/src/keymap-tests.el (keymap--key-description): * test/lisp/subr-tests.el (subr--kbd): New tests.
* | Merge from origin/emacs-27Glenn Morris2021-01-041-3/+3
|\ \ | |/ | | | | a7c2793efe Fix last change
| * Fix last changeEli Zaretskii2021-01-021-3/+3
| | | | | | | | | | * doc/lispref/strings.texi (Creating Strings): Improve wording of last change. (Bug#45516)
| * Add a reference between the Strings node and Search/ReplaceLars Ingebrigtsen2021-01-021-1/+4
| | | | | | | | | | | | | | * doc/lispref/strings.texi (Creating Strings): Mention string-replace/replace-regexp-in-string (bug#45516). (cherry picked from commit b9359d4183a1a6923122d3aa12b922ab89693354)
* | * doc/lispref/syntax.texi (Syntax Class Table): Clarify `@`Stefan Monnier2021-01-031-1/+1
| |
* | Merge from origin/emacs-27Paul Eggert2021-01-011-1/+1
|\ \ | |/ | | | | 33d159c36f Fix copyright years by hand
| * Fix copyright years by handPaul Eggert2021-01-011-1/+1
| | | | | | | | These are dates that admin/update-copyright did not update.
| * Update copyright year to 2021Paul Eggert2021-01-0156-56/+56
| | | | | | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* | Merge from origin/emacs-27Paul Eggert2021-01-011-1/+2
|\ \ | |/ | | | | | | | | 74a77ef299 Improve documentation of 'network-lookup-address-info' c6d5555646 Display messages sent using ERC's /say c156723769 Fix Rmail summary display when From: header is malformed
generated by cgit v1.2.1 (git 2.18.0) at 2026-03-05 20:31:48 +0000