1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-18 00:50:44 -08:00
Commit graph

9771 commits

Author SHA1 Message Date
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
Eli Zaretskii
3848e2727e Improve the documentation of a recent change
* etc/NEWS:
* doc/lispref/sequences.texi (Sequence Functions): Improve
documentation of 'seq-union'.
2021-09-17 15:03:53 +03:00
Stefan Kangas
0cf0a2b986 Add new sequence function 'seq-union'
* lisp/emacs-lisp/seq.el (seq-union): New function.
* doc/lispref/sequences.texi (Sequence Functions):
* lisp/emacs-lisp/shortdoc.el (sequence): Document above new
function.
* test/lisp/emacs-lisp/seq-tests.el (test-seq-union): New test.
2021-09-17 11:03:39 +02:00
Stefan Kangas
bcf59b99f4 Prefer "website" to "homepage"
These days, a "home page" is understood to be only "the main web page
of a website" or "landing page", whereas a "website" is "a collection
of web pages and related content" (Wikipedia).

* doc/emacs/emacs.texi (Top):
* doc/emacs/package.texi (Package Menu):
* doc/lispintro/emacs-lisp-intro.texi (Top):
* doc/lispref/elisp.texi (Top):
* doc/lispref/tips.texi (Documentation Tips):
* doc/misc/ede.texi (ede-project):
* doc/misc/efaq-w32.texi (More information):
* doc/misc/gnus-faq.texi (FAQ 5-7):
* doc/misc/gnus.texi (About mairix):
* doc/misc/mairix-el.texi (About):
* doc/misc/reftex.texi (AUCTeX, Imprint):
* lisp/cedet/ede/base.el (ede-project):
* lisp/cedet/ede/system.el (ede-web-browse-home):
* lisp/emacs-lisp/package.el (package-menu-mode-menu)
(package-browse-url):
* lisp/erc/erc-button.el (erc-emacswiki-url):
* lisp/filesets.el (filesets-goto-homepage):
* lisp/net/mairix.el:
* lisp/net/webjump.el (webjump-sample-sites):
* lisp/obsolete/vc-arch.el:
* lisp/progmodes/idlw-shell.el (idlwave-shell-mode):
* lisp/progmodes/idlwave.el (idlwave, idlwave-mode):
* lisp/textmodes/reftex-vars.el (reftex):
Prefer "website" to "home page".

* doc/lispref/tips.texi (Documentation Tips):
Sort the "URL" header comment before "Homepage".

* lisp/emacs-lisp/lisp-mnt.el
(lm-website): Rename from 'lm-homepage'.
(lm-homepage): Make into alias for 'lm-website'.
2021-09-16 15:42:44 +02:00
Eli Zaretskii
a9558baaf9 Clarify use of early-init file
* doc/emacs/custom.texi (Early Init File): Clarify that using the
early-init file should be reserved to cases where it is absolutely
necessary.  (Bug#50491)
2021-09-16 15:34:36 +03:00
Stefan Kangas
7f53446a10 Doc fix for y-or-n-p; trailing space is no longer needed
* doc/lispref/minibuf.texi (Yes-or-No Queries):
* doc/lispref/os.texi (Suspending Emacs):
* doc/lispref/tips.texi (Programming Tips):
* doc/misc/gnus-faq.texi (FAQ 5-9):
* lisp/subr.el (y-or-n-p):
* src/fns.c (Fyes_or_no_p): Doc fix to reflect that a trailing space
is no longer needed; one is added or removed automatically.
2021-09-16 09:38:24 +02:00
Stefan Kangas
1bae08dbf0 * doc/misc/pgg.texi: Clarify that its obsolete in the menu entry. 2021-09-16 02:33:08 +02:00
Eli Zaretskii
9b50b36efe Documentation followup to a recent commit
* doc/lispref/tips.texi (Documentation Tips): Make the wording of
recommendation not to over-use \\[..] more future-proof.
(Bug#50599)
2021-09-15 22:01:21 +03:00
Philip Kaludercic
7a69fe3bc9
Merge branch 'feature/rcirc-update' 2021-09-15 17:36:19 +02:00
Eli Zaretskii
83557511a7 Update Unicode support to Unicode version 14.0.0
* admin/unidata/copyright.html:
* admin/unidata/UnicodeData.txt:
* admin/unidata/Blocks.txt:
* admin/unidata/BidiBrackets.txt:
* admin/unidata/BidiMirroring.txt:
* admin/unidata/IVD_Sequences.txt:
* admin/unidata/NormalizationTest.txt:
* admin/unidata/SpecialCasing.txt:
* test/manual/BidiCharacterTest.txt: Updated files from Unicode
14.0.

* lisp/international/fontset.el (script-representative-chars): Add
new scripts.
(otf-script-alist): Update from latest version.
(setup-default-fontset): Add new scripts.
* lisp/international/characters.el: Update syntax and category
tables for new characters and scripts.
(char-width-table): Update for changes in Unicode 14.0.
* lisp/international/mule-cmds.el (ucs-names): Update used and
unused ranges per Unicode 14.0.

* test/lisp/international/ucs-normalize-tests.el
(ucs-normalize-tests--failing-lines-part1)
(ucs-normalize-tests--failing-lines-part2): Update per the test
results.

* doc/lispref/nonascii.texi (Character Properties): Update Unicode
version number.

* etc/NEWS: Announce support for Unicode 14.0.

* admin/notes/unicode: Minor copyedits.
2021-09-15 14:40:13 +03:00
João Távora
bce1013883 * doc/misc/flymake.texi: Fix @include docstyle.texi 2021-09-15 10:23:40 +01:00
Glenn Morris
4c492c8c5f * doc/misc/flymake.texi: Avoid xrefs in @copying.
This isn't really what @copying is for, and doesn't work with
makeinfo 4.13.
2021-09-14 14:27:41 -07:00
Philip Kaludercic
8eb9eb0c41
Allow for multiple attempts when reconnecting
* doc/misc/rcirc.texi (rcirc commands): Mention rcirc-reconnect-attempts
* etc/NEWS: Document change
(rcirc-connect): Ensure no other process exists
(rcirc-reconnect-attempts): Add option
(rcirc-failed-attempts): Add local variable
(rcirc-reconnection-timer): Add local variable
(rcirc-reconnect): Add function
(rcirc-sentinel): Manage multiple reconnection attempts
(rcirc-process-server-response): Change user for error messages
(rcirc-mode): Don't set rcirc-last-connect-time
(reconnect): Extract functionality to rcirc-reconnect
2021-09-14 19:05:12 +02:00
Philip Kaludercic
ec50a368d5
* rcirc.texi (Hacking and Tweaking): Add missing section to menu 2021-09-14 18:14:57 +02:00
Eli Zaretskii
0934363c96 Fix recent changes in Flymake manual
* doc/misc/flymake.texi: Fix typos.  Downcase the first word of
each index entry, for more reliable sorting.
(Starting Flymake, Finding diagnostics, Troubleshooting): Fix
typos.
2021-09-14 16:47:40 +03:00