Re: [PATCH v10 3/7] Documentation: ACPI: Document _DSE object usage for enum power state

From: Randy Dunlap
Date: Mon Feb 08 2021 - 13:27:57 EST


On 2/8/21 12:01 AM, Sakari Ailus wrote:
> Hi Randy,
>
> On Fri, Feb 05, 2021 at 04:56:47PM -0800, Randy Dunlap wrote:
>> On 2/5/21 5:25 AM, Sakari Ailus wrote:
>>> Document the use of the _DSE object for setting desirable power state
>>> during probe.
>>>
>>> Signed-off-by: Sakari Ailus <sakari.ailus@xxxxxxxxxxxxxxx>
>>> Reviewed-by: Tomasz Figa <tfiga@xxxxxxxxxxxx>
>>> ---
>>> Documentation/firmware-guide/acpi/index.rst | 1 +
>>> .../firmware-guide/acpi/low-power-probe.rst | 69 +++++++++++++++++++
>>> 2 files changed, 70 insertions(+)
>>> create mode 100644 Documentation/firmware-guide/acpi/low-power-probe.rst
>>>
>>
>>> diff --git a/Documentation/firmware-guide/acpi/low-power-probe.rst b/Documentation/firmware-guide/acpi/low-power-probe.rst
>>> new file mode 100644
>>> index 0000000000000..b96804d959a6c
>>> --- /dev/null
>>> +++ b/Documentation/firmware-guide/acpi/low-power-probe.rst
>>> @@ -0,0 +1,69 @@
>>> +.. SPDX-License-Identifier: GPL-2.0
>>> +
>>> +======================================
>>> +Probing I²C devices in low power state
>>> +======================================
>>> +
>>> +Introduction
>>> +============
>>> +
>>> +In some cases it may be preferred to leave certain devices powered off for the
>>> +entire system bootup if powering on these devices has adverse side effects,
>>> +beyond just powering on the said device.
>>> +
>>> +How it works
>>> +============
>>>
>>
>> Hi,
>>
>> Please don't use ============ underlines for all section levels.
>
> The sections under the title are intended to be on the same level.
>

Oops. My bad. Sorry about that.

--
~Randy