1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-01 05:10:54 -08:00
Commit graph

9254 commits

Author SHA1 Message Date
Alan Mackenzie
3cc77aa976 Clarify (elisp) insert-file-contents with BEG or END not on character boundary
* doc/lispref/files.texi (Reading from files): When the argument BEG or END to
insert-file-contents are at a byte position not at a character boundary,
clarify that raw bytes get inserted, and how to handle this awkwardness in
Lisp.  Also clarify that insert-file-contents-literally is intended to insert
raw bytes into the buffer.  Fix the outdated example that states it inserts
500 characters, when it actually inserts 500 bytes.
2021-10-03 18:13:23 +00:00
Michael Albinus
3863919a00 Fix unmounting in Tramp
* doc/misc/tramp.texi (FUSE setup): Add tramp-fuse-unmount-on-cleanup.

* lisp/net/tramp.el (tramp-file-name-unify): New defun.
(tramp-file-name-equal-p):
* lisp/net/tramp-cache.el (tramp-get-connection-property)
(tramp-set-connection-property, tramp-flush-connection-property)
(tramp-flush-connection-properties): Use it.

* lisp/net/tramp-fuse.el (tramp-fuse-get-fusermount): New defun.
(tramp-fuse-mount-points): New defvar.
(tramp-fuse-unmount): Use it.  Delete VEC from
`tramp-fuse-mount-points'.  Delete mount point.
(tramp-fuse-unmount-on-cleanup): New user option.
(tramp-fuse-cleanup, tramp-fuse-cleanup-all): New defuns.
(top): Adapt `tramp-fuse-unload-hook',
`tramp-cleanup-connection-hook',
`tramp-cleanup-all-connections-hook' and `kill-emacs-hook'.

