aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/objects.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* ; * doc/lispref/objects.texi (Type Predicates): fix xrefsMattias Engdegård2024-04-291-2/+2
|
* Use a dedicated type to represent interpreted-function valuesStefan Monnier2024-04-281-13/+25
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Change `function` so that when evaluating #'(lambda ...) we return an object of type `interpreted-function` rather than a list starting with one of `lambda` or `closure`. The new type reuses the existing PVEC_CLOSURE (nee PVEC_COMPILED) tag and tries to align the corresponding elements: - the arglist, the docstring, and the interactive-form go in the same slots as for byte-code functions. - the body of the function goes in the slot used for the bytecode string. - the lexical context goes in the slot used for the constants of bytecoded functions. The first point above means that `help-function-arglist`, `documentation`, and `interactive-form`s don't need to distinguish interpreted and bytecode functions any more. Main benefits of the change: - We can now reliably distinguish a list from a function value. - `cl-defmethod` can dispatch on `interactive-function` and `closure`. Dispatch on `function` also works now for interpreted functions but still won't work for functions represented as lists or as symbols, of course. - Function values are now self-evaluating. That was alrready the case when byte-compiled, but not when interpreted since (eval '(closure ...)) signals a void-function error. That also avoids false-positive warnings about "don't quote your lambdas" when doing things like `(mapcar ',func ...)`. * src/eval.c (Fmake_interpreted_closure): New function. (Ffunction): Use it and change calling convention of `Vinternal_make_interpreted_closure_function`. (FUNCTIONP, Fcommandp, eval_sub, funcall_general, funcall_lambda) (Ffunc_arity, lambda_arity): Simplify. (funcall_lambda): Adjust to new representation. (syms_of_eval): `defsubr` the new function. Remove definition of `Qclosure`. * lisp/emacs-lisp/cconv.el (cconv-make-interpreted-closure): Change calling convention and use `make-interpreted-closure`. * src/data.c (Fcl_type_of): Distinguish `byte-code-function`s from `interpreted-function`s. (Fclosurep, finterpreted_function_p): New functions. (Fbyte_code_function_p): Don't be confused by `interpreted-function`s. (Finteractive_form, Fcommand_modes): Simplify. (syms_of_data): Define new type symbols and `defsubr` the two new functions. * lisp/emacs-lisp/cl-print.el (cl-print-object) <interpreted-function>: New method. * lisp/emacs-lisp/oclosure.el (oclosure): Refine the parent to be `closure`. (oclosure--fix-type, oclosure-type): Simplify. (oclosure--copy, oclosure--get, oclosure--set): Adjust to new representation. * src/callint.c (Fcall_interactively): Adjust to new representation. * src/lread.c (bytecode_from_rev_list): * lisp/simple.el (function-documentation): * lisp/help.el (help-function-arglist): Remove the old `closure` case and adjust the byte-code case so it handles `interpreted-function`s. * lisp/emacs-lisp/cl-preloaded.el (closure): New type. (byte-code-function): Add it as a parent. (interpreted-function): Adjust parent (the type itself was already added earlier by accident). * lisp/emacs-lisp/bytecomp.el (byte-compile--reify-function): Adjust to new representation. (byte-compile): Use `interpreted-function-p`. * lisp/emacs-lisp/byte-opt.el (byte-compile-inline-expand): Adjust to new representation. (side-effect-free-fns): Add `interpreted-function-p` and `closurep`. * src/profiler.c (trace_hash, ffunction_equal): Simplify. * lisp/profiler.el (profiler-function-equal): Simplify. * lisp/emacs-lisp/nadvice.el (advice--interactive-form-1): Use `interpreted-function-p`; adjust to new representation; and take advantage of the fact that function values are now self-evaluating. * lisp/emacs-lisp/lisp-mode.el (closure): Remove `lisp-indent-function` property. * lisp/emacs-lisp/disass.el (disassemble-internal): Adjust to new representation. * lisp/emacs-lisp/edebug.el (edebug--strip-instrumentation): Use `interpreted-function-p`. * lisp/emacs-lisp/comp-common.el (comp-known-type-specifiers): Add `closurep` and `interpreted-function-p`. * test/lisp/help-fns-tests.el (help-fns-test-lisp-defun): Adjust to more precise type info in `describe-function`. * test/lisp/erc/resources/erc-d/erc-d-tests.el (erc-d--render-entries): Use `interpreted-function-p`. * test/lisp/emacs-lisp/macroexp-resources/vk.el (vk-f4, vk-f5): Don't hardcode function values. * doc/lispref/functions.texi (Anonymous Functions): Don't suggest that function values are lists. Reword "self-quoting" to reflect the fact that #' doesn't return the exact same object. Update examples with the new shape of the return value. * doc/lispref/variables.texi (Lexical Binding): * doc/lispref/lists.texi (Rearrangement): * doc/lispref/control.texi (Handling Errors): Update examples to reflect new representation of function values.
* Followup changes to `cl-type-of`scratch/object-typeStefan Monnier2024-03-181-3/+3
| | | | | | | | | | | | | | These changes came up while working on `cl-type-of` but are not directly related to the new `cl-type-of`. The BASE_PURESIZE bump was needed at some point on one of my machine, not sure why. * src/puresize.h (BASE_PURESIZE): Bump up. * src/sqlite.c (bind_value): Don't use `Ftype_of`. * lisp/emacs-lisp/seq.el (seq-remove-at-position): Simplify. * lisp/emacs-lisp/cl-preloaded.el (finalizer): New (previously missing) type. * doc/lispref/objects.texi (Type Predicates): Minor tweaks.
* (cl-type-of): New function to return more precise types (bug#69739)Stefan Monnier2024-03-181-0/+21
| | | | | | | | | | | | | | | | | | | | | | | | * src/data.c (Fcl_type_of): New function, extracted from `Ftype_of`. Make it return more precise types for symbols, integers, and subrs. (Ftype_of): Use it. (syms_of_data): Define the corresponding new symbols and defsubr the new function. * doc/lispref/objects.texi (Type Predicates): Document it. * src/comp.c (emit_limple_insn): Use `Fcl_type_of`. * lisp/emacs-lisp/cl-preloaded.el (subr): Demote it to `atom`. (subr-native-elisp, subr-primitive): Add `compiled-function` as parent instead. (special-form): New type. * lisp/obsolete/eieio-core.el (cl--generic-struct-tag): * lisp/emacs-lisp/cl-generic.el (cl--generic-typeof-generalizer): Use `cl-type-of`. cl--generic--unreachable-types): Update accordingly. test/src/data-tests.el (data-tests--cl-type-of): New test.
* Change bare-symbol back to match intentPaul Eggert2024-03-111-3/+3
| | | | | | | | | | Also, attempt to document the intent better. Problem reported by Alan Mackenzie (Bug#69684). * src/data.c (Fbare_symbol): Do not signal if the SYM is a symbol with position and symbols-with-pos-enabled is nil. Instead, ignore symbols-with-pos-enabled, as that was the intent. * test/src/data-tests.el (data-tests-bare-symbol): New test, to help prevent this bug from reoccurring.
* Rename type_hierarchy.* -> elisp_type_hierarchy.*Andrea Corallo2024-03-061-1/+1
| | | | | | | | | | * doc/lispref/elisp_type_hierarchy.txt: Renamed. * doc/lispref/elisp_type_hierarchy.jpg: Likewise. * doc/lispref/Makefile.in (auxfiles) ($(buildinfodir)/elisp_type_hierarchy.txt) ($(buildinfodir)/elisp_type_hierarchy.jpg): Update. * admin/syncdoc-type-hierarchy.el (syncdoc-update-type-hierarchy0): Likewise. * Makefile.in (install-info, uninstall): Likewise.
* Fix documentation of last changeEli Zaretskii2024-03-011-8/+11
| | | | | | * doc/lispref/objects.texi (Type Hierarchy): Fix wording and markup. * doc/lispref/elisp.texi (Top): Add new node to @detailmenu.
* * doc/lispref/objects.texi (Type Hierarchy): Small improvementsAndrea Corallo2024-03-011-4/+4
|
* Merge remote-tracking branch 'origin/master' into 'feature/type-hierarchy'Andrea Corallo2024-02-281-1/+4
|\
| * Update NEWS and manual after obarray changesMattias Engdegård2024-02-231-1/+4
| | | | | | | | | | | | | | | | * doc/lispref/abbrevs.texi (Abbrev Tables): * doc/lispref/symbols.texi (Creating Symbols): * doc/lispref/objects.texi (Type Predicates): Update text for obarray now being an opaque type. * etc/NEWS: Announce.
* | * Add initial "Type Hierarchy" node to the elisp manualAndrea Corallo2024-02-151-0/+21
|/ | | | | * doc/lispref/objects.texi (Lisp Data Types, Type Hierarchy): Add Type Hierarchy node.
* Merge from origin/emacs-29Eli Zaretskii2024-01-271-7/+8
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 53481cc9546 Fix description of when "\xNNN" is considered a unibyte c... 1ef8b90ae06 Simplify imenu setup for {cmake,dockerfile}-ts-modes 7338af9c986 ; * etc/PROBLEMS: Document that GnuPG 2.4.4 solves the Ea... 5483a1df99c Improve documentation of profiler commands fb4cf0ab46d ; Fix xref under Output Overrides in Elisp manual. aa6c24da61f Fix broken links to Freedesktop notifications spec 14d68221d26 Fix nasty cut'n'waste error in Tramp 51ca049608c Fix image-dired-tags-db-file void variable error c450eec07ff typescript-ts-mode: Skip test if tsx grammar missing 9841ced147f ; Fix typos 557ed9c0463 * admin/README: Document the run-codespell script. 5701f96335c * admin/README: Fix entry on coccinelle subdirectory. 1805f4bfd62 Add script admin/run-codespell and supporting files
| * Fix description of when "\xNNN" is considered a unibyte characterEli Zaretskii2024-01-271-7/+8
| | | | | | | | | | | | * doc/lispref/objects.texi (Non-ASCII in Strings): More accurate description of when a hexadecimal escape sequence yields a unibyte character. (Bug#68751)
* | Hash-table documentation updates (bug#68244)Mattias Engdegård2024-01-131-2/+1
| | | | | | | | | | | | | | | | | | | | * doc/lispref/hash.texi (Creating Hash, Other Hash): Manual updates for make-hash-table, hash-table-rehash-size and hash-table-rehash-threshold. * doc/lispref/objects.texi (Hash Table Type): Update example. * src/fns.c (Fhash_table_rehash_size, Fhash_table_rehash_threshold): Update doc strings. * etc/NEWS: Announce changes.
* | Merge from savannah/emacs-29Po Lu2024-01-021-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | dc4e6b13296 ; Update copyright years in more files 64b37776318 ; Run set-copyright from admin.el 8e1c56ae467 ; Add 2024 to copyright years # Conflicts: # doc/misc/modus-themes.org # doc/misc/texinfo.tex # etc/NEWS # etc/refcards/ru-refcard.tex # etc/themes/modus-operandi-theme.el # etc/themes/modus-themes.el # etc/themes/modus-vivendi-theme.el # lib/alloca.in.h # lib/binary-io.h # lib/c-ctype.h # lib/c-strcasecmp.c # lib/c-strncasecmp.c # lib/careadlinkat.c # lib/cloexec.c # lib/close-stream.c # lib/diffseq.h # lib/dup2.c # lib/filemode.h # lib/fpending.c # lib/fpending.h # lib/fsusage.c # lib/getgroups.c # lib/getloadavg.c # lib/gettext.h # lib/gettime.c # lib/gettimeofday.c # lib/group-member.c # lib/malloc.c # lib/md5-stream.c # lib/md5.c # lib/md5.h # lib/memmem.c # lib/memrchr.c # lib/nanosleep.c # lib/save-cwd.h # lib/sha1.c # lib/sig2str.c # lib/stdlib.in.h # lib/strtoimax.c # lib/strtol.c # lib/strtoll.c # lib/time_r.c # lib/xalloc-oversized.h # lisp/auth-source-pass.el # lisp/emacs-lisp/lisp-mnt.el # lisp/emacs-lisp/timer.el # lisp/info-look.el # lisp/jit-lock.el # lisp/loadhist.el # lisp/mail/rmail.el # lisp/net/ntlm.el # lisp/net/webjump.el # lisp/progmodes/asm-mode.el # lisp/progmodes/project.el # lisp/progmodes/sh-script.el # lisp/textmodes/flyspell.el # lisp/textmodes/reftex-toc.el # lisp/textmodes/reftex.el # lisp/textmodes/tex-mode.el # lisp/url/url-gw.el # m4/alloca.m4 # m4/clock_time.m4 # m4/d-type.m4 # m4/dirent_h.m4 # m4/dup2.m4 # m4/euidaccess.m4 # m4/fchmodat.m4 # m4/filemode.m4 # m4/fsusage.m4 # m4/getgroups.m4 # m4/getloadavg.m4 # m4/getrandom.m4 # m4/gettime.m4 # m4/gettimeofday.m4 # m4/gnulib-common.m4 # m4/group-member.m4 # m4/inttypes.m4 # m4/malloc.m4 # m4/manywarnings.m4 # m4/mempcpy.m4 # m4/memrchr.m4 # m4/mkostemp.m4 # m4/mktime.m4 # m4/nproc.m4 # m4/nstrftime.m4 # m4/pathmax.m4 # m4/pipe2.m4 # m4/pselect.m4 # m4/pthread_sigmask.m4 # m4/readlink.m4 # m4/realloc.m4 # m4/sig2str.m4 # m4/ssize_t.m4 # m4/stat-time.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/stdio_h.m4 # m4/stdlib_h.m4 # m4/stpcpy.m4 # m4/strnlen.m4 # m4/strtoimax.m4 # m4/strtoll.m4 # m4/time_h.m4 # m4/timegm.m4 # m4/timer_time.m4 # m4/timespec.m4 # m4/unistd_h.m4 # m4/warnings.m4 # nt/configure.bat # nt/preprep.c # test/lisp/register-tests.el
| * ; Add 2024 to copyright yearsPo Lu2024-01-021-1/+1
| |
* | Merge from origin/emacs-29Eli Zaretskii2023-11-111-2/+27
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | ce0ebb91f25 Improve documentation of read syntax and printed represen... 81f84b00a5d ; * doc/lispref/modes.texi (Other Font Lock Variables): A... 434592b0746 ; * lisp/dired.el (dired-use-ls-dired): Doc fix (bug#67053). fe000236cf2 Improve documentation of signaling errors in batch mode 103ca678ac1 Fix treesit-simple-indent-presets docstring (bug#67007) b7871cefe7b Prevent an infinite loop in todo-mode (bug#66994) fa8cc4c9ee2 Fix cmake-ts-mode indentation (Bug#66845) 5bdc61bc0ef Update to Org 9.6.11 18e2de1bec9 ; * lisp/bindings.el (right-word, left-word): Doc fix. 4f0fc3bfda3 ; Document core input events problems with XInput2
| * Improve documentation of read syntax and printed representationEli Zaretskii2023-11-111-2/+27
| | | | | | | | | | | | | | | | * doc/lispref/objects.texi (Syntax for Strings): Describe in more detail how to specify special characters in string literals. (Printed Representation, Character Type, Nonprinting Characters): Improve information and add cross-references about printed representation and read syntax. (Bug#67033)
* | Merge from origin/emacs-29Eli Zaretskii2023-09-091-1/+3
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | bc56da92d8d ; Fix error in 'tex-recenter-output-buffer' d17c5adc057 Fix regexp for recognizing PBM images 9e9f61866e7 Improve wording in ELisp manual 7427efa033b Fix typo (Bug#65764) 59c66244080 ; * lisp/ido.el (ido-completion-buffer): Fix :type (bug#6... 4ec4b18c2a0 Fix libgccjit build on Haiku 80bdcf8f351 (regexp-tests-backtrack-optimization): Mark it as failing 8a9e653cc82 ; Add regression test for bug#65726 6fad73d7cc5 * src/regex-emacs.c (mutually_exclusive_p): Fix inf-loop ... 1d3d4196073 ; * lisp/files.el (save-some-buffers-functions): Doc fix ... 42b14c6e5bb Bump seq version to 2.24 ff5190a174f Add note on ELPA to admin/notes/bug-triage f1e4cbe72aa ; * etc/PROBLEMS: Minor wording fix. fd5593c7f25 * etc/PROBLEMS: Mention bug#65432 and its remedy. dd896ea1e62 Ignore errors when checking for object initializers (bug#... 3550f44c17c ; Fix typos 5b246b9b817 * CONTRIBUTE: Document making ChangeLogs with Magit. 0bd46619413 Doc fixes for obsolete functions and variables 524c0c34f24 ; * lisp/ffap.el (ffap-rfs-regexp): Fix :type (bug#65698). f48dccc4675 Merge branch 'emacs-29' of git.savannah.gnu.org:/srv/git/... 71a85e22668 A revision to the Widget manual dbbcf4a6599 Fix fontification of " in edit-kbd-macro # Conflicts: # test/src/regex-emacs-tests.el
| * Improve wording in ELisp manualEli Zaretskii2023-09-061-1/+3
| | | | | | | | | | | | * doc/lispref/objects.texi (Printed Representation): Improve wording. Suggested by Xie Shynur <one.last.kiss@outlook.com>. (Bug# 60639)
* | Correct the handling of symbols with position in equalAlan Mackenzie2023-09-041-0/+11
|/ | | | | | | | | | | | | | | * src/fns.c (internal_equal): Only regard symbols with position as their symbols when symbols-with-pos-enabled is non-nil. * doc/lispref/symbols.texi (Symbols with Position): Expand the description of symbols with position, in particular the way they work with eq and equal. * doc/lispref/objects.texi (Equality Predicates): Describe how eq and equal handle symbols with position. * test/src/fns-tests.el (fns-tests-equal-symbols-with-position): New tests for symbols with position.
* ; Minor wording fix in ELisp reference manualEli Zaretskii2023-03-161-7/+8
| | | | | * doc/lispref/objects.texi (General Escape Syntax): More accurate wording. Avoid non-ASCII characters in Texinfo. (Bug#62224)
* Remove mention of old dotted-list reader quirk from manualMattias Engdegård2023-03-121-7/+0
| | | | | * doc/lispref/objects.texi (Dotted Pair Notation): The (. X) reader peculiarity is no more (bug#62020).
* ; Add 2023 to copyright years.Eli Zaretskii2023-01-011-1/+1
|
* (compiled-function-p): New function (bug#56648)Stefan Monnier2022-08-141-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | * lisp/subr.el (compiled-function-p): New function. * test/lisp/international/ucs-normalize-tests.el (ucs-normalize-part1): * lisp/gnus/gnus.el (gnus): * lisp/mh-e/mh-e.el (mh-version): * lisp/emacs-lisp/macroexp.el (emacs-startup-hook): * lisp/emacs-lisp/cl-macs.el (compiled-function): * lisp/emacs-lisp/bytecomp.el (byte-compile-fdefinition) (byte-compile, display-call-tree): * lisp/emacs-lisp/byte-opt.el (<toplevel-end>): * lisp/emacs-lisp/advice.el (ad-compiled-p): * lisp/cedet/semantic/bovine.el (semantic-bovinate-stream): * lisp/loadup.el (macroexpand-all): * admin/unidata/unidata-gen.el (unidata--ensure-compiled): Use it. * lisp/emacs-lisp/pcase.el (pcase-mutually-exclusive-predicates): Add entries for it. (pcase--split-pred): Use it. * lisp/help-fns.el (help-fns-function-description-header): Use `functionp`. (help-fns--var-safe-local): Use `compiled-function-p`.
* Merge from origin/emacs-28Stefan Kangas2022-06-101-0/+6
|\ | | | | | | 22a832ad82 Mention the #f syntax from cl-prin1
| * Mention the #f syntax from cl-prin1Lars Ingebrigtsen2022-06-091-0/+6
| | | | | | | | | | * doc/lispref/objects.texi (Special Read Syntax): Mention #f, which is in cl-prin1 output (bug#55853).
* | 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
| |
* | Document the xwidget typePo Lu2021-11-071-0/+15
|/ | | | | | | * doc/lispref/elisp.texi: Add Xwidget Type to the menu. * doc/lispref/objects.texi (Editing Types): Add Xwidget Type to the menu. (Xwidget Type): New node.
* Minor fixes for recent changes in ELisp manualEli Zaretskii2021-10-181-1/+1
| | | | | | | | * doc/lispref/windows.texi (Basic Windows, Windows and Frames) (Selecting Windows): * doc/lispref/objects.texi (Window Type): * doc/lispref/frames.texi (Input Focus, Frame Layout): Fix wording, punctuation, and indexing.
* Rewrites of Elisp manual including tab-bar and tab-line changesMartin Rudalics2021-10-181-11/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/buffers.texi (Current Buffer, Buffer List): Update references to 'selected-window'. * doc/lispref/elisp.texi (Top): Move up Selecting Windows section in front of Window Sizes section. * doc/lispref/frames.texi (Creating Frames): Say window system instead of windowing system. (Frame Layout): Add Tab Bar to layout. (Layout Parameters): Add 'tab-bar-lines'. (Input Focus): Say window system window instead of window manager window. Fix reference to 'selected-window'. * doc/lispref/objects.texi (Window Type): Minor rewrite. * doc/lispref/windows.texi (Basic Windows): Rewrite. Settle on term 'window system window' for disambiguation with our windows. Move 'selected-window' description to Selecting Windows section. Move schematic of window structure here. Use 'decorations' for objects outside the window body. Say that the areas reserved for continuation and truncation glyphs, vertical dividers and line numbers are part of the window body. (Windows and Frames): Minor rewrite, adding and fixing some cross references. Move live window schematic to 'Basic Windows' section. (Selecting Windows): Move section in front of Window Sizes section. Move description of 'selected-window' here. Move up description of 'frame-selected-window' and 'set-frame-selected-window'. Update and move description of 'window-bump-use-time' here. (Window Sizes): Throughout use the term 'decorations' instead of enumerating them individually. Add 'window-tab-line-height' description. (Resizing Windows): Again use the term 'decorations' instead of enumerating them individually. (Splitting Windows): Minor fix. (Cyclic Window Ordering): Improve descriptions of 'get-lru-window' and 'get-mru-window'. Move 'window-bump-use-time' to Selecting Windows section. (Coordinates and Windows, Window Configurations): Once more use the term 'decorations' instead of enumerating them individually. * src/window.c (Fwindow_bump_use_time): Move after 'window-use-time'. Make it work for live windows only. Make WINDOW argument optional. Update doc-string.
* Prefer "graphical displays" to "X terminals" in documentationStefan Kangas2021-10-151-5/+5
| | | | | | | | | | * doc/lispref/objects.texi (Ctl-Char Syntax): Fix incorrect remark; some text terminals can generate ASCII control characters. (Other Char Bits): * lisp/bindings.el: * lisp/gnus/gnus-undo.el (gnus-undo-mode-map): Say "graphical display" and "GUI display" instead of "X terminal"; the latter term is archaic. (Bug#51217)
* Explain what ( . c) means to the Emacs Lisp readerLars Ingebrigtsen2021-07-061-0/+7
| | | | | * doc/lispref/objects.texi (Dotted Pair Notation): Explain what ( . c) means to the Lisp reader (bug#24875).
* Merge from origin/emacs-27Glenn Morris2021-04-161-1/+1
|\ | | | | | | | | eedad01b4b (origin/emacs-27) Fix typos in manuals 24d214652e Fix description of momentary message display
| * Fix typos in manualsEli Zaretskii2021-04-131-1/+1
| | | | | | | | | | * doc/misc/eshell.texi (Completion): * doc/lispref/objects.texi (Mutability): Fix typos. (Bug#47738)
* | Merge from origin/emacs-27Glenn Morris2021-03-181-3/+0
|\ \ | |/ | | | | | | a7f95d5244 Remove duplicate @table item from ELisp manual be1b3512f7 Fix reference to 'diff-font-lock-syntax' in diff-mode docu...
| * Remove duplicate @table item from ELisp manualFabrice Bauzac2021-03-171-3/+0
| | | | | | | | | | * doc/lispref/objects.texi (Special Read Syntax): Remove duplicate item "#@N" from the table of Special Read Syntax. (Bug#47200)
| * Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* | Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright".
* | Merge from origin/emacs-27Glenn Morris2020-05-231-45/+48
|\ \ | |/ | | | | | | | | | | 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
| * 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-161-47/+51
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-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-251-7/+14
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
| * 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 wording about constantsPaul Eggert2020-04-221-7/+14
| | | | | | | | | | | | | | | | 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-201-0/+48
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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).
generated by cgit v1.2.1 (git 2.18.0) at 2026-04-24 03:38:56 +0000