id       = "atom"
name     = "Atom"
homepage = "https://github.com/atom/atom"
description = "A hackable text editor for the 21st Century, built on Electron."
icon     = "theSVG:atom"
executables   = ["atom", "apm"]

[dotfiles]

# Atom was archived by GitHub on 15 December 2022 and ships no new releases.
# The paths are still facts for everyone who kept it installed, and for the
# forks (Pulsar) that inherited the same layout.
#
# https://flight-manual.atom.io/using-atom/sections/basic-customization/ names
# each file in "your ~/.atom directory" (the same page spells the Windows
# location %USERPROFILE%\.atom, which resolves to the same place):
# config.cson ("Atom loads configuration settings from the config.cson file"),
# keymap.cson ("By default, keymap.cson is loaded when Atom is started"),
# styles.less ("you can add styles to the styles.less file"), plus
# snippets.cson (/using-atom/sections/snippets) and init.coffee
# (/hacking-atom/sections/the-init-file). Confirmed against a ~/.atom
# directory on this machine, which holds exactly those five files beside
# packages/, storage/, blob-store/, compile-cache/ and .apm/.
paths = [
  "~/.atom/config.cson",
  "~/.atom/keymap.cson",
  "~/.atom/snippets.cson",
  "~/.atom/styles.less",
  "~/.atom/init.coffee",
]

# Nothing to carve out: the rest of ~/.atom is the apm package checkout
# (packages/, .apm/) and generated state (blob-store/, compile-cache/,
# storage/, recovery/), none of which is named above.
exclude = []

# The five files above are settings, key bindings, snippets, styles and a
# startup script. Atom keeps its GitHub token in the OS keychain, not here.
secret = []

# core.projectHome is "The directory where projects are assumed to be located"
# (Configuration Key Reference, same page) — an absolute path into this
# machine's disk, and one the user picked: where their own checkouts live is
# worth keeping for a rebuild, so backup rather than discarded. config.cson is
# CSON, which no structured matcher here reads, but the key is written on its
# own line, so the line-oriented match applies.
[[dotfiles.machine_lines]]
file  = "~/.atom/config.cson"
match = { prefix = ["projectHome"] }
scope = "backup"