id       = "spacemacs"
name     = "Spacemacs"
homepage = "https://www.spacemacs.org/"
# The project's own repository description.
description = "A community-driven Emacs distribution - The best editor is neither Emacs nor Vim, it's Emacs and Vim!"
icon     = "SimpleIcons:spacemacs"
# Spacemacs defines no command of its own — it is run as `emacs` — and it is
# not an application bundle, so there is no binary a user types for it and no
# bundle identifier. The entry is filed and detected under the project's name,
# the way the other editor distributions in this catalog are (see `janus`).
# Deliberately not `emacs`: that maps to Emacs's own entry, whose ~/.emacs.d is
# the tree Spacemacs installs itself into.
executables   = ["spacemacs"]

[dotfiles]

# The documentation (https://www.spacemacs.org/doc/DOCUMENTATION.html,
# "Dotfile (Configuration)") names both shapes and their order: the dotfile is
# "~/.spacemacs" or, as a directory, "~/.spacemacs.d/init.el", and "~/.spacemacs
# will always take priority over ~/.spacemacs.d/init.el, so ~/.spacemacs must
# not exist for ~/.spacemacs.d/init.el to be used by Spacemacs".
# $SPACEMACSDIR overrides the directory form. Both are joined to the home
# directory, so both stay literal, and both are listed because a machine has
# one or the other.
#
# The directory form is listed whole: alongside init.el it is where a user
# keeps their private layers, snippets and any extra elisp the dotfile loads.
paths = [
  "~/.spacemacs",
  "~/.spacemacs.d/",
]

# Spacemacs's own install — the ~/.emacs.d (or ~/.config/emacs) checkout of the
# distribution, with its package and native-compilation caches — is not below
# either path above, so there is nothing to carve out of them. The `emacs`
# entry covers what lives in that other tree.

# Emacs Lisp the user wrote. Tokens belong in the auth-source files the `emacs`
# entry marks, not here.
secret = []

# No machine_lines: the machine-local part of an Emacs Lisp config — a font
# name, a Homebrew prefix, a (setq …) holding an absolute path — sits inside an
# expression, which prefix matching cannot pick out of the line around it. Same
# reasoning as the `emacs` and `doom-emacs` entries.