[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

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

[sashiko-bot]

Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Low] The patch incompletely updates the 'Users: HAL' references, missing the occurrence under 'actual_brightness'.
--

--- Patch [1]: [PATCH] doc: ABI: sysfs-class-backlight: update outdated HAL userspace reference ---
commit 394037cb75e2eb0f44c91b48f3a8658b6c642c06
Author: Shivank Sharma <shivanksharma2376543@gmail.com>

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

This commit replaces the deprecated HAL userspace references in the
sysfs-class-backlight ABI documentation with modern userspace references.

> diff --git a/Documentation/ABI/stable/sysfs-class-backlight b/Documentation/ABI/stable/sysfs-class-backlight
> index 40b8c46b95b28..2f60dd3f40a5c 100644
> --- a/Documentation/ABI/stable/sysfs-class-backlight
> +++ b/Documentation/ABI/stable/sysfs-class-backlight
[ ... ]
> @@ -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

[Severity: Low]
Did this patch miss updating the Users field for actual_brightness?

In Documentation/ABI/stable/sysfs-class-backlight, actual_brightness also
has HAL listed as the user, but it appears to have been left out of this
update:

What:           /sys/class/backlight/<backlight>/actual_brightness
Date:           March 2006
KernelVersion:  2.6.17
Contact:        Richard Purdie <rpurdie@rpsys.net>
Description:
                Show the actual brightness by querying the hardware. Due
...
Users:          HAL

> @@ -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.

-- 
Sashiko AI review · https://sashiko.dev/#/patchset/20260721132253.256422-1-shivanksharma2376543@gmail.com?part=1

[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