id       = "nano"
name     = "GNU nano"
homepage = "https://www.nano-editor.org"
description = "nano is a small and friendly text editor."
executables   = ["nano"]

[dotfiles]

# nano(1), FILES: "nano reads two configuration files: first the system's
# nanorc (if it exists), and then the user's nanorc (if it exists), either
# ~/.nanorc or $XDG_CONFIG_HOME/nano/nanorc or ~/.config/nano/nanorc,
# whichever is encountered first." The last two are the variable and its
# default — one file, which is [configHome]/nano/nanorc. Both user locations
# are listed; nano reads whichever it finds, so a consumer that only knew one
# would miss the file on a machine using the other. The system nanorc is not
# user-level.
paths = [
  "~/.nanorc",
  "[configHome]/nano/nanorc",
]

exclude = []

# A nanorc is `set`/`unset` options, `bind` keys and `include` lines for syntax
# files. Nothing in it is a credential.
secret = []

# Read once at startup; nano never rewrites it.
side_effect = false

# Both spellings on both rules, or they do not run for a user whose file is the
# other one. The colours, key bindings and editing options around these two
# lines are exactly what the user wants to follow them, so only these are held
# back — and they are held back for different reasons, hence two rules.
#
# `include` names the syntax-definition files under the prefix nano was
# installed with — /usr/share/nano on a distro, /opt/homebrew/share/nano on a
# Homebrew machine. That follows from the kind of machine, not from this one,
# so it holds for every box of the same OS and architecture.
[[dotfiles.machine_lines]]
file  = ["~/.nanorc", "[configHome]/nano/nanorc"]
match = { prefix = ["include"] }
scope = "platform"

# `set backupdir` names a directory on this disk that the user chose: worth
# keeping so they can rebuild this machine, worth nothing on any other.
[[dotfiles.machine_lines]]
file  = ["~/.nanorc", "[configHome]/nano/nanorc"]
match = { prefix = ["set backupdir"] }
scope = "backup"