aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/objects.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* 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).
| * Fix mutability glitches reported by Drew AdamsPaul Eggert2020-04-191-4/+6
| | | | | | | | | | | | | | | | | | | | 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 documentationPaul Eggert2020-04-191-0/+45
| | | | | | | | | | | | | | | | | | | | | | | | | | 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.
* | Merge from origin/emacs-27Glenn Morris2020-01-281-15/+17
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1bcac29b2f (origin/emacs-27) dns-mode-soa-auto-increment-serial: safe... abf0f8666d * lisp/wdired.el: Clean out isearch-filter-predicate (bug#... c31c31e57f ; Spelling and URL fixes 066aad7b9d Finish the documentation for c-noise-macro-{,with-parens-}... c8fcabf245 Correct regexp for flags in `format' doc string 2e9a153b26 Moderate recommendation to escape '(' in doc strings d7cd4ab7d9 Objective C Mode: Make c-forward-type work with "unsigned ... 1705e32ebc Fix help text about configure module support baca81e641 * doc/lispref/streams.texi (Output Functions): Improve ind... 568a560fce Improve doc string of 'newline' 7f50698505 Improve doc of eq on bignums etc. e5327a569c Do not refer to obsolete alias fd09196781 ; Clarify what time-stamp-active enables # Conflicts: # etc/NEWS
| * Improve doc of eq on bignums etc.Paul Eggert2020-01-241-15/+17
| | | | | | | | | | | | * doc/lispref/numbers.texi (Integer Basics): * doc/lispref/objects.texi (Integer Type, Equality Predicates): Be clearer about eq vs eql vs = on bignums, floats, and strings.
* | Fix sxhash-equal on bytecodes, markers, etc.Paul Eggert2020-01-071-2/+6
|/ | | | | | | | | | | | | | | | | | Problem reported by Pip Cet (Bug#38912#14). * doc/lispref/objects.texi (Equality Predicates): Document better when ‘equal’ looks inside objects. * doc/lispref/windows.texi (Window Configurations): Don’t say that ‘equal’ looks inside window configurations. * etc/NEWS: Mention the change. * src/fns.c (internal_equal): Do not look inside window configurations. (sxhash_obj): Hash markers, byte-code function objects, char-tables, and font objects consistently with Fequal. * src/window.c (compare_window_configurations): Now static. Remove last argument. Caller changed. * test/lisp/ffap-tests.el (ffap-other-window--bug-25352): Use compare-window-configurations, not ‘equal’. * test/src/fns-tests.el (test-sxhash-equal): New test.
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Fix manual typo in Special Read SyntaxLars Ingebrigtsen2019-12-241-1/+1
| | | | * doc/lispref/objects.texi (Special Read Syntax): Fix typo.
* Improve errors & warnings due to fancy quoted vars (Bug#32939)Noam Postavsky2019-11-281-1/+5
| | | | | | | | | | | | | | | | | | | | | | | | Add some hints to the message for byte compiler free & unused variable warnings, and 'void-variable' errors where the variable has confusable quote characters in it. * lisp/help.el (uni-confusables), uni-confusables-regexp): New constants. (help-command-error-confusable-suggestions): New function, added to `command-error-function'. (help-uni-confusable-suggestions): New function. * lisp/emacs-lisp/bytecomp.el (byte-compile-variable-ref): * lisp/emacs-lisp/cconv.el (cconv--analyze-use): Use it. * lisp/emacs-lisp/lisp-mode.el (lisp--match-confusable-symbol-character): New function. (lisp-fdefs): Use it to fontify confusable characters with font-lock-warning-face when they occur in symbol names. * doc/lispref/modes.texi (Faces for Font Lock): * doc/lispref/objects.texi (Basic Char Syntax): Recommend backslash escaping of confusable characters, and mention new fontification. * etc/NEWS: Announce the new fontification behavior. * test/lisp/emacs-lisp/lisp-mode-tests.el (lisp-fontify-confusables): New test.
* Fix a recent change in ELisp manualEli Zaretskii2019-11-211-3/+1
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Fix wording of the last change: don't document #' twice. (Bug#38278)
* Fix up previous #' documentation additionLars Ingebrigtsen2019-11-211-1/+1
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Add an xref for the #' (bug#38278).
* Document the #' syntaxLars Ingebrigtsen2019-11-211-0/+5
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Document the #' syntax (bug#38278).
* ; Remove unneeded @samp from a @tableEli Zaretskii2019-10-121-2/+2
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Remove @samp from @item's.
* Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacsEli Zaretskii2019-10-121-0/+10
|\
| * Document #$ in the overviewLars Ingebrigtsen2019-10-121-3/+10
| | | | | | | | * doc/lispref/objects.texi (Special Read Syntax): Add #$.
* | Fix recent changes in ELisp manualEli Zaretskii2019-10-121-15/+15
|/ | | | | | | | * doc/lispref/objects.texi (Special Read Syntax): Use @samp in @table. * doc/lispref/elisp.texi (Top): Update the detailed menu due to a recent addition.
* Add a lispref node to list special read syntax formsLars Ingebrigtsen2019-10-121-0/+64
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Add a node to list all the special read syntax forms (bug#18957).
* Improve ‘equal’ and array docPaul Eggert2019-06-271-6/+9
| | | | | | | * doc/lispref/objects.texi (Array Type): Array sizes are nonnegative fixnums, not arbitrary integers. (Equality Predicates): Do not say that ‘eq’ equals ‘=’ on bignums. Do not imply that ‘equal’ must signal an error on circular lists.
* Merge from origin/emacs-26Paul Eggert2018-12-311-1/+1
|\ | | | | | | | | | | 2fcf2df Fix copyright years by hand 26bed8b Update copyright year to 2019 2814292 Fix value of default frame height. (Bug#33921)
| * Update copyright year to 2019Paul Eggert2019-01-011-1/+1
| | | | | | | | Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
* | Move bignump, fixnump from C to LispPaul Eggert2018-08-211-3/+4
| | | | | | | | | | | | | | | | | | * doc/lispref/objects.texi (Integer Type): Mention most-negative-fixnum and most-positive-fixnum as alternatives to fixnump and bignump. * lisp/subr.el (fixnump, bignump): Now written in Lisp. * src/data.c (Ffixnump, Fbignump): No longer written in C, as these new functions are not crucial for performance.
* | Document bignumsTom Tromey2018-07-121-8/+18
| | | | | | | | | | | | | | | | | | * doc/lispref/numbers.texi (Numbers, Integer Basics) (Predicates on Numbers, Comparison of Numbers) (Arithmetic Operations, Bitwise Operations): Update for bignums. * doc/lispref/objects.texi (Integer Type, Type Predicates): Update for bignums. * etc/NEWS: Update for bigums.
* | Merge from origin/emacs-26Glenn Morris2018-06-231-9/+9
|\ \ | |/ | | | | | | | | | | | | | | | | 5cb3991 Fix a typo in emacs-lisp-intro.texi d6aa55e Avoid segfaults in replace-buffer-contents with large buffers d22b8d1 Adjust for scaling for mode-line popup menus (Bug#31880) 3d2e3dc Change name of `seqp' argument (Bug#26411) 40e1db8 Change index of ";" to better reflect it's usage (Bug#31623) d289e7e Fix bug of 'mouse-drag-and-drop-region' to detect edges of re... e292c09 Fix #'fun handling inside `labels' (Bug#31792)
| * Change index of ";" to better reflect it's usage (Bug#31623)Noam Postavsky2018-06-201-9/+9
| | | | | | | | | | | | * doc/lispref/objects.texi (Comments): "; for commenting" fits better with the following text about how a semicolon begins a comment. Also mention that only unescaped semicolons start a comment.
* | Merge from emacs-26Noam Postavsky2018-06-101-0/+15
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3434edc731 Enlarge DUMPED_HEAP_SIZE for 64-bit Windows builds 36bbdfc017 Update Unicode data files to version 11.0.0 of Unicode b7b7a5f4f3 * etc/NEWS: Belatedly call out vc-hg changes in v26.1. (B... 5b6f8b54d1 Clarify the documentation of 'dired-recursive-deletes' 9db97b49cd ; * etc/DEBUG: Add information about debugging libXft prob... 0214ffbe60 Clarify doc string of 'update-glyphless-char-display' ef35d405b1 Clarify subtle issues with 'eq' in byte-compiled code c6ef3c8321 Make cl-print respect print-quoted (bug#31649) 26b52ac40e Fix unexpected jumps of window-point in 'set-window-config... 4af077ab4d * etc/emacs.appdata.xml: Update Emacs screenshot. e5ab25deae Fix cursor movement by 'next-logical-line' after 'next-line' d20beef5f1 Fix prompt in bookmark.el (Bug#24726) c57e7eaae8 Improve documentation of 'empty' whitespace-style # Conflicts: # etc/NEWS
| * Clarify subtle issues with 'eq' in byte-compiled codeEli Zaretskii2018-06-081-0/+15
| | | | | | | | | | | | * doc/lispref/objects.texi (Equality Predicates): Explain why byte-compiled code might compare literal objects with identical contents as 'eq'. (Bug#31688)
* | Clarify eq on floatsPaul Eggert2018-04-021-0/+10
|/ | | | | * doc/lispref/objects.texi (Equality Predicates): Say that two floats with the same values might or might not be eq.
* Minor fix in documentation of 'equal'Eli Zaretskii2018-01-261-3/+2
| | | | | | * doc/lispref/objects.texi (Equality Predicates): Correct the conditions for equality of unibyte and multibyte strings. (Bug#30218)
* Update copyright year to 2018Paul Eggert2018-01-011-1/+1
| | | | Run admin/update-copyright.
* Reorder type predicates in ELisp manualEli Zaretskii2017-11-241-21/+12
| | | | | * doc/lispref/objects.texi (Type Predicates): Restore alphabetical order of listed predicates. (Bug#29411)
* Adapt Lisp reference to reader changesPhilipp Stephani2017-07-021-17/+18
| | | | | | | | | The reader now warns about some unescaped character literals, but still allows them for compatibility reasons. Slightly adapt the manual to forbid them officially. * doc/lispref/objects.texi (Basic Char Syntax): Document that backslashes are now required before some characters.
generated by cgit v1.2.1 (git 2.18.0) at 2026-04-22 03:33:54 +0000