gnu: guix-emacs: Reword docstrings.

The current documentation strings cause compilation warnings; thus improve
them.

* gnu/packages/aux-files/emacs/guix-emacs.el (guix-emacs-autoload-regexp)
(guix-emacs-find-autoloads, guix-emacs-autoload-packages): Make do without
quoting 'autoload'.  Reserve quotation to variables and functions.
This commit is contained in:
Liliana Marie Prikler 2023-09-02 00:09:37 +02:00
parent b02ad19305
commit 6750c114e3
No known key found for this signature in database
GPG key ID: 442A84B8C70E2F87

View file

@ -32,10 +32,14 @@
(defvar guix-emacs-autoloads-regexp
(rx (* any) "-autoloads.el" (zero-or-one "c") string-end)
"Regexp to match Emacs 'autoloads' file.")
"Regexp to match files containing autoload definitions.
Historically, this used to be the package name followed by \"-autoloads.el\".
As of Emacs 29, the term \"loaddefs\" is preferred over \"autoloads\",
but they function much in the same manner.")
(defun guix-emacs-find-autoloads (directory)
"Return a list of Emacs 'autoloads' files in DIRECTORY.
"Return a list of files containing autoload definitions in DIRECTORY.
The files in the list do not have extensions (.el, .elc)."
;; `directory-files' doesn't honor group in regexp.
(delete-dups (mapcar #'file-name-sans-extension
@ -66,12 +70,12 @@ The files in the list do not have extensions (.el, .elc)."
;;;###autoload
(defun guix-emacs-autoload-packages (&optional no-reload)
"Autoload Emacs packages found in EMACSLOADPATH.
"Load autoload definitions for packages in `load-path'.
'Autoload' means to load the 'autoloads' files matching
`guix-emacs-autoloads-regexp'. By default, the subdirs.el files
found on the load path are reloaded to discover newly installed
packages, unless NO-RELOAD is provided."
Autoload definitions are contained within files matching
`guix-emacs-autoload-regexp'; load each file matching that regexp.
When NO-RELOAD is nil (the default), also evaluate any subdirs.el files
found in `load-path' to discover newly installed packages."
(interactive "P")
;; Reload the subdirs.el files such as the one generated by the Guix profile
;; hook, so that newly installed Emacs packages located under