summaryrefslogtreecommitdiff
path: root/doc/lispref/symbols.texi
Commit message (Collapse)AuthorAgeFilesLines
* Backport: Improve pure and side-effect-free docsBasil L. Contovounesios2019-04-221-4/+11
| | | | | | | | | | | | | | | | | | 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)
* Update copyright year to 2019Paul Eggert2019-01-011-1/+1
| | | | Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
* Update copyright year to 2018Paul Eggert2018-01-011-1/+1
| | | | Run admin/update-copyright.
* Remove "baroque" use of prefix argument from gensymMark Oteiza2017-09-131-2/+1
| | | | | | | | | 'cl-gensym' was simply moved here, but let us take an opportunity to shed some historical baggage. * lisp/subr.el (gensym): Remove special treatment of PREFIX as a number. Use "g" as prefix to differentiate from cl-gensym defaults. * doc/lispref/symbols.texi (Creating Symbols): Update accordingly. * lisp/emacs-lisp/cl-macs.el (cl--gensym-counter, cl-gensym): Restore.
* Move gensym to core ElispMark Oteiza2017-09-121-0/+7
| | | | | | | | | | | | | | | | | | | | | * doc/lispref/symbols.texi (Creating Symbols): Mention gensym right after make-symbol. * etc/NEWS: Mention. * lisp/emacs-lisp/cl-macs.el (cl--gensym-counter): Alias to gensym-counter. (cl-gensym): Alias to gensym. * lisp/emacs-lisp/cl.el: Remove gensym from list of aliases. * lisp/emacs-lisp/edebug.el (edebug-make-enter-wrapper): * lisp/emacs-lisp/ert-x.el (ert-with-message-capture): (ert--expand-should-1, ert--expand-should): (ert--should-error-handle-error): * lisp/emacs-lisp/generator.el (cps--gensym): * lisp/emacs-lisp/gv.el (setf): * lisp/emacs-lisp/inline.el (inline--do-letlisteval): * lisp/emacs-lisp/pcase.el (pcase--make-docstring, pcase-dolist): (pcase--funcall, pcase--u1): Use gensym. * lisp/subr.el (gensym-counter): New variable. (gensym): New function, assimilated from cl-lib.
* Update copyright year to 2017Paul Eggert2016-12-311-1/+1
| | | | Run admin/update-copyright.
* Typo fixes in elisp manualBogdan Creanga2016-11-291-1/+1
| | | | | | | | | * doc/lispref/sequences.texi: Add missing '4' in result (Bug#25047). * doc/lispref/strings.texi (Text Comparison): Avoid duplicate definitions of 'string-prefix-p' and 'string-suffix-p'. * doc/lispref/symbols.texi (Definitions): Pluralize 'definitions'. Copyright-paperwork-exempt: yes
* Document 'function-put'Eli Zaretskii2016-01-161-2/+15
| | | | | * doc/lispref/symbols.texi (Symbol Plists): Document 'function-put'. Update documentation of 'function-get'.
* Update copyright year to 2016Paul Eggert2016-01-011-1/+1
| | | | Run admin/update-copyright.
* Restore some of the quoting in the manualsEli Zaretskii2015-09-161-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/windows.texi (Coordinates and Windows) (Coordinates and Windows): * doc/lispref/variables.texi (Lexical Binding) (File Local Variables): * doc/lispref/text.texi (Format Properties): * doc/lispref/symbols.texi (Symbol Components): * doc/lispref/strings.texi (Creating Strings): * doc/lispref/sequences.texi (Sequence Functions): * doc/lispref/searching.texi (Regexp Special, Regexp Search) (Search and Replace): * doc/lispref/processes.texi (Bindat Spec): * doc/lispref/os.texi (Idle Timers): * doc/lispref/objects.texi (Basic Char Syntax): * doc/lispref/numbers.texi (Float Basics, Random Numbers): * doc/lispref/nonascii.texi (Character Properties): * doc/lispref/modes.texi (Major Mode Conventions, Mode Hooks) (Mode Line Variables): * doc/lispref/minibuf.texi (Text from Minibuffer): * doc/lispref/loading.texi (Autoload): * doc/lispref/keymaps.texi (Controlling Active Maps): * doc/lispref/frames.texi (Frame Layout, Size and Position) (Size Parameters, Implied Frame Resizing): * doc/lispref/files.texi (Changing Files, Magic File Names): * doc/lispref/eval.texi (Self-Evaluating Forms): * doc/lispref/display.texi (Progress, Abstract Display) (Abstract Display Example, Bidirectional Display): * doc/lispref/commands.texi (Event Mod): * doc/emacs/windows.texi (Displaying Buffers): * doc/emacs/trouble.texi (Bug Criteria, Checklist): * doc/emacs/text.texi (Enriched Text): * doc/emacs/programs.texi (MixedCase Words): * doc/emacs/picture-xtra.texi (Insert in Picture) (Tabs in Picture): * doc/emacs/misc.texi (Emacs Server, Printing): * doc/emacs/mini.texi (Minibuffer History): * doc/emacs/maintaining.texi (Old Revisions, VC Change Log) (Pulling / Pushing): * doc/emacs/killing.texi (Yanking, Cut and Paste, Clipboard): * doc/emacs/help.texi (Help, Help Echo): * doc/emacs/glossary.texi (Glossary): * doc/emacs/frames.texi (Mouse Commands, Creating Frames) (Frame Commands): * doc/emacs/files.texi (Reverting, Saving, Directories): * doc/emacs/entering.texi (Exiting): * doc/emacs/emacs.texi (Top): * doc/emacs/cmdargs.texi (Window Size X, Icons X): * doc/emacs/anti.texi (Antinews): Restore quoting of text where appropriate or replace quoting with @dfn. * doc/misc/ediff.texi (Window and Frame Configuration): * doc/lispref/processes.texi (Network Feature Testing): * doc/lispref/display.texi (Display Margins): Quote the phrase after "a.k.a." where appropriate.
* Quote less in manualsPaul Eggert2015-09-151-3/+3
| | | | | | | | | | The manuals often used quotes ``...'' when it is better to use @dfn or @code or capitalized words or no quoting at all. For example, there is no need for the `` and '' in “if a variable has one effect for @code{nil} values and another effect for ``non-@code{nil}'' values”. Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate unnecessary quoting like this, and to use @dfn etc. instead when called for (Bug#21472).
* Update copyright year to 2015Paul Eggert2015-01-011-1/+1
| | | | Run admin/update-copyright.
* Update copyright year to 2014 by running admin/update-copyright.Paul Eggert2014-01-011-1/+1
|
* * symbols.texi (Standard Properties): Document pure. (Bug#13823)Christopher Schmidt2013-03-171-2/+3
|
* Merge from emacs-24; up to 2012-12-06T01:39:03Z!monnier@iro.umontreal.caPaul Eggert2013-01-021-1/+2
|\
| * Update copyright notices for 2013.Paul Eggert2013-01-011-1/+2
| |
* | Spelling fixes.Paul Eggert2012-12-061-1/+1
|/
* Fix minor whitespace issues after "." in manual.Paul Eggert2012-12-051-2/+2
| | | | | | | | | | | | Be more systematic about using "@." (not ".") at end of sentence that ends in a capital letter, and about appending "@:" after non-ends of sentences that end in a lower case letter followed by "." followed by whitespace. Omit unnecessary use of "@:" and "@.". Similarly for "?" and "!". Be more consistent about putting a comma after "i.e." and "e.g."; this is the typical American style and it's easier to code in Texinfo. Fixes: debbugs:12973
* Minor fixes for Lisp manual.Chong Yidong2012-12-051-7/+16
| | | | | | * lists.texi (Plist Access): Move put example to Symbol Plists. * symbols.texi (Standard Properties): Fix typo.
* Lisp manual improvements for plists and symbol plists.Chong Yidong2012-12-021-159/+141
| | | | | | | | | | | | | | | * doc/lispref/commands.texi (Using Interactive): Fix index entry. * doc/lispref/customize.texi (Variable Definitions): * doc/lispref/display.texi (Defining Faces): * doc/lispref/sequences.texi (Char-Tables): Fix xref. * doc/lispref/lists.texi (Property Lists): Move here from symbols.texi. (Plist Access): Rename from Other Plists. * doc/lispref/symbols.texi (Symbol Properties): New node. (Symbol Plists): Make it a subsection under Symbol Properties. (Standard Properties): New node.
* Document more Emacs 24.3 changes.Chong Yidong2012-10-301-0/+6
| | | | | | | | * frames.texi (Visibility of Frames): Document tty-top-frame. * loading.texi (Autoload): Document autoloadp, autoload-do-load. * symbols.texi (Symbol Plists): Document function-get.
* Nuke hand-written node pointers in doc/lisprefGlenn Morris2012-05-261-5/+5
| | | | Let makeinfo figure them out, as is recommended.
* Merge from emacs-24; up to 2012-04-21T14:12:27Z!sdl.web@gmail.comGlenn Morris2012-05-081-10/+10
|\
| * More small edits for doc/lisprefGlenn Morris2012-05-041-11/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * control.texi: Where possible, use example rather than smallexample. (Sequencing, Conditionals, Signaling Errors, Handling Errors): Tweak page breaks. * customize.texi: Where possible, use example rather than smallexample. (Common Keywords, Variable Definitions, Applying Customizations) (Custom Themes): Tweak page breaks. * eval.texi, functions.texi, loading.texi, macros.texi: Where possible, use example rather than smallexample. * sequences.texi (Arrays): Tweak page breaks. * symbols.texi: Where possible, use example rather than smallexample. (Symbol Components): Fix typo. (Other Plists): Tweak page break.
* | Merge changes from emacs-24 branchChong Yidong2012-04-271-1/+1
|\ \ | |/
| * Use Texinfo recommended convention for quotes+punctuation.Glenn Morris2012-04-251-1/+1
| |
* | Remove unnecessary @setfilename commands from many doc/lispref/*.texiGlenn Morris2012-04-131-2/+1
|/
* Update several Lisp manual chapters.Chong Yidong2012-01-231-97/+79
| | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/eval.texi (Intro Eval, Symbol Forms): Minor tweaks for correctness with lexical scoping. (Eval): Copyedits. * doc/lispref/sequences.texi (Sequence Functions): Don't repeat the introduction already given in the parent. (Vectors): Copyedits. (Rings): Move from lists.texi. Note that this is specific to the ring package. * doc/lispref/lists.texi (Cons Cells): Copyedits. (List Elements): Mention push. (List Variables): Mention pop. (Rings): Move to sequences.texi. * doc/lispref/strings.texi (Text Comparison): Minor qualification. * doc/lispref/symbols.texi (Definitions, Symbol Components): Mention variable scoping issues. (Plists and Alists): Copyedits.
* Add 2012 to FSF copyright years for Emacs filesGlenn Morris2012-01-051-1/+1
|
* * doc/lispref/symbols.texi (Other Plists): Markup fix. (Bug#9702)Glenn Morris2011-10-081-1/+1
|
* Convert consecutive FSF copyright years to ranges.Glenn Morris2011-01-241-2/+1
|
* Nuke arch-tags.Glenn Morris2011-01-151-4/+0
|
* Add 2011 to FSF/AIST copyright years.Glenn Morris2011-01-021-1/+1
|
* Document some Emacs 23.3 changes in manuals.Chong Yidong2010-11-201-1/+1
| | | | | | | | | | | | | | | | | * doc/emacs/macos.texi (Mac / GNUstep Basics): Document ns-right-alternate-modifier. * doc/lispref/numbers.texi (Float Basics): Document float-e and float-pi. * doc/lispref/symbols.texi (Creating Symbols): Using unintern without an obarray arg is now obsolete. * doc/lispref/text.texi (Kill Functions, Kill Functions) (Low-Level Kill Ring, Low-Level Kill Ring): Remove obsolete YANK-HANDLER args. * doc/lispref/variables.texi (Defining Variables): Change "pi" example to "float-pi".
* Add 2010 to copyright years.Glenn Morris2010-01-131-1/+1
|
* (Property Lists): Emphasize that property lists are not restricted to symbol ↵Chong Yidong2009-02-221-16/+14
| | | | | | cells. (Other Plists): Copyedit.
* Add 2009 to copyright years.Glenn Morris2009-01-081-1/+1
|
* Fix last change.Chong Yidong2008-08-051-1/+1
|
* (Other Plists): Fix incorrect example. Suggested by Florian Beck.Chong Yidong2008-08-051-2/+2
|
* Merge from emacs--rel--22Miles Bader2008-01-081-1/+1
| | | | Revision: emacs@sv.gnu.org/emacs--devo--0--patch-987
* (setfilename): Go up one more level to ../../info.Glenn Morris2007-09-061-1/+1
|
* Move here from ../../lisprefGlenn Morris2007-09-061-0/+598
View Lorry Controller Status