[PATCH] doc: ABI: sysfs-class-backlight: update outdated HAL userspace reference

[PATCH] doc: ABI: sysfs-class-backlight: update outdated HAL userspace reference

[Shivank Sharma]

HAL was deprecated around 2009 and is
no longer used on modern Linux distributions. Update the 'Users:' field
in the sysfs-class-backlight ABI documentation to reflect modern
systemd-logind, udev, general userspace.

Signed-off-by: Shivank Sharma <shivanksharma2376543@gmail.com>
---
 Documentation/ABI/stable/sysfs-class-backlight | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/ABI/stable/sysfs-class-backlight b/Documentation/ABI/stable/sysfs-class-backlight
index 40b8c46b9..2f60dd3f4 100644
--- a/Documentation/ABI/stable/sysfs-class-backlight
+++ b/Documentation/ABI/stable/sysfs-class-backlight
@@ -8,7 +8,7 @@ Description:
 
 		 - 0 (FB_BLANK_UNBLANK)   : power on.
 		 - 4 (FB_BLANK_POWERDOWN) : power off
-Users:		HAL
+Users:		systemd-logind, udev, general userspace.
 
 What:		/sys/class/backlight/<backlight>/brightness
 Date:		April 2005
@@ -19,7 +19,7 @@ Description:
 		are between 0 and max_brightness. This file will also
 		show the brightness level stored in the driver, which
 		may not be the actual brightness (see actual_brightness).
-Users:		HAL
+Users:		systemd-logind, udev, general userspace.
 
 What:		/sys/class/backlight/<backlight>/actual_brightness
 Date:		March 2006
@@ -40,7 +40,7 @@ KernelVersion:	2.6.12
 Contact:	Richard Purdie <rpurdie@rpsys.net>
 Description:
 		Maximum brightness for <backlight>.
-Users:		HAL
+Users:		systemd-logind, udev, general userspace.
 
 What:		/sys/class/backlight/<backlight>/type
 Date:		September 2010
-- 
2.55.0

[PATCH v2] doc: ABI: sysfs-class-backlight: update outdated HAL userspace references

[Shivank Sharma]

Replace all deprecated HAL userspace references in sysfs-class-backlight
ABI documentation with modern references (systemd-logind, udev, general
userspace).

Signed-off-by: Shivank Sharma <shivanksharma2376543@gmail.com>
---
v1 -> v2:
 - Update 'Users: HAL' entry under actual_brightness which was missed in v1.

 Documentation/ABI/stable/sysfs-class-backlight | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/ABI/stable/sysfs-class-backlight b/Documentation/ABI/stable/sysfs-class-backlight
index 40b8c46b9..e77bd574a 100644
--- a/Documentation/ABI/stable/sysfs-class-backlight
+++ b/Documentation/ABI/stable/sysfs-class-backlight
@@ -8,7 +8,7 @@ Description:
 
         - 0 (FB_BLANK_UNBLANK)   : power on.
         - 4 (FB_BLANK_POWERDOWN) : power off
-Users:     HAL
+Users:     systemd-logind, udev, general userspace.
 
 What:      /sys/class/backlight/<backlight>/brightness
 Date:      April 2005
@@ -19,7 +19,7 @@ Description:
        are between 0 and max_brightness. This file will also
        show the brightness level stored in the driver, which
        may not be the actual brightness (see actual_brightness).
-Users:     HAL
+Users:     systemd-logind, udev, general userspace.
 
 What:      /sys/class/backlight/<backlight>/actual_brightness
 Date:      March 2006
@@ -32,7 +32,7 @@ Description:
        may treat blanking differently or have custom power saving
        features. Userspace should generally use the values in
        'brightness' to make decisions.
-Users:     HAL
+Users:     systemd-logind, udev, general userspace.
 
 What:      /sys/class/backlight/<backlight>/max_brightness
 Date:      April 2005
@@ -40,7 +40,7 @@ KernelVersion:    2.6.12
 Contact:   Richard Purdie <rpurdie@rpsys.net>
 Description:
        Maximum brightness for <backlight>.
-Users:     HAL
+Users:     systemd-logind, udev, general userspace.
 
 What:      /sys/class/backlight/<backlight>/type
 Date:      September 2010
-- 
2.55.0

Re: [PATCH v2] doc: ABI: sysfs-class-backlight: update outdated HAL userspace references

[Daniel Thompson]

On Tue, Jul 21, 2026 at 08:49:38PM +0530, Shivank Sharma wrote:
> Replace all deprecated HAL userspace references in sysfs-class-backlight
> ABI documentation with modern references (systemd-logind, udev, general
> userspace).

Do these really add anything? Use by "General userspace" sounds so vague
it might be better just to delete the Users: field.


Daniel.