linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Bagas Sanjaya <bagasdotme@gmail.com>
To: James Seo <james@equiv.tech>, Jean Delvare <jdelvare@suse.com>,
	Guenter Roeck <linux@roeck-us.net>,
	Jonathan Corbet <corbet@lwn.net>
Cc: linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org,
	linux-kernel@vger.kernel.org
Subject: Re: [RFC 05/11] Documentation/hwmon: Revise PMBus core documentation
Date: Fri, 5 May 2023 11:27:57 +0700	[thread overview]
Message-ID: <ZFSFzaWZsS9qxmzz@debian.me> (raw)
In-Reply-To: <20230504075752.1320967-6-james@equiv.tech>

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:

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

-- 
An old man doll... just what I always wanted! - Clara

  reply	other threads:[~2023-05-05  4:28 UTC|newest]

Thread overview: 35+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-05-04  7:57 [RFC 00/11] hwmon: Modernize documentation James Seo
2023-05-04  7:57 ` [RFC 01/11] Documentation/hwmon: Move misplaced entry in hwmon docs index James Seo
2023-05-05  4:58   ` Bagas Sanjaya
2023-05-06 13:43   ` Guenter Roeck
2023-05-04  7:57 ` [RFC 02/11] hwmon: (core) Rename last parameter of devm_hwmon_register_with_info() James Seo
2023-05-04 15:29   ` Guenter Roeck
2023-05-05 13:15     ` James Seo
2023-05-05 13:30       ` Guenter Roeck
2023-05-05 14:39         ` James Seo
2023-05-04  7:57 ` [RFC 03/11] hwmon: (core) Revise kerneldoc comments James Seo
2023-07-25 23:51   ` Russell Haley
2023-05-04  7:57 ` [RFC 04/11] Documentation/hwmon: Revise hwmon kernel API reference James Seo
2023-05-05  4:12   ` Bagas Sanjaya
2023-05-05  4:20   ` Bagas Sanjaya
2023-05-05 13:29     ` James Seo
2023-05-06 13:52   ` Guenter Roeck
2023-05-07 14:40     ` James Seo
2023-05-04  7:57 ` [RFC 05/11] Documentation/hwmon: Revise PMBus core documentation James Seo
2023-05-05  4:27   ` Bagas Sanjaya [this message]
2023-05-05  4:32     ` Guenter Roeck
2023-05-05 13:35     ` James Seo
2023-05-04  7:57 ` [RFC 06/11] Documentation/hwmon: Revise patch submission checklist James Seo
2023-05-05  4:34   ` Bagas Sanjaya
2023-05-05 14:50     ` James Seo
2023-05-04  7:57 ` [RFC 07/11] Documentation/hwmon: Revise sysfs interface specification James Seo
2023-05-05  4:51   ` Bagas Sanjaya
2023-05-05 15:01     ` James Seo
2023-05-05 15:10       ` Jonathan Corbet
2023-05-04  7:57 ` [RFC 08/11] Documentation/hwmon: Revise userspace tools documentation James Seo
2023-05-05  5:03   ` Bagas Sanjaya
2023-05-05 15:12     ` James Seo
2023-05-05 21:10       ` Guenter Roeck
2023-05-04  7:57 ` [RFC 09/11] ABI: sysfs-class-hwmon: Revise hwmon ABI documentation James Seo
2023-05-04  7:57 ` [RFC 10/11] hwmon: (core) Add missing beep-related standard attributes James Seo
2023-05-04  7:57 ` [RFC 11/11] ABI: sysfs-class-hwmon: Add missing hwmon " James Seo

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=ZFSFzaWZsS9qxmzz@debian.me \
    --to=bagasdotme@gmail.com \
    --cc=corbet@lwn.net \
    --cc=james@equiv.tech \
    --cc=jdelvare@suse.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-hwmon@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux@roeck-us.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).