id       = "prezto"
name     = "Prezto"
homepage = "https://github.com/sorin-ionescu/prezto"
# The project's own repository description.
description = "The configuration framework for Zsh"
# Prezto has no binary of its own: it is sourced by zsh at startup. `pmodload`
# is the command the framework defines — `function pmodload {` in its own
# init.zsh — and the word a user types to load a module by hand, so it is the
# detect name, the way the oh-my-zsh entry uses `omz`.
executables   = ["pmodload"]
platforms = ["macos", "linux"]

[dotfiles]

# The project's own README installs the framework by cloning it to
# `${ZDOTDIR:-$HOME}/.zprezto` and then symlinking the files in its `runcoms`
# directory into the home directory, so ~/.zshrc, ~/.zshenv, ~/.zprofile,
# ~/.zlogin and ~/.zlogout become links into the checkout — those five belong
# to the `zsh` entry in this catalog, which already lists them.
#
# What is left, and what this entry is for, is ~/.zpreztorc: the README's
# instructions for both enabling modules ("in ${ZDOTDIR:-$HOME}/.zpreztorc")
# and choosing a theme point at that file, and it is the only runcom a user
# actually edits.
paths = ["~/.zpreztorc"]

exclude = []

# A list of `zstyle ':prezto:…'` lines: which modules to load, which prompt
# theme, editor key bindings, syntax-highlighting colours. No credential.
secret = []

# Read once by zsh at startup and never held open, so rewriting it mid-session
# is harmless — the next shell picks it up.
side_effect = false

# ~/.zprezto (and the ~/.zprezto-contrib the README shows as an extra
# `pmodule-dirs` entry) are git checkouts of the framework and of third-party
# modules, not settings, so they are deliberately not in `paths`.
#
# No machine_lines: the module list, the theme and the key bindings are the
# whole point of carrying this file. `pmodule-dirs` can name an absolute path,
# but the README's own example writes it as `$HOME/.zprezto-contrib`, which
# resolves per machine on its own.