aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/objects.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* 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.
* ; Spelling and punctuation fixesPaul Eggert2017-04-061-2/+2
|
* Update documentation for type semantics of records.Lars Brinkhoff2017-04-061-1/+15
| | | | | | | | | | | * objects.texi (Record Type): improve description of what `type-of' returns for records. (Type Descriptors): new section. * elisp.texi: reference it. * records.texi (Records): reference it. Document behaviour when type slot is a record. * alloc.c (Fmake_record, Frecord): mention type desciptors.
* Add record objects with user-defined types.Lars Brinkhoff2017-04-041-3/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * src/alloc.c (allocate_record): New function. (Fmake_record, Frecord, Fcopy_record): New functions. (syms_of_alloc): defsubr them. (purecopy): Work with records. * src/data.c (Ftype_of): Return slot 0 for record objects, or type name if record's type holds class. (Frecordp): New function. (syms_of_data): defsubr it. Define `Qrecordp'. (Faref, Faset): Work with records. * src/fns.c (Flength): Work with records. * src/lisp.h (prec_type): Add PVEC_RECORD. (RECORDP, CHECK_RECORD, CHECK_RECORD_TYPE): New functions. * src/lread.c (read1): Add syntax for records. * src/print.c (PRINT_CIRCLE_CANDIDATE_P): Add RECORDP. (print_object): Add syntax for records. * test/lisp/emacs-lisp/cl-print-tests.el (cl-print-tests-2): New test. * test/src/alloc-tests.el (record-1, record-2, record-3): New tests. * doc/lispref/elisp.texi, doc/lispref/objects.texi, doc/lispref/records.texi: Add documentation for records.
* Hash table threshold is now float, not doublePaul Eggert2017-02-211-1/+1
| | | | | | | | | | | | | | | Change default from 0.8 to 0.8125 so it fits in float without rounding glitches. * doc/lispref/hash.texi (Creating Hash): * doc/lispref/objects.texi (Hash Table Type): * etc/NEWS: Document change. * src/fns.c (make_hash_table, maybe_resize_hash_table) (Fmake_hash_table): Threshold is now float, not double. Be consistent about how this is rounded. * src/lisp.h (struct Lisp_Hash_Table.rehash_threshold): Change back to float, now that the other code rounds consistently. (DEFAULT_REHASH_THRESHOLD): Now float 0.8125 instead of double 0.8.
* Merge from origin/emacs-25Paul Eggert2017-01-011-1/+1
|\ | | | | | | | | 2e2a806 Fix copyright years by hand 5badc81 Update copyright year to 2017
| * Update copyright year to 2017Paul Eggert2016-12-311-1/+1
| | | | | | | | Run admin/update-copyright.
* | Documentation and commentary improvementsEli Zaretskii2016-12-101-0/+69
| | | | | | | | | | | | | | | | | | | | | | | | * src/lisp.h: * src/regex.c: * src/xgselect.c (xg_select): Improve commentary and formatting. * doc/lispref/objects.texi (Thread Type, Mutex Type) (Condition Variable Type): New subsections. (Type Predicates): Add thread-related predicates. * doc/lispref/objects.texi (Editing Types): * doc/lispref/elisp.texi (Top): Update higher-level menus.
* | Merge branch 'concurrency'Eli Zaretskii2016-12-041-5/+15
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Conflicts (resolved): configure.ac src/Makefile.in src/alloc.c src/bytecode.c src/emacs.c src/eval.c src/lisp.h src/process.c src/regex.c src/regex.h
| * \ merge from trunkKen Raeburn2015-11-011-60/+78
| |\ \
| * \ \ merge from trunkTom Tromey2013-03-081-3/+5
| |\ \ \
generated by cgit v1.2.1 (git 2.18.0) at 2026-01-13 19:54:55 +0000