2017-02-20 13:19:12 +08:00
|
|
|
# Modules
|
|
|
|
|
|
2017-02-21 01:02:57 +08:00
|
|
|
Modules are made up of three (optional) parts:
|
2017-02-20 13:19:12 +08:00
|
|
|
|
2017-02-21 01:02:57 +08:00
|
|
|
+ A `config.el` file, automatically loaded when the module is loaded
|
|
|
|
|
(through `@doom` or `@require`). It uses `@def-package` calls (thin
|
|
|
|
|
wrappers around `use-package`) to configure packages.
|
|
|
|
|
+ A `packages.el` file filled with `@package` and `@depends-on`
|
|
|
|
|
declarations. These are purely declarative macros. They populate
|
|
|
|
|
`doom-packages` and `doom-modules` for the package management
|
|
|
|
|
system.
|
|
|
|
|
+ Either an `autoload.el` file or `autoload/*.el` files, which are
|
|
|
|
|
scanned by `doom/reload-autoloads` and lazily loaded.
|
2017-02-20 13:19:12 +08:00
|
|
|
|
2017-02-21 01:02:57 +08:00
|
|
|
The convention for extra config files is to prefix them with a plus
|
|
|
|
|
(`+git.el`). These are not automatically loaded.
|
2017-02-20 13:19:12 +08:00
|
|
|
|
2017-02-21 01:02:57 +08:00
|
|
|
## What modules aren't
|
|
|
|
|
|
|
|
|
|
Modules loosely take after Spacemacs' notion of layers, but are not
|
|
|
|
|
meant to be interchangeable. Their purpose is _almost_ purely
|
|
|
|
|
organizational.
|
|
|
|
|
|
|
|
|
|
The only exception to this are completion modules. Other modules make
|
|
|
|
|
no assumptions about which completion modules are enabled. If company
|
|
|
|
|
isn't installed, company plugins will silently refuse to install, and
|
|
|
|
|
their respective `@def-package` blocks will be ignored.
|
