From a8b0f5adfa46a596409a97d13fd74394e0605e17 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 12 Jul 2025 10:11:09 +0300 Subject: [PATCH] ; Fix documentation of last change (bug#78844) * doc/lispref/elisp.texi (Top): * doc/lispref/package.texi (Packaging): Fix menus. (Package Information): Fix wording, indexing and markup. --- doc/lispref/elisp.texi | 3 +++ doc/lispref/package.texi | 13 ++++++++----- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index f6f8afcd326..724437b3eb7 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -1648,6 +1648,9 @@ Preparing Lisp code for distribution * Simple Packages:: How to package a single .el file. * Multi-file Packages:: How to package multiple files. * Package Archives:: Maintaining package archives. +* Archive Web Server:: Interfacing to an archive web server. +* Forwards-Compatibility:: Supporting older versions of Emacs. +* Package Information:: Information about built-in packages. Tips and Conventions diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi index 5341e3e794a..41fc6c77dd6 100644 --- a/doc/lispref/package.texi +++ b/doc/lispref/package.texi @@ -29,6 +29,7 @@ these archives). * Package Archives:: Maintaining package archives. * Archive Web Server:: Interfacing to an archive web server. * Forwards-Compatibility:: Supporting older versions of Emacs. +* Package Information:: Information about built-in packages. @end menu @node Packaging Basics @@ -428,15 +429,17 @@ Compat manual}. @node Package Information @section Get built-in packages and versions @cindex package information +@cindex version of a built-in package +@cindex list of built-in packages Emacs ships built-in packages which may also be packaged externally on ELPA. Knowing whether a built-in package has a higher version than on ELPA or other packaging systems may be useful for external packaging -tools. Those who would like to query such information can use the -following functions. +tools. Lisp programs which would like to query such information can use +the following functions. @defun package-versioned-builtin-packages -This function returns the list of packages that are built-in to Emacs +This function returns the list of packages that are built into Emacs and have a version. The returned list contains one symbol for each built-in package that has a version, which are likely also packaged externally on ELPA. @@ -446,6 +449,6 @@ externally on ELPA. This function returns the version of a built-in @var{package}. @var{package} should be a symbol. The returned value is a list of integers representing the version of PACKAGE in the format returned by -the function @code{version-to-list}, or nil if @var{package} is built-in -but has no version or is not a built-in package. +the function @code{version-to-list}, or @code{nil} if @var{package} is +built-in but has no version, or is not a built-in package. @end defun