Variable: battery-upower-device

battery-upower-device is a customizable variable defined in battery.el.gz.

Value

nil

Documentation

Preferred UPower device name(s).

When battery-status-function is set to battery-upower, this user option specifies which power sources to query for status information and merge into a single report.

When nil (the default), battery-upower queries all present battery and line power devices as determined by the UPower EnumerateDevices method. A string or a nonempty list of strings names particular devices to query instead. UPower battery and line power device names typically follow the patterns
"battery_BATN" and "line_power_ACN", respectively, with N
starting at 0 when present. Device names should not include the leading D-Bus path "/org/freedesktop/UPower/devices/".

This variable was added, or its default value changed, in Emacs 28.1.

Probably introduced at or before Emacs version 28.1.

Source Code

;; Defined in /usr/src/emacs/lisp/battery.el.gz
(defcustom battery-upower-device nil
  "Preferred UPower device name(s).
When `battery-status-function' is set to `battery-upower', this
user option specifies which power sources to query for status
information and merge into a single report.

When nil (the default), `battery-upower' queries all present
battery and line power devices as determined by the UPower
EnumerateDevices method.  A string or a nonempty list of strings
names particular devices to query instead.  UPower battery and
line power device names typically follow the patterns
\"battery_BATN\" and \"line_power_ACN\", respectively, with N
starting at 0 when present.  Device names should not include the
leading D-Bus path \"/org/freedesktop/UPower/devices/\"."
  :version "28.1"
  :type '(choice (const :tag "Autodetect all devices" nil)
                 (string :tag "Device")
                 (repeat :tag "Devices" string)))