[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <CAJZ5v0h5HZQqSV7EEbYBNPTqudkocDjr-KpBD1yDAGUF0qZ+gA@mail.gmail.com>
Date: Wed, 29 Jun 2022 19:49:06 +0200
From: "Rafael J. Wysocki" <rafael@...nel.org>
To: Andy Shevchenko <andy.shevchenko@...il.com>
Cc: Sudeep Holla <sudeep.holla@....com>,
ACPI Devel Maling List <linux-acpi@...r.kernel.org>,
Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
"Rafael J . Wysocki" <rafael@...nel.org>,
Andy Shevchenko <andriy.shevchenko@...ux.intel.com>,
Samer El-Haj-Mahmoud <Samer.El-Haj-Mahmoud@....com>
Subject: Re: [PATCH] Documentation: ACPI: Update links and references to DSD
related docs
On Wed, Jun 22, 2022 at 1:31 PM Andy Shevchenko
<andy.shevchenko@...il.com> wrote:
>
> On Tue, Jun 21, 2022 at 5:12 PM Sudeep Holla <sudeep.holla@....com> wrote:
> >
> > The existing references to DSD are stale and outdated. The new process
> > and guidance is maintained @https://github.com/UEFI/DSD-Guide
> >
> > Update the existing documents to reflect the same.
>
> Taking Rafael's comment into account,
> Reviewed-by: Andy Shevchenko <andy.shevchenko@...il.com>
> Thanks!
>
> > Signed-off-by: Sudeep Holla <sudeep.holla@....com>
> > ---
> > .../firmware-guide/acpi/DSD-properties-rules.rst | 11 +++++++----
> > 1 file changed, 7 insertions(+), 4 deletions(-)
> >
> > diff --git a/Documentation/firmware-guide/acpi/DSD-properties-rules.rst b/Documentation/firmware-guide/acpi/DSD-properties-rules.rst
> > index 8b2d8d0864c2..70442bc2521e 100644
> > --- a/Documentation/firmware-guide/acpi/DSD-properties-rules.rst
> > +++ b/Documentation/firmware-guide/acpi/DSD-properties-rules.rst
> > @@ -21,7 +21,9 @@ specific type) associated with it.
> >
> > In the ACPI _DSD context it is an element of the sub-package following the
> > generic Device Properties UUID in the _DSD return package as specified in the
> > -Device Properties UUID definition document [1]_.
> > +section titled "Well-Known _DSD UUIDs and Data Structure Formats" sub-section
> > +"Device Properties UUID" in _DSD (Device Specific Data) Implementation Guide
> > +document [1]_.
> >
> > It also may be regarded as the definition of a key and the associated data type
> > that can be returned by _DSD in the Device Properties UUID sub-package for a
> > @@ -36,7 +38,9 @@ Property subsets are nested collections of properties. Each of them is
> > associated with an additional key (name) allowing the subset to be referred
> > to as a whole (and to be treated as a separate entity). The canonical
> > representation of property subsets is via the mechanism specified in the
> > -Hierarchical Properties Extension UUID definition document [2]_.
> > +section titled "Well-Known _DSD UUIDs and Data Structure Formats" sub-section
> > +"Hierarchical Data Extension UUID" in _DSD (Device Specific Data)
> > +Implementation Guide document [1]_.
> >
> > Property sets may be hierarchical. That is, a property set may contain
> > multiple property subsets that each may contain property subsets of its
> > @@ -96,5 +100,4 @@ contents.
> > References
> > ==========
> >
> > -.. [1] https://www.uefi.org/sites/default/files/resources/_DSD-device-properties-UUID.pdf
> > -.. [2] https://www.uefi.org/sites/default/files/resources/_DSD-hierarchical-data-extension-UUID-v1.1.pdf
> > +.. [1] https://github.com/UEFI/DSD-Guide
> > --
Applied as 5.20 material, thanks!
Powered by blists - more mailing lists