]> git.eshelyaron.com Git - emacs.git/log
emacs.git
4 years ago; Update TODO item about ligature support
Eli Zaretskii [Tue, 19 May 2020 15:46:27 +0000 (18:46 +0300)]
; Update TODO item about ligature support

* etc/TODO: Add the todo item for moving cursor "inside" a
ligature.

4 years ago* doc/lispref/control.texi (Processing of Errors): Improve indexing.
Stefan Kangas [Tue, 19 May 2020 00:33:57 +0000 (02:33 +0200)]
* doc/lispref/control.texi (Processing of Errors): Improve indexing.

4 years agoMinor fixups for mutability doc
Paul Eggert [Sun, 17 May 2020 01:16:23 +0000 (18:16 -0700)]
Minor fixups for mutability doc

* doc/lispref/objects.texi (Mutability): Minor fixups in
response to a comment by Dmitry Gutov (Bug#40671#477).

4 years agoDon’t use “constant” for values you shouldn’t change
Paul Eggert [Sun, 17 May 2020 00:17:00 +0000 (17:17 -0700)]
Don’t use “constant” for values you shouldn’t change

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.

4 years agoImprove documentation of manually installing Lisp packages
Eli Zaretskii [Sat, 16 May 2020 08:54:37 +0000 (11:54 +0300)]
Improve documentation of manually installing Lisp packages

* doc/emacs/building.texi (Lisp Libraries): Describe how to
manually load packages in the init file.  Mention the 'site-lisp'
subdirectory of the default 'load-path'.

* doc/emacs/package.texi (Packages): Describe manual installation
of ELisp packages.  Suggested by Jean-Christophe Helary
<jean.christophe.helary@traduction-libre.org>.

4 years agoReflect the emacs-devel ELPA/MELPA dispute in FAQ
Eli Zaretskii [Sat, 16 May 2020 07:30:43 +0000 (10:30 +0300)]
Reflect the emacs-devel ELPA/MELPA dispute in FAQ

* doc/misc/efaq.texi (Packages that do not come with Emacs): Warn
that some MELPA packages may require non-free software.

4 years agoConsider face inheritance when checking region face background.
Tassilo Horn [Fri, 15 May 2020 20:24:29 +0000 (22:24 +0200)]
Consider face inheritance when checking region face background.

Some themes (like dracula) make the region face inherit from some
other face.  If the background color of the region was inherited,
`indicate-copied-region' did the switch-point-and-mark-twice dance
which is not visible in case the region is highlighted.  It just
looked like Emacs would hang for a second after M-w.

* lisp/simple.el (indicate-copied-region): Consider face inheritance
when checking region face background.

4 years agoFix dired default file operation (bug#41261)
Leo Vivier [Thu, 14 May 2020 22:03:18 +0000 (00:03 +0200)]
Fix dired default file operation (bug#41261)

* lisp/dired-aux.el (dired-dwim-target-directories): Restore
pre-emacs-27 behavior of 'dired-dwim-target'.

4 years agoFix documentation related to 'command-switch-alist'.
Philipp Stephani [Thu, 14 May 2020 17:26:43 +0000 (19:26 +0200)]
Fix documentation related to 'command-switch-alist'.

While there, add a unit test to verify the behavior.

* doc/lispref/os.texi (Command-Line Arguments): Fix documentation: the
option string in 'command-switch-alist' does include leading hyphens.
Also mention that 'command-switch-alist' parsing ignores equals signs
in options.

* test/lisp/startup-tests.el
(startup-tests/command-switch-alist): New unit test.

4 years agoImprove ediff readability in misterioso theme (Bug#41221)
Simon Lang [Tue, 12 May 2020 21:54:52 +0000 (22:54 +0100)]
Improve ediff readability in misterioso theme (Bug#41221)

* etc/themes/misterioso-theme.el: Add ediff faces.

Copyright-paperwork-exempt: yes

4 years agoFix a crash in handle_display_spec
Clément Pit-Claudel [Wed, 13 May 2020 14:37:05 +0000 (10:37 -0400)]
Fix a crash in handle_display_spec

* src/xdisp.c (handle_display_spec): Check that the cdr of the
disable-eval spec is a cons before taking its car.  (Bug#41232)

4 years agoIn x_hide_tip reset tip_last_frame for GTK+ tooltips only (Bug#41200)
Martin Rudalics [Wed, 13 May 2020 08:31:50 +0000 (10:31 +0200)]
In x_hide_tip reset tip_last_frame for GTK+ tooltips only (Bug#41200)

* src/xfns.c (x_hide_tip): Reset tip_last_frame only when
using GTK+ system tooltips (Bug#41200).

4 years agoFix docstring of flymake-make-diagnostic (bug#40351)
João Távora [Tue, 12 May 2020 18:33:19 +0000 (19:33 +0100)]
Fix docstring of flymake-make-diagnostic (bug#40351)

* lisp/progmodes/flymake.el (flymake-make-diagnostic): Fix docstring

4 years agoGo back to “Bahá’í”
Paul Eggert [Sun, 10 May 2020 15:47:47 +0000 (08:47 -0700)]
Go back to “Bahá’í”

* doc/emacs/calendar.texi (Holidays): Revert previous change, as
bahai.org spells it “Bahá’í” (with U+2019 RIGHT SINGLE QUOTATION
MARK) and that’s good enough for us.

4 years ago* lisp/dired.el (dired-toggle-marks): Doc fix. (Bug#41097)
Eli Zaretskii [Sun, 10 May 2020 16:04:51 +0000 (19:04 +0300)]
* lisp/dired.el (dired-toggle-marks): Doc fix.  (Bug#41097)

4 years agoSmall fix for type of 'display-fill-column-indicator-character'
Philipp Stephani [Sat, 9 May 2020 12:33:05 +0000 (14:33 +0200)]
Small fix for type of 'display-fill-column-indicator-character'

* lisp/cus-start.el (standard): Don't mark t as safe file-local value
for 'display-fill-column-indicator-character', as that value isn't
allowed.

4 years agoFix customization of 'display-fill-column-indicator-character'
Eli Zaretskii [Sat, 9 May 2020 09:34:58 +0000 (12:34 +0300)]
Fix customization of 'display-fill-column-indicator-character'

* lisp/cus-start.el (display-fill-column-indicator-character): Fix
the customization form.  (Bug#41145)

4 years agoRefer to fill column indicator Info node in some places.
Philipp Stephani [Sat, 9 May 2020 08:20:47 +0000 (10:20 +0200)]
Refer to fill column indicator Info node in some places.

* src/xdisp.c (syms_of_xdisp): Add reference to manual in
documentation strings for variables related to fill column indicators.

* lisp/display-fill-column-indicator.el (display-fill-column-indicator)
(display-fill-column-indicator-mode): Add reference to manual.

4 years agoMerge branch 'emacs-27' of git.sv.gnu.org:/srv/git/emacs into emacs-27
Martin Rudalics [Sat, 9 May 2020 07:39:40 +0000 (09:39 +0200)]
Merge branch 'emacs-27' of git.sv.gnu.org:/srv/git/emacs into emacs-27

4 years agoFix GTK's Tool Bar menu radio buttons
Martin Rudalics [Sat, 9 May 2020 07:38:27 +0000 (09:38 +0200)]
Fix GTK's Tool Bar menu radio buttons

* lisp/menu-bar.el (menu-bar-showhide-tool-bar-menu): Fix typo
that makes the radio buttons pretend that the tool bar is always
shown on the left side of the frame.

4 years agoMinor clarifications in NEWS
Eli Zaretskii [Sat, 9 May 2020 07:23:49 +0000 (10:23 +0300)]
Minor clarifications in NEWS

* etc/NEWS: Tell how to revert to previous behaviors regarding
displaying messages when the minibuffer is active.  (Bug#41087)

4 years agoImprove documentation of 'with-suppressed-warnings'.
Philipp Stephani [Fri, 8 May 2020 20:12:07 +0000 (22:12 +0200)]
Improve documentation of 'with-suppressed-warnings'.

* lisp/emacs-lisp/byte-run.el (with-suppressed-warnings): Refer to
'byte-compile-warnings' instead of 'byte-compile-warning-types', as
only the former variable documents the available warning types.

4 years agoFix a typo in a comment
Eli Zaretskii [Fri, 8 May 2020 17:27:39 +0000 (20:27 +0300)]
Fix a typo in a comment

* lisp/display-fill-column-indicator.el: Fix a typo in a comment.
Suggested by david s <ds@fastmail.com>.

4 years agoImprove documentation of Hi Lock mode
Eli Zaretskii [Fri, 8 May 2020 14:25:45 +0000 (17:25 +0300)]
Improve documentation of Hi Lock mode

* lisp/hi-lock.el (hi-lock-mode, hi-lock-face-buffer)
(hi-lock-face-phrase-buffer, hi-lock-face-symbol-at-point):
Clarify when 'hi-lock-mode' will use Font Lock and when it will
use overlays.  (Bug#41124)

4 years agoFix typos in the Emacs user manual
Eli Zaretskii [Fri, 8 May 2020 11:21:35 +0000 (14:21 +0300)]
Fix typos in the Emacs user manual

* doc/emacs/calendar.texi (Holidays): Fix usage of non-ASCII
accents.
* doc/emacs/custom.texi (Init Rebinding): Fix a cross-reference.
* doc/emacs/dired.texi (Operating on Files): Make the
cross-reference to "VC Delete/Rename" be to a different manual in
the printed version.  (Bug#41100)

4 years agoFix references to Speedbar in VHDL mode
Björn Holby [Mon, 4 May 2020 20:02:57 +0000 (22:02 +0200)]
Fix references to Speedbar in VHDL mode

* lisp/progmodes/vhdl-mode.el (vhdl-speedbar-initialize): Update
references to Speedbar variables.  (Bug#41084)

Copyright-paperwork-exempt: yes

4 years agoFix handling of FROM = t and TO = t by 'window-text-pixel-size'
Eli Zaretskii [Fri, 8 May 2020 10:35:34 +0000 (13:35 +0300)]
Fix handling of FROM = t and TO = t by 'window-text-pixel-size'

* src/xdisp.c (Fwindow_text_pixel_size): Use byte position for
accessing buffer text, not character positions.  (Bug#41125)

4 years ago* doc/emacs/modes.texi (Major Modes): Fix quoting. (Bug#41110)
Eli Zaretskii [Wed, 6 May 2020 14:13:55 +0000 (17:13 +0300)]
* doc/emacs/modes.texi (Major Modes): Fix quoting.  (Bug#41110)

4 years agoFix docstring quoting
Noam Postavsky [Wed, 6 May 2020 01:11:18 +0000 (21:11 -0400)]
Fix docstring quoting

* lisp/gnus/message.el (message-sendmail-extra-arguments): Fix
escaping of quotes in docstring.

4 years ago; Mark Bug#29799 tests as failing since we reverted the fix
Noam Postavsky [Thu, 30 Apr 2020 23:35:45 +0000 (19:35 -0400)]
; Mark Bug#29799 tests as failing since we reverted the fix

* test/lisp/emacs-lisp/cl-macs-tests.el (cl-macs-loop-for-as-equals-and)
(cl-macs-loop-conditional-step-clauses): Set :expected-result to
:failed.

Don't merge to master.  The mentioned reverts are a safe-for-release
fix for Bug#40727.

4 years agoRevert "cl-loop: Calculate the array length just once"
Noam Postavsky [Thu, 30 Apr 2020 23:33:51 +0000 (19:33 -0400)]
Revert "cl-loop: Calculate the array length just once"

Don't merge to master.  This is a safe-for-release fix for Bug#40727.

4 years agoRevert "cl-loop: Add missing guard condition"
Noam Postavsky [Thu, 30 Apr 2020 23:33:50 +0000 (19:33 -0400)]
Revert "cl-loop: Add missing guard condition"

Don't merge to master.  This is a safe-for-release fix for Bug#40727.

4 years agoRevert "Refix conditional step clauses in cl-loop"
Noam Postavsky [Thu, 30 Apr 2020 23:33:34 +0000 (19:33 -0400)]
Revert "Refix conditional step clauses in cl-loop"

Don't merge to master.  This is a safe-for-release fix for Bug#40727.

4 years agoImprove "Help Summary" section in user manual
Eli Zaretskii [Tue, 5 May 2020 14:47:33 +0000 (17:47 +0300)]
Improve "Help Summary" section in user manual

* doc/emacs/help.texi (Help Summary): Add cross-references to
sections with details of each Help command.

4 years agoClarify message-sendmail-extra-arguments docstring
Stefan Kangas [Tue, 5 May 2020 14:44:02 +0000 (16:44 +0200)]
Clarify message-sendmail-extra-arguments docstring

* lisp/gnus/message.el (message-sendmail-extra-arguments): Clarify
docstring.

4 years ago* src/editfns.c (Fformat): Small documentation fix.
Philipp Stephani [Tue, 5 May 2020 12:58:24 +0000 (14:58 +0200)]
* src/editfns.c (Fformat): Small documentation fix.

4 years agoRemove calls to non-existent functions from edebug.el.
Alan Mackenzie [Mon, 4 May 2020 18:26:38 +0000 (18:26 +0000)]
Remove calls to non-existent functions from edebug.el.

Do not merge to master.

*lisp/emacs-lisp/edebug.el (edebug--display-1)
(edebug-toggle-disable-breakpoint): Remove calls to
edebug--overlay-breakpoints and edebug--overlay-breakpoints-removed which had
been overlooked in a recent changed to edebug.

4 years agoHonor search-upper-case
Dmitry Gutov [Sun, 3 May 2020 23:56:10 +0000 (02:56 +0300)]
Honor search-upper-case

* lisp/fileloop.el (fileloop--case-fold):
Extract from existing code.  Honor search-upper-case (bug#40940).
(fileloop-initialize-replace, fileloop-initialize-search): Use it.
Update the docstring.

4 years agoFix eww-follow-link on URLs with #target
Basil L. Contovounesios [Wed, 22 Apr 2020 10:42:17 +0000 (11:42 +0100)]
Fix eww-follow-link on URLs with #target

* lisp/net/eww.el (eww-display-html): Ensure shr-target-id is set as
callers depend on this (bug#28441, bug#40532).

4 years agoRevert part of recent commit 85544f8ef5 (bug#40808)
Juri Linkov [Sun, 3 May 2020 22:31:44 +0000 (01:31 +0300)]
Revert part of recent commit 85544f8ef5 (bug#40808)

* lisp/isearch.el (isearch-lazy-highlight-search): Remove recent fix of
lazy-highlighting of hidden matches.  In emacs-27 leave only the fix for
lazy-counting of hidden matches when isearch-lazy-count is non-nil.

; Do not merge to master.

4 years agoImprove doc strings of makunbound and fmakunbound
Stefan Kangas [Sun, 3 May 2020 20:00:02 +0000 (22:00 +0200)]
Improve doc strings of makunbound and fmakunbound

* src/data.c (Fmakunbound, Ffmakunbound): Improve doc
strings.  (Bug#41026)

4 years agoRevert "Mark breakpoints in edebug with highlights". This fixes bug #40992
Alan Mackenzie [Sun, 3 May 2020 11:25:19 +0000 (11:25 +0000)]
Revert "Mark breakpoints in edebug with highlights".  This fixes bug #40992

Do not merge to master.

This reverts commit e8b3a15cb6ff187ce08afcb43bd9a0b7907268ca.

4 years agoMake memq etc. examples more like they were
Paul Eggert [Sat, 2 May 2020 20:48:21 +0000 (13:48 -0700)]
Make memq etc. examples more like they were

Problem reported by Štěpán Němec in:
https://lists.gnu.org/r/emacs-devel/2020-05/msg00130.html
* doc/lispref/lists.texi (Sets And Lists, Association Lists):
Revert examples to be more like the way they were, using
self-evaluating expressions.  Be more consistent about listing
unspecified results.

4 years agoDocument effect of 'search-upper-case' on replacement commands
Eli Zaretskii [Sat, 2 May 2020 07:54:01 +0000 (10:54 +0300)]
Document effect of 'search-upper-case' on replacement commands

* doc/emacs/search.texi (Replacement and Lax Matches): Document
the role of 'search-upper-case' in replacement commands.
(Lax Search): Document the value 'not-yanks' of
'search-upper-case' where the variable itself is documented.

* lisp/replace.el (query-replace-regexp, query-replace): Mention
'search-upper-case' and its effect in doc strings.  (Bug#40940)

4 years ago* lisp/desktop.el (desktop-save): Doc fix. (Bug#41007)
Eli Zaretskii [Fri, 1 May 2020 19:59:27 +0000 (22:59 +0300)]
* lisp/desktop.el (desktop-save): Doc fix.  (Bug#41007)

4 years ago; Auto-commit of loaddefs files.
Glenn Morris [Fri, 1 May 2020 13:12:54 +0000 (06:12 -0700)]
; Auto-commit of loaddefs files.

4 years agoRecommend to avoid unnecessary abbreviations in doc
Stefan Kangas [Thu, 30 Apr 2020 16:02:28 +0000 (18:02 +0200)]
Recommend to avoid unnecessary abbreviations in doc

* doc/lispref/tips.texi (Documentation Tips): Recommend to avoid
unnecessary abbreviations.  (Bug#40011)

4 years agoRevert "Fix calculator division truncation (bug#40892)"
Eli Zaretskii [Thu, 30 Apr 2020 14:02:57 +0000 (17:02 +0300)]
Revert "Fix calculator division truncation (bug#40892)"

This reverts commit 82140c510c4d27e639b4bca1e9bf158f0f66c375.
(Bug#40892)

4 years agoFix calculator division truncation (bug#40892)
Mattias Engdegård [Thu, 30 Apr 2020 13:06:06 +0000 (15:06 +0200)]
Fix calculator division truncation (bug#40892)

* lisp/calculator.el (calculator-string-to-number): Convert decimal
numbers input to float, fixing a regression introduced in f248292ede.
Reported by Aitor Soroa.

4 years agoExpand file name for remote dirs as well
Dmitry Gutov [Wed, 29 Apr 2020 19:46:17 +0000 (22:46 +0300)]
Expand file name for remote dirs as well

* lisp/progmodes/project.el (project--files-in-directory):
Expand file name for remote dirs as well (bug#40940).

4 years agoFix project.el commands in "transient" projects
Eli Zaretskii [Wed, 29 Apr 2020 15:58:42 +0000 (18:58 +0300)]
Fix project.el commands in "transient" projects

* lisp/progmodes/project.el (project--files-in-directory): Run
local DIR directory names through 'expand-file-name', so that "~/"
is expanded, in case the shell doesn't or the shell's notion of
the home directory is different from that of Emacs.  (Bug#40940)

4 years agoMake sure alist-related functions say so in their doc
Eli Zaretskii [Wed, 29 Apr 2020 14:52:53 +0000 (17:52 +0300)]
Make sure alist-related functions say so in their doc

* src/fns.c (Fassq, assq_no_quit, Fassoc, assoc_no_quit, Frassq)
(Frassoc): Rename argument LIST to ALIST.  Doc strings updated.

4 years ago; Fix last change
Eli Zaretskii [Wed, 29 Apr 2020 11:15:03 +0000 (14:15 +0300)]
; Fix last change

4 years ago* lisp/env.el (substitute-env-vars): Doc fix. (Bug#40948)
Eli Zaretskii [Wed, 29 Apr 2020 11:06:35 +0000 (14:06 +0300)]
* lisp/env.el (substitute-env-vars): Doc fix.  (Bug#40948)

4 years ago* lisp/isearch.el: Fix lazy-highlighting and lazy-counting of hidden matches
Juri Linkov [Tue, 28 Apr 2020 23:49:44 +0000 (02:49 +0300)]
* lisp/isearch.el: Fix lazy-highlighting and lazy-counting of hidden matches

* lisp/isearch.el (isearch-lazy-highlight-search): Let-bind
search-invisible to t when search-invisible is 'open' or when both
isearch-lazy-count and search-invisible are non-nil.  (Bug#40808)

4 years agoFix error in ERC when 'erc-server-coding-system' is customized
Eli Zaretskii [Tue, 28 Apr 2020 17:22:50 +0000 (20:22 +0300)]
Fix error in ERC when 'erc-server-coding-system' is customized

* lisp/erc/erc-backend.el (erc-split-line): Handle the case where
'erc-coding-system-for-target' returns a coding-system's symbol.
(Bug#40914)

4 years agoAvoid crashes on TTY frames with over-long compositions
Eli Zaretskii [Tue, 28 Apr 2020 08:57:16 +0000 (11:57 +0300)]
Avoid crashes on TTY frames with over-long compositions

* src/term.c (encode_terminal_code): Each character from an
automatic composition is a multibyte character, so its multibyte
representation can take up to MAX_MULTIBYTE_LENGTH bytes.
Account for that when allocating storage for characters to be
encoded.  (Bug#40913)

4 years agoFix typo in custom.texi
Stefan Kangas [Mon, 27 Apr 2020 15:09:11 +0000 (17:09 +0200)]
Fix typo in custom.texi

* doc/emacs/custom.texi (Variables): Fix typo.  Pointed out by
ej32u@protonmail.com.  (Bug#40890)

4 years ago* test/lisp/simple-tests.el (with-shell-command-dont-erase-buffer):
Michael Albinus [Mon, 27 Apr 2020 08:36:33 +0000 (10:36 +0200)]
* test/lisp/simple-tests.el (with-shell-command-dont-erase-buffer):

Use `shell-quote-argument' instead of quoting 'like this'.

4 years ago* lisp/image-mode.el (image-mode-map): Update menu items.
Juri Linkov [Sun, 26 Apr 2020 22:33:36 +0000 (01:33 +0300)]
* lisp/image-mode.el (image-mode-map): Update menu items.

* lisp/image-mode.el (image-mode-map): Move "Fit Image to Window (Best Fit)"
higher.  Add "Zoom In" (image-increase-size), "Zoom Out" (image-decrease-size)
and "Rotate Clockwise" (image-rotate).  Use name "Set Rotation..."
for image-transform-set-rotation.  Swap "Next Image" and "Previous Image".
Swap "Next Frame" and "Previous Frame".

4 years agoFix bugs in tab-bar and tab-line and mention remaining features in manual.
Juri Linkov [Sun, 26 Apr 2020 22:28:36 +0000 (01:28 +0300)]
Fix bugs in tab-bar and tab-line and mention remaining features in manual.

* doc/emacs/frames.texi (Tab Bars): Mention tab-bar-new-tab-to,
tab-bar-close-last-tab-choice, tab-bar-close-tab-select, tab-undo,
tab-select, tab-bar-history-mode.

* doc/emacs/windows.texi (Tab Line): Mention tab-line-tabs-function.

* lisp/tab-bar.el (tab-bar-select-tab-modifiers): Mention
tab-bar-tab-hints in docstring.
(tab-bar-tab-hints): Mention tab-bar-select-tab-modifiers
in docstring.
(tab-bar-select-tab): Mention tab-bar-select-tab-modifiers
in docstring.
(tab-bar-switch-to-tab): Expand the docstring.
(tab-bar-new-tab-to): Fix bug in handling 'left' value.
(tab-bar-close-tab): Fix bug in handling 'left' value.
(tab-bar-undo-close-tab): Use funcall tab-bar-tabs-function
instead of direct call to tab-bar-tabs.
(tab-bar-history-back, tab-bar-history-forward): Add docstrings.
(tab-bar-history-mode): Expand docstring.

* lisp/tab-line.el (tab-line-format): Fix bug for handling window
switching that should set face 'tab-line-tab-current'.

4 years agoMake shell-command tests fit for tcsh.
Michael Albinus [Sun, 26 Apr 2020 09:39:40 +0000 (11:39 +0200)]
Make shell-command tests fit for tcsh.

* test/lisp/simple-tests.el (with-shell-command-dont-erase-buffer):
Fix debug spec.  Format command to run also under tcsh.
(simple-tests-shell-command-39067)
(simple-tests-shell-command-dont-erase-buffer): Quote newline in string.

4 years agoRemove doc duplication
Paul Eggert [Sat, 25 Apr 2020 18:22:01 +0000 (11:22 -0700)]
Remove doc duplication

* doc/lispref/objects.texi (Constants and Mutability): Remove
duplication.  From a suggestion by Andreas Schwab (Bug#40671#150).

4 years ago* etc/NEWS: Fix inconsistencies.
Michael Albinus [Sat, 25 Apr 2020 14:54:28 +0000 (16:54 +0200)]
* etc/NEWS: Fix inconsistencies.

4 years agoClarify semantics of trace-function CONTEXT argument
Noam Postavsky [Wed, 15 Apr 2020 02:10:58 +0000 (22:10 -0400)]
Clarify semantics of trace-function CONTEXT argument

* lisp/emacs-lisp/trace.el (trace-function-foreground): Explain that
CONTEXT should be a function, when called from Lisp.

4 years agoDon't let a code literal get modified in mml parsing (Bug#39884)
Noam Postavsky [Fri, 17 Apr 2020 00:24:26 +0000 (20:24 -0400)]
Don't let a code literal get modified in mml parsing (Bug#39884)

* lisp/gnus/mml.el (mml-parse-1): Make a fresh cons for the tag type,
because 'mml-generate-mime' destructively modifies it.

4 years ago* lisp/simple.el (kill-ring-save): Doc fix. (Bug#40797)
Eli Zaretskii [Sat, 25 Apr 2020 10:04:16 +0000 (13:04 +0300)]
* lisp/simple.el (kill-ring-save): Doc fix.  (Bug#40797)

4 years agoMinor doc clarification regarding fringe bitmaps
Clément Pit-Claudel [Wed, 22 Apr 2020 21:46:07 +0000 (17:46 -0400)]
Minor doc clarification regarding fringe bitmaps

* doc/lispref/display.texi (Customizing Bitmaps): Add a note
regarding the order of bits being the opposite of that in
XBM images.  (Bug#40784)

4 years agoFix documentation of fringe bitmaps
Eli Zaretskii [Sat, 25 Apr 2020 09:48:14 +0000 (12:48 +0300)]
Fix documentation of fringe bitmaps

* doc/lispref/display.texi (Fringe Bitmaps): The 'empty-line'
fringe indicator _is_ used.  (Bug#40799)

4 years agoTweak mutability doc a bit more
Paul Eggert [Sat, 25 Apr 2020 02:19:31 +0000 (19:19 -0700)]
Tweak mutability doc a bit more

Inspired by a comment from Michael Heerdegen (Bug#40671#114).
* doc/lispref/objects.texi (Constants and Mutability): Tweak further.

4 years agoCalc: fix autoload errors (bug#40800)
Mattias Engdegård [Fri, 24 Apr 2020 10:49:42 +0000 (12:49 +0200)]
Calc: fix autoload errors (bug#40800)

Reported by Hugo Daschbach.

* lisp/calc/calc-ext.el (calc-init-extensions):
Remove calc-kbd-report key binding and autoload; it was removed in 2005.
calc-keypad-x-{left,right,middle}-click were renamed to
calc-keypad-{left,right,middle}-click in 2001; fix the autoloads.
calc-twos-complement-mode is a variable, not a function; remove the
autoload.
* lisp/calc/calc-prog.el: Remove commented-out calc-kbd-report.

4 years ago; * src/xdisp.c: Improve the introductory commentary.
Eli Zaretskii [Fri, 24 Apr 2020 15:09:20 +0000 (18:09 +0300)]
; * src/xdisp.c: Improve the introductory commentary.

4 years agoImprove indexing of ELisp manual
Stefan Kangas [Fri, 24 Apr 2020 05:58:17 +0000 (07:58 +0200)]
Improve indexing of ELisp manual

* doc/lispref/tips.texi (Tips): Add index entry 'best practices'.

4 years ago* lisp/image-mode.el (image-transform-resize): Remove FIXME comment.
Juri Linkov [Thu, 23 Apr 2020 22:50:48 +0000 (01:50 +0300)]
* lisp/image-mode.el (image-transform-resize): Remove FIXME comment.

The user customizable variable 'image-auto-resize' is documented now
in the manual.

4 years agoImprove the default value of 'doc-view-ghostscript-program'.
Tassilo Horn [Thu, 23 Apr 2020 16:25:07 +0000 (18:25 +0200)]
Improve the default value of 'doc-view-ghostscript-program'.

* lisp/doc-view.el (doc-view-ghostscript-program): Use plain command
name instead of qualified name returned by executable-find (as
suggested by Stefan Monnier).  (Bug#36357)

4 years agoChange doc-view-mode-map prefix key 's' to 'c'.
Juri Linkov [Wed, 22 Apr 2020 23:14:42 +0000 (02:14 +0300)]
Change doc-view-mode-map prefix key 's' to 'c'.

* doc/emacs/misc.texi (DocView Slicing): Change prefix key 's' to 'c'.

* lisp/doc-view.el (doc-view-mode-map): Change prefix key 's' to 'c'.

* lisp/image-mode.el (image-mode-map): Add image-transform-set-scale to menu.

* doc/emacs/files.texi (Image Mode): Describe commands
image-transform-fit-both, image-transform-set-scale, image-transform-reset.

* etc/NEWS: Rearrange image sections.

https://lists.gnu.org/archive/html/emacs-devel/2020-04/msg01315.html

4 years agoImprove wording about constants
Paul Eggert [Wed, 22 Apr 2020 17:42:09 +0000 (10:42 -0700)]
Improve wording about constants

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.

4 years agoImprove the default value of 'doc-view-ghostscript-program'.
Tassilo Horn [Wed, 22 Apr 2020 17:23:23 +0000 (19:23 +0200)]
Improve the default value of 'doc-view-ghostscript-program'.

* lisp/doc-view.el (doc-view-ghostscript-program): On Windows, try
gswin64c, gswin32c, rungs, and mgs.  (Bug#36357)

4 years agoMinor improvements in documentation of the last change
Eli Zaretskii [Tue, 21 Apr 2020 13:50:13 +0000 (16:50 +0300)]
Minor improvements in documentation of the last change

* etc/NEWS:
* doc/emacs/files.texi (Image Mode): Minor copyedits of last change.

4 years agoAdd image-auto-resize defcustoms to image-mode.el
Juri Linkov [Mon, 20 Apr 2020 23:42:16 +0000 (02:42 +0300)]
Add image-auto-resize defcustoms to image-mode.el

* lisp/image-mode.el (image-auto-resize)
(image-auto-resize-on-window-resize): New defcustoms.
(image-mode-map): Bind "sb" to image-transform-fit-both.
(image-mode): Set image-transform-resize to image-auto-resize initially.
(image-mode--setup-mode): Add hook on image-auto-resize-on-window-resize.
(image-toggle-display-image): Check if image-transform-resize is t.
(image-transform-properties): Check image-transform-resize for nil and t.
(image-transform-fit-both): New command.
(image-transform-reset): Reset image-transform-resize to image-auto-resize.

* doc/emacs/files.texi (Image Mode): Mention image-auto-resize and
image-auto-resize-on-window-resize.

https://lists.gnu.org/archive/html/emacs-devel/2020-04/msg01160.html

4 years agoImprove the documentation of tab-bar and tab-line
Juri Linkov [Mon, 20 Apr 2020 23:23:35 +0000 (02:23 +0300)]
Improve the documentation of tab-bar and tab-line

* doc/emacs/frames.texi (Tab Bars): Add xref to "Tab Line".
Document more commands.

* doc/emacs/windows.texi (Windows):
* doc/emacs/emacs.texi (Top): Add "Tab Line" menu.

* doc/emacs/windows.texi (Window Convenience):
Move tab-line documentation to new node "Tab Line".
(Tab Line): New node.

* doc/emacs/glossary.texi (Glossary):
* doc/emacs/modes.texi (Minor Modes):
* doc/emacs/display.texi (Standard Faces): Add xref to "Tab Line".

4 years agoTweak wording re constant variables
Paul Eggert [Mon, 20 Apr 2020 02:52:53 +0000 (19:52 -0700)]
Tweak wording re constant variables

* doc/lispref/objects.texi (Constants and Mutability): Tweak.
Problem reported by Michael Heerdegen (Bug#40693#44).

4 years agoTweak setcar-related wording
Paul Eggert [Sun, 19 Apr 2020 23:46:47 +0000 (16:46 -0700)]
Tweak setcar-related wording

* doc/lispref/eval.texi (Self-Evaluating Forms):
Change “primitives” to “operations”.
Problem reported by Štěpán Němec in:
https://lists.gnu.org/r/emacs-devel/2020-04/msg01146.html

4 years ago* lisp/image-mode.el: Add prefix key 's' and reduce dependency on ImageMagick.
Juri Linkov [Sun, 19 Apr 2020 23:07:43 +0000 (02:07 +0300)]
* lisp/image-mode.el: Add prefix key 's' and reduce dependency on ImageMagick.

* lisp/image-mode.el (image-mode-map): Regroup existing keybindings and
add new ones with the prefix key 's'.
Remove condition ":visible (eq image-type 'imagemagick)" from menu.
(image-toggle-display-image): Don't rotate again after user rotated manually.
(image-transform-check-size): Remove check for imagemagick.
(image-transform-properties, image-transform-set-scale)
(image-transform-fit-to-height, image-transform-fit-to-width)
(image-transform-set-rotation, image-transform-reset):
Remove mentions of ImageMagick from docstrings since these commands
now work without ImageMagick.

4 years ago* doc/emacs/windows.texi (Window Convenience): Decribe more windmove features.
Juri Linkov [Sun, 19 Apr 2020 22:57:32 +0000 (01:57 +0300)]
* doc/emacs/windows.texi (Window Convenience): Decribe more windmove features.

* doc/emacs/windows.texi (Window Convenience): Add descriptions of
windmove-display-default-keybindings,
windmove-delete-default-keybindings,
windmove-swap-states-in-direction.

* etc/NEWS: Regroup to move some parts closer to related sections.

4 years agoFix mutability glitches reported by Drew Adams
Paul Eggert [Sun, 19 Apr 2020 22:09:02 +0000 (15:09 -0700)]
Fix mutability glitches reported by Drew Adams

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.

4 years agoImprove mutability doc
Paul Eggert [Sun, 19 Apr 2020 20:22:10 +0000 (13:22 -0700)]
Improve mutability doc

See Eli Zaretskii’s suggestions (Bug#40671#33).
* doc/lispref/lists.texi (Setcar, Setcdr, Rearrangement):
* doc/lispref/sequences.texi (Sequence Functions)
(Array Functions):
Add commentary to examples.
* doc/lispref/lists.texi (Sets And Lists):
Revert change to delq example.

4 years agoImprove mutability documentation
Paul Eggert [Sun, 19 Apr 2020 19:00:49 +0000 (12:00 -0700)]
Improve mutability documentation

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.

4 years agoDocument that quoting yields constants
Paul Eggert [Sun, 19 Apr 2020 16:37:51 +0000 (09:37 -0700)]
Document that quoting yields constants

* doc/lispref/eval.texi (Quoting, Backquote):
Mention that quoted expressions yield a constant (Bug#40693).

4 years ago* doc/lispref/keymaps.texi (Extended Menu Items, Easy Menu) <:key-sequence>:
Stefan Monnier [Sun, 19 Apr 2020 15:19:03 +0000 (11:19 -0400)]
* doc/lispref/keymaps.texi (Extended Menu Items, Easy Menu) <:key-sequence>:

Clarify the documentation further

4 years agoRemove #' and function quoting from lambda forms in manual
Mattias Engdegård [Sun, 19 Apr 2020 10:40:43 +0000 (12:40 +0200)]
Remove #' and function quoting from lambda forms in manual

* 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.

4 years ago* src/regex-emacs.c (re_match_2_internal): Rework comment in last change
Stefan Monnier [Sun, 19 Apr 2020 03:01:43 +0000 (23:01 -0400)]
* src/regex-emacs.c (re_match_2_internal): Rework comment in last change

Explain why we don't need to worry about Lisp modifying the buffer.

* src/syntax.c (parse_sexp_propertize): Fix name in error message.

4 years agoAdd new node "Image Mode" to Emacs Manual.
Juri Linkov [Sat, 18 Apr 2020 23:43:06 +0000 (02:43 +0300)]
Add new node "Image Mode" to Emacs Manual.

* doc/emacs/dired.texi (Image-Dired): Add xref to "Image Mode".

* doc/emacs/emacs.texi (Top): Add new node "Image Mode" to menu.

* doc/emacs/files.texi (Files): Add new node "Image Mode" to menu.
(File Conveniences): Split part of node to new node "Image Mode".

* doc/emacs/frames.texi (Mouse Commands): Add xref to "Image Mode".

* doc/emacs/misc.texi (Embedded WebKit Widgets): Rename xref from
"File Conveniences" to "Image Mode".

4 years ago; Fix a typo in cmdargs.texi (bug#40701)
Štěpán Němec [Sat, 18 Apr 2020 21:28:40 +0000 (23:28 +0200)]
; Fix a typo in cmdargs.texi (bug#40701)

4 years ago* doc/lispref/display.texi (Customizing Bitmaps): Fix typo.
Paul Eggert [Sat, 18 Apr 2020 19:59:50 +0000 (12:59 -0700)]
* doc/lispref/display.texi (Customizing Bitmaps): Fix typo.

4 years agoDocument constant vs mutable objects better
Paul Eggert [Sat, 18 Apr 2020 19:59:17 +0000 (12:59 -0700)]
Document constant vs mutable objects better

This patch builds on a suggested patch by Mattias Engdegård
and on further comments by Eli Zaretskii.
Original bug report by Kevin Vigouroux (Bug#40671).
* doc/lispintro/emacs-lisp-intro.texi (set & setq, Review)
(setcar, Lists diagrammed, Mail Aliases, Indent Tabs Mode):
setq is a special form, not a function or command.
* doc/lispintro/emacs-lisp-intro.texi (setcar):
* doc/lispref/lists.texi (Modifying Lists, Rearrangement):
* doc/lispref/sequences.texi (Sequence Functions)
(Array Functions, Vectors):
* doc/lispref/strings.texi (String Basics, Modifying Strings):
Mention mutable vs constant objects.
* doc/lispintro/emacs-lisp-intro.texi (setcar, setcdr)
(kill-new function, cons & search-fwd Review):
* doc/lispref/edebug.texi (Printing in Edebug):
* doc/lispref/keymaps.texi (Changing Key Bindings):
* doc/lispref/lists.texi (Setcar, Setcdr, Rearrangement)
(Sets And Lists, Association Lists, Plist Access):
* doc/lispref/sequences.texi (Sequence Functions)
(Array Functions):
* doc/lispref/strings.texi (Text Comparison):
Fix examples so that they do not try to change constants.

4 years agoImprove documentation of 'sort-lines'
Eli Zaretskii [Sat, 18 Apr 2020 16:26:30 +0000 (19:26 +0300)]
Improve documentation of 'sort-lines'

* lisp/sort.el (sort-lines): Clarify the interactive invocation.
(Bug#40697)

4 years agoMention 'spam-stat-process-directory-age' in the documentation
Štěpán Němec [Wed, 31 Jul 2019 07:51:09 +0000 (09:51 +0200)]
Mention 'spam-stat-process-directory-age' in the documentation

I was at a loss as to why my attempt to set up spam-stat seemed to
have no effect, only to find (digging in the code) that it was
ignoring most of the sample files due to this undocumented variable.

* doc/misc/gnus.texi (Creating a spam-stat dictionary): Document
the variable 'spam-stat-process-directory-age'.  (bug#39780)

4 years ago; Fix some typos and doc issues (bug#40695)
Štěpán Němec [Sun, 1 Mar 2020 17:50:14 +0000 (18:50 +0100)]
; Fix some typos and doc issues (bug#40695)

4 years agoAvoid crashes in regex-emacs.c due to GC
Eli Zaretskii [Sat, 18 Apr 2020 11:53:13 +0000 (14:53 +0300)]
Avoid crashes in regex-emacs.c due to GC

* src/regex-emacs.c (re_match_2_internal): Prevent GC from
invalidating C pointers to buffer text.  (Bug#40661)