From 196def4fa6411a32e26aa8e589a588f9cd0fbc95 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 4 Nov 2023 09:59:45 +0200 Subject: [PATCH] Fix description of 'Package-Requires' library header * doc/lispref/tips.texi (Library Headers): Update the description of the 'Package-Requires' header. (Bug#66677) --- doc/lispref/tips.texi | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi index f594d684338..f760b2554f0 100644 --- a/doc/lispref/tips.texi +++ b/doc/lispref/tips.texi @@ -1169,6 +1169,21 @@ element) is equivalent to entry with version "0". For instance: ;; Package-Requires: ((gnus "1.0") (bubbles "2.7.2") cl-lib (seq)) @end smallexample +Packages that don't need to support Emacs versions older than Emacs 27 +can have the @samp{Package-Requires} header split across multiple +lines, like this: + +@smallexample +@group +;; Package-Requires: ((emacs "27.1") +;; (compat "29.1.4.1")) +@end group +@end smallexample + +@noindent +Note that with this format, you still need to start the list on the +same line as @samp{Package-Requires}. + The package code automatically defines a package named @samp{emacs} with the version number of the currently running Emacs. This can be used to require a minimal version of Emacs for a package. -- 2.39.2