Subject: 29.0.50; Missing description for excluded files in docstring of loaddefs-generate
From: Arash Esbati <[email-masked]>
To: emacs-bugs <[email-masked]>
Date: Thu, 11 Aug 2022 21:31:32 +0200
List-Id: <debbugs-submit.debbugs.gnu.org>

Hi all,

This is the docstring of `loaddefs-generate':

,----[ C-h f loaddefs-generate RET ]
| loaddefs-generate is an autoloaded Lisp function in ‘loaddefs-gen.el’.
| 
| (loaddefs-generate DIR OUTPUT-FILE &optional EXCLUDED-FILES EXTRA-DATA
| INCLUDE-PACKAGE-VERSION GENERATE-FULL)
| 
| Generate loaddefs files for Lisp files in the directories DIRS.
| DIR can be either a single directory or a list of directories.
| 
| The autoloads will be written to OUTPUT-FILE.  If any Lisp file
| binds ‘generated-autoload-file’ as a file-local variable, write
| its autoloads into the specified file instead.
| 
| The function does NOT recursively descend into subdirectories of the
| directory or directories specified.
| 
| If EXTRA-DATA, include this string at the start of the generated
| file.  This will also force generation of OUTPUT-FILE even if
| there are no autoloads to put into the file.
| 
| If INCLUDE-PACKAGE-VERSION, include package version data.
| 
| If GENERATE-FULL, don’t update, but regenerate all the loaddefs files.
`----

A description for EXCLUDED-FILES is missing.  It will a list containing
file names, but details should be added.

Best, Arash