aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/functions.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Remove #' and function quoting from lambda forms in manualMattias Engdegård2020-04-191-1/+1
| | | | | | | | | | | | * doc/lispref/abbrevs.texi (Abbrev Expansion): * doc/lispref/backups.texi (Reverting): * doc/lispref/functions.texi (Mapping Functions): * doc/lispref/help.texi (Accessing Documentation): * doc/lispref/sequences.texi (Char-Tables): * doc/lispref/syntax.texi (Categories): * doc/lispref/text.texi (Sorting): Remove function quoting from lambda in examples where it still occurs, since examples should follow our best style and be consistent.
* ; Fix some typos and doc issues (bug#40695)Štěpán Němec2020-04-181-1/+1
|
* ; Move the description of define-inline to a different node in functions.texiRichard Stallman2020-01-111-96/+100
|
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Fix documentation of define-obsolete-* functionsEli Zaretskii2019-12-281-3/+3
| | | | | | | | | | | * doc/lispref/functions.texi (Obsolete Functions): Make documentation of functions that obsolete symbols match the advertised calling conventions. * lisp/emacs-lisp/byte-run.el (define-obsolete-function-alias) (define-obsolete-variable-alias, define-obsolete-face-alias): State in the doc strings that WHEN is a mandatory argument, to be consistent with the advertised calling convention. (Bug#38675)
* Improve indexing of function doc string conventionsEli Zaretskii2019-11-151-1/+2
| | | | | * doc/lispref/functions.texi (Function Documentation): Improve indexing (bug#38158).
* Minor wording change in ELisp manualRichard Stallman2019-11-011-3/+9
| | | | | | * doc/lispref/functions.texi (Advising Named Functions): Improve and clarify wording of the advice to avoid advising functions in released code.
* identity, ignore: Make arg names more consistent with docsJuanma Barranquero2019-10-101-4/+4
| | | | | | | | * lisp/subr.el (ignore): Rename argument IGNORE to ARGUMENTS. * src/fns.c (Fidentity): Rename ARG to ARGUMENT. * doc/lispref/functions.texi (Calling Functions): Fix references.
* Add an advice-add/interactive spec exampleŠtěpán Němec2019-08-181-0/+24
| | | | | * doc/lispref/functions.texi (Core Advising Primitives): Add an advice-add example that extends the `interactive' spec (bug#17871).
* Capitalise a couple of node namesLars Ingebrigtsen2019-08-041-5/+5
| | | | | | * doc/lispref/functions.texi (Advising Functions): Capitalise node names (bug#17717). (Advice Combinators, Porting Old Advice): Capitalise.
* Core Advising Primitives `interactive' clarificationLars Ingebrigtsen2019-08-041-1/+2
| | | | | * doc/lispref/functions.texi (Core Advising Primitives): Clarify when the interactive spec is a function (bug#17871).
* Add a really simple nadvice exampleLars Ingebrigtsen2019-07-091-2/+20
| | | | | * doc/lispref/functions.texi (Advising Functions): Add a really trivial and simple example (bug#35250).
* Merge from origin/emacs-26Glenn Morris2019-06-011-1/+1
|\ | | | | | | | | | | | | | | | | | | | | 2168165 ; * doc/lispref/nonascii.texi (Explicit Encoding): Fix typo. 8f18d12 Improve documentation of decoding into a unibyte buffer 7681a57 Remove redundants "See" before @xref or @pxref (Bug#35793) 9bee762 ; * src/coding.c: Improve commentary. (Bug#34765) e61349c Fix customization type of recentf-max-saved-items # Conflicts: # src/coding.c
| * Remove redundants "See" before @xref or @pxref (Bug#35793)Mauro Aranda2019-05-251-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/control.texi (Control Structures): * doc/lispref/modes.texi (Search-based Fontification): * doc/misc/cc-mode.texi (Filling and Line Breaking Commands) (Auto-newline Insertion, Other Special Indentations): * doc/misc/dbus.texi (Errors and Events): * doc/misc/dired-x.texi (Find File At Point): * doc/misc/eudc.texi (Display of Query Results, Inline Query Expansion): * doc/misc/gnus-faq.texi (FAQ 3-11): * doc/misc/gnus.texi (Group Parameters, Posting Styles) (Spam Package Introduction): * doc/misc/org.texi (LaTeX fragments, Previewing LaTeX fragments): * doc/misc/reftex.texi (Commands): Remove redundant "See" before cross references. * doc/lispref/functions.texi (Function Safety): Redundant "see" is in ignored text, but remove it anyway. * doc/lispref/positions.texi (Skipping Characters): Remove redundant "See" before cross references. Change @xref to @pxref, which is more suitable when at the end of a sentence. Most of the redundants "See" found by Noam Postavsky.
| * Backport: Improve pure and side-effect-free docsBasil L. Contovounesios2019-04-221-1/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For discussion, see thread starting at: https://lists.gnu.org/archive/html/emacs-devel/2019-04/msg00316.html * doc/lispref/customize.texi (Composite Types): Do not overspecify :match-alternatives predicates. * doc/lispref/eval.texi (Intro Eval): Anchor definition of "side effect" for cross-referencing... * doc/lispref/functions.texi (What Is a Function): ...from here. Define what a pure function is. * doc/lispref/internals.texi (Writing Emacs Primitives): Describe currently preferred approach to marking primitives as pure and side-effect-free. * doc/lispref/symbols.texi (Standard Properties): Expand description of pure and side-effect-free properties. (cherry picked from commit 4430a9b54fca266e48d0eb8b72d83706910f10b8)
* | Improve documentation of the 'function' special formMichael Heerdegen2019-05-241-0/+4
| | | | | | | | | | | | | | | | Point out that 'function' quoting is beneficial also for symbols. * src/eval.c (function): Enhance docstring. * doc/lispref/functions.texi (Anonymous Functions): Improve documentation.
* | Improve pure and side-effect-free docsBasil L. Contovounesios2019-04-221-1/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For discussion, see thread starting at: https://lists.gnu.org/archive/html/emacs-devel/2019-04/msg00316.html * doc/lispref/customize.texi (Composite Types): Do not overspecify :match-alternatives predicates. * doc/lispref/eval.texi (Intro Eval): Anchor definition of "side effect" for cross-referencing... * doc/lispref/functions.texi (What Is a Function): ...from here. Define what a pure function is. * doc/lispref/internals.texi (Writing Emacs Primitives): Describe currently preferred approach to marking primitives as pure and side-effect-free. * doc/lispref/symbols.texi (Standard Properties): Expand description of pure and side-effect-free properties.
* | 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)'.
* | Merge from origin/emacs-26Glenn Morris2018-11-121-3/+6
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 913c001 * lisp/files.el (write-file): Clarify the doc string. (Bug#3... d614b84 Fix typos in midnight.el 8c2778a Improve documentation of 'move-file-to-trash' c7b8a51 ; * doc/lispref/functions.texi (Anonymous Functions): Fix typo. 92296de * src/data.c (Ftype_of): xwidget objects are possible! (bug#3... a3242cc Improve documentation of Diff mode 39e85a0 Note that lex bound lambda forms are not self-quoting (Bug#33... fa605f2 Rewrite buffer display related doc-strings and doc aa55659 Fix call to GlobalMemoryStatusEx in w32.c # Conflicts: # doc/emacs/files.texi # src/data.c
| * ; * doc/lispref/functions.texi (Anonymous Functions): Fix typo.Charles A. Roelli2018-11-101-2/+2
| |
| * Note that lex bound lambda forms are not self-quoting (Bug#33199)Noam Postavsky2018-11-081-3/+6
| | | | | | | | | | | | * doc/lispref/functions.texi (Anonymous Functions): * lisp/subr.el (lambda): Note that under lexical binding a lambda form yields a closure object (Bug#33199).
* | Merge from origin/emacs-26Glenn Morris2018-10-311-0/+7
|\ \ | |/ | | | | | | | | | | | | | | | | | | eb903d8 * lisp/emacs-lisp/pcase.el: Improve docstrings. 86abbb3 * lisp/emacs-lisp/rx.el (rx): Fix typo in doc string. (Bug#3... ced58d3 Improve doc string of 'call-process' 38f88a7 Document that generic functions cannot be commands 5aeddfa * lisp/mail/rmailsum.el (rmail-summary-output): Add lost word... 10e0fd8 Add index entries for more isearch commands/bindings (Bug#32990) de28184 * lisp/simple.el (filter-buffer-substring): Clarify doc (Bug#... d192c16 Fix recent change in lispref/processes.texi.
| * Document that generic functions cannot be commandsEli Zaretskii2018-10-301-0/+7
| | | | | | | | | | | | | | * doc/lispref/commands.texi (Defining Commands): * doc/lispref/functions.texi (Generic Functions): Document that generic functions cannot be turned into commands. (Bug#33170)
* | Merge from origin/emacs-26Glenn Morris2018-10-031-1/+3
|\ \ | |/ | | | | | | | | | | | | ea77c65 Revert "Temporary workaround for bug #32848 for branch emacs-26" 2c8ea46 Revert "* etc/NEWS: Note setting make-cursor-line-fully-visib... f8df6f2 * etc/NEWS: Note setting make-cursor-line-fully-visible to ni... cdca208 Fix note about interactive advice (Bug#32905) 508c40e Comple fix for Bug#32550
| * Fix note about interactive advice (Bug#32905)Noam Postavsky2018-10-021-1/+3
| | | | | | | | | | * doc/lispref/functions.texi (Core Advising Primitives): Add missing ':', and finish the sentence fragment.
* | Merge from origin/emacs-26Glenn Morris2018-06-231-4/+8
|\ \ | |/ | | | | | | | | | | | | | | bbc9d37 (origin/emacs-26) Fix previous change in minibuffer-default-a... 7caeef1 * src/editfns.c (Fformat): Make %x easier to spot in doc stri... ecc29fb Improve responsiveness while in 'replace-buffer-contents' 8182d64 Improve documentation of 'server-start' and friends decdfed Clarify wording about functions' argument lists 5abac8b * lisp/doc-view.el: Fix typos in the commentary. (Bug#31937)
| * Clarify wording about functions' argument listsEli Zaretskii2018-06-231-4/+8
| | | | | | | | | | * doc/lispref/functions.texi (Argument List): Clarify the wording. (Bug#31872)
* | Merge from origin/emacs-26Glenn Morris2018-04-201-0/+8
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5de608f (origin/emacs-26) Update the documentation of 'perform-replace' 06245b6 * etc/NEWS: Another fix for the last change (noted by Juri Li... 8f6293c Fix use of @key in Texinfo manuals f4c9894 Improve documentation of actual arglist ce0e253 ; * etc/NEWS: Improve last change as proposed by Phil Sainty b89ff0e Don't assume term-current-row cache is valid (Bug#31193) 326a296 ; * etc/NEWS: Mention 'display-buffer-in-major-side-window' c... 3bdc9a1 Fix flyspell-auto-correct-previous-word broken by recent change a539eb5 * test/src/lread-tests.el (lread-test-bug-31186): New test. 3fa472b Fix undefined behaviour while looking for lexical-binding fil... 4341aac Minor wording improvement in "Bookmarks" Conflicts: test/src/lread-tests.el
| * Improve documentation of actual arglistEli Zaretskii2018-04-191-0/+8
| | | | | | | | | | | | | | * doc/lispref/functions.texi (Function Documentation): Advise against using '(fn ARGLIST)' method of advertising a calling convention when the old calling convention is deprecated. (Bug#31191)
* | Merge from origin/emacs-26Glenn Morris2018-03-281-0/+2
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 9bff405 (origin/emacs-26) * doc/misc/org.texi (Installation): Fix clo... 613c9a5 Update Org to v9.1.9 1b075a9 ; Fix some tiny doc typos 441fe20 De-obsolete `if-let' and `when-let' 8696038 * lisp/htmlfontify.el (hfy-begin-span-handler): Doc fix. 930f7b1 * doc/lispref/functions.texi (Defining Functions): Improve in... 95ccf50 Fix crash after frame is freed on macOS (bug#30800) 45d0475 More manual editing 2acb9f0 Minor manual changes changes d481cba * lisp/calculator.el (calculator-paste-decimals): Add version. 7d6c7d0 ; Use GNU not Gnu in docs 1bc4def More proofreading of the Emacs manual Conflicts: doc/misc/org.texi etc/NEWS lisp/org/org-clock.el
| * * doc/lispref/functions.texi (Defining Functions): Improve indexing.Eli Zaretskii2018-03-261-0/+2
| |
* | Allow `&rest' or `&optional' without following variable (Bug#29165)Noam Postavsky2018-03-251-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is sometimes convenient when writing macros, so that the empty variable case doesn't need to be handled specially. Older versions of Emacs accepted this in some cases (especially the interpreter in Emacs 25 and below was very accepting). | interpreted/compiled | | arglist | 25 & earlier | 26 | 27 | |---------------------------+--------------+-----+-----| | (&rest) | y/n | n/n | y/y | | (&rest &rest) | y/n | n/n | n/n | | (&rest &rest x) | y/n | n/n | n/n | | (&rest x &rest) | y/n | n/n | n/n | | (&rest x &rest y) | y/n | n/n | n/n | |---------------------------+--------------+-----+-----| | (&optional) | y/n | n/n | y/y | | (&optional &optional) | y/n | n/n | n/n | | (&optional x &optional) | y/n | n/n | n/n | | (&optional x &optional y) | y/y | n/n | n/n | |---------------------------+--------------+-----+-----| | (&optional &rest) | y/n | n/n | y/y | | (&optional x &rest) | y/n | n/n | y/y | | (&optional &rest y) | y/y | n/n | y/y | |---------------------------+--------------+-----+-----| | (&rest &optional) | y/n | n/n | n/n | | (&rest &optional y) | y/n | n/n | n/n | | (&rest x &optional y) | y/n | n/n | n/n | The values in the table above can be produced with the following code: (with-current-buffer (get-buffer-create "*ck-args*") (erase-buffer) (dolist (arglist '((&rest) (&rest &rest) (&rest &rest x) (&rest x &rest) (&rest x &rest y) (&optional) (&optional &optional) (&optional x &optional) (&optional x &optional y) (&optional &rest) (&optional x &rest) (&optional &rest y) (&rest &optional) (&rest &optional y) (&rest x &optional y))) (insert (format "%c/%c\n" (condition-case err (progn (funcall `(lambda ,arglist 'ok)) ?y) (error ?n)) (condition-case err (progn (byte-compile-check-lambda-list arglist) ?y) (error ?n)))) (display-buffer (current-buffer)))) * src/eval.c (funcall_lambda): * lisp/emacs-lisp/bytecomp.el (byte-compile-check-lambda-list): Don't check for missing variables after `&rest' and `&optional'. * test/src/eval-tests.el (eval-tests--bugs-24912-and-24913) (eval-tests-accept-empty-optional-rest): Update tests accordingly. * etc/NEWS: Update announcement accordingly. * doc/lispref/functions.texi (Argument List): Update manual to indicate that variable names are optional.
* | Merge from origin/emacs-26Glenn Morris2018-02-241-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | 7e7f2ea (origin/emacs-26) * src/keyboard.c (syms_of_keyboard): Doc fi... c0676d4 Improve documentation of X resources d806d69 ; Use @minus for negative numbers in some texi files 4a8ea7d * lisp/international/mule.el (keyboard-coding-system): Doc fix. 8a73b80 Minor doc fixes, mostly for timestamp issues 361a8b9 * doc/emacs/mini.texi (Completion Styles): Improve indexing. 2dc24d5 Fix @findex and @vindex entries in manuals 76f5242 Document, in the Elisp manual, how to get a character's raw s... 5fb2957 Improvements in the Emacs manual de17b8e Tiny doc/misc markup fixes
| * Minor doc fixes, mostly for timestamp issuesPaul Eggert2018-02-231-1/+1
| |
* | Merge from origin/emacs-26Glenn Morris2018-02-021-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | 6f495ab (origin/emacs-26) Another round of manual fixups 59344c4 * doc/lispref/customize.texi (Custom Themes): Clarify .el pre... 6386efc * doc/emacs/entering.texi (Entering Emacs): Another wording fix. e21f018 * doc/lispref/functions.texi (Inline Functions): Fix typo (Bu... 1c2fb04 * lisp/imenu.el (imenu-generic-expression): Rephrase doc (Bug... b90e91c Fix last change of @key markup f180075 * doc/emacs/entering.texi (Entering Emacs): Fix markup.
| * * doc/lispref/functions.texi (Inline Functions): Fix typo (Bug#30238).Noam Postavsky2018-02-011-1/+1
| |
| * Fix description of 'struct' generic function specializerStephen Leake2018-01-041-3/+3
| | | | | | | | | | | | | | | | | | | | Backport: * doc/lispref/functions.texi (Generic Functions): Fix description of 'struct' specializer; it must be the named struct or a child, not a parent. (cherry picked from commit b6add8c7cfc6d36f9dd8ad99be06bd8ab41cc6f8)
* | Fix description of 'struct' generic function specializerStephen Leake2018-01-021-3/+3
| | | | | | | | | | | | * doc/lispref/functions.texi (Generic Functions): Fix description of 'struct' specializer; it must be the named struct or a child, not a parent.
* | Merge from origin/emacs-26Paul Eggert2018-01-011-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 63b04c11d5 Fix copyright years by hand 5c7dd8a783 Update copyright year to 2018 220a9ecba1 Merge from Gnulib 312c565566 Don't add empty keyboard macro to macro ring (Bug#24992) 39ca289a7a Allow customization of decoding of "man" command f8240815ea * etc/NEWS: Add security consideration note on passphrase ... 0c78822c70 Fix subtle problem with scroll-down when scroll-margin is ... acd289c5a4 Fix problems with indexing in User manual b240c7846b * lisp/help.el (describe-key): Only (copy-sequence elt) wh... e879a5444a * src/buffer.c (Frestore_buffer_modified_p): Fix bug#29846 81b1028b63 Improve documentation of 'inhibit-modification-hooks' and ... 7175496d7a Fix doc string of 'enable-recursive-minibuffers' 5b38406491 Fix documentation of delsel and of killing text # Conflicts: # etc/NEWS # etc/refcards/ru-refcard.tex
| * Update copyright year to 2018Paul Eggert2018-01-011-1/+1
| | | | | | | | Run admin/update-copyright.
* | Merge from origin/emacs-26Glenn Morris2017-12-221-2/+2
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 34fcfc5 (origin/emacs-26, emacs-26) * lisp/emacs-lisp/inline.el (defi... f7a62c2 Fix doc string of 'footnote-style-alist' c3b6742 Improve documentation of selecting windows 861d110 Improve documentation of records 22b3075 * etc/NEWS: Mention the removal of pinentry.el. (Bug#27445) 689526b Fix interactive spec of 'semantic-ia-show-variants' 90ca37f Fix documentation of 'mouse-drag-and-drop-region' and friends d60faf3 Improve detection of speller version in ispell.el a0e3b06 Document 'mouse-drag-and-drop-region' options and mention the... 164e84c Fix uses of 'nil' and 'non-nil' in manuals and a few more min... 798f07f Document that mode commands should be idempotent. ad2a47c ; * src/xdisp.c (extend_face_to_end_of_line): Fix last change. 88ddf53 Fontify a CPP construct correctly when a comment follows with... de7de9c Prevent infloop in redisplay on TTY frames 293720e Fix loss of documentation face in certain CC Mode doc comment... # Conflicts: # etc/NEWS # lisp/mail/footnote.el
| * Fix uses of 'nil' and 'non-nil' in manuals and a few more minor issuesMartin Rudalics2017-12-221-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/building.texi (Grep Searching): Fix doc of 'grep-save-buffers'. (Drag and Drop): Reorder paragraphs. Fix doc of 'mouse-drag-and-drop-region'. * doc/emacs/frames.texi (Word and Line Mouse): * doc/emacs/search.texi (Other Repeating Search): * doc/lispref/compile.texi (Compilation Functions): * doc/lispref/files.texi (Directory Names): * doc/lispref/functions.texi (Advising Named Functions): * doc/lispref/keymaps.texi (Controlling Active Maps): * doc/lispref/lists.texi (Association Lists): * doc/lispref/windows.texi (Quitting Windows): Fix uses of 'non-nil' and 'nil'.
* | Clarify manual section on &context specializer for methodsEric Abrahamsen2017-12-141-10/+15
|/ | | | | * doc/lispref/functions.texi (Generic Functions): Provide a little more information on how they work.
* Fix a typo in the ELisp manualEli Zaretskii2017-10-301-2/+2
| | | | | * doc/lispref/functions.texi (Obsolete Functions): Fix a typo. (Bug#29068)
* Fix some duplicate words typosGlenn Morris2017-10-271-1/+1
| | | | | | | | | | * lisp/erc/erc.el (erc-hide-current-message-p): * lisp/progmodes/flymake-proc.el (flymake-proc-diagnostic-type-pred): * doc/lispref/display.texi (Bidirectional Display, Delayed Warnings): * doc/lispref/functions.texi (Defining Functions): * doc/lispref/os.texi (Terminal-Specific): * doc/misc/sem-user.texi (Analyzer Debug): * doc/misc/srecode.texi (Special Variables): Fix typos.
* Fix a minor markup problem in ELisp manualEli Zaretskii2017-09-061-2/+2
| | | | | | * doc/lispref/functions.texi (Mapping Functions): Fix the order of @example and @group. For the details, see http://lists.gnu.org/archive/html/bug-texinfo/2017-09/msg00007.html.
* Sync NEWS with the documentationEli Zaretskii2017-08-301-5/+25
| | | | | | * etc/NEWS: Mark entries according to documentation. * doc/lispref/functions.texi (Mapping Functions): Document 'mapcan'.
* Document internal-use naming conventionsPaul Eggert2017-08-121-0/+9
| | | | | | | * doc/lispref/functions.texi (Function Names): * doc/lispref/variables.texi (Tips for Defining): Document naming conventions for internal-use functions and vars. See Bug#28023#59.
* [doc elisp] Add some index entries for "old" advice mechanismThien-Thi Nguyen2017-03-081-0/+7
| | | | | * doc/lispref/functions.texi (Porting old advice): Add one @cindex and two @findex entries.
generated by cgit v1.2.1 (git 2.18.0) at 2026-01-14 17:43:11 +0000