From 6750c114e3e988249f4069d0180316c6d0192350 Mon Sep 17 00:00:00 2001 From: Liliana Marie Prikler Date: Sat, 2 Sep 2023 00:09:37 +0200 Subject: 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. --- gnu/packages/aux-files/emacs/guix-emacs.el | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) (limited to 'gnu/packages/aux-files') diff --git a/gnu/packages/aux-files/emacs/guix-emacs.el b/gnu/packages/aux-files/emacs/guix-emacs.el index c253e64df8..265c8bde16 100644 --- a/gnu/packages/aux-files/emacs/guix-emacs.el +++ b/gnu/packages/aux-files/emacs/guix-emacs.el @@ -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 -- cgit v1.2.3