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