Autoloads and subdirectories

[Clément Pit--Claudel]

Hi emacs-devel,

What is the proper way to organize the sources of a multi-file package into 
subdirectories, without breaking autoloads? As far as I can see 
`update-directory-autoloads` doesn't explore subdirectories recursively (in 
fact, it is documented not to), and package.el doesn't call it on 
subdirectories of a package's content directory. And yet, the manual says 
(emphasis mine):

> Do not include any file named name-autoloads.el. This file is 
> reserved for the package’s autoload definitions (see Packaging 
> Basics). It is created automatically when the package is installed, 
> by searching *all the Lisp files* in the package for autoload magic 
> comments.

This claims that all files in the package are searched (which sounds nice, but 
seems incorrect).  Presumably this is just imprecise wording, since Packaging 
Basics does say the following:

> Emacs then searches every Lisp file in the content directory for
> autoload magic comments (see Autoload). These autoload definitions
> are saved to a file named name-autoloads.el in the content directory.

Which brings me back to square one: how do I move parts of a package to a 
subdirectory, without breaking their autoloads?

Thanks!
Clément.

signature.asc
Description: OpenPGP digital signature