procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document adding package dependency on Emacs version

Browse source 
* doc/lispref/package.texi (Simple Packages, Multi-file Packages):
Document how to make a package depend on a specific version of Emacs.
This commit is contained in:
Stefan Kangas 2024-07-05 13:58:07 +02:00
parent d190cb0e88
commit cefec59df7
1 changed files with 9 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
doc/lispref/package.texi
View file

@ -192,10 +192,11 @@ used as the long description. (When displaying the description, Emacs
omits the @samp{;;; Commentary:} line, as well as the leading comment
characters in the commentary itself.)
If the file has a @samp{Package-Requires} header, that is used as
the package dependencies. In the above example, the package depends
on the @samp{flange} package, version 1.0 or higher. @xref{Library
Headers}, for a description of the @samp{Package-Requires} header. If
If the file has a @samp{Package-Requires} header, that is used as the
package dependencies. In the above example, the package depends on the
@samp{flange} package, version 1.0 or higher. @xref{Library Headers},
for a description of the @samp{Package-Requires} header. To depend on a
specific version of Emacs, specify @samp{emacs} as the package name. If
the header is omitted, the package has no dependencies.
The @samp{Keywords} and @samp{URL} headers are optional, but recommended.
@ -247,9 +248,10 @@ is the brief description.
@var{requirements} is a list of required packages and their versions.
Each element in this list should have the form @code{(@var{dep-name}
@var{dep-version})}, where @var{dep-name} is a symbol whose name is
the dependency's package name, and @var{dep-version} is the
dependency's version (a string).
@var{dep-version})}, where @var{dep-name} is a symbol whose name is the
dependency's package name, and @var{dep-version} is the dependency's
version (a string). The spacial value @samp{emacs} means that the
package depends on the given version of Emacs.
@end defun
If the content directory contains a file named @file{README}, this