emacs-28 30f1bdb41f: Clarify docstring of package-native-compile

[Stefan Kangas]

branch: emacs-28
commit 30f1bdb41faa705fed497126322547c2d8111f36
Author: Stefan Kangas <stefan@marxist.se>
Commit: Stefan Kangas <stefan@marxist.se>

    Clarify docstring of package-native-compile
    
    * lisp/emacs-lisp/package.el (package-native-compile): Clarify
    docstring.
---
 lisp/emacs-lisp/package.el | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index 8fc54945d6..1387439f0a 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -397,7 +397,13 @@ a sane initial value."
   :type '(repeat symbol))
 
 (defcustom package-native-compile nil
-  "Non-nil means to native compile packages on installation."
+  "Non-nil means to native compile packages after installing them.
+This controls ahead-of-time compilation.  If this option is nil,
+packages are normally compiled after they have been loaded for
+the first time.
+
+This option does not have any effect if Emacs was not built with
+native compilation support."
   :type '(boolean)
   :risky t
   :version "28.1")