id       = "skim"
name     = "Skim"
homepage = "https://skim-app.sourceforge.io/"
# The project's own first sentence, from its homepage.
description = "Skim is a PDF reader and note-taker for OS X, designed to help you read and annotate scientific papers in PDF."
# The app icon its own home page publishes.
icon     = "https://skim-app.sourceforge.io/images/icon64@2x.png"
# Skim does ship command-line tools, and the Homebrew cask exposes all three
# under the names a user types: `binary "#{appdir}/Skim.app/Contents/
# SharedSupport/displayline"`, the same for skimnotes and skimpdf
# (Casks/s/skim.rb). displayline is the SyncTeX helper an editor invokes,
# skimnotes reads and writes Skim's notes, skimpdf converts them. The bundle
# identifier behind them is net.sourceforge.skim-app.skim, which the same cask
# uses throughout its zap stanza.
executables   = ["skimpdf", "skimnotes", "displayline"]
platforms = ["macos"]

[dotfiles]

# Skim is a direct download rather than an App Store app, so it is not
# sandboxed and its settings are an ordinary preferences domain. The Homebrew
# cask's `zap trash:` names two preference files, and only one of them is
# settings: ~/Library/Preferences/net.sourceforge.skim-app.skim.plist holds the
# reading, display and note-taking options, the note colours and the SyncTeX
# preset. [preferences] is ~/Library/Preferences, and the entry is macOS-only,
# so there is no other platform for that root to stand for.
paths = ["[preferences]/net.sourceforge.skim-app.skim.plist"]

# The second preference file in that zap list is the bookmarks database —
# ~/Library/Preferences/net.sourceforge.skim-app.skim.bookmarks.plist — which
# is Skim's list of the user's own PDFs by absolute path, plus the page each
# one was left on. It is a pointer into one machine's filesystem rather than a
# setting, so it is named here even though it is not below the path above.
exclude = ["[preferences]/net.sourceforge.skim-app.skim.bookmarks.plist"]

# No credential: Skim is free software, and everything else in the cask's zap
# list is cache or window state (~/Library/Caches/net.sourceforge.skim-app.skim,
# ~/Library/HTTPStorages/net.sourceforge.skim-app.skim, the saved application
# state and the shared file list).
secret = []

# No machine_lines: the note colours, the default zoom and the SyncTeX editor
# preset are exactly what a user wants on the next Mac. A macOS property list
# has no matcher in this schema in any case — `format` covers toml, yaml and
# json only — so a plist entry is paths and nothing else.