Commit graph

5760 commits

Author SHA1 Message Date
Eli Zaretskii
dfcfaa0ef5 More accurate documentation of 'equal' in ELisp Reference
* doc/lispref/objects.texi (Equality Predicates): Add lists and
conses.  (Bug#72888)
2024-08-30 13:57:29 +03:00
Stefan Kangas
aa6ed7f67e Fix copyright years by hand (Bug#72809)
These are dates that admin/update-copyright did not update.
2024-08-26 02:50:24 +02:00
Eli Zaretskii
4eaab54896 ; * doc/lispref/display.texi (Low-Level Font): Fix wording (bug#72771). 2024-08-25 20:47:51 +03:00
Eli Zaretskii
fc7581ae2e ; Fix documentation of secure-hash functions
* src/fns.c (Fsecure_hash):
* doc/lispref/text.texi (Checksum/Hash):
* lisp/subr.el (sha1): Fix documentation wrt to the number of
bytes 'secure-hash' and its variants return when BINARY is
non-nil.  Reported by Pip Cet <pipcet@protonmail.com>.
2024-08-19 17:51:50 +03:00
Eli Zaretskii
3fc1635783 ; * doc/lispref/strings.texi (Text Comparison): Improve indexing. 2024-08-16 14:05:20 +03:00
Eli Zaretskii
9bedb957be Improve documentation of time-parsing functions
* doc/lispref/os.texi (Time Parsing):
* lisp/calendar/iso8601.el (iso8601-parse):
* lisp/calendar/parse-time.el (parse-time-string): Document that
these functions don't care about the distinction between local
time and UTC.  (Bug#72570)
2024-08-14 11:35:48 +03:00
Eli Zaretskii
a0406f7c12 ; Improve documentation of 'add-to-list'
* doc/lispref/lists.texi (List Variables):
* lisp/subr.el (add-to-list): Add/clarify caveats of using
'add-to-list'.
2024-08-09 08:45:30 +03:00
Eli Zaretskii
a577eccdbb ; * doc/lispref/strings.texi (String Conversion): Fix last change. 2024-08-08 11:41:52 +03:00
Ulrich Müller
d22e52375a Remove manual entry for string-to-int
* doc/lispref/strings.texi (String Conversion): Remove mention of
'string-to-int' which was dropped in Emacs 26.  (Bug#72520)
2024-08-08 08:07:31 +02:00
Ulrich Müller
4dc9e99349 Update description of string comparison functions
* doc/lispref/strings.texi (Text Comparison): Swap descriptions	of
'string-equal' (the function) and 'string=' (its alias).  Same for
'string-lessp' and 'string<'.  Document 'string>'.  (Bug#72486)
* doc/lispref/sequences.texi (Sequence Functions): Update cross
reference to 'string-lessp'.
2024-08-06 18:04:46 +02:00
Eli Zaretskii
158835668d ; * doc/lispref/modes.texi (Mode Line Data): Fix formatting. 2024-07-27 15:56:47 +03:00
Eli Zaretskii
87389f9ff9 ; Improve documentation of 'line-prefix' and 'wrap-prefix'.
* doc/lispref/text.texi (Special Properties): Spell out more
accurately how 'line-prefix' and 'wrap-prefix' properties should
be set.
2024-07-26 14:56:14 +03:00
Stefan Kangas
a799661566 Standardize possessive apostrophe usage in manuals, docs, and comments
See the note in admin/notes/documentation.
Ref: https://lists.gnu.org/r/emacs-devel/2012-02/msg00649.html
2024-07-25 03:35:18 +02:00
Stefan Kangas
9b426e15ab Correctly typeset nil and t in texinfo
* doc/emacs/package.texi (Fetching Package Sources):
* doc/lispref/display.texi (Image Descriptors):
* doc/lispref/windows.texi (Buffer Display Action Alists):
* doc/misc/gnus-faq.texi (FAQ 5-4): Correctly typeset nil and t.
2024-07-22 10:14:51 +02:00
Stefan Kangas
00adee897a ; Fix punctuation in docs 2024-07-21 17:35:13 +02:00
Stefan Kangas
55110d1fda Document GNU ELPA copyright in tips.texi
* doc/lispref/tips.texi (Library Headers): Document that GNU ELPA
packages should have their copyright assigned to the FSF.
2024-07-20 07:46:37 +02:00
Michael Albinus
0218fb2143 Adapt file-remote-p doc
* doc/lispref/files.texi (Magic File Names): Adapt file-remote-p.

* lisp/files.el (file-remote-p): Adapt docstring.
2024-07-19 18:29:49 +02:00
Stefan Kangas
a6cab228d4 ; Fix typos 2024-07-18 11:46:50 +02:00
Eli Zaretskii
504bdd560a ; Fix last change
* doc/lispref/windows.texi (Dedicated Windows):
* doc/emacs/windows.texi (Displaying Buffers): Mention keybinding.
2024-07-17 14:10:50 +03:00
Robert Pluim
3ccebbe17b Fix 'toggle-window-dedicated' documentation
* doc/emacs/windows.texi (Displaying Buffers): Fix the cross reference
to the elisp manual.  Add missing 'toggle-window-dedicated'.
* doc/lispref/windows.texi (Dedicated Windows): Mention
'toggle-window-dedicated'.
2024-07-17 09:47:28 +02:00
Eli Zaretskii
719d5753ca ; * doc/lispref/help.texi (Keys in Documentation): Add cross-reference. 2024-07-16 17:35:42 +03:00
Steven Allen
ecc8516d9c ; Replace (non-)nil with (non-)@code{nil} in texinfo files
* doc/lispref/functions.texi:
* doc/lispref/keymaps.texi:
* doc/lispref/strings.texi:
* doc/misc/cl.texi:
* doc/misc/dbus.texi:
* doc/misc/eshell.texi:
* doc/misc/message.texi:
* doc/misc/ses.texi:
* doc/misc/vtable.texi: Replace (non-)nil with (non-)@code{nil}.
2024-07-15 18:16:41 +02:00
Robert Pluim
945335fec1 Improve 'put-image' documentation
* doc/lispref/display.texi (Showing Images): Mention that it returns the
created overlay.
* lisp/image.el (put-image): And here.
2024-07-10 16:08:29 +02:00
Eli Zaretskii
c193a702dc ; Improve a recent change to the documentation
* lisp/emacs-lisp/comp.el (native-comp-debug):
* doc/lispref/compile.texi (Native-Compilation Variables): Improve
wording.
2024-07-08 14:48:25 +03:00
Andrea Corallo
7668385390 ; Improve 'native-comp-debug' documentation
* lisp/emacs-lisp/comp.el (native-comp-debug): Improve doc.
* doc/lispref/compile.texi (Native-Compilation Variables): Likewise.
2024-07-08 11:06:35 +02:00
Eli Zaretskii
a6a588ccf1 ; * doc/lispref/strings.texi (Creating Strings): Followup to last change. 2024-07-06 11:36:44 +03:00
Stefan Kangas
cefec59df7 Document adding package dependency on Emacs version
* doc/lispref/package.texi (Simple Packages, Multi-file Packages):
Document how to make a package depend on a specific version of Emacs.
2024-07-05 15:02:23 +02:00
Eli Zaretskii
2f71460d52 More updates of documentation for Emacs 30
* etc/NEWS: Improve wording and move/mark entries.

* doc/lispref/positions.texi (List Motion): Document
'forward-sentence-function'.
* doc/lispref/functions.texi (What Is a Function): Document
'primitive-function-p' and 'cl-functionp'.
* doc/emacs/misc.texi (Saving Emacs Sessions): Improve wording and
indexing.
* doc/lispref/tips.texi (Documentation Tips): Adapt to the new
value of 'emacs-lisp-docstring-fill-column'.
* doc/emacs/fixit.texi (Spelling): Document
'flyspell-check-changes'.
2024-06-30 22:25:31 +03:00
Eli Zaretskii
df0eb5be1e Improve documentation of 'remove-overlays' in ELisp manual
* doc/lispref/display.texi (Managing Overlays): Update
documentation of 'remove-overlays'.  (Bug#57534)  (Bug#13648)
2024-06-28 14:52:05 +03:00
Eli Zaretskii
039e6ffd86 Write Antinews for Emacs 30 ELisp Reference
* doc/lispref/anti.texi (Antinews):
* doc/lispref/elisp.texi (Top): Rewrite "Antinews" for Emacs 30.
2024-06-27 21:54:52 +03:00
Stefan Kangas
fb11294d41 ; Fix typos 2024-06-23 16:40:06 +02:00
Stefan Kangas
41cbfead7e Remove more references to Windows 95
* doc/lispref/frames.texi (Window System Selections):
* doc/misc/ediff.texi (Patch and Diff Programs):
* doc/misc/efaq-w32.texi (Third-party multibyte, Swap Caps NT)
(Subprocesses and floppy drive):
* etc/PROBLEMS:
* lisp/printing.el (pr-path-alist, pr-command):
* lisp/ps-print.el: Remove more references to Windows 95, which is not
supported by Emacs.
2024-06-20 13:30:11 +02:00
Eli Zaretskii
775aeabcfb Fix use of ':align-to' in 'wrap-prefix'
* src/dispextern.h (struct it): New flag 'align_visually_p'.
* src/xdisp.c (handle_line_prefix): Set the 'align_visually_p'
flag for 'wrap-prefix'.
(produce_stretch_glyph): If 'align_visually_p' flag is set, count
the :align-to offset from the beginning of the screen line, not
from BOL.  (Bug#71605)

* doc/lispref/display.texi (Truncation, Specified Space): Document
the special handling of ':align-to' in 'wrap-prefix'.
2024-06-20 12:52:06 +03:00
Stefan Kangas
c0eefebabf ; Fix typos 2024-06-16 22:38:26 +02:00
Eli Zaretskii
1bc093e33c Merge from origin/emacs-29
59261e6f4f Fix auth-info-password
778f8c793d ; * lisp/mail/rmail.el (rmail-get-new-mail-hook): Doc fix.
e6044b29e6 ; Minor fixes in ELisp manual
2024-06-15 13:06:09 -04:00
Eli Zaretskii
2cbea4f35c Better documentation of 'emacs-internal' encoding
* doc/lispref/nonascii.texi (Coding System Basics): Recommend
'emacs-internal' encoding for caching.
2024-06-15 15:59:55 +03:00
Eli Zaretskii
7375b6d5ad ; * doc/lispref/nonascii.texi (Character Codes): Fix wording. 2024-06-11 15:09:30 +03:00
Robert Pluim
3a4cf1aa1e Add 'char-to-name' convenience function
* lisp/international/mule-cmds.el (char-to-name): New function.  This is
the inverse of 'char-from-name'.
* doc/lispref/nonascii.texi (Character Codes): Document it.
* etc/NEWS: Announce it.
2024-06-11 11:06:37 +02:00
Juri Linkov
8254e50e2d Text improvements for the documentation of 'some-window' (bug#70949)
* doc/lispref/windows.texi (Buffer Display Action Functions):
Improve wording.  Suggested by martin rudalics <rudalics@gmx.at>.
2024-06-09 20:03:32 +03:00
Jared Finder
a5c0d682b1 Add documentation for window-tool-bar package
Also change window-tool-mode to not pay attention to if
tool-bar-map has a buffer local value or not as that made the
documentation complicated.  Documentation added in Emacs manual,
Elisp manual, package commentary, and docstrings.  Also extend
window-tool-bar support to Emacs 27 and newer.  (bug#68765)

* doc/emacs/emacs.texi (Top):
* doc/emacs/frames.texi (Menu Bars):
* doc/emacs/glossary.texi (Glossary):
* doc/emacs/modes.texi (Minor Modes):
* doc/emacs/windows.texi (Windows, Tab Line): Mention Window
Tool Bar.
(Window Tool Bar): New documentation.
* doc/lispref/elisp.texi (Top):
* doc/lispref/modes.texi (Mode Line Format, Mode Line Basics)
(Mode Line Data): Mention Tab Lines.
(Tab Lines): New documentation.
* etc/NEWS: Mention newly added variable and package.
* lisp/window-tool-bar.el (window-tool-bar-mode): Don't display
tool bar when tool-bar-map is nil.
* lisp/window-tool-bar.el (tool-bar-always-show-default): Define
variable for older Emacs versions.
2024-06-09 15:21:34 +03:00
Stefan Kangas
7f8ded2a85 ; Fix typo in help.texi
* doc/lispref/help.texi (Keys in Documentation): Fix typo.
2024-06-09 13:02:00 +02:00
Stefan Monnier
8253228d55 (hack-dir-local-get-variables-functions): New hook
Make it possible to provide more dir-local variables, such as
done by the Editorconfig package.

* lisp/files.el (hack-dir-local--get-variables): Make arg optional.
(hack-dir-local-get-variables-functions): New hook.
(hack-dir-local-variables): Run it instead of calling
`hack-dir-local--get-variables`.

* doc/lispref/variables.texi (Directory Local Variables):
Document the new hook.
2024-06-09 00:20:50 -04:00
Stefan Monnier
3ecc6b4f3c (find-auto-coding): Provide filename to auto-coding-functions
Allow `auto-coding-functions` to know the file name.
Motivated by the needs of Editorconfig support.

* lisp/international/mule.el (auto-coding-file-name): New var.
(find-auto-coding): Let-bind it for `auto-coding-functions`.
Document the expectation that the arg be an absolute file name.

* doc/lispref/nonascii.texi (Default Coding Systems):
Mention `auto-coding-file-name`.

* test/lisp/international/mule-util-resources/test.utf-16le: New file.
* test/lisp/international/mule-tests.el (mule-tests--dir): New var.
(mule-tests--auto-coding): New fun.
(mule-tests--auto-coding-functions): New test.
2024-06-09 00:19:03 -04:00
Eli Zaretskii
e6044b29e6 ; Minor fixes in ELisp manual
* doc/lispref/searching.texi (Regexp Search): Caveat about using
'search-spaces-regexp'.  (Bug#71429)
* doc/lispref/help.texi (Keys in Documentation): Fix markup.
2024-06-08 21:06:51 +03:00
Eli Zaretskii
4468216f17 ; * doc/lispref/display.texi (Image Descriptors): Clarify text. 2024-06-08 16:19:54 +03:00
Stefan Kangas
bef514de4d ; Fix typos 2024-06-07 23:51:18 +02:00
Juri Linkov
979365eef2 Add new alist entry 'some-window' for 'display-buffer-use-some-window'
* doc/lispref/windows.texi (Buffer Display Action Functions):
Add details of using the alist entry 'some-window' in
'display-buffer-use-some-window'.
(Buffer Display Action Alists): Add 'some-window'.

* lisp/window.el (display-buffer-use-some-window):
Handle the alist entry 'some-window' (bug#70949).
Extend docstring with its description.
2024-06-07 19:45:06 +03:00
Basil L. Contovounesios
6dd3c6023e Fix tree-sitter markup in Elisp manual
* doc/lispref/parsing.texi (Retrieving Nodes, User-defined Things)
(Multiple Languages): Mark up variable names as @code, not
metasyntactic @var.
2024-06-07 11:08:31 +02:00
Eli Zaretskii
9da2faf73b ; Fix last change in sqlite.c
* etc/NEWS:
* doc/lispref/text.texi (Database):
* src/sqlite.c (Fsqlite_execute_batch): Fix last change (Bug#70145).
2024-06-06 13:06:58 +03:00
Javier Olaechea
23ef989935 Add 'sqlite-execute-batch' command
This command is similar to 'sqlite-execute' except that it
executes multiple statements in exchange for not accepting
any arguments.  (Bug#70145)
* src/sqlite.c (Fsqlite_execute_batch): New function.

* test/src/sqlite-tests.el (sqlite-multiple-statements): Add
smoke test for 'sqlite-execute-batch'.

* etc/NEWS: Mention new command 'sqlite-execute-batch'.
* doc/lispref/text.texi (Database): Document the new command.
2024-06-06 12:51:46 +03:00