diff mbox series

[2/2] iio: adxl345: update documentation for spi-3wire

Message ID 20240319212713.257600-3-l.rubusch@gmail.com (mailing list archive)
State Superseded
Headers show
Series iio: adxl345: add spi-3wire and refac | expand

Commit Message

Lothar Rubusch March 19, 2024, 9:27 p.m. UTC
Provide the optional spi-3wire option for the DT binding.

Signed-off-by: Lothar Rubusch <l.rubusch@gmail.com>
---
 Documentation/devicetree/bindings/iio/accel/adi,adxl345.yaml | 2 ++
 1 file changed, 2 insertions(+)

Comments

Krzysztof Kozlowski March 20, 2024, 9:34 a.m. UTC | #1
On 19/03/2024 22:27, Lothar Rubusch wrote:
> Provide the optional spi-3wire option for the DT binding.
> 
> Signed-off-by: Lothar Rubusch <l.rubusch@gmail.com>

A nit, subject: drop second/last, redundant "documentation". The
"dt-bindings" prefix is already stating that these are bindings.
See also:
https://elixir.bootlin.com/linux/v6.7-rc8/source/Documentation/devicetree/bindings/submitting-patches.rst#L18

Also, everything is an update. Be descriptive.

Please use subject prefixes matching the subsystem. You can get them for
example with `git log --oneline -- DIRECTORY_OR_FILE` on the directory
your patch is touching.

Please use scripts/get_maintainers.pl to get a list of necessary people
and lists to CC. It might happen, that command when run on an older
kernel, gives you outdated entries. Therefore please be sure you base
your patches on recent Linux kernel.

Tools like b4 or scripts/get_maintainer.pl provide you proper list of
people, so fix your workflow. Tools might also fail if you work on some
ancient tree (don't, instead use mainline), work on fork of kernel
(don't, instead use mainline) or you ignore some maintainers (really
don't). Just use b4 and everything should be fine, although remember
about `b4 prep --auto-to-cc` if you added new patches to the patchset.

You missed at least devicetree list (maybe more), so this won't be
tested by automated tooling. Performing review on untested code might be
a waste of time, thus I will skip this patch entirely till you follow
the process allowing the patch to be tested.

Please kindly resend and include all necessary To/Cc entries.

Best regards,
Krzysztof
Lothar Rubusch March 22, 2024, 12:27 a.m. UTC | #2
On Wed, Mar 20, 2024 at 10:34 AM Krzysztof Kozlowski <krzk@kernel.org> wrote:
>
> On 19/03/2024 22:27, Lothar Rubusch wrote:
> > Provide the optional spi-3wire option for the DT binding.
> >
> > Signed-off-by: Lothar Rubusch <l.rubusch@gmail.com>
>
> A nit, subject: drop second/last, redundant "documentation". The
> "dt-bindings" prefix is already stating that these are bindings.
> See also:
> https://elixir.bootlin.com/linux/v6.7-rc8/source/Documentation/devicetree/bindings/submitting-patches.rst#L18
>
> Also, everything is an update. Be descriptive.

Ok

> Please use subject prefixes matching the subsystem. You can get them for
> example with `git log --oneline -- DIRECTORY_OR_FILE` on the directory
> your patch is touching.

Yes. Next time I'll chose better prefixes. For now I keep the subject
to the mail to not break the mailing thread and update the patches in a
follow up. I hope this is ok?

> Please use scripts/get_maintainers.pl to get a list of necessary people
> and lists to CC. It might happen, that command when run on an older
> kernel, gives you outdated entries. Therefore please be sure you base
> your patches on recent Linux kernel.
>
> Tools like b4 or scripts/get_maintainer.pl provide you proper list of
> people, so fix your workflow. Tools might also fail if you work on some
> ancient tree (don't, instead use mainline), work on fork of kernel
> (don't, instead use mainline) or you ignore some maintainers (really
> don't). Just use b4 and everything should be fine, although remember
> about `b4 prep --auto-to-cc` if you added new patches to the patchset.
>
> You missed at least devicetree list (maybe more), so this won't be
> tested by automated tooling. Performing review on untested code might be
> a waste of time, thus I will skip this patch entirely till you follow
> the process allowing the patch to be tested.
>
> Please kindly resend and include all necessary To/Cc entries.
>
> Best regards,
> Krzysztof

I understand. I took linux-next. I fetched it this week from mainline
kernel.org. I took "get_maintainers.pl" as a mere
recommendation rather than mandatory and skipped most of the emails.
Sry for that. Thank you  for all the information.
Krzysztof Kozlowski March 22, 2024, 5:36 a.m. UTC | #3
On 22/03/2024 01:27, Lothar Rubusch wrote:
> 
>> Please use subject prefixes matching the subsystem. You can get them for
>> example with `git log --oneline -- DIRECTORY_OR_FILE` on the directory
>> your patch is touching.
> 
> Yes. Next time I'll chose better prefixes. For now I keep the subject
> to the mail to not break the mailing thread and update the patches in a
> follow up. I hope this is ok?

No. Email threading depends on reply-to headers, not subject. It's
irrelevant.


Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/iio/accel/adi,adxl345.yaml b/Documentation/devicetree/bindings/iio/accel/adi,adxl345.yaml
index 07cacc3f6..280ed479e 100644
--- a/Documentation/devicetree/bindings/iio/accel/adi,adxl345.yaml
+++ b/Documentation/devicetree/bindings/iio/accel/adi,adxl345.yaml
@@ -32,6 +32,8 @@  properties:
 
   spi-cpol: true
 
+  spi-3wire: true
+
   interrupts:
     maxItems: 1