mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-03-15 11:21:19 -07:00
Code Issues Projects Releases Wiki Activity
174784 commits 247 branches 194 tags 1 GiB
Commit graph

5793 commits

Author SHA1 Message Date
Stefan Kangas
7dcf9b71e6 ; Don't document package-x.el 
* doc/lispref/package.texi (Package Archives): Delete documentation on
package-x.el, since it's obsolete in Emacs 31 and we want to discourage
its use.
 2025-03-02 05:09:37 +01:00
Eli Zaretskii
bd1d6761f4 ; Document what happens when 'display' and 'invisible' props clash 
* doc/lispref/display.texi (Replacing Specs, Overlay Properties)
(Invisible Text): Document that 'invisible' is ignored when
'display' property covers the same text.  (Bug#76658)
 2025-03-01 12:59:32 +02:00
Stefan Kangas
526eeedf88 keymaps.texi: Move "Changing Key Bindings" section up 
* doc/lispref/keymaps.texi (Changing Key Bindings): Move section
up.  (Bug#52821)
 2025-03-01 06:36:43 +01:00
Stefan Kangas
7ec6531c7b keymaps.texi: Move "Key Sequences" section down 
* doc/lispref/keymaps.texi (Key Sequences): Move section
down.  (Bug#52821)
 2025-03-01 06:36:43 +01:00
Eli Zaretskii
f88dc0f2f9 ; Fix documentation of 'buffer-text-pixel-size' 
* doc/lispref/display.texi (Size of Displayed Text): Fix arguments
of 'buffer-text-pixel-size'.  (Bug#76519)
 2025-02-26 14:52:26 +02:00
Stefan Kangas
3c9b1c3cd1 Don't document deleted xwidget functions 
* doc/lispref/display.texi (Xwidgets): Don't document deleted function
xwidget-webkit-execute-script-rv.  Fix name of deleted and then re-added
function xwidget-webkit-title.
 2025-02-23 20:47:34 +01:00
Stefan Kangas
9e9b78dda9 ; Improve lsh and ash documented argument names 
* doc/lispref/numbers.texi (Bitwise Operations): Improve lsh and
ash argument names.
 2025-02-23 20:47:34 +01:00
Stefan Kangas
92e96a1175 ; Delete troff markers from ChangeLog files 2025-02-20 02:46:43 +01:00
Stefan Kangas
be7625cae7 ; Fix typos 2025-02-18 05:42:12 +01:00
Stefan Kangas
87a61eba1b Move 'package-archives' documentation to emacs manual 
* doc/lispref/package.texi (Package Archives): Move documentation
of package-archives variable from here...
* doc/emacs/package.texi (Package Installation): ...to here.
(Bug#76266)
 2025-02-13 16:40:15 +01:00
Stefan Kangas
c68886ddb7 ; Change "virus" to "malicious" in lispref 
* doc/lispref/functions.texi (Function Safety): Replace 'virus' with
'malicious' to ensure broader accuracy, as 'malicious' encompasses all
harmful software types.
 2025-02-13 03:04:30 +01:00
Eli Zaretskii
737f249aa2 ; Document 'completing-read-multiple' in the ELisp manual 
* doc/lispref/minibuf.texi (Minibuffer Completion): Mention
'completing-read-multiple' (bug#76194).
 2025-02-11 16:42:19 +02:00
Eli Zaretskii
223ee56aae ; Avoid passive tense in Emacs manual 
* doc/lispref/variables.texi (Defining Variables): Avoid passive
tense (bug#76135).
 2025-02-08 13:47:11 +02:00
Eli Zaretskii
143f1096da Improve documentation of 'file-name-concat' 
* doc/lispref/files.texi (Directory Names):
* src/fileio.c (Ffile_name_concat): Advise not to use
'file-name-concat' unless necessary.  (Bug#76023)
 2025-02-06 10:42:04 +02:00
Eli Zaretskii
6d7e7899d8 Improve documentation of 'display-monitor-attributes- 
* doc/lispref/frames.texi (Multiple Terminals):
* lisp/frame.el (display-monitor-attributes-list): Better
documentation of what the 'source' key means on X.  (Bug#75936)
 2025-02-02 15:58:18 +02:00
Stefan Kangas
3bccd04c5c Improve wording in symbols.texi 
* doc/lispref/symbols.texi (Symbol Components): Improve wording
(Bug#75512).   Reported by Matt Trzcinski <matt@excalamus.com>.
 2025-02-01 04:08:43 +01:00
Eli Zaretskii
5d021a711a ; Improve documentation of '.dir-locals.el' 
* doc/lispref/variables.texi (Directory Local Variables):
* doc/emacs/custom.texi (Directory Variables): Document that
'.dir-locals-2.el' must be in the same directory as
'.dir-locals.el'.  (Bug#75890)
 2025-01-27 15:19:06 +02:00
Stefan Kangas
5617b07a45 ; Prefer HTTPS to HTTP in docs 
* doc/emacs/android.texi (Android Software):
* doc/lispref/frames.texi (X Selections):
* doc/misc/cc-mode.texi (Custom Filling and Breaking):
* doc/misc/efaq.texi (Basic editing):
* doc/misc/gnus.texi (Propagating marks, Spam Statistics Package):
* doc/misc/org.org (External Links, Images in HTML export)
(LaTeX Export, LaTeX math snippets): Prefer HTTPS to HTTP.  Fix or
mark some broken links while we're at it.
 2025-01-26 22:45:13 +01:00
Stefan Kangas
3c820cd265 Document insert-directory-program as a user option 
* doc/lispref/files.texi (Contents of Directories): Document
'insert-directory-program' as a user option.
 2025-01-26 22:45:13 +01:00
Stefan Monnier
2c1edf5f62 doc/lispref/modes.texi (Syntactic Font Lock): Update for commit 644c6b414f 
Remove outdated `nil` element, as discussed in
https://lists.gnu.org/archive/html/help-gnu-emacs/2025-01/msg00244.html
 2025-01-25 10:48:38 -05:00
Stefan Kangas
fb282da2a0 Avoid double spaces around abbrevations in Texinfo 
* doc/emacs/custom.texi (Init Rebinding):
* doc/emacs/dired.texi (Operating on Files):
* doc/emacs/emacs.texi (Top):
* doc/emacs/emerge-xtra.texi (Emerge):
* doc/emacs/files.texi (Files):
* doc/emacs/frames.texi (Drag and Drop):
* doc/emacs/misc.texi (Hyperlinking):
* doc/emacs/modes.texi (Modes):
* doc/emacs/mule.texi (Input Methods):
* doc/emacs/windows.texi (Window Tool Bar):
* doc/lispintro/emacs-lisp-intro.texi
(Lexical & Dynamic Binding Differences):
* doc/lispref/elisp.texi (Top):
* doc/lispref/functions.texi (Functions, Generic Functions):
* doc/lispref/hash.texi (Defining Hash):
* doc/lispref/keymaps.texi (Creating Keymaps):
* doc/lispref/lists.texi (Property Lists):
* doc/lispref/modes.texi (%-Constructs):
* doc/lispref/nonascii.texi (Character Properties):
* doc/lispref/processes.texi (Misc Network):
* doc/lispref/searching.texi (Regexp Functions):
* doc/lispref/syntax.texi (Syntax Table Internals):
* doc/lispref/text.texi (Filling, Checksum/Hash)
(JSONRPC deferred requests):
* doc/misc/calc.texi (What is Calc, Modes Tutorial):
* doc/misc/cc-mode.texi (List Line-Up, Operator Line-Up)
(Custom Macros, Indenting Directives):
* doc/misc/efaq.texi (Colors on a TTY, Security risks with Emacs):
* doc/misc/eglot.texi (Eglot Variables):
* doc/misc/erc.texi (Connecting):
* doc/misc/eshell.texi (Aliases, Completion):
* doc/misc/flymake.texi (Backend functions):
* doc/misc/gnus-faq.texi (FAQ 5 - Composing messages):
* doc/misc/gnus.texi (Gnus Unplugged, Window Layout)
(Filtering Incoming Mail, History):
* doc/misc/idlwave.texi (Online Help, Catalogs):
* doc/misc/wisent.texi (Wisent Overview): Be more consistent with
abbreviations.  Use @: or comma or rewrite to avoid double spaces.
Ref: https://lists.gnu.org/r/emacs-devel/2025-01/msg00909.html
 2025-01-24 23:10:23 +01:00
Stefan Kangas
cda78edc7d ; Fix typos 2025-01-23 03:14:37 +01:00
Stefan Kangas
9878092d2b Minor copyedits in internals.texi 
* doc/lispref/internals.texi (Writing Emacs Primitives): Minor
copyedits.
 2025-01-19 14:30:31 +01:00
Stefan Kangas
4726900fdc Better document side-effect free and pure C functions 
* doc/lispref/internals.texi (Writing Emacs Primitives):
Document that side-effect free and pure properties of C functions
are defined in byte-opt.el.
 2025-01-19 14:30:31 +01:00
Mauro Aranda
30e84fc653 Emphasize the use of :tag for new customization types 
* doc/lispref/customize.texi (Type Keywords): Name important use
cases of the :tag keyword.
(Defining New Types): Emphasize the use of the :tag keyword when
using the lazy widget.  (Bug#74409)

(cherry picked from commit 99b85e116f)
 2025-01-12 21:25:06 +02:00
Stefan Kangas
6de2ee5663 Document string-as-{unibyte,multibyte} as obsolete in manual 
* doc/lispref/nonascii.texi (Selecting a Representation): Document
string-as-unibyte and string-as-multibyte as obsolete.
 2025-01-11 05:18:14 +01:00
Stefan Kangas
002960ceab Clarify that 'mac' line ending convention is not used on macOS 
* doc/emacs/mule.texi (Coding Systems):
* doc/lispref/nonascii.texi (Coding System Basics): Clarify that the
'mac' line ending convention is not used on macOS, and is now rare
outside of legacy software.
 2025-01-08 05:07:57 +01:00
Eli Zaretskii
ee1034422b ; Improve documentation of function-type display 
* etc/NEWS: Document 'help-display-function-type'.

* doc/lispref/functions.texi (Declare Form):
* doc/lispref/objects.texi (Type Specifiers):
* doc/emacs/help.texi (Name Help): Better indexing of function
types.  (Bug#65288)
 2025-01-07 17:20:22 +02:00
Stefan Kangas
cd6e2a0828 Fix copyright years by hand 
These are dates that admin/update-copyright did not update.
 2025-01-02 18:44:48 +01:00
Stefan Kangas
7fa975adbc Update copyright year to 2025 
Run "TZ=UTC0 admin/update-copyright".
 2025-01-02 18:39:42 +01:00
Kohei Tsuruta
7acfea1935 ; * doc/lispref/modes.texi (Customizing Keywords): Fix typo (bug#75193). 2024-12-30 16:01:02 +02:00
Kohei Tsuruta
d47a7d6f0f ; Add missing parameters in keymap doc 
* doc/lispref/keymaps.texi (Controlling Active Maps): Add missing
parameters.  (Bug#75174)

Copyright-paperwork-exempt: yes
 2024-12-29 15:40:13 +02:00
Eli Zaretskii
2ba6387d1d ; Fix inaccuracy in ELisp Reference manual 
* doc/lispref/objects.texi (Basic Char Syntax): Fix inaccurate
wording.  (Bug#75113)
 2024-12-28 14:04:26 +02:00
Yuan Fu
10f976300d
; Add some tree-sitter thing content to the manual 
* doc/lispref/parsing.texi (User-defined Things): List "builtin"
things.
 2024-12-15 21:40:49 -08:00
Eli Zaretskii
5c6dbc65f3 ; * doc/lispref/frames.texi (Multiple Terminals): Add indexing. 2024-12-15 09:45:58 +02:00
Chu
6fd5e02cb9 Fix typo in maps.texi 
* doc/lispref/maps.texi (Standard Keymaps): Fix typo.  (Bug#74761)

Copyright-paperwork-exempt: yes
 2024-12-10 11:51:12 +01:00
Yuan Fu
cf4f1387a6
; Update tree-sitter manual 
* doc/lispref/parsing.texi (User-defined Things): Add manual
entry for treesit-node-match-p, treesit-thing-defined-p,
treesit-thing-definition.  Change wording for some functions.
 2024-12-01 11:35:06 -08:00
Eli Zaretskii
afb34a3b23 ; Improve documentation of ':box' face attribute 
* doc/lispref/display.texi (Face Attributes): Describe a subtlety
of displaying ':box'.  (Bug#74536)
 2024-11-30 12:44:01 +02:00
Mike Kupfer
3f99cdaf26 Mention special variables in lexical binding documentation 
* doc/lispref/variables.texi (Lexical Binding): Briefly mention
special variables and their semantics.  (Bug#74540)
 2024-11-28 17:27:16 +02:00
Joost Kremers
3e396b2c5b Improve documentation for 'while-let' 
* doc/lispref/control.texi (Conditionals): Reorganise describing
what's overlapping between the macros (and between the macros
and let*), and then improve the documentation for 'while-let'.
 2024-11-25 12:45:00 +08:00
Juri Linkov
5339c6f69e ; Improve example of display-buffer-alist category in ELisp Reference 
* doc/lispref/windows.texi (Choosing Window): Use 'add-to-list'
and add an example how to override display-buffer-alist entries
such as 'inhibit-same-window' by matching the window
using the 'category' condition (bug#74457).
 2024-11-23 20:27:39 +02:00
Eli Zaretskii
c50ce03afc ; Fix recent additions to the manuals 
* doc/lispref/objects.texi (Type Specifiers):
* doc/lispref/functions.texi (Declare Form):
* doc/emacs/help.texi (Name Help): Fix wording and markup.
(Bug#73626)
 2024-11-21 17:47:22 +02:00
Andrea Corallo
59b3eae481 ; Introduce type specifiers to the elisp manual (bug#73626) 
* doc/lispref/objects.texi (Programming Types): Add 'Type Specifiers' entry.
(Type Specifiers): Add node.
* doc/lispref/functions.texi (Declare Form): Add 'Type Specifiers'
reference.
 2024-11-21 15:38:15 +01:00
Eli Zaretskii
3eb3018682 ; Improve documentation of 'category' in display-buffer actions 
* doc/lispref/windows.texi (Choosing Window)
(Buffer Display Action Alists): Add cross-references.
* doc/lispref/buffers.texi (Buffer List):

* lisp/subr.el (buffer-match-p): Improve documentation of
'category' condition.  (Bug#74361)
 2024-11-21 12:28:26 +02:00
Stefan Kangas
0856360d80 ; Fix typo in recent change 2024-11-16 07:22:48 +01:00
Eli Zaretskii
94bf7ad797 Document the 'display-line-numbers-disable' property 
* doc/lispref/display.texi (Overlay Properties):
* doc/lispref/text.texi (Special Properties): Document
'display-line-numbers-disable'.  Fix indexing.
 2024-11-09 13:33:21 +02:00
Robert Pluim
3231af3727 Improve 'open-network-stream' documentation. 
* doc/lispref/processes.texi (Network): Correct explanation of
':warn-unless-encrypted'.  Document ':error' return keyword.
* lisp/net/network-stream.el (open-network-stream): Improve
':return-list' documentation.  Document ':error'.  Correct
explanation of ':warn-unless-encrypted'.
 2024-11-05 13:51:21 +01:00
Robert Pluim
fb55431c44 ; Fix typos in case-conversion descriptions 
* doc/lispref/nonascii.texi (Character Properties): Fix typos.
* doc/lispref/strings.texi (Case Conversion): Fix typos.
(Case Tables): Fix typos.
 2024-11-05 12:33:49 +01:00
Eli Zaretskii
83f095d1fd ; Fix typo and indexing in the ELisp manual 
* doc/lispref/display.texi (Image Descriptors): Fix typo and indexing.
(Defining Images): Fix indexing.
 2024-11-04 21:34:25 +02:00
Eli Zaretskii
f7b85fe986 Improve documentation of letter-case conversions 
* doc/lispref/nonascii.texi (Character Properties):
* doc/lispref/strings.texi (Case Conversion, Case Tables):
Document that special-casing rules override the case-table
conversions.  (Bug#74155)
 2024-11-01 16:39:39 +02:00