summaryrefslogtreecommitdiff
path: root/doc/lispintro
AgeCommit message (Collapse)Author
2026-05-03; * doc/lispintro/emacs-lisp-intro.texi: Update *Backtrace* outputs.Matto Fransen
Copyright-paperwork-exempt: yes
2026-04-12; * doc/lispintro/emacs-lisp-intro.texi (Files List): Fix typo (bug#80694).Eli Zaretskii
2026-04-10; Update "Key Binding" node in Emacs Lisp IntroEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Key Bindings): Remove obsolete text about \C in key bindings. (Bug#80787)
2026-04-07; Update description of 'defcustom' in Emacs Lisp Intro manualEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (defcustom): Update text (bug#80751).
2026-03-29; Fix a typo in 'emacs-lisp-intro.texi'Eli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (lengths-list-file): Fix doc string of 'lengths-list-file' and surrounding text. (Bug#80686)
2026-03-21; * doc/lispintro/emacs-lisp-intro.texi: Fix parens (bug#80646).Eli Zaretskii
2026-03-08; * doc/lispintro/emacs-lisp-intro.texi (Lists diagrammed): Fix last change.Eli Zaretskii
2026-03-08Use images in Emacs Lisp Intro manual (bug#80519)Eli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Lists diagrammed) (Symbols as Chest, kill-ring-yank-pointer, lambda): Use @image and remove ASCII-art diagrams, which are now on separate *.txt files. (header): Remove print-postscript-figures and its commentary. * doc/lispintro/Makefile.in (auxfiles): New file list. (${buildinfodir}/%.txt, ${buildinfodir}/%.png): New targets. (${buildinfodir}/eintr.info): Depend on ${auxfiles}. (infoclean): Remove ${auxfiles}. * doc/lispintro/cons-1.png: * doc/lispintro/cons-1.txt: * doc/lispintro/cons-2.png: * doc/lispintro/cons-2.txt: * doc/lispintro/cons-2a.png: * doc/lispintro/cons-2a.txt: * doc/lispintro/cons-3.png: * doc/lispintro/cons-3.txt: * doc/lispintro/cons-4.png: * doc/lispintro/cons-4.txt: * doc/lispintro/cons-5.png: * doc/lispintro/cons-5.txt: * doc/lispintro/drawers.png: * doc/lispintro/drawers.txt: * doc/lispintro/lambda-1.png: * doc/lispintro/lambda-1.txt: * doc/lispintro/lambda-2.png: * doc/lispintro/lambda-2.txt: * doc/lispintro/lambda-3.png: * doc/lispintro/lambda-3.txt: New files, from Matto Fransen <matto@matto.nl>.
2026-02-27emacs-lisp-intro.texi: Eliminate duplicate ASCII artStefan Monnier
* doc/lispintro/emacs-lisp-intro.texi (print-postscript-figures): Set it only if we're outputting TeX. (Lists diagrammed, Lists diagrammed, Lists diagrammed) (Lists diagrammed, Lists diagrammed, Symbols as Chest) (kill-ring-yank-pointer, lambda): Presume that `print-postscript-figures` is set only for TeX output and remove the `@tex...@end tex` around `@image` which do not seem relevant any more.
2026-02-21Adapt ELisp Intro manual to recent changes in EmacsEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Effect of installation): Fix example. (Bug#80442) (Review): Adapt to recent Emacs. (Bug#80447)
2026-02-21; Make the document language in Info manuals explicitly statedEli Zaretskii
* doc/misc/woman.texi: * doc/misc/wisent.texi: * doc/misc/widget.texi: * doc/misc/vtable.texi: * doc/misc/viper.texi: * doc/misc/vhdl-mode.texi: * doc/misc/use-package.texi: * doc/misc/url.texi: * doc/misc/tramp.texi: * doc/misc/todo-mode.texi: * doc/misc/srecode.texi: * doc/misc/speedbar.texi: * doc/misc/smtpmail.texi: * doc/misc/sieve.texi: * doc/misc/ses.texi: * doc/misc/semantic.texi: * doc/misc/sc.texi: * doc/misc/sasl.texi: * doc/misc/remember.texi: * doc/misc/reftex.texi: * doc/misc/rcirc.texi: * doc/misc/pgg.texi: * doc/misc/pcl-cvs.texi: * doc/misc/octave-mode.texi: * doc/misc/nxml-mode.texi: * doc/misc/newsticker.texi: * doc/misc/mh-e.texi: * doc/misc/message.texi: * doc/misc/mairix-el.texi: * doc/misc/info.texi: * doc/misc/ido.texi: * doc/misc/idlwave.texi: * doc/misc/htmlfontify.texi: * doc/misc/gnus.texi: * doc/misc/forms.texi: * doc/misc/flymake.texi: * doc/misc/eww.texi: * doc/misc/eudc.texi: * doc/misc/eshell.texi: * doc/misc/ert.texi: * doc/misc/erc.texi: * doc/misc/epa.texi: * doc/misc/emacs-gnutls.texi: * doc/misc/eieio.texi: * doc/misc/eglot.texi: * doc/misc/efaq-w32.texi: * doc/misc/efaq.texi: * doc/misc/edt.texi: * doc/misc/ediff.texi: * doc/misc/ede.texi: * doc/misc/ebrowse.texi: * doc/misc/dired-x.texi: * doc/misc/dbus.texi: * doc/misc/cl.texi: * doc/misc/cc-mode.texi: * doc/misc/calc.texi: * doc/misc/bovine.texi: * doc/misc/autotype.texi: * doc/misc/auth.texi: * doc/lispintro/emacs-lisp-intro.texi: * doc/lispref/elisp.texi: * doc/emacs/emacs.texi: Add @documentlanguage where it was missing. This makes the language explicit given the change in behavior expected in Texinfo 7.3.
2026-02-16Fix cross-reference in Emacs Lisp IntroEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Lexical & Dynamic Binding Differences): Fix cross-reference. (Bug#80420)
2026-02-14Say in Emacs Lisp Intro how to contribute code to EmacsEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Permanent Installation): Add a cross-reference to "Contributing" in the Emacs user manual. Suggested by Matto Fransen <matto@matto.nl>. (Bug#80393)
2026-01-01; Add 2026 to copyright years.Sean Whitton
2025-07-24; Fix file name in "Loading Files" doc.Paul Eggert
2025-04-30Merge from origin/emacs-30Eli Zaretskii
cc5b1a01a2c ; * doc/misc/efaq-w32.texi (Location of init file): Fix a... 6c2aaedfceb Fix compilation errors in emacsclient.c with MinGW GCC 15 d56e5ba97ee ; * etc/DEBUG: Add link to GCC bug #78685. 80cbd1e31cc ; Fix key notation in Introduction to Emacs Lisp 1224e5fd961 ; * lisp/files.el (revert-buffer-restore-functions): Doc ... 79e7eeb3296 ; Improve documentation of 'format-time-string' 2838b64fc8b ; * lisp/textmodes/text-mode.el (text-mode-variant): Fix ... 9adb05422ea ; Improve obsolescence of 'text-mode-variant' 4858d818488 ; * lisp/files.el (revert-buffer-restore-functions): Doc ... 2a8e223b8d7 ; Mention early-init file in Emacs FAQ for Windows 14c707b42d9 ; Isearch: Fix key bindings in docstrings
2025-04-30; Fix key notation in Introduction to Emacs LispEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Typing Lists) (Note for Novices): Fix notation of 'M-C-\'. (Bug#78153)
2025-03-11Don't recommend legacy keymap functions in documentationStefan Kangas
* doc/emacs/mule.texi (Input Methods): * doc/lispintro/emacs-lisp-intro.texi (Miscellaneous): * doc/lispref/text.texi (Clickable Text): * doc/misc/calc.texi (Defining Functions, Defining Simple Commands) (Customizing Calc): * doc/misc/efaq.texi (Matching parentheses, Modifying pull-down menus) (Deleting menus and menu options, Binding keys to commands) (Invalid prefix characters) (Terminal setup code works after Emacs has begun) (Backspace invokes help, Swapping keys, No Escape key) (Binding combinations of modifiers and function keys) (Replying to the sender of a message): * doc/misc/eudc.texi (Installation, Emacs-only Configuration) (External Configuration): * doc/misc/gnus.texi (Group Parameters, Misc Group Stuff) (Summary Buffer, Generic Marking Commands, RSS) (nnmairix tips and tricks, Oort Gnus): * doc/misc/ido.texi (Customization): * doc/misc/mairix-el.texi (Using): * doc/misc/mh-e.texi (HTML, Miscellaneous Commands and Options) (Folders, Composing): * doc/misc/octave-mode.texi (Running Octave from Within Emacs): * doc/misc/reftex.texi (Citations Outside LaTeX): * doc/misc/remember.texi (Quick Start): * doc/misc/sem-user.texi (Smart Jump): * doc/misc/viper.texi (Key Bindings, Vi Macros): * doc/misc/widget.texi (Defining New Widgets): * doc/misc/woman.texi (Word at point): Recommend 'keymap-set', 'keymap-global-set', 'keymap-global-unset', 'keymap-local-set', and 'key-translate', instead of their legacy equivalents. (Bug#55647)
2025-02-20; Delete troff markers from ChangeLog filesStefan Kangas
2025-02-18(lexical-binding): Allow changing the default value (bug#74145)Stefan Monnier
* lisp/loadup.el: Preserve (default-toplevel-value 'lexical-binding). * src/lread.c (Fload, Feval_buffer): Obey (default-toplevel-value 'lexical-binding). * doc/lispintro/emacs-lisp-intro.texi (Lexical vs Dynamic Binding Example): Use the lexical dialect also for the dynamic scoping example. * doc/lispref/edebug.texi (Edebug Eval): Remove long-obsolete mention of Edebug support for `lexical-let`.
2025-01-25Merge from origin/emacs-30Eli Zaretskii
67903f5909d Restore the old behavior of `bookmark-write-file' 062da7003f9 ; Improve prompts and error messages in 'info-look' 52dc01f1c8b ; * admin/admin.el (set-version): Note about Android. fb282da2a07 Avoid double spaces around abbrevations in Texinfo bc1ab8ac3d8 ; * doc/emacs/custom.texi (Init Rebinding): Fix spacing. b41ef43af19 ; Fix previous change 5638b1d6bd4 Ispell: Use "personal dictionary" terminology consistently cc791e7499f ; Check man pages for mistakes less frequently 4ed4792e3b9 ; * admin/release-process: Minor copy-edits. 4a867c823b7 Add language server "ruff server" for Python 9e687c2871f Fix go-ts-mode type declaration indentation (Bug#75785) f751b3afa4f ; Minor improvements for doc strings in map.el cda78edc7d9 ; Fix typos ce50a1d3c18 ; * src/w32.c (w32_memory_info): Fix coding style of last... 58d3d4820ad Fix bug in w32_memory_info 77386412050 Avoid crashes in redisplay due to problematic font setups 0e3687e6006 Improve 'key-valid-p' docstring 9878092d2b9 Minor copyedits in internals.texi 4726900fdc5 Better document side-effect free and pure C functions 04c475a39f2 ; Fix documentation about faces of tool-tip text # Conflicts: # admin/codespell/codespell.exclude
2025-01-24Avoid double spaces around abbrevations in TexinfoStefan Kangas
* doc/emacs/custom.texi (Init Rebinding): * doc/emacs/dired.texi (Operating on Files): * doc/emacs/emacs.texi (Top): * doc/emacs/emerge-xtra.texi (Emerge): * doc/emacs/files.texi (Files): * doc/emacs/frames.texi (Drag and Drop): * doc/emacs/misc.texi (Hyperlinking): * doc/emacs/modes.texi (Modes): * doc/emacs/mule.texi (Input Methods): * doc/emacs/windows.texi (Window Tool Bar): * doc/lispintro/emacs-lisp-intro.texi (Lexical & Dynamic Binding Differences): * doc/lispref/elisp.texi (Top): * doc/lispref/functions.texi (Functions, Generic Functions): * doc/lispref/hash.texi (Defining Hash): * doc/lispref/keymaps.texi (Creating Keymaps): * doc/lispref/lists.texi (Property Lists): * doc/lispref/modes.texi (%-Constructs): * doc/lispref/nonascii.texi (Character Properties): * doc/lispref/processes.texi (Misc Network): * doc/lispref/searching.texi (Regexp Functions): * doc/lispref/syntax.texi (Syntax Table Internals): * doc/lispref/text.texi (Filling, Checksum/Hash) (JSONRPC deferred requests): * doc/misc/calc.texi (What is Calc, Modes Tutorial): * doc/misc/cc-mode.texi (List Line-Up, Operator Line-Up) (Custom Macros, Indenting Directives): * doc/misc/efaq.texi (Colors on a TTY, Security risks with Emacs): * doc/misc/eglot.texi (Eglot Variables): * doc/misc/erc.texi (Connecting): * doc/misc/eshell.texi (Aliases, Completion): * doc/misc/flymake.texi (Backend functions): * doc/misc/gnus-faq.texi (FAQ 5 - Composing messages): * doc/misc/gnus.texi (Gnus Unplugged, Window Layout) (Filtering Incoming Mail, History): * doc/misc/idlwave.texi (Online Help, Catalogs): * doc/misc/wisent.texi (Wisent Overview): Be more consistent with abbreviations. Use @: or comma or rewrite to avoid double spaces. Ref: https://lists.gnu.org/r/emacs-devel/2025-01/msg00909.html
2025-01-04Merge from origin/emacs-30Eli Zaretskii
6468c3f7a74 Update doc string of 'insert' 6d8c3c0cbe4 Use `keymap*-set' over `global-set-key'/`define-key' in e... 4b2bb63b7ac Fix documentation and prompt in 'package-isolate' 55f43f5b220 ; Fix typo in treesit-explore-mode 921f454f508 Update fontification for attribute values in heex-ts-mode ae2589ea7a5 Add expression handling to heex-ts-mode 0cacf806391 ; * etc/NEWS: Document change of 'make-cursor-line-fully-... f47a29da5c4 * lisp/man.el (Man-mode): Improve docstring. # Conflicts: # etc/NEWS
2025-01-04Use `keymap*-set' over `global-set-key'/`define-key' in elisp introHong Xu
* doc/lispintro/emacs-lisp-intro.texi (Key Bindings): Since `global-set-key' and `define-key' are considered legacy, we encourage `keymap-global-set' and `keymap-set' now. (Bug#74999)
2025-01-02Update copyright year to 2025Stefan Kangas
Run "TZ=UTC0 admin/update-copyright".
2025-01-01Update copyright year to 2025Paul Eggert
Run "TZ=UTC0 admin/update-copyright".
2024-12-22; Fix node name in emacs-lisp-intro.texiEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Lexical vs Dynamic Binding Example): Renamed from "... vs. ...", to avoid using period in node names.
2024-09-02Update FSF's addressStefan Kangas
* doc/emacs/emacs.texi (Distrib): * doc/lispintro/emacs-lisp-intro.texi: * doc/lispref/elisp.texi: * doc/misc/org.org (Link Abbreviations): * etc/tutorials/TUTORIAL.eo: * lisp/elide-head.el: * lisp/textmodes/page-ext.el: Update the FSF address to 31 Milk Street.
2024-07-21; Fix punctuation in docsStefan Kangas
2024-05-18; * doc/lispintro/emacs-lisp-intro.texi (nthcdr): Whitespace (bug#71033).Eli Zaretskii
2024-04-27Fix a typo in Introduction to Emacs Lisp (bug#70571).Brad Howes
Copyright-paperwork-exempt: yes
2024-01-13Fix info-xref-testsEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (How let Binds Variables): Fix cross-reference. (Bug#68428) * test/lisp/info-xref-tests.el (info-xref-test-write-file): Fix test on MS-Windows when run from MSYS Bash.
2024-01-09Introduce 'let' using lexical binding in the Lisp IntroductionJim Porter
* doc/lispintro/emacs-lisp-intro.texi (Prevent confusion): Rework the explanation to discuss how things work under lexical binding. (How let Binds Variables): Describe the differences between lexical and dynamic binding (including how to configure it). (defvar): Mention that 'defvar' declares variables as always dynamically-bound (bug#66756).
2024-01-02; Add 2024 to copyright yearsPo Lu
2023-12-24; Fix footnotes in ELisp Intro manualEli Zaretskii
2023-12-24Fix usage of `setq-default' and offer more suggestionsXiyue Deng
cd61af0 changed from default-major-mode to major-mode in the first code sample but didn't change the rest. This patch fixes this and add some explanations of why use `setq-default' instead of `setq'. In addition, it gives background on suggesting using text-mode as default mode and suggest other alternatives. * doc/lispintro/emacs-lisp-intro.texi (Text and Auto-fill): Fix usage of `setq-default' and offer more suggestions. (Bug#67848)
2023-12-23Add explanation for extra parentheses in ELisp IntroductionXiyue Deng
* doc/lispintro/emacs-lisp-intro.texi (fwd-para while): Add a note to explain the extra parentheses. (Bug#67820)
2023-12-23Add sample code to the "let*" section in "forward-paragraph"Xiyue Deng
* doc/lispintro/emacs-lisp-intro.texi (fwd-para let): Add code sample. (Bug#67817)
2023-12-21doc/lispintro: Don't mention `set` (bug#67734)Stefan Monnier
* doc/lispintro/emacs-lisp-intro.texi (Using set): Delete. (Using setq): Adjust accordingly. (setq): Rename from "set & setq" and don't refer to `set` any more. (Review): Don't mention `set` any more.
2023-12-03; Fix typosStefan Kangas
2023-12-02Drop extra parenthesis in example code in Emacs Lisp IntroductionXiyue Deng
* doc/lispintro/emacs-lisp-intro.texi (Small buffer case): Drop trailing unmatched parenthesis. (Bug#67576) Copyright-paperwork-exempt: yes
2023-12-01Fix example code in Emacs Lisp Introduction manualXiyue Deng
* doc/lispintro/emacs-lisp-intro.texi (Optional Arguments): Fix indentation in an example. (Bug#67559) Copyright-paperwork-exempt: yes
2023-12-01Fix example in Emacs Lisp Intro manualEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (beginning-of-buffer opt arg): Fix indentation in example. Reported by Xiyue Deng <manphiz@gmail.com>. (Bug#67560)
2023-11-29; * doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Fix last change.Eli Zaretskii
2023-11-29Add more text to clarify the behavior of 'with-current-buffer'Xiyue Deng
* doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Expand description of 'with-current-buffer'. (Bug#67521) Copyright-paperwork-exempt: yes
2023-11-19Fix wording in ELisp Intro manualRichard Stallman
* doc/lispintro/emacs-lisp-intro.texi (Lisp macro): Improve wording in description of 'unless'. (Bug#67185)
2023-10-22; Another Texinfo fixEli Zaretskii
* doc/lispintro/emacs-lisp-intro.texi (Counting function definitions): Fix Texinfo 7.1 warning.
2023-06-25; * doc/lispintro/emacs-lisp-intro.texi (car & cdr): Fix typo.Eli Zaretskii
(cherry picked from commit 0ebedd0119c1bc3c1f55e873385a01e97f102766)
2023-06-25Clarify list terminologyRichard M. Stallman
* doc/lispintro/emacs-lisp-intro.texi (Lists diagrammed): Mention "cons cell". Add index entries. (car & cdr): Simplify etymology of `car' and `cdr'. Explain why for some purposes they are better than `first' and `rest'. Mention cons cells. (cherry picked from commit 188c90c7c111dbbdc3edd29c23b59ade26f97bfd)
2023-06-13Fix some Texinfo markup in manualsBasil L. Contovounesios
* doc/emacs/macos.texi (Mac / GNUstep Customization): * doc/lispintro/emacs-lisp-intro.texi (condition-case): * doc/lispref/control.texi (pcase Macro): * doc/lispref/debugging.texi (Internals of Debugger): * doc/lispref/internals.texi (Building Emacs): * doc/lispref/modes.texi (Imenu): (Parser-based Font Lock, Parser-based Indentation): * doc/lispref/parsing.texi (Retrieving Nodes, Tree-sitter C API): * doc/lispref/processes.texi (Network, Bindat Types): * doc/lispref/searching.texi (Rx Functions): * doc/lispref/text.texi (Replacing): * doc/lispref/windows.texi (Textual Scrolling): * doc/misc/calc.texi (Killing From Stack, Customizing Calc): * doc/misc/cc-mode.texi (Misc Font Locking, List Line-Up): * doc/misc/ede.texi (ede-cpp-root-project) (ede-proj-target-makefile, ede-sourcecode): * doc/misc/ert.texi (Running Tests in Batch Mode): * doc/misc/eudc.texi (Emacs-only Configuration, The Server Hotlist): * doc/misc/eww.texi (Advanced): * doc/misc/flymake.texi (Starting Flymake) (Proc customization variables): * doc/misc/tramp.texi (File name completion): * doc/misc/gnus.texi (Summary Buffer Lines, Gnus Registry Setup) (Fancy splitting to parent, Customizing the IMAP Connection) (Mail Source Specifiers, Agent as Cache): Consistently mark up nil and t as @code. Also fix the markup and wording of some surrounding text (bug#64016). * doc/lispref/display.texi (SVG Images, Icons): * doc/lispref/modes.texi (Customizing Keywords): Prefer ASCII apostrophe over Unicode right single quotation mark.