Re: [PATCH v1 2/2] acpi/dock: document sysfs interface

From: Rafael J. Wysocki
Date: Fri Feb 09 2018 - 05:26:15 EST


On Wed, Feb 7, 2018 at 2:18 PM, Aishwarya Pant <aishpant@xxxxxxxxx> wrote:
> Description has been collected from git commit history and reading
> through code.
>
> Signed-off-by: Aishwarya Pant <aishpant@xxxxxxxxx>
> ---
> .../ABI/testing/sysfs-devices-platform-dock | 38 ++++++++++++++++++++++
> 1 file changed, 38 insertions(+)
> create mode 100644 Documentation/ABI/testing/sysfs-devices-platform-dock
>
> diff --git a/Documentation/ABI/testing/sysfs-devices-platform-dock b/Documentation/ABI/testing/sysfs-devices-platform-dock
> new file mode 100644
> index 000000000000..0bb0d42e9126
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-devices-platform-dock
> @@ -0,0 +1,38 @@
> +sysfs interface for ACPI dock station driver
> +--------------------------------------------
> +
> +What: /sys/devices/platform/dock.N/docked
> +What: /sys/devices/platform/dock.N/undock
> +Date: Dec, 2006
> +KernelVersion: 2.6.19
> +Contact: linux-acpi@xxxxxxxxxxxxxxx
> +Description:
> + docked: (RO) Value 1 or 0 indicates whether the software
> + believes the laptop is docked in a docking station.
> +
> + undock: (WO) Writing to this file causes the software to
> + initiate an undock request to the firmware.

Please split the above into two entries.

Apart from that it looks OK to me.