* lisp/net/tramp-rclone.el (tramp-rclone-maybe-open-connection):
* lisp/net/tramp-sshfs.el (tramp-sshfs-maybe-open-connection):
Add VEC to `tramp-fuse-mount-points'.

* test/lisp/net/tramp-tests.el (tramp-fuse-unmount-on-cleanup): Declare.
(tramp-test39-make-lock-file-name): Use it.
2021-10-03 18:55:35 +02:00
João Távora
137fa2d716 Rename elisp-shorthands to read-symbol-shorthands
The new name fits better in the family of variables that affect
the Lisp reader.

Suggested-by: Po Lu <luangruo@yahoo.com>

* doc/lispref/symbols.texi (Shorthands): Mention read-symbol-shorthands

* lisp/shorthands.el (hack-read-symbol-shorthands)
(hack-read-symbol-shorthands)
(shorthands-font-lock-shorthands): Use read-symbol-shorthands

* lisp/progmodes/elisp-mode.el (elisp--completion-local-symbols)
(elisp--completion-local-symbols)
(elisp-shorthands): Use read-symbol-shorthands

* src/lread.c:
(syms_of_lread): Define Vread_symbol_shorthands
(oblookup_considering_shorthand): Use Vread_symbol_shorthands.

* test/lisp/progmodes/elisp-mode-tests.el (elisp-shorthand-read-buffer):
(elisp-shorthand-read-from-string): Use read-symbol-shorthands

* test/lisp/progmodes/elisp-mode-resources/simple-shorthand-test.el
Use new symbol name read-symbol-shorthands.
2021-10-03 16:18:40 +01:00
Eli Zaretskii
a9052248da Improve documentation of 'shift-select-mode'
* doc/emacs/mark.texi (Shift Selection): Document the 'permanent'
value of 'shift-select-mode'.  Add index entry for that variable.
(Bug#50954)

* etc/NEWS: Update the entry for 'shift-select-mode'.
2021-10-02 09:40:44 +03:00
Glenn Morris
99884c2264 Merge from origin/emacs-28
626696c3c8 (origin/emacs-28) * doc/lispref/control.texi (pcase Macro)...
2895cb8d49 ; * lisp/time-stamp.el: Fix wording in some documentation ...
1e79c9e9c0 ; * admin/release-branch.txt: Small edits.
f1f57a541e Fix some custom types
2021-10-01 09:27:47 -07:00
Glenn Morris
626696c3c8 * doc/lispref/control.texi (pcase Macro): Fix cross-reference. 2021-10-01 09:27:09 -07:00
Lars Ingebrigtsen
295d552e4e Allow skipping erts tests
* doc/misc/ert.texi (erts files): Document it.

* lisp/emacs-lisp/ert.el (ert-test-erts-file): Allow skipping tests.
2021-10-01 13:20:20 +02:00
Lars Ingebrigtsen
1a65320903 Add new functionality to write buffer-based tests
* doc/misc/ert.texi (erts files): New node.

* lisp/files.el (auto-mode-alist): Map .erts to erts-mode.

* lisp/emacs-lisp/ert.el (ert-test-erts-file): New function.

* lisp/emacs-lisp/ert.el (ert--erts-specifications)
(ert--erts-unquote): Helper functions.

* lisp/progmodes/erts-mode.el: New mode and file.
2021-10-01 12:17:47 +02:00
Philip Kaludercic
a1789fd67b Add rcirc-omit-unless-requested option
* doc/misc/rcirc.texi (Notices): Update documentation
* lisp/net/rcirc.el (rcirc-pending-requests): Add local variable
(rcirc-omit-unless-requested): Add user option
(rcirc-print): Respect rcirc-omit-unless-requested
(rcirc-define-command): Update rcirc-pending-requests
2021-09-30 16:25:48 +02:00
Kyle Meyer
bf9ec3d91a Update to Org 9.5 2021-09-29 23:21:21 -04:00
Protesilaos Stavrou
7c79eea51d Update modus-themes to version 1.6.0
* doc/misc/modus-themes.org (Customization Options): Document new user
options in code sample.
(Option for inhibiting theme reload): Remove trailing space.
(Option for mode line presentation): Include new possible value.
(Option for Org agenda constructs): Include new symbols for the
'modus-themes-org-agenda' alist.
(Control the scale of headings): Document 'modus-themes-scale-small'.
(Override color saturation (DIY)): Fix markup for proper texi output.
(Custom Org user faces (DIY)): Update code samples.
(Full support for packages or face groups): Note names of newly
supported packages or face groups.
(Indirectly covered packages): Document indirectly supported packages.
(Note on highlight-parentheses.el): Provide detailed instructions on
how to use 'highlight-parentheses' with the Modus themes.
(Note on prism.el): Refine code samples.
(What is the best setup for legibility?): Minor rewording.
(Sources of the themes): Mention only Emacs28 without explaining that
it is the development target---in preparation of the emacs-28 branch
cut.
(Acknowledgements): Name new contributors to code/ideas.  Stephen
Gildea's patch was a couple lines long.  The others have assigned
copyright to the FSF.
(Meta): Include another link to the development notes of the themes
about 'modus-themes-org-agenda'.

* etc/themes/modus-operandi-theme.el,
  etc/themes/modus-vivendi-theme.el: Bump file version.

* etc/themes/modus-themes.el (modus-themes-operandi-colors)
(modus-themes-vivendi-colors): Recalibrate some colour values and add
a few new ones.
(modus-themes-slanted-constructs): Remove obsolete user option.
Superseded by the alias 'modus-themes-italic-constructs'.
(modus-themes-org-agenda, modus-themes-mode-line): Update user option.
(modus-themes-scale-headings, modus-themes-scale-4): Update doc
string.
(modus-themes-scale-5): Remove obsolete user option.  Superseded by
the alias 'modus-themes-scale-title'.
(modus-themes-scale-small, modus-themes-tabs-accented): Add new user
option.
(modus-themes--agenda-date, modus-themes--mode-line-attrs)
(modus-themes--tab): Update internal functions.
(modus-themes-faces): Update variousface attributes.

Detailed change log here:
<https://protesilaos.com/codelog/2021-09-29-modus-themes-1-6-0/>.
2021-09-29 12:55:46 +02:00
Philip Kaludercic
1a0f4b3f23 Remove rcirc-omit-responses-after-join option
The implementation does not work as expected and behaves
unpredictably.

* rcirc.el (rcirc-omit-responses-after-join): Remove option
(rcirc-joined): Remove variable
(rcirc-reconnect): Remove rcirc-joined code
(rcirc-get-buffer-create): Remove rcirc-joined code
(rcirc-print): Remove rcirc-omit-responses-after-join check
* doc/misc/rcirc.texi (Notices): Remove documentation
* etc/NEWS: Remove mention
2021-09-29 12:18:54 +02:00
Stefan Kangas
c847899081 * doc/man/emacs.1.in: Add --no-x-resources. (Bug#50855) 2021-09-28 15:45:27 +02:00
Stefan Kangas
9a5a35c5a6 ; * doc/lispref/tips.texi (Programming Tips): Fix markup. 2021-09-28 15:33:39 +02:00
Stefan Kangas
e9c7ef3348 Improve coding conventions for error messages
* doc/lispref/tips.texi (Programming Tips): Clarify coding
conventions for error messages to say that an error message can
start with a Lisp symbol.  (Bug#50658)
2021-09-28 14:56:07 +02:00
Eli Zaretskii
90655e4bc0 Make the build of source tarball produce *.eln files
* lisp/emacs-lisp/comp.el (batch-native-compile): Accept an
optional argument; if non-nil, place the .eln file as appropriate
for building a source tarball.

* doc/lispref/compile.texi (Native-Compilation Functions):
Document the new optional argument of 'batch-native-compile'.

* lisp/Makefile.in (.PHONY, $(THEFILE)n) [HAVE_NATIVE_COMP]: New
targets.

* src/Makefile.in (%.eln) [HAVE_NATIVE_COMP]: New recipe.
(all) [HAVE_NATIVE_COMP]: Add ../native-lisp to prerequisites.
(elnlisp) [HAVE_NATIVE_COMP]: New list of *.eln files.
(../native-lisp) [HAVE_NATIVE_COMP]: New recipe.

* src/verbose.mk.in (AM_V_ELN): New macro.
2021-09-28 15:00:50 +03:00
Stefan Kangas
dc12ad8978 ; Update some links to HTTPS and note some broken links 2021-09-27 12:40:04 +02:00
Basil L. Contovounesios
129efd9c0b ; Fix compilation of doc/lispref/symbols.texi. 2021-09-27 10:25:02 +01:00
Eli Zaretskii
106a95c8ab Minor fixes in documentation of shorthands
* etc/NEWS:
* doc/lispref/symbols.texi (Symbol Components, Creating Symbols)
(Shorthands): Improve wording, fix indexing and typos.
2021-09-27 09:37:33 +03:00
Lars Ingebrigtsen
44dbc11ff7 Note that the Packaging sub-nodes are mostly for maintainers
* doc/lispref/package.texi (Packaging): Note that the information
is mostly for ELPA maintainers (bug#50825).
2021-09-27 06:12:53 +02:00
João Távora
58055b5fc3 Document shorthands in the Elisp manual section on Symbols
* doc/lispref/symbols.texi (Symbol Components): Mentione "Shorthands".
(Creating Symbols): Mention shorthands.  Correct references to Common
Lisp.
(Shorthands): New section.

* etc/NEWS (Shorthands): New entry.
2021-09-27 01:07:11 +01:00
Robert Pluim
950831c369 Add glyphless-char-display-control for Variation Selectors
* lisp/international/characters.el (update-glyphless-char-display):
(glyphless-char-display-control): Add control knob for U+FE00 through
U+FE0F, defaulting to 'thin-space'.
* doc/lispref/display.texi (Glyphless Chars): Document it.
2021-09-26 18:54:49 +02:00
Mattias Engdegård
6e1de14e51 Rx documentation touch-ups (bug#46910)
* doc/lispref/searching.texi (Rx Constructs, Rx Functions):
Add clarifications and improve naming of arguments.  Add examples
illustrating the differences between `rx` and `rx-to-string`.
2021-09-26 14:44:06 +02:00
Stefan Kangas
68994995db Doc fix: mode name in local variables needs no suffix
* doc/emacs/custom.texi (Specifying File Variables): Clarify that a
mode name does not need the "-mode" suffix.  (Bug#50801)
2021-09-26 11:37:29 +02:00
Eli Zaretskii
cd0817a0f7 ; Improve documentation of 'with-environment-variables'
* lisp/env.el (with-environment-variables):
* doc/lispref/os.texi (System Environment): Improve the
documentation of 'with-environment-variables'.
2021-09-26 12:11:56 +03:00
Lars Ingebrigtsen
7cb2944043 Add new macro with-environment-variables
* doc/lispref/os.texi (System Environment): Document it.

* lisp/env.el (with-environment-variables): New macro.
2021-09-26 08:27:51 +02:00
Stefan Kangas
43ae8c828d Revert "; Fix capitalization of F1..F12 keys in docs"
This reverts commit fe5b20410f.

This change was not correct; these are Lisp symbols that should be in
lower-case.  Problem reported by Mattias Engdegård <mattiase@acm.org>.
2021-09-25 22:50:09 +02:00
Stefan Kangas
fe5b20410f ; Fix capitalization of F1..F12 keys in docs
* doc/emacs/custom.texi (Function Keys):
* doc/misc/edt.texi (Unix):
* doc/misc/idlwave.texi (Custom Expression Examination):
* doc/misc/viper.texi (Improved Search, Vi Macros): Fix
capitalization of F1..F12 keys.
2021-09-25 20:51:13 +02:00
Mattias Engdegård
e93bdfb6da ; * doc/emacs/help.texi (Misc Help): @key{f1} -> @key{F1} 2021-09-25 20:25:02 +02:00
Mattias Engdegård
32de11d8de ; Remove various duplicated words
* doc/lispref/searching.texi (Extending Rx):
* doc/lispref/strings.texi (Creating Strings):
* doc/misc/modus-themes.org (Measure color contrast (DIY)):
* etc/NEWS:
* lisp/find-file.el (ff-find-other-file):
* lisp/gnus/gnus-group.el (gnus-group-suspend):
* lisp/progmodes/cc-langs.el (c-ml-string-any-closer-re):
* lisp/progmodes/flymake.el (flymake-list-only-diagnostics):
* lisp/progmodes/xref.el (xref--group-name-for-display):
* lisp/transient.el (transient-child, transient-files)
(transient-infix-value):
* src/alloc.c:
* src/regex-emacs.c (regex_compile):

Remove duplicate words in comments, documentation etc.
2021-09-25 20:25:01 +02:00
Mattias Engdegård
ed02b88bba Renege on anonymous &rest (bug#50268, bug#50720)
Allowing &rest without a variable name following turned out not to be
very useful, and it never worked properly.  Disallow it.

* lisp/emacs-lisp/bytecomp.el (byte-compile-check-lambda-list):
* src/eval.c (funcall_lambda):
Signal error for &rest without variable name.
* doc/lispref/functions.texi (Argument List): Adjust manual.
* etc/NEWS (file): Announce.
* test/src/eval-tests.el (eval-tests--bugs-24912-and-24913):
Extend test, also checking with and without lexical binding.
(eval-tests-accept-empty-optional-rest): Reduce to...
(eval-tests-accept-empty-optional): ...this, again checking
with and without lexical binding.
2021-09-25 20:25:01 +02:00
Michael Albinus
4778e10572 ; Fix typo in ert.texi 2021-09-25 18:50:32 +02:00
Philip Kaludercic
a51aa94b6e * rcirc.texi (Using rcirc with bouncers): Remove confusing sentence 2021-09-25 18:31:56 +02:00
Eli Zaretskii
0b7af608c9 ; Another minor improvement in ERT manual
* doc/misc/ert.texi (Running Tests Interactively): State the
function run by each key, per conventions.
2021-09-25 18:56:02 +03:00
Eli Zaretskii
d9abb06ded ; * doc/misc/ert.texi (Running Tests Interactively): Fix markup. 2021-09-25 18:46:33 +03:00
Stefan Kangas
c7370f7334 Extend and improve ERT manual section on running interactively
* doc/misc/ert.texi (Running Tests Interactively): Format commands in
a table, improve indexing, and add several missing
commands.  (Bug#41829)
2021-09-25 16:56:55 +02:00
Basil L. Contovounesios
c17eded545 ; Fix omission in recent CONTRIBUTE doc change. 2021-09-25 14:41:24 +01:00
Lars Ingebrigtsen
c2b8058c07 Document the new paren-space indentation rule
* doc/emacs/programs.texi (Lisp Indent): Mention the new
paren-space indentation rule.
2021-09-25 12:11:26 +02:00
Lars Ingebrigtsen
f90b026978 Document the 'string' thingatpt target
* doc/lispref/text.texi (Buffer Contents): Mention the 'string'
target.
2021-09-25 11:45:30 +02:00
Eli Zaretskii
12b860bd1b ; Improve text about 'CONTRIBUTE'
* doc/emacs/trouble.texi (Contributing): Expand the
recently-changed text.
2021-09-25 10:45:38 +03:00
Eli Zaretskii
f82f3d62ad ; Improve recently added documentation
* etc/NEWS:
* doc/lispref/tips.texi (Documentation Tips): Improve and clarify
recently-added documentation of man page references.
2021-09-25 09:59:53 +03:00
Lars Ingebrigtsen
1ea434b191 Document redisplay-skip-fontification-on-input
* doc/emacs/display.texi (Scrolling): Mention
redisplay-skip-fontification-on-input.
2021-09-25 07:24:48 +02:00
Bastien Guerry
e971e0868d ; * doc/misc/gnus.texi (Gnus Registry Setup): Fix missing parenthesis. 2021-09-25 07:15:31 +02:00
Stefan Kangas
f1071bf08e New :type natnum for defcustom
* lisp/wid-edit.el (natnum): New widget type.  (Bug#15809)
* doc/lispref/customize.texi (Simple Types): Document it.
2021-09-25 04:15:22 +02:00
Stefan Kangas
0917919337 Add support for man page hyperlinks in doc strings
* lisp/help-mode.el (help-man): New button type.
(help-xref-man-regexp): New const.
(help-make-xrefs): Use them to allow making man page buttons.
* doc/lispref/tips.texi (Documentation Tips): Document the new
hyperlink type.  (Bug#39215)
2021-09-25 04:00:37 +02:00
Lars Ingebrigtsen
0b2596432d Fix some instances in the Emacs manual with misleading prefix syntax
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/misc.texi (Editing Binary Files):
* doc/emacs/macos.texi (Mac / GNUstep Events):
* doc/emacs/kmacro.texi (Basic Keyboard Macro):
* doc/emacs/glossary.texi (Glossary):
* doc/emacs/fixit.texi (Spelling): Fix some instances where the
syntax seems to imply we're talking about a prefix key (bug#50792).
2021-09-25 03:59:42 +02:00
Stefan Kangas
c748164702 Clarify where to find CONTRIBUTE
* doc/emacs/trouble.texi (Contributing): Say that CONTRIBUTE is
found in the development version of Emacs.  (Bug#37414)
2021-09-25 03:24:56 +02:00
Robert Pluim
68b8f3128f ; * doc/misc/tramp.texi: Grammar fixes for process-connection-type 2021-09-24 13:31:32 +02:00
Eli Zaretskii
4e8e2a18da ; * doc/emacs/glossary.texi (Glossary): Improve the "symbol" entry. 2021-09-24 10:25:08 +03:00
Lars Ingebrigtsen
794c5a0ba7 Add s Symbol entry in the glossary
* doc/emacs/glossary.texi (Glossary): Add an entry for Symbol
(bug#50760).
2021-09-23 23:33:36 +02:00