Eli Zaretskii
6bb3c6f9e1
Merge from origin/emacs-30
...
cc5b1a01a26c2aaedfced56e5ba97e#78685 .
80cbd1e31c1224e5fd9679e7eeb3292838b64fc89adb05422e4858d818482a8e223b8d14c707b42d
2025-04-30 07:14:23 -04:00
Eli Zaretskii
80cbd1e31c
; Fix key notation in Introduction to Emacs Lisp
...
* doc/lispintro/emacs-lisp-intro.texi (Typing Lists)
(Note for Novices): Fix notation of 'M-C-\'. (Bug#78153)
2025-04-30 09:03:17 +03:00
Stefan Kangas
96a704346a
Don't recommend legacy keymap functions in documentation
...
* 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-03-11 21:19:13 +01:00
Stefan Monnier
d685d21e8a
(lexical-binding): Allow changing the default value (bug#74145)
...
* 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-02-18 15:37:50 -05:00
Stefan Kangas
fb282da2a0
Avoid double spaces around abbrevations in Texinfo
...
* 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-24 23:10:23 +01:00
Hong Xu
6d8c3c0cbe
Use keymap*-set' over global-set-key'/`define-key' in elisp intro
...
* 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-04 14:33:10 +02:00
Stefan Kangas
7fa975adbc
Update copyright year to 2025
...
Run "TZ=UTC0 admin/update-copyright".
2025-01-02 18:39:42 +01:00
Eli Zaretskii
861b7864fc
; Fix node name in emacs-lisp-intro.texi
...
* doc/lispintro/emacs-lisp-intro.texi
(Lexical vs Dynamic Binding Example): Renamed from "... vs. ...",
to avoid using period in node names.
2024-12-22 12:11:46 +02:00
Stefan Kangas
4047072c7d
Update FSF's address
...
* 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-09-02 21:02:09 +02:00
Stefan Kangas
00adee897a
; Fix punctuation in docs
2024-07-21 17:35:13 +02:00
Eli Zaretskii
a4828155d8
; * doc/lispintro/emacs-lisp-intro.texi (nthcdr): Whitespace (bug#71033).
2024-05-18 14:38:29 +03:00
Brad Howes
f37f01b504
Fix a typo in Introduction to Emacs Lisp (bug#70571).
...
Copyright-paperwork-exempt: yes
2024-04-27 12:43:58 +03:00
Eli Zaretskii
1f97a87879
Fix info-xref-tests
...
* 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-13 20:38:34 +02:00
Jim Porter
d58d0fa52f
Introduce 'let' using lexical binding in the Lisp Introduction
...
* 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-09 10:31:06 -08:00
Po Lu
8e1c56ae46
; Add 2024 to copyright years
2024-01-02 09:47:10 +08:00
Eli Zaretskii
03dc914fd3
; Fix footnotes in ELisp Intro manual
2023-12-24 10:46:04 +02:00
Xiyue Deng
ceacf75395
Fix usage of `setq-default' and offer more suggestions
...
cd61af0
2023-12-24 10:38:46 +02:00
Xiyue Deng
fba7b9db39
Add explanation for extra parentheses in ELisp Introduction
...
* doc/lispintro/emacs-lisp-intro.texi (fwd-para while): Add
a note to explain the extra parentheses. (Bug#67820)
2023-12-23 11:35:33 +02:00
Xiyue Deng
7723282682
Add sample code to the "let*" section in "forward-paragraph"
...
* doc/lispintro/emacs-lisp-intro.texi (fwd-para let): Add code
sample. (Bug#67817)
2023-12-23 10:48:06 +02:00
Stefan Monnier
77678244b8
doc/lispintro: Don't mention set (bug#67734)
...
* 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-21 10:24:29 -05:00
Stefan Kangas
5f923ff1a6
; Fix typos
2023-12-03 23:31:30 +01:00
Xiyue Deng
7f0bef47dd
Drop extra parenthesis in example code in Emacs Lisp Introduction
...
* doc/lispintro/emacs-lisp-intro.texi (Small buffer case): Drop
trailing unmatched parenthesis. (Bug#67576)
Copyright-paperwork-exempt: yes
2023-12-02 09:59:43 +02:00
Xiyue Deng
bd62bdbc68
Fix example code in Emacs Lisp Introduction manual
...
* doc/lispintro/emacs-lisp-intro.texi (Optional Arguments): Fix
indentation in an example. (Bug#67559)
Copyright-paperwork-exempt: yes
2023-12-01 13:55:59 +02:00
Eli Zaretskii
c7e459132a
Fix example in Emacs Lisp Intro manual
...
* 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-12-01 10:47:27 +02:00
Eli Zaretskii
2e5d47f578
; * doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Fix last change.
2023-11-29 15:04:49 +02:00
Xiyue Deng
c46700deb0
Add more text to clarify the behavior of 'with-current-buffer'
...
* doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Expand
description of 'with-current-buffer'. (Bug#67521)
Copyright-paperwork-exempt: yes
2023-11-29 15:01:20 +02:00
Richard Stallman
e521669fb3
Fix wording in ELisp Intro manual
...
* doc/lispintro/emacs-lisp-intro.texi (Lisp macro): Improve
wording in description of 'unless'. (Bug#67185)
2023-11-19 12:14:36 +02:00
Eli Zaretskii
27c71979ff
; Another Texinfo fix
...
* doc/lispintro/emacs-lisp-intro.texi (Counting function
definitions): Fix Texinfo 7.1 warning.
2023-10-22 14:05:53 +03:00
Eli Zaretskii
1d9200d9bb
; * doc/lispintro/emacs-lisp-intro.texi (car & cdr): Fix typo.
...
(cherry picked from commit 0ebedd0119
2023-06-25 08:27:01 +03:00
Richard M. Stallman
987b25d60d
Clarify list terminology
...
* 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 188c90c7c1
2023-06-25 08:26:20 +03:00
Basil L. Contovounesios
0e9307eb2b
Fix some Texinfo markup in manuals
...
* 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.
2023-06-13 15:29:06 +01:00
Eli Zaretskii
d041f01b02
; Minor fix in Emacs Lisp Intro manual
...
* doc/lispintro/emacs-lisp-intro.texi (what-line): Fix punctuation
and wording. Reported by Holger Kienle <hkienle@posteo.de>.
(Bug#62998)
2023-04-21 19:16:52 +03:00
Eli Zaretskii
cae528457c
; Add 2023 to copyright years.
2023-01-01 05:31:12 -05:00
Shynur
9f4306cd8d
; * doc/lispintro/emacs-lisp-intro.texi (Complete kill-region): Fix typo
2022-11-23 10:26:46 +01:00
Mattias Engdegård
60102016e4
Abolish max-specpdl-size (bug#57911)
...
The max-lisp-eval-depth limit is sufficient to prevent unbounded stack
growth including the specbind stack; simplify matters for the user by
not having them to worry about two different limits. This change
turns max-specpdl-size into a harmless variable with no effects,
to keep existing code happy.
* lisp/subr.el (max-specpdl-size):
Define as an ordinary (but obsolete) dynamic variable.
* admin/grammars/Makefile.in:
* doc/lispintro/emacs-lisp-intro.texi (Loops & Recursion):
* doc/lispref/control.texi (Cleanups):
* doc/lispref/edebug.texi (Checking Whether to Stop):
* doc/lispref/eval.texi (Eval):
* doc/lispref/variables.texi (Local Variables):
* doc/misc/calc.texi (Recursion Depth):
Update documentation.
* etc/NEWS: Announce.
* src/eval.c
(FletX): Use safe iteration to guard against circular bindings list.
(syms_of_eval): Remove old max-specpdl-size definition.
(init_eval_once, restore_stack_limits, call_debugger)
(signal_or_quit, grow_specpdl_allocation):
* leim/Makefile.in:
* lisp/Makefile.in:
* lisp/calc/calc-stuff.el (calc-more-recursion-depth)
(calc-less-recursion-depth):
* lisp/calc/calc.el (calc-do):
* lisp/cedet/semantic/ede-grammar.el (ede-proj-makefile-insert-rules):
* lisp/cedet/semantic/grammar.el (semantic-grammar-batch-build-one-package):
* lisp/cus-start.el (standard):
* lisp/emacs-lisp/comp.el (comp--native-compile):
* lisp/emacs-lisp/edebug.el (edebug-max-depth):
(edebug-read-and-maybe-wrap-form, edebug-default-enter):
* lisp/emacs-lisp/regexp-opt.el (regexp-opt):
* lisp/eshell/esh-mode.el (eshell-mode):
* lisp/loadup.el (max-specpdl-size):
* lisp/mh-e/mh-e.el (mh-invisible-headers):
* lisp/net/shr.el (shr-insert-document, shr-descend):
* lisp/play/hanoi.el (hanoi-internal):
* lisp/progmodes/cperl-mode.el:
* src/fileio.c (Fdo_auto_save):
Remove references to and modifications of max-specpdl-size.
2022-09-19 19:30:03 +02:00
Stefan Kangas
8f784a2766
Merge from origin/emacs-28
...
a4078fa628dd077ebded362c9ab879
2022-08-17 06:30:25 +02:00
Stefan Kangas
dd077ebded
Revert "; * doc/lispintro/emacs-lisp-intro.texi: Fix typo."
...
This reverts commit 9d0dba44da
2022-08-16 13:38:40 +02:00
Stefan Kangas
75372c6c4e
Merge from origin/emacs-28
...
9d0dba44da0e336fa51f
2022-08-15 06:30:29 +02:00
Stefan Kangas
d5174ed4ea
Don't use obsolete library as example in Elisp Intro
...
* doc/lispintro/emacs-lisp-intro.texi (Several files recursively)
(Sorting, Files List): Don't use obsolete library makesum.el as
example.
2022-08-14 23:46:33 +02:00
Stefan Kangas
9d0dba44da
; * doc/lispintro/emacs-lisp-intro.texi: Fix typo.
2022-08-14 16:44:29 +02:00
Stefan Kangas
2d4058b3ff
Merge from origin/emacs-28
...
72fc7258bfe746fc2e7b77613b9217
2022-08-13 06:30:27 +02:00
Stefan Kangas
e746fc2e7b
Delete stale comments from Lisp Intro manual
...
* doc/lispintro/emacs-lisp-intro.texi (Args as Variable or List)
(print-elements-of-list, Miscellaneous): Delete some references to
Emacs 22.
2022-08-12 15:59:36 +02:00
Paul Eggert
083d2708f9
Change current-time back to list form
...
Change current-time and related functions back to using the
traditional list form. Also, add a new boolean variable
current-time-list that lets people try out (TICKS . HZ) form,
with the goal of smoothing the transition.
* src/timefns.c (CURRENT_TIME_LIST): Change default back to true.
(current-time-list): New boolean Lisp variable, which defaults to
CURRENT_TIME_LIST. All uses of CURRENT_TIME_LIST changed to
use current_time_list, and all documentation changed.
2022-04-28 12:54:06 -07:00
Paul Eggert
4a1f69ebca
Use (TICKS . HZ) for current-time etc.
...
* src/timefns.c (CURRENT_TIME_LIST): Change default to false.
All documentation changed.
2022-04-25 12:40:20 -07:00
Lars Ingebrigtsen
cb09a1120e
Make the eintr.html target match what's on the web
...
* doc/lispintro/Makefile.in (HTML_TARGETS, eintr.html): Make the
name match the URL at
https://www.gnu.org/software/emacs/manual/eintr.html (bug#38817).
2022-02-07 04:58:49 +01:00
Eli Zaretskii
dcd76bd48d
Merge from origin/emacs-28
...
836be7a11286cbc6ee4aebe8772f6523c1ee69898d3fc7ec8919dcb237b5
2022-01-01 07:03:03 -05:00
Eli Zaretskii
19dcb237b5
; Add 2022 to copyright years.
2022-01-01 02:45:51 -05:00
Stefan Kangas
cf6dc1838a
; Fix spelling; be consistent with "key binding" (Bug#52674)
2021-12-21 11:19:04 +01:00
YugaEgo
b7338d870a
Cleanup append-to-buffer section in ELisp Intro
...
* doc/lispintro/emacs-lisp-intro.texi
(append-to-buffer, Buffer Related Review, fwd-para let):
Finalize shifting focus of the 'let*' introduction
to the 'append-to-buffer' section. Improve wording, fix
typos, remove redundant comments (Bug#8275).
2021-12-18 16:24:45 +02:00
Stefan Kangas
93d9bc09f4
Merge from origin/emacs-28
...
e632b83a28e9fdb119038fa4749df1ea5a90b4f4ef4954b69c6d5886e7809e16c6a96d9aa8fd6e6270c229b1fccd9dd26d24ab291656d0354f6c56096192525a96
2021-12-01 06:30:22 +01:00
