1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-05 11:21:04 -08:00
Commit graph

9085 commits

Author SHA1 Message Date
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
Lars Ingebrigtsen
efdb89f15b Move 'kdb-macro-redisplay' key binding
* doc/emacs/kmacro.texi (Basic Keyboard Macro): Adjust.

* lisp/kmacro.el (kmacro-keymap): Move 'kdb-macro-redisplay' to
`C-x C-k d' since upper-case letters are reserved for users (bug#50727).
2021-09-22 21:56:31 +02:00
Stephen Gildea
e402a21704 ; * doc/misc/mh-e.texi (Scan Line Formats): Fix typo, an extra "the". 2021-09-21 22:34:35 -07:00
Lars Ingebrigtsen
636e082e45 Document isearch-wrap-pause
* doc/emacs/search.texi (Repeat Isearch): Document
`isearch-wrap-pause'.
2021-09-21 22:01:28 +02:00
Stefan Kangas
e4a9aa940b ; * doc/lispref/windows.texi (Cyclic Window Ordering): Fix typo. 2021-09-21 21:07:37 +02:00
Eli Zaretskii
fd77065fc6 Improve recently added documentation
* doc/lispref/lists.texi (Building Lists):
* lisp/subr.el (ensure-list): Avoid passive tense in documenting
'ensure-list'.
2021-09-21 21:51:38 +03:00
Lars Ingebrigtsen
be4f858498 Add new function `ensure-list'
* doc/lispref/lists.texi (Building Lists): Document it.

* lisp/subr.el (ensure-list): New function.

* lisp/emacs-lisp/shortdoc.el (list): Mention it.
2021-09-21 20:31:05 +02:00
Lars Ingebrigtsen
314f27014e Document `window-bump-use-time'
* doc/lispref/windows.texi (Cyclic Window Ordering): Mention
window-bump-use-time.
2021-09-21 19:48:01 +02:00
Lars Ingebrigtsen
a7d51676f1 Document completions-detailed
* doc/emacs/help.texi (Name Help): Document completions-detailed.
* lisp/minibuffer.el (completions-detailed): Give an example in
the doc string.
2021-09-21 19:43:07 +02:00
Dmitry Gutov
e1712bdb35 Rename project-remove-known-project to project-forget-project
* doc/emacs/maintaining.texi (Managing Projects): Ditto.

* etc/NEWS: Update accordingly.

* lisp/progmodes/project.el (project-forget-project):
Rename from 'project-remove-known-project', for consistency with
'project-remember-project' (discussed in bug#50297).
2021-09-21 16:07:52 +03:00
Dmitry Gutov
df1d4f5894 New command: project-find-dir
* doc/emacs/maintaining.texi (Project File Commands):
Mention the new command and update the bindings information.

* lisp/progmodes/project.el (project-find-dir):
New command (bug#43153).
(project-prefix-map): Use 'd' as its binding.
Move 'project-dired' to 'D'.
(project-switch-commands):
Replace 'project-dired' with 'project-find-dir'.
2021-09-21 03:53:21 +03:00
Juri Linkov
644d0ba589 Add support for url-retrieve-synchronously to eww-retrieve-command (bug#50680)
* doc/misc/eww.texi (Advanced): Mention url-retrieve-synchronously
for eww-retrieve-command.

* lisp/net/eww.el (eww-retrieve-command): Add choice 'sync' for
url-retrieve-synchronously.
(eww-retrieve): Use value 'sync' for url-retrieve-synchronously.
(eww-isearch-next-buffer): Let-bind eww-retrieve-command to 'sync'.
2021-09-20 10:16:09 +03:00
Miha Rihtaršič
469b15f27c Improve documentation of exiting recursive editing
* doc/lispref/commands.texi (Recursive Editing): Mention what happens
when throwing a string or any other value to 'exit.
* src/keyboard.c (Frecursive_edit): Document throwing a function
to 'exit (bug#49700).
2021-09-20 08:00:08 +02:00
Stefan Kangas
7abbf3779c Be explicit about missing sections in eshell manual
* doc/misc/eshell.texi (Writing a module, Module testing)
(Directory handling, Key rebinding, Smart scrolling)
(Terminal emulation): Explicitly say that these sections remain to
be written.  (Bug#49306)
2021-09-19 18:33:53 +02:00
Juri Linkov
4b3dc7a139 * lisp/subr.el (string-replace): Add dashes to arg names (bug#50644)
* lisp/net/tramp-compat.el (tramp-compat-string-replace): Idem.
* doc/lispref/searching.texi (Search and Replace): Idem.
2021-09-18 21:43:18 +03:00
Eli Zaretskii
acba74a395 ; Clarify recently added documentation
* etc/NEWS:
* doc/emacs/help.texi (Name Help): Clarify documentation of
'help-enable-symbol-autoload'.
2021-09-18 21:04:07 +03:00
Arthur Miller
c53aff5de7 Add new help-enable-symbol-autoload user option
* lisp/help-fns.el (help-fns--analyze-function): Use it.
* lisp/help-fns.el (help-enable-symbol-autoload): New user option.
* doc/emacs/help.texi (Name Help): Document it.
2021-09-18 19:51:47 +02:00
Lars Ingebrigtsen
32d85f7b89 Mention xref-quit-and-pop-marker-stack in the manual
* doc/emacs/maintaining.texi (Xref Commands): Mention
xref-quit-and-pop-marker-stack in the manual.
2021-09-18 18:32:22 +02:00
Lars Ingebrigtsen
a8103cf9e0 Stop imenu indexing after a certain number of seconds
* doc/emacs/programs.texi (Imenu): Document it.
* lisp/imenu.el (imenu-max-index-time): New user option.
(imenu-default-create-index-function, imenu--generic-function):
Use it (bug#18696).
2021-09-17 17:54:21 +02:00
Lars Ingebrigtsen
928c162673 Mention that the garbage collection is convervative
* doc/lispref/internals.texi (Garbage Collection): Mention that
we're using a conservative gc (bug#42013).
2021-09-17 16:17:08 +02:00