summaryrefslogtreecommitdiff
path: root/doc/lispintro
Commit message (Collapse)AuthorAgeFilesLines
* Abolish max-specpdl-size (bug#57911)Mattias Engdegård2022-09-191-3/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The max-lisp-eval-depth limit is sufficient to prevent unbounded stack growth including the specbind stack; simplify matters for the user by not having them to worry about two different limits. This change turns max-specpdl-size into a harmless variable with no effects, to keep existing code happy. * lisp/subr.el (max-specpdl-size): Define as an ordinary (but obsolete) dynamic variable. * admin/grammars/Makefile.in: * doc/lispintro/emacs-lisp-intro.texi (Loops & Recursion): * doc/lispref/control.texi (Cleanups): * doc/lispref/edebug.texi (Checking Whether to Stop): * doc/lispref/eval.texi (Eval): * doc/lispref/variables.texi (Local Variables): * doc/misc/calc.texi (Recursion Depth): Update documentation. * etc/NEWS: Announce. * src/eval.c (FletX): Use safe iteration to guard against circular bindings list. (syms_of_eval): Remove old max-specpdl-size definition. (init_eval_once, restore_stack_limits, call_debugger) (signal_or_quit, grow_specpdl_allocation): * leim/Makefile.in: * lisp/Makefile.in: * lisp/calc/calc-stuff.el (calc-more-recursion-depth) (calc-less-recursion-depth): * lisp/calc/calc.el (calc-do): * lisp/cedet/semantic/ede-grammar.el (ede-proj-makefile-insert-rules): * lisp/cedet/semantic/grammar.el (semantic-grammar-batch-build-one-package): * lisp/cus-start.el (standard): * lisp/emacs-lisp/comp.el (comp--native-compile): * lisp/emacs-lisp/edebug.el (edebug-max-depth): (edebug-read-and-maybe-wrap-form, edebug-default-enter): * lisp/emacs-lisp/regexp-opt.el (regexp-opt): * lisp/eshell/esh-mode.el (eshell-mode): * lisp/loadup.el (max-specpdl-size): * lisp/mh-e/mh-e.el (mh-invisible-headers): * lisp/net/shr.el (shr-insert-document, shr-descend): * lisp/play/hanoi.el (hanoi-internal): * lisp/progmodes/cperl-mode.el: * src/fileio.c (Fdo_auto_save): Remove references to and modifications of max-specpdl-size.
* Merge from origin/emacs-28Stefan Kangas2022-08-171-1/+1
|\ | | | | | | | | | | a4078fa628 ; * lisp/vc/ediff.el: Improve wording in last change. dd077ebded Revert "; * doc/lispintro/emacs-lisp-intro.texi: Fix typo." 362c9ab879 * doc/misc/gnus.texi (Article Washing): Fix Links URL.
| * Revert "; * doc/lispintro/emacs-lisp-intro.texi: Fix typo."Stefan Kangas2022-08-161-1/+1
| | | | | | | | | | | | This reverts commit 9d0dba44da7ac83d018fff3c26d33dac12ebd806. This was not a typo, but incorrectly matching parens in Info-mode.
* | Merge from origin/emacs-28Stefan Kangas2022-08-151-1/+1
|\| | | | | | | | | 9d0dba44da ; * doc/lispintro/emacs-lisp-intro.texi: Fix typo. 0e336fa51f ; Improve documentation of minibuffer history wrt completion
| * ; * doc/lispintro/emacs-lisp-intro.texi: Fix typo.Stefan Kangas2022-08-141-1/+1
| |
* | Don't use obsolete library as example in Elisp IntroStefan Kangas2022-08-141-21/+7
| | | | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Several files recursively) (Sorting, Files List): Don't use obsolete library makesum.el as example.
* | Merge from origin/emacs-28Stefan Kangas2022-08-131-15/+2
|\| | | | | | | | | | | 72fc7258bf Delete references to deleted library hilit19.el e746fc2e7b Delete stale comments from Lisp Intro manual 77613b9217 ; Delete redundant installation instructions from ebnf2ps.el
| * Delete stale comments from Lisp Intro manualStefan Kangas2022-08-121-15/+2
| | | | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Args as Variable or List) (print-elements-of-list, Miscellaneous): Delete some references to Emacs 22.
* | Change current-time back to list formPaul Eggert2022-04-281-3/+6
| | | | | | | | | | | | | | | | | | | | | | Change current-time and related functions back to using the traditional list form. Also, add a new boolean variable current-time-list that lets people try out (TICKS . HZ) form, with the goal of smoothing the transition. * src/timefns.c (CURRENT_TIME_LIST): Change default back to true. (current-time-list): New boolean Lisp variable, which defaults to CURRENT_TIME_LIST. All uses of CURRENT_TIME_LIST changed to use current_time_list, and all documentation changed.
* | Use (TICKS . HZ) for current-time etc.Paul Eggert2022-04-251-3/+3
| | | | | | | | | | * src/timefns.c (CURRENT_TIME_LIST): Change default to false. All documentation changed.
* | Make the eintr.html target match what's on the webLars Ingebrigtsen2022-02-072-4/+2
| | | | | | | | | | | | * doc/lispintro/Makefile.in (HTML_TARGETS, eintr.html): Make the name match the URL at https://www.gnu.org/software/emacs/manual/eintr.html (bug#38817).
* | Merge from origin/emacs-28Eli Zaretskii2022-01-0114-14/+14
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-0114-14/+14
| |
* | ; Fix spelling; be consistent with "key binding" (Bug#52674)Stefan Kangas2021-12-211-22/+22
| |
* | Cleanup append-to-buffer section in ELisp IntroYugaEgo2021-12-181-98/+49
| | | | | | | | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (append-to-buffer, Buffer Related Review, fwd-para let): Finalize shifting focus of the 'let*' introduction to the 'append-to-buffer' section. Improve wording, fix typos, remove redundant comments (Bug#8275).
* | Merge from origin/emacs-28Stefan Kangas2021-12-011-1/+2
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e632b83a28 Update authors.el for Emacs 28 e9fdb11903 ; * ChangeLog.3: Some additional fixes. 8fa4749df1 ; * ChangeLog.3: Filename fixes. ea5a90b4f4 * lisp/repeat.el: Fix long-standing problem when a random ... ef4954b69c * lisp/repeat.el (repeat-keep-prefix): Change default to nil. 6d5886e780 * test/lisp/repeat-tests.el (repeat-tests-call-b): Test fo... 9e16c6a96d ; * src/comp.c (syms_of_comp) <comp-no-native-file-h>: Doc... 9aa8fd6e62 * src/callint.c (Fcall_interactively): Fix inhibit_mouse_e... 70c229b1fc Fix regression in gdb-frame-handler cd9dd26d24 Format and index concept 'predicate' in ELisp Intro ab291656d0 ; * ChangeLog.3: Fix typos. 354f6c5609 ; * ChangeLog.3: Formatting fixes. 6192525a96 ; make change-history-commit
| * Format and index concept 'predicate' in ELisp IntroYugaEgo2021-11-301-1/+2
| | | | | | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Wrong Type of Argument): Add index and format definition (bug#52197). Copyright-paperwork-exempt: yes
* | Merge from origin/emacs-28Stefan Kangas2021-11-121-1/+1
|\| | | | | | | | | | | a6905e90cc Fix problem with temp buffer killing in package-install-file 144ad77fda Fix Lisp Intro markup error 24b86cb4f7 Fix ACL errors with WebDAV volumes on MS-Windows
| * Fix Lisp Intro markup errorLars Ingebrigtsen2021-11-121-1/+1
| | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Insert let): Fix @code markup error (bug#51777).
* | Merge from origin/emacs-28Glenn Morris2021-10-291-1/+1
|\| | | | | | | | | | | | | | | 08de838531 ; Improve commentary in the last change 3da9fa875b Make hieroglyphs display correctly with existing fonts 928e05f2d6 Clarify "default face attributes" in the ELisp manual 5dbb04e0eb Make `C-u RET' work again d72fefdeab Fix typos in the manual and in a comment
| * Fix typos in the manual and in a commentJan Synacek2021-10-281-1/+1
| | | | | | | | | | | | | | | | * lisp/minibuffer.el (completion-pcm--hilit-commonality): * doc/lispintro/emacs-lisp-intro.texi (Mode Line): Fix typos (bug#51434). Copyright-paperwork-exempt: yes
* | Merge from origin/emacs-28Glenn Morris2021-10-271-0/+4
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2bdd5732aa (origin/emacs-28) ; * etc/NEWS: Fix last change. 492b927909 Fix help commands for menu-bar menus 9589be772d ; * etc/NEWS: Fix typos. d353fc4a00 ; Explain why "kinds of atom" isn't a typo 47a3750162 ; * etc/NEWS: Improve wording of the Emoji entry. b814712796 ; Checkdoc fixes in image-dired.el e45b3fc521 Improve function documentation with text from XDG BDS spec 284c77eeb6 * lisp/transient.el: Update to package version 0.3.7. 40400e6977 ; Revert parts of "Use string-replace instead of replace-r... 214c2e268c ; Revert parts of "Use string-search instead of string-mat... # Conflicts: # etc/NEWS
| * ; Explain why "kinds of atom" isn't a typoEli Zaretskii2021-10-271-0/+4
| | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Add a comment explaining why "kinds of atom" isn't a typo.
* | Merge from origin/emacs-28Glenn Morris2021-10-251-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | a2c17e115e (origin/emacs-28) Merge branch 'emacs-28' of git.savannah.... fde56eeb76 Revert "Fix a typo in emacs-lisp-intro.texi" 4779d3ba19 * doc/lispref/functions.texi (Mapping Functions): Use #' w... 85ea3f7f47 Fix issue with interpreting ANSI codes in eshell 50f9436146 image-dired: Doc fix to better explain thumbnail generation bb475e10b9 Clarify two image-dired docstrings f5b4bb4a6f Fix flymake example backend conditions in the manual 0771d8939a * etc/PROBLEMS: Mention problems with regexp matcher. (Bu... ee579033b9 * test/lisp/repeat-tests.el: New file. 7385a7667f * lisp/tab-bar.el (tab-bar-move-repeat-map): Fix alias bin... 56caf1c9b8 Use restrictive umask when creating image-dired data 3b5de7f991 ; lisp/transient.el: Revert some misguided stylistic fixes.
| * Revert "Fix a typo in emacs-lisp-intro.texi"Eli Zaretskii2021-10-251-1/+1
| | | | | | | | | | | | | | | | | | This reverts commit 98eb6d783a482cd7ebca7ec656b0775b82c68e57. I've consulted with Richard Stallman about this, and he says that the original wording, "kinds of atom", is both correct and more elegant writing. So I'm restoring the original text. * doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Undo the fix of a "typo" that wasn't a typo. (Bug#51271)
* | Add comment on reworking a section in emacs-lisp-intro.texiStefan Kangas2021-10-211-0/+17
| | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Body of mark-whole-buffer): Add comment about how one could rework this section.
* | Merge from origin/emacs-28Glenn Morris2021-10-191-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d742cc3c20 (origin/emacs-28) ; etc/NEWS: Fix typos 28db29590f * admin/notes/unicode: Refer to Unicode's emoji-style.txt 9bd2f59db6 Handle VS-16 correctly for non-emoji codepoints e55e2d4a11 ; * etc/NEWS: Minor copyedit about 'repeat-mode'. 380981ddb5 Adjust bug-reference-bug-regexp default values to match on... c1cf95a0e1 ; * doc/emacs/windows.texi: Doc fix. 98eb6d783a Fix a typo in emacs-lisp-intro.texi f5b8f626e3 Fix some Tramp problems fc988a7113 Adapt Tramp manual 0c241043a8 Further fixes to Elisp manual 8e8a920246 * lisp/progmodes/cc-engine.el (c-forward-decl-or-cast-1): ... 5a3242301d Rename tab-bar-drag-maybe to tab-bar--dragging-in-progress bb4209a5a5 Fix xref elisp identifier namespace mistake # Conflicts: # etc/NEWS
| * Fix a typo in emacs-lisp-intro.texiStefan Kangas2021-10-191-1/+1
| | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Fix typo. Reported by Mor Zahavi <morzahavi@me.com>. (Bug#51271)
* | 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.
* Minor fix to clarify a sentence in emacs-lisp-introStefan Kangas2021-10-111-3/+3
| | | | | * doc/lispintro/emacs-lisp-intro.texi (Simple Extension): Add the word "that" for clarity. (Bug#43965)
* ; Very minor touch-up to a recent changeStefan Kangas2021-10-051-1/+1
| | | | | * doc/lispintro/emacs-lisp-intro.texi (Design @value{COUNT-WORDS}): Remove an unnecessary and potentially confusing "now".
* Don't use some obsolete names in documentationStefan Kangas2021-10-041-4/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * admin/notes/bugtracker: Use non-obsolete name 'mail-dont-reply-to-names'. * admin/notes/multi-tty: Mention new variable name 'x-selection-value'. * doc/lispintro/emacs-lisp-intro.texi (Point and mark) (Point and mark, Design @value{COUNT-WORDS}): Avoid using obsolete name 'count-lines-region'. * doc/lispref/hooks.texi (Standard Hooks): Remove reference to obsolete abnormal hook 'completion-annotate-function'. * doc/misc/efaq.texi (SPC no longer completes file names): Remove reference to obsolete 'minibuffer-local-filename-must-match-map'; setting it has no effect. * doc/misc/gnus.texi (NNTP): Remove reference to obsolete variable 'nntp-authinfo-file'. * doc/misc/reftex.texi (Table of Contents, Creating Citations) (Options - Table of Contents, Options - Referencing Labels) (Options - Creating Citations, Options - Index Support) (Options - Index Support, Changes): Don't use obsolete names. * doc/misc/speedbar.texi (Minor Display Modes) (Major Display Modes): Make variable name suggestions more in line with existing non-obsolete variable. * lisp/textmodes/reftex-cite.el (reftex-select-bib-mode-map): * lisp/textmodes/reftex-ref.el (reftex-offer-label-menu): Don't use obsolete variable names. * lisp/progmodes/which-func.el (which-func-mode): Doc fix.
* Prefer "website" to "homepage"Stefan Kangas2021-09-161-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These days, a "home page" is understood to be only "the main web page of a website" or "landing page", whereas a "website" is "a collection of web pages and related content" (Wikipedia). * doc/emacs/emacs.texi (Top): * doc/emacs/package.texi (Package Menu): * doc/lispintro/emacs-lisp-intro.texi (Top): * doc/lispref/elisp.texi (Top): * doc/lispref/tips.texi (Documentation Tips): * doc/misc/ede.texi (ede-project): * doc/misc/efaq-w32.texi (More information): * doc/misc/gnus-faq.texi (FAQ 5-7): * doc/misc/gnus.texi (About mairix): * doc/misc/mairix-el.texi (About): * doc/misc/reftex.texi (AUCTeX, Imprint): * lisp/cedet/ede/base.el (ede-project): * lisp/cedet/ede/system.el (ede-web-browse-home): * lisp/emacs-lisp/package.el (package-menu-mode-menu) (package-browse-url): * lisp/erc/erc-button.el (erc-emacswiki-url): * lisp/filesets.el (filesets-goto-homepage): * lisp/net/mairix.el: * lisp/net/webjump.el (webjump-sample-sites): * lisp/obsolete/vc-arch.el: * lisp/progmodes/idlw-shell.el (idlwave-shell-mode): * lisp/progmodes/idlwave.el (idlwave, idlwave-mode): * lisp/textmodes/reftex-vars.el (reftex): Prefer "website" to "home page". * doc/lispref/tips.texi (Documentation Tips): Sort the "URL" header comment before "Homepage". * lisp/emacs-lisp/lisp-mnt.el (lm-website): Rename from 'lm-homepage'. (lm-homepage): Make into alias for 'lm-website'.
* ; Fix Texinfo markup of a recent changeEli Zaretskii2021-08-211-1/+1
| | | | | * doc/lispintro/emacs-lisp-intro.texi (count-words-in-defun): Fix last change.
* Clarify how to do the `count-words-in-defun' recipeLars Ingebrigtsen2021-08-211-1/+3
| | | | | * doc/lispintro/emacs-lisp-intro.texi (count-words-in-defun): Clarify the recipe (bug#15069).
* Remove references to very old versions of Emacs from eintrStefan Kangas2021-04-031-84/+12
| | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Making Errors) (Void Function, Void Variable, Wrong Type of Argument, debug) (debug-on-entry): Remove commented out references to Emacs 20 or earlier. * doc/lispintro/emacs-lisp-intro.texi (what-line) (print-elements-of-list, debug, X Axis Tic Marks): Don't call version 22 or earlier a "recent" version of Emacs.
* Make tags tables from Texinfo sourcesPetteri Hintsanen2021-03-111-0/+16
| | | | | | | | | | | | | | | | | * doc/misc/Makefile.in (ETAGS, texifiles): New variables. (TAGS, tags, FORCE, ${ETAGS}): New targets. (bootstrap-clean maintainer-clean): Delete TAGS. * doc/lispref/Makefile.in (ETAGS, texifiles): New variables. (TAGS, tags, FORCE, ${ETAGS}): New targets. (bootstrap-clean maintainer-clean): Delete TAGS. * doc/lispintro/Makefile.in (ETAGS, texifiles): New variables. (TAGS, tags, FORCE, ${ETAGS}): New targets. (bootstrap-clean maintainer-clean): Delete TAGS. * doc/emacs/Makefile.in (ETAGS, texifiles): New variables. (TAGS, tags, FORCE, ${ETAGS}): New targets. (bootstrap-clean maintainer-clean): Delete TAGS. * Makefile.in (TAGS tags): Make tags in doc/emacs, doc/lispintro, doc/lispref and doc/misc.
* Remove several references to Emacs 22 and earlierStefan Kangas2021-03-101-9/+8
| | | | | | | | | | | | | | | | | | | | | | * 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.
* Simplify silent-rules build machineryGlenn Morris2021-03-061-7/+2
| | | | | | | | | | | | | | * src/verbose.mk.in: New file. * configure.ac (AM_V, AM_DEFAULT_V): Remove output variables. (src/verbose.mk): New output file. * Makefile.in, admin/charsets/Makefile.in: * admin/grammars/Makefile.in, admin/unidata/Makefile.in: * doc/emacs/Makefile.in, doc/lispintro/Makefile.in: * doc/lispref/Makefile.in, doc/misc/Makefile.in, leim/Makefile.in: * lib-src/Makefile.in, lib/Makefile.in, lisp/Makefile.in: * lwlib/Makefile.in, nt/Makefile.in, oldXMenu/Makefile.in: * src/Makefile.in, src/verbose.mk.in, test/Makefile.in: Include src/verbose.mk rather than repeatedly defining AM_V_at etc.
* Update copyright year to 2021Paul Eggert2021-01-0114-14/+14
| | | | Run "TZ=UTC0 admin/update-copyright".
* Clarify wordingRichard M Stallman2020-10-141-1/+1
| | | | Clarify doc string of line-to-top-of-window.
* ; shorten https://lists.gnu.org/archive/html/... linksStefan Kangas2020-10-091-1/+1
|
* Merge from origin/emacs-27Glenn Morris2020-08-311-1/+1
|\ | | | | | | | | | | | | | | f20169399d (origin/emacs-27) Fix typo in Introduction to Emacs Lisp 7605060d51 Update Elisp Manual reference to which-function-mode 29708cbde7 Some precisions to bug handling dddc971f0e CC Mode: Fix processing for when c-multiline-string-start-... 4a73fb9668 Fix description of %-constructs in 'mode-line-format'
| * Fix typo in Introduction to Emacs LispStefan Kangas2020-08-311-1/+1
| | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (type-of-animal in detail): Remove extraneous parenthesis.
* | Merge from origin/emacs-27Glenn Morris2020-05-231-4/+1
|\| | | | | | | | | | | | | 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
| * Don’t use “constant” for values you shouldn’t changePaul Eggert2020-05-161-4/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-04-201-11/+21
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
| * Improve mutability documentationPaul Eggert2020-04-191-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | 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 constant vs mutable objects betterPaul Eggert2020-04-181-11/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch builds on a suggested patch by Mattias Engdegård and on further comments by Eli Zaretskii. Original bug report by Kevin Vigouroux (Bug#40671). * doc/lispintro/emacs-lisp-intro.texi (set & setq, Review) (setcar, Lists diagrammed, Mail Aliases, Indent Tabs Mode): setq is a special form, not a function or command. * doc/lispintro/emacs-lisp-intro.texi (setcar): * doc/lispref/lists.texi (Modifying Lists, Rearrangement): * doc/lispref/sequences.texi (Sequence Functions) (Array Functions, Vectors): * doc/lispref/strings.texi (String Basics, Modifying Strings): Mention mutable vs constant objects. * doc/lispintro/emacs-lisp-intro.texi (setcar, setcdr) (kill-new function, cons & search-fwd Review): * doc/lispref/edebug.texi (Printing in Edebug): * doc/lispref/keymaps.texi (Changing Key Bindings): * doc/lispref/lists.texi (Setcar, Setcdr, Rearrangement) (Sets And Lists, Association Lists, Plist Access): * doc/lispref/sequences.texi (Sequence Functions) (Array Functions): * doc/lispref/strings.texi (Text Comparison): Fix examples so that they do not try to change constants.
* | Merge from origin/emacs-27Glenn Morris2020-04-131-1/+2
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | 1dfc497fac Minor wording change in Introduction to Programming in Ema... ff09b4eeac Fix 'flymake-show-diagnostics-buffer' when line numbers ar... 63e8d0ea87 Fix last changes describing mail commands 01212a762f Do setup Flymake in file-less Elisp buffers 36873ef2b2 Fix error message for ‘cl-struct-unknown-slot’ (bug#39995) 3f9310b0fe Fix and improve documentation of mail-related features 1482a75efa Fix build failure with Fx_gtk_debug cf57663f2a Mention jit-lock deferred as an alternative to fast-but-im... # Conflicts: # etc/NEWS