id       = "top"
name     = "top"
homepage = "https://gitlab.com/procps-ng/procps"
description = "The top program provides a dynamic real-time view of a running system."
executables   = ["top"]
platforms = ["linux"]

[dotfiles]

# procps-ng top(1), "6a. PERSONAL Configuration File": the file "is created or
# updated via the 'W' interactive command". "The legacy version is written as
# '$HOME/.your-name-4-top' + 'rc' with a leading period. A newly created
# configuration file is written as 'procps/your-name-4-top' + 'rc' without a
# leading period. The procps directory will be subordinate to either
# $XDG_CONFIG_HOME when set as an absolute path or the $HOME/.config
# directory." The name-4-top is the program name, so both spellings are
# `toprc` for a top invoked as `top`. That base directory is `[configHome]`,
# which is what makes the $XDG_CONFIG_HOME half of the sentence hold.
#
# platforms is linux only: this is procps-ng's top. The macOS and BSD top is a
# different program with no configuration file at all — it takes only command
# line options — so a consumer must not go looking for a toprc there.
paths = ["~/.toprc", "[configHome]/procps/toprc"]

exclude = []

# Field layout, sort column, colours and window settings. top reads /proc and
# authenticates to nothing.
secret = []

# No machine_lines. The rcfile is a positional format that top rewrites whole
# on 'W', and its optional "inspect" entries at the end can name a local file
# or pipeline — but they are hand-added tools a user would want everywhere,
# and the rest of the file is a field layout, so nothing here is pinned to one
# machine.