aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Merge from origin/emacs-27Glenn Morris2020-06-074-90/+218
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 35661ef943 (origin/emacs-27) Fix typo in "(elisp) Type Keywords" 1af0e95fec Gnus nnir-summary-line-format has no effect dd366b5d3b Improve documentation of 'window-text-pixel-size' fbd49f969e * src/xdisp.c (Fwindow_text_pixel_size): Doc fix. (Bug#41... d8593fd19f Minor improvements to EDE and EIEIO manuals 3916e63f9e Have Fido mode also imitate Ido mode in ignore-case options cc35b197c7 Update package-menu-quick-help bf09106256 Improve documentation of 'sort-subr' 73749efa13 Update Ukrainian transliteration 30a7ee505a Fix Arabic shaping when eww/shr fill the text to be rendered 7d323f07c0 Silence some byte-compiler warnings in tests cf473e742f * test/lisp/battery-tests.el: New file. b07e3b1d97 Improve format-spec documentation (bug#41571) # Conflicts: # test/lisp/emacs-lisp/package-tests.el
| * 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)
| * Improve documentation of 'window-text-pixel-size'Eli Zaretskii2020-06-061-23/+32
| | | | | | | | | | * doc/lispref/display.texi (Size of Displayed Text): Clarify the description of 'window-text-pixel-size'.
| * Improve documentation of 'sort-subr'Eli Zaretskii2020-06-051-2/+9
| | | | | | | | | | * doc/lispref/text.texi (Sorting): Clarify the meaning and use of PREDICATE argument to 'sort-subr'. (Bug#41706)
| * Improve format-spec documentation (bug#41571)Basil L. Contovounesios2020-06-022-64/+176
| | | | | | | | | | | | | | | | | | * doc/lispref/text.texi (Interpolated Strings): Move from here... * doc/lispref/strings.texi (Custom Format Strings): ...to here, renaming the node and clarifying the documentation. (Formatting Strings): End node with sentence referring to the next one. * lisp/format-spec.el (format-spec): Clarify docstring.
* | Use 65535 as color-values scale value in the NS backendMattias Engdegård2020-06-071-3/+3
| | | | | | | | | | | | | | * src/nsfns.m (Fxw_color_values): Scale with 65535 instead of 65280, for uniformity with other backends. * lisp/faces.el (color-values): Update doc string. * doc/lispref/frames.texi (Color Names): Update examples.
* | Merge from origin/emacs-27Glenn Morris2020-05-285-13/+14
|\ \ | |/ | | | | | | | | | | | | | | bd7b681dc4 (origin/emacs-27) Tiny texinfo markup fixes d0dd0e0612 ; Fix more @var/@code mixups in Elisp manual 313dc0439e ; Fix another format-spec typo in the Elisp manual 9d7fd78421 Make next-error behavior a bit more flexible 0691d25295 * etc/NEWS.25: Belatedly announce upcase-dwim and downcase... df91c94ca8 Fix access to single-byte characters in buffer text
| * Tiny texinfo markup fixesGlenn Morris2020-05-274-3/+4
| | | | | | | | | | | | * doc/lispref/edebug.texi (Edebug Views): * doc/lispref/loading.texi (Library Search): * doc/lispref/os.texi (User Identification): Markup fixes.
| * ; Fix more @var/@code mixups in Elisp manualBasil L. Contovounesios2020-05-281-9/+9
| | | | | | | | | | * doc/lispref/text.texi (Replacing): Fix markup for function arguments.
| * ; Fix another format-spec typo in the Elisp manualBasil L. Contovounesios2020-05-271-1/+1
| | | | | | | | | | * doc/lispref/text.texi (Interpolated Strings): Correct markup for function argument.
* | Merge from origin/emacs-27Glenn Morris2020-05-281-7/+4
|\ \ | |/ | | | | | | | | | | e7a3ed8a6d Fix tab-bar-tab-name-ellipsis initialization 4737d0af75 Fix Elisp manual entry for format-spec 0195809bb6 Fix rare assertion violations in 'etags' cddb0079ff ; * lisp/format-spec.el (format-spec): Fix typo.
| * Fix Elisp manual entry for format-specBasil L. Contovounesios2020-05-241-7/+4
| | | | | | | | | | | | * doc/lispref/text.texi (Interpolated Strings): Fix typos. Don't document modifier for default space padding as it's redundant and inconsistent with the docstring and implementation of format-spec.
* | Merge from origin/emacs-27Glenn Morris2020-05-231-3/+3
|\ \ | |/ | | | | | | | | | | | | | | d6a0b66a0c (origin/emacs-27) * lisp/subr.el (save-match-data): Clarif... 1a6d59eeba Improve the documentation of setting up fontsets c7737d40f2 ; * etc/TODO (Ligatures): Update the entry based on recent... fb2e34cd21 ; * etc/TODO (Ligatures): Update the entry based on recent... 13b6dfd4f7 * doc/emacs/killing.texi (Rectangles): Improve indexing. a10254dd46 Fix accessing files on networked drives on MS-Windows
| * Improve the documentation of setting up fontsetsEli Zaretskii2020-05-231-3/+3
| | | | | | | | | | | | | | | | * doc/lispref/display.texi (Fontsets): Improve the accuracy of a cross-reference to "Character Properties". * doc/emacs/mule.texi (Fontsets, Modifying Fontsets): Improve the documentation of fontsets and how to modify them.
* | Merge from origin/emacs-27Glenn Morris2020-05-231-1/+1
|\ \ | |/ | | | | 8cc453d788 Second attempt at improving indexing in control.texi
| * Second attempt at improving indexing in control.texiStefan Kangas2020-05-211-1/+1
| | | | | | | | | | | | * doc/lispref/control.texi (Processing of Errors): Improve indexing by adding the word form "handle" in addition to "handling". With thanks to Eli Zaretskii.
* | Merge from origin/emacs-27Glenn Morris2020-05-237-85/+84
|\ \ | |/ | | | | | | | | | | 4b9fbdb5a7 ; Update TODO item about ligature support 03d44acfdd * doc/lispref/control.texi (Processing of Errors): Improve... b48ab743a8 Minor fixups for mutability doc 6ac2326e5b Don’t use “constant” for values you shouldn’t change
| * * doc/lispref/control.texi (Processing of Errors): Improve indexing.Stefan Kangas2020-05-191-0/+1
| |
| * Minor fixups for mutability docPaul Eggert2020-05-161-8/+7
| | | | | | | | | | * doc/lispref/objects.texi (Mutability): Minor fixups in response to a comment by Dmitry Gutov (Bug#40671#477).
| * Don’t use “constant” for values you shouldn’t changePaul Eggert2020-05-166-87/+86
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Inspired by patch proposed by Dmitry Gutov (Bug#40671#393) and by further comments by him and by Michael Heerdegen in the same bug report. * doc/lispintro/emacs-lisp-intro.texi (setcar): Don’t push mutability here. * doc/lispref/eval.texi (Self-Evaluating Forms, Quoting) (Backquote): * doc/lispref/lists.texi (Modifying Lists): * doc/lispref/objects.texi (Lisp Data Types, Mutability): * doc/lispref/sequences.texi (Array Functions, Vectors): * doc/lispref/strings.texi (String Basics, Modifying Strings): Don’t use the word “constant” to describe all values that a program should not change. * doc/lispref/objects.texi (Mutability): Rename from “Constants and Mutability”. All uses changed. In a footnote, contrast the Emacs behavior with that of Common Lisp, Python, etc. for clarity, and say the goal is to be nicer.
* | Merge from origin/emacs-27Glenn Morris2020-05-161-1/+9
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b4937f64cd (origin/emacs-27) Improve documentation of manually instal... efd4e973a4 Reflect the emacs-devel ELPA/MELPA dispute in FAQ 28541674cd Consider face inheritance when checking region face backgr... e75f6be6cc Fix dired default file operation (bug#41261) 406fb0746c Fix documentation related to 'command-switch-alist'. 747e0a2523 Improve ediff readability in misterioso theme (Bug#41221) 48830c73e7 Fix a crash in handle_display_spec a37290a6f9 In x_hide_tip reset tip_last_frame for GTK+ tooltips only ... 3d81995692 Fix docstring of flymake-make-diagnostic (bug#40351) 632aa9d57a Go back to “Bahá’í” e2406ff60f * lisp/dired.el (dired-toggle-marks): Doc fix. (Bug#41097) # Conflicts: # doc/emacs/building.texi
| * Fix documentation related to 'command-switch-alist'.Philipp Stephani2020-05-141-1/+9
| | | | | | | | | | | | | | | | | | | | | | | | While there, add a unit test to verify the behavior. * doc/lispref/os.texi (Command-Line Arguments): Fix documentation: the option string in 'command-switch-alist' does include leading hyphens. Also mention that 'command-switch-alist' parsing ignores equals signs in options. * test/lisp/startup-tests.el (startup-tests/command-switch-alist): New unit test.
* | Introduce process-file-return-signal-stringMichael Albinus2020-05-161-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/processes.texi (Synchronous Processes): Describe `process-file-return-signal-string'. * doc/misc/tramp.texi: Adapt Tramp and Emacs version numbers. (Remote processes): Describe `process-file-return-signal-string' and $INSIDE_EMACS. * etc/NEWS: Describe `process-file-return-signal-string'. Fix typos. * lisp/simple.el (process-file-return-signal-string): New user option. * lisp/net/tramp-adb.el (tramp-adb-handle-process-file): * lisp/net/tramp-sh.el (tramp-sh-handle-process-file): Use it. * lisp/net/tramp.el (tramp-get-signal-strings): New defun. * test/lisp/net/tramp-tests.el (tramp-test28-process-file): Adapt test.
* | Combine archive-int-to-mode and tar-grind-file-modebug27952_combine-tar-grind-file-mode_archive-int-to-modeTino Calancha2020-05-141-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a new function, file-modes-number-to-symbolic. Make archive-int-to-mode and obsolete alias of it; use it to define tar-grind-file-mode (Bug#27952). * lisp/files.el (file-modes-number-to-symbolic): New defun. * lisp/arc-mode.el (archive-int-to-mode): Make it an obsolete alias. * lisp/tar-mode.el (tar-grind-file-mode): Use file-modes-number-to-symbolic. * test/lisp/arc-mode-tests.el (arc-mode-test-archive-int-to-mode) * test/lisp/tar-mode-tests.el (tar-mode-test-tar-grind-file-mode): Update test. * test/lisp/files-tests.el (files-tests-file-modes-symbolic-to-number) (files-tests-file-modes-number-to-symbolic): New tests. * doc/lispref/files.texi (Changing Files): Document the new funtion. * etc/NEWS (Lisp Changes in Emacs 28.1): Announce it.
* | Base timer-list-mode on tabulated-list-mode (Bug#40854)Stefan Kangas2020-05-121-3/+3
| | | | | | | | | | | | | | | | * lisp/emacs-lisp/timer-list.el (list-timers) (timer-list-mode): Inherit from 'tabulated-list-mode' instead of 'special-mode' and make the necessary changes to support that. * doc/lispref/os.texi (Timers): Update documentation.
* | Consult browse-url-{default-,}handlers in drag&drop.Tassilo Horn2020-05-061-4/+6
| | | | | | | | | | | | | | | | | | * lisp/dnd.el (dnd-handle-one-url): Consult `browse-url-handlers' and `browse-url-default-handlers' for a matching handler. Adapt docstring. * doc/lispref/frames.texi (Drag and Drop): Remove the docs for the deprecated alist choice of `browse-url-browser-function' and mention `browse-url-handlers' and `browse-url-default-handlers'.
* | Merge from origin/emacs-27Glenn Morris2020-05-031-9/+9
|\ \ | |/ | | | | | | | | 0a3731feef Make memq etc. examples more like they were ed25282b82 Document effect of 'search-upper-case' on replacement comm... 5a5d8a8ec0 * lisp/desktop.el (desktop-save): Doc fix. (Bug#41007)
| * Make memq etc. examples more like they werePaul Eggert2020-05-021-9/+9
| | | | | | | | | | | | | | | | | | Problem reported by Štěpán Němec in: https://lists.gnu.org/r/emacs-devel/2020-05/msg00130.html * doc/lispref/lists.texi (Sets And Lists, Association Lists): Revert examples to be more like the way they were, using self-evaluating expressions. Be more consistent about listing unspecified results.
* | Merge from origin/emacs-27Glenn Morris2020-05-031-0/+8
|\ \ | |/ | | | | | | 1d477a0fec Recommend to avoid unnecessary abbreviations in doc aea1b4db72 Revert "Fix calculator division truncation (bug#40892)"
| * Recommend to avoid unnecessary abbreviations in docStefan Kangas2020-04-301-0/+8
| | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Recommend to avoid unnecessary abbreviations. (Bug#40011)
* | Regexps cannot infloop; fix manualMattias Engdegård2020-05-031-6/+4
| | | | | | | | | | * doc/lispref/searching.texi (Regexp Special): Edit erroneous statements about infinite looping in regexps.
* | Add lisp-data-mode for editing non-code Lisp dataJoão Távora2020-05-011-13/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Fixes: bug#40573 The new mode can be used stand-alone or inherited from by modes intended to edit programs. The existing emacs-lisp-mode and lisp-mode are examples. Thanks to Juri Linkov and Basil L. Contovounesios for researching some data files in Emacs that can be automatically set to use the new mode. * lisp/files.el (auto-mode-alist): Add entry for ".dir-locals" and ".dir-locals-2" * lisp/emacs-lisp/lisp-mode.el: (lisp-data-mode): New major mode. (lisp-mode): Inherit from lisp-data-mode. Set special lisp-mode stuff here. * lisp/progmodes/elisp-mode.el (emacs-lisp-mode): Inherit from lisp-data-mode. * lisp/bookmark.el (bookmark-insert-file-format-version-stamp): Use lisp-data-mode. * lisp/saveplace.el (save-place-alist-to-file): Use lisp-data-mode. * lisp/net/eww.el (eww-write-bookmarks): Use lisp-data-mode. * lisp/net/nsm.el (nsm-write-settings): Use lisp-data-mode. * lisp/net/tramp-cache.el (tramp-dump-connection-properties): Use lisp-data-mode. * etc/NEWS: Mention lisp-data-mode. * doc/lispref/modes.texi (Example Major Modes): Update example.
* | Add new function dom-remove-attributeLars Ingebrigtsen2020-04-301-0/+3
| | | | | | | | | | | | * doc/lispref/text.texi (Document Object Model): Document it. * lisp/dom.el (dom-remove-attribute): Add new function.
* | Merge from origin/emacs-27Glenn Morris2020-04-291-2/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2f9bfaef21 (origin/emacs-27) ; Fix last change 520fd3e728 * lisp/env.el (substitute-env-vars): Doc fix. (Bug#40948) 85544f8ef5 * lisp/isearch.el: Fix lazy-highlighting and lazy-counting... d83cc05a73 Fix error in ERC when 'erc-server-coding-system' is custom... 16fed05ba8 Avoid crashes on TTY frames with over-long compositions 0278741676 Fix typo in custom.texi 9f5ae717fb * test/lisp/simple-tests.el (with-shell-command-dont-erase... 1f76a16ed3 * lisp/image-mode.el (image-mode-map): Update menu items. f0e1bf56f0 Fix bugs in tab-bar and tab-line and mention remaining fea... f0b9f18457 Make shell-command tests fit for tcsh. 68f4a740a1 Remove doc duplication ac31cd384c * etc/NEWS: Fix inconsistencies. # Conflicts: # etc/NEWS
| * Remove doc duplicationPaul Eggert2020-04-251-2/+1
| | | | | | | | | | * doc/lispref/objects.texi (Constants and Mutability): Remove duplication. From a suggestion by Andreas Schwab (Bug#40671#150).
* | Merge from origin/emacs-27Glenn Morris2020-04-255-15/+30
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 45a64c97c7 (origin/emacs-27) Clarify semantics of trace-function CONT... 821760fdc4 Don't let a code literal get modified in mml parsing (Bug#... 74a92be16d * lisp/simple.el (kill-ring-save): Doc fix. (Bug#40797) 3d0e859692 Minor doc clarification regarding fringe bitmaps 4d86c7f822 Fix documentation of fringe bitmaps a76af88dd8 Tweak mutability doc a bit more f7e488d206 Calc: fix autoload errors (bug#40800) 369761b36d ; * src/xdisp.c: Improve the introductory commentary. a92ca1f177 Improve indexing of ELisp manual 5a25d17760 * lisp/image-mode.el (image-transform-resize): Remove FIXM... 37ebec3a95 Improve the default value of 'doc-view-ghostscript-program'. ba6104d1e8 Change doc-view-mode-map prefix key 's' to 'c'. 400ff5cd19 Improve wording about constants d2836fe71b Improve the default value of 'doc-view-ghostscript-program'. fc55f65305 Minor improvements in documentation of the last change a64da75961 Add image-auto-resize defcustoms to image-mode.el 692ad40539 Improve the documentation of tab-bar and tab-line # Conflicts: # etc/NEWS
| * Minor doc clarification regarding fringe bitmapsClément Pit-Claudel2020-04-251-1/+2
| | | | | | | | | | | | * doc/lispref/display.texi (Customizing Bitmaps): Add a note regarding the order of bits being the opposite of that in XBM images. (Bug#40784)
| * Fix documentation of fringe bitmapsEli Zaretskii2020-04-251-3/+4
| | | | | | | | | | * doc/lispref/display.texi (Fringe Bitmaps): The 'empty-line' fringe indicator _is_ used. (Bug#40799)
| * Tweak mutability doc a bit morePaul Eggert2020-04-241-2/+2
| | | | | | | | | | Inspired by a comment from Michael Heerdegen (Bug#40671#114). * doc/lispref/objects.texi (Constants and Mutability): Tweak further.
| * Improve indexing of ELisp manualStefan Kangas2020-04-241-0/+1
| | | | | | | | * doc/lispref/tips.texi (Tips): Add index entry 'best practices'.
| * Improve wording about constantsPaul Eggert2020-04-223-11/+23
| | | | | | | | | | | | | | | | Thanks to Štěpán Němec and Drew Adams for reviews of recent changes. * doc/lispref/eval.texi (Quoting): Give an example. * doc/lispref/lists.texi (Association Lists): Simplify example code. * doc/lispref/objects.texi (Lisp Data Types) (Constants and Mutability): Clarify wording.
* | Merge from origin/emacs-27Glenn Morris2020-04-2016-126/+205
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 05089a4d65 (origin/emacs-27) Tweak wording re constant variables a1040861f1 Tweak setcar-related wording 751510f865 * lisp/image-mode.el: Add prefix key 's' and reduce depend... 9261a219ec * doc/emacs/windows.texi (Window Convenience): Decribe mor... e1d42da0d6 Fix mutability glitches reported by Drew Adams 5805df74f5 Improve mutability doc dca35b31d0 Improve mutability documentation 81e7d7f111 Document that quoting yields constants 5734339f40 * doc/lispref/keymaps.texi (Extended Menu Items, Easy Menu... 14a570afae Remove #' and function quoting from lambda forms in manual d5ec18c66b * src/regex-emacs.c (re_match_2_internal): Rework comment ... 4df8a61117 Add new node "Image Mode" to Emacs Manual. d7d5ee6c57 ; Fix a typo in cmdargs.texi (bug#40701) 5e9db48fbe * doc/lispref/display.texi (Customizing Bitmaps): Fix typo. eebfb72c90 Document constant vs mutable objects better 6c187ed6b0 Improve documentation of 'sort-lines' 52288f4b66 Mention 'spam-stat-process-directory-age' in the documenta... 067b070598 ; Fix some typos and doc issues (bug#40695) # Conflicts: # etc/NEWS
| * Tweak wording re constant variablesPaul Eggert2020-04-191-1/+2
| | | | | | | | | | * doc/lispref/objects.texi (Constants and Mutability): Tweak. Problem reported by Michael Heerdegen (Bug#40693#44).
| * Tweak setcar-related wordingPaul Eggert2020-04-191-1/+1
| | | | | | | | | | | | | | * doc/lispref/eval.texi (Self-Evaluating Forms): Change “primitives” to “operations”. Problem reported by Štěpán Němec in: https://lists.gnu.org/r/emacs-devel/2020-04/msg01146.html
| * Fix mutability glitches reported by Drew AdamsPaul Eggert2020-04-192-8/+10
| | | | | | | | | | | | | | | | | | | | See Bug#40693#32. * doc/lispref/eval.texi (Self-Evaluating Forms, Backquote): Say that these yield constant conses, vectors and strings, not constant symbols. * doc/lispref/objects.texi (Constants and Mutability): Say that an attempt to modify a constant variable signals an error, instead of saying that it has undefined behavior.
| * Improve mutability docPaul Eggert2020-04-192-15/+15
| | | | | | | | | | | | | | | | | | | | See Eli Zaretskii’s suggestions (Bug#40671#33). * doc/lispref/lists.texi (Setcar, Setcdr, Rearrangement): * doc/lispref/sequences.texi (Sequence Functions) (Array Functions): Add commentary to examples. * doc/lispref/lists.texi (Sets And Lists): Revert change to delq example.
| * Improve mutability documentationPaul Eggert2020-04-196-13/+67
| | | | | | | | | | | | | | | | | | | | | | | | | | This change was inspired by comments from Štěpán Němec in: https://lists.gnu.org/r/emacs-devel/2020-04/msg01063.html * doc/lispref/objects.texi (Lisp Data Types): Mention mutability. (Constants and mutability): New section. * doc/lispintro/emacs-lisp-intro.texi (Lists diagrammed) (Indent Tabs Mode): Improve wording. * doc/lispref/eval.texi (Self-Evaluating Forms): Say that they return constants. * doc/lispref/lists.texi (Sets And Lists): Fix memql mistake/confusion that I recently introduced.
| * Document that quoting yields constantsPaul Eggert2020-04-191-1/+7
| | | | | | | | | | * doc/lispref/eval.texi (Quoting, Backquote): Mention that quoted expressions yield a constant (Bug#40693).
| * * doc/lispref/keymaps.texi (Extended Menu Items, Easy Menu) <:key-sequence>:Stefan Monnier2020-04-191-14/+11
| | | | | | | | Clarify the documentation further
| * Remove #' and function quoting from lambda forms in manualMattias Engdegård2020-04-197-50/+47
| | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/abbrevs.texi (Abbrev Expansion): * doc/lispref/backups.texi (Reverting): * doc/lispref/functions.texi (Mapping Functions): * doc/lispref/help.texi (Accessing Documentation): * doc/lispref/sequences.texi (Char-Tables): * doc/lispref/syntax.texi (Categories): * doc/lispref/text.texi (Sorting): Remove function quoting from lambda in examples where it still occurs, since examples should follow our best style and be consistent.