Re: [RFC 05/11] Documentation/hwmon: Revise PMBus core documentation

[Guenter Roeck]

On 5/4/23 21:27, Bagas Sanjaya wrote:
> On Thu, May 04, 2023 at 12:57:46AM -0700, James Seo wrote:
> > -[from pmbus.org] The Power Management Bus (PMBus) is an open standard
> > -power-management protocol with a fully defined command language that facilitates
> > -communication with power converters and other devices in a power system. The
> > -protocol is implemented over the industry-standard SMBus serial interface and
> > -enables programming, control, and real-time monitoring of compliant power
> > -conversion products. This flexible and highly versatile standard allows for
> > -communication between devices based on both analog and digital technologies, and
> > -provides true interoperability which will reduce design complexity and shorten
> > -time to market for power system designers. Pioneered by leading power supply and
> > -semiconductor companies, this open power system standard is maintained and
> > -promoted by the PMBus Implementers Forum (PMBus-IF), comprising 30+ adopters
> > -with the objective to provide support to, and facilitate adoption among, users.
> > +  The Power Management Bus (PMBus) is an open standard power-management protocol
> > +  with a fully defined command language that facilitates communication with
> > +  power converters and other devices in a power system. The protocol is
> > +  implemented over the industry-standard SMBus serial interface and enables
> > +  programming, control, and real-time monitoring of compliant power conversion
> > +  products. This flexible and highly versatile standard allows for communication
> > +  between devices based on both analog and digital technologies, and provides
> > +  true interoperability which will reduce design complexity and shorten time to
> > +  market for power system designers. Pioneered by leading power supply and
> > +  semiconductor companies, this open power system standard is maintained and
> > +  promoted by the PMBus Implementers Forum (PMBus-IF), comprising 30+ adopters
> > +  with the objective to provide support to, and facilitate adoption among,
> > +  users.
> > +
> > +    (from pmbus.org)
>
> Seems like a candidate for attribution:

Yes, and I do not feel comfortable removing it.

Guenter

> ---- >8 ----
> diff --git a/Documentation/hwmon/pmbus-core.rst b/Documentation/hwmon/pmbus-core.rst
> index 2f88a03446d2be..75404f088fd777 100644
> --- a/Documentation/hwmon/pmbus-core.rst
> +++ b/Documentation/hwmon/pmbus-core.rst
> @@ -21,7 +21,7 @@ Introduction
>     with the objective to provide support to, and facilitate adoption among,
>     users.
>   
> -    (from pmbus.org)
> +  -- (from pmbus.org)
>   
>   Unfortunately, while PMBus commands are standardized, there are no mandatory
>   commands, and manufacturers can add as many non-standard commands as they like.
>
> Otherwise the formatting LGTM, thanks!
>
> Reviewed-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx>