unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Autoloads and subdirectories
@ 2016-05-28  4:25 Clément Pit--Claudel
  2016-05-28  5:00 ` Robert Weiner
  0 siblings, 1 reply; 9+ messages in thread
From: Clément Pit--Claudel @ 2016-05-28  4:25 UTC (permalink / raw)
  To: Emacs developers


[-- Attachment #1.1: Type: text/plain, Size: 1240 bytes --]

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.


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2016-05-29 15:39 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-05-28  4:25 Autoloads and subdirectories Clément Pit--Claudel
2016-05-28  5:00 ` Robert Weiner
2016-05-28  5:13   ` Clément Pit--Claudel
2016-05-28 18:18     ` Stefan Monnier
2016-05-28 18:47       ` Clément Pit--Claudel
2016-05-28 19:07         ` Stefan Monnier
2016-05-28 19:21           ` Clément Pit--Claudel
2016-05-29 15:01             ` Stefan Monnier
2016-05-29 15:39               ` Clément Pit--Claudel

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).