Skip to contentSkip to conversation

Fix new warnings at linux-next

PATCH In review Mauro Carvalho Chehab 4 participants 8 messages Oct 9, 2020 – Oct 21, 2020

Subsystems (7)
lore
Share & tools
lore
#0 lore raw

cover Fix new warnings at linux-next

There are some file renames at linux-next that are causing some new documentation warnings. Address them.

Mauro Carvalho Chehab (2):
MAINTAINERS: fix broken doc refs due to yaml conversion
crypto: sun8x-ce*: update entries to its documentation

 Documentation/devicetree/bindings/clock/hi6220-clock.txt | 2 +-
 MAINTAINERS                                              | 9 ++++-----
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c        | 2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c        | 2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c        | 2 +-
 .../devicetree/bindings/net/wireless/silabs,wfx.yaml     | 2 +-
 6 files changed, 9 insertions(+), 10 deletions(-)
Signature · 1 line
2.26.2
#1 lore raw

PATCH 1/2 MAINTAINERS: fix broken doc refs due to yaml conversion

Several *.txt files got converted to yaml. Update their references at MAINTAINERS file accordingly.

---
 Documentation/devicetree/bindings/clock/hi6220-clock.txt | 2 +-
 MAINTAINERS                                              | 9 ++++-----
 .../devicetree/bindings/net/wireless/silabs,wfx.yaml     | 2 +-
 3 files changed, 6 insertions(+), 7 deletions(-)
Documentation/devicetree/bindings/clock/hi6220-clock.txt +1 -1
index ef3deb7b86ea..17ac4a3dd26a 100644
@@ -4,7 +4,7 @@ Clock control registers reside in different Hi6220 system controllers,
 please refer the following document to know more about the binding rules
 for these system controllers:
 
-Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
+Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
 
 Required Properties:
 
MAINTAINERS +4 -5
index d55f55d89509..7b1183aaafe5 100644
@@ -978,7 +978,7 @@ M:	Michael Hennerich <[email protected]>
 L:	[email protected]
 S:	Supported
 W:	http://ez.analog.com/community/linux-device-drivers
-F:	Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.txt
+F:	Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.yaml
 F:	drivers/iio/adc/ad7768-1.c
 
 ANALOG DEVICES INC AD7780 DRIVER
@@ -3867,7 +3867,7 @@ M:	Roger Quadros <[email protected]>
 L:	[email protected]
 S:	Maintained
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/peter.chen/usb.git
-F:	Documentation/devicetree/bindings/usb/cdns-usb3.txt
+F:	Documentation/devicetree/bindings/usb/cdns,usb3.yaml
 F:	drivers/usb/cdns3/
 
 CADET FM/AM RADIO RECEIVER DRIVER
@@ -7918,7 +7918,7 @@ HISILICON LPC BUS DRIVER
 M:	[email protected]
 S:	Maintained
 W:	http://www.hisilicon.com
-F:	Documentation/devicetree/bindings/arm/hisilicon/hisilicon-low-pin-count.txt
+F:	Documentation/devicetree/bindings/arm/hisilicon/low-pin-count.yaml
 F:	drivers/bus/hisi_lpc.c
 
 HISILICON NETWORK SUBSYSTEM 3 DRIVER (HNS3)
@@ -14911,7 +14911,6 @@ RENESAS ETHERNET DRIVERS
 R:	Sergei Shtylyov <[email protected]>
 L:	[email protected]
 L:	[email protected]
-F:	Documentation/devicetree/bindings/net/renesas,*.txt
 F:	Documentation/devicetree/bindings/net/renesas,*.yaml
 F:	drivers/net/ethernet/renesas/
 F:	include/linux/sh_eth.h
@@ -18107,7 +18106,7 @@ M:	Yu Chen <[email protected]>
 M:	Binghui Wang <[email protected]>
 L:	[email protected]
 S:	Maintained
-F:	Documentation/devicetree/bindings/phy/phy-hi3660-usb3.txt
+F:	Documentation/devicetree/bindings/phy/hisilicon,hi3660-usb3.yaml
 F:	drivers/phy/hisilicon/phy-hi3660-usb3.c
 
 USB ISP116X DRIVER
drivers/staging/wfx/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml +1 -1
index 43b5630c0407..510edd12ed19 100644
@@ -24,7 +24,7 @@ description:
     In addition, it is recommended to declare a mmc-pwrseq on SDIO host above
     WFx. Without it, you may encounter issues with warm boot. The mmc-pwrseq
     should be compatible with mmc-pwrseq-simple. Please consult
-    Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.txt for more
+    Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.yaml for more
     information.
 
   For SPI':'
Signature · 1 line
2.26.2
maintainer
#2 lore raw

Re: [PATCH 1/2] MAINTAINERS: fix broken doc refs due to yaml conversion

Quoted 9 lines · Mauro Carvalho Chehab

Several *.txt files got converted to yaml. Update their references at MAINTAINERS file accordingly.

---
 Documentation/devicetree/bindings/clock/hi6220-clock.txt | 2 +-
 MAINTAINERS                                              | 9 ++++-----
 .../devicetree/bindings/net/wireless/silabs,wfx.yaml     | 2 +-
 3 files changed, 6 insertions(+), 7 deletions(-)

Doesn't apply for me.

#3 lore raw

Re: [PATCH 1/2] MAINTAINERS: fix broken doc refs due to yaml conversion

Em Mon, 12 Oct 2020 14:21:14 -0500
Rob Herring <[email protected]> escreveu:

Quoted 12 lines · Mauro Carvalho Chehab
Quoted 9 lines

Several *.txt files got converted to yaml. Update their references at MAINTAINERS file accordingly.

---
 Documentation/devicetree/bindings/clock/hi6220-clock.txt | 2 +-
 MAINTAINERS                                              | 9 ++++-----
 .../devicetree/bindings/net/wireless/silabs,wfx.yaml     | 2 +-
 3 files changed, 6 insertions(+), 7 deletions(-)  

Doesn't apply for me.

It is based on the top of -next, so perhaps it depends on some other changes that aren't upstream yet and comes from other trees.

I could try to split it, but I guess the easiest way is to just push this one by the end of the merge window, together with the remaining patches I have left, fixing the other doc build issues.

Would that work for you?

Thanks,
Mauro

author Acked-by Stephen Boyd
#4 lore raw

Re: [PATCH 1/2] MAINTAINERS: fix broken doc refs due to yaml conversion

Em Tue, 13 Oct 2020 10:52:39 +0200
Mauro Carvalho Chehab <[email protected]> escreveu:

Quoted 19 lines

Em Mon, 12 Oct 2020 14:21:14 -0500
Rob Herring <[email protected]> escreveu:

Quoted 12 lines · Mauro Carvalho Chehab
Quoted 9 lines

Several *.txt files got converted to yaml. Update their references at MAINTAINERS file accordingly.

---
 Documentation/devicetree/bindings/clock/hi6220-clock.txt | 2 +-
 MAINTAINERS                                              | 9 ++++-----
 .../devicetree/bindings/net/wireless/silabs,wfx.yaml     | 2 +-
 3 files changed, 6 insertions(+), 7 deletions(-)    

Doesn't apply for me.

It is based on the top of -next, so perhaps it depends on some other changes that aren't upstream yet and comes from other trees.

Quoted 6 lines

I could try to split it, but I guess the easiest way is to just push this one by the end of the merge window, together with the remaining patches I have left, fixing the other doc build issues.

Would that work for you?

It now applies cleanly on the top of upstream.

If it would be ok for you, I'll send this one together with the other pending doc warning fix patch series.

Regards,
Mauro

[PATCH] MAINTAINERS: fix broken doc refs due to yaml conversion

Several *.txt files got converted to yaml. Update their references at MAINTAINERS file accordingly.

Documentation/devicetree/bindings/clock/hi6220-clock.txt +1 -1
index ef3deb7b86ea..17ac4a3dd26a 100644
@@ -4,7 +4,7 @@ Clock control registers reside in different Hi6220 system controllers,
 please refer the following document to know more about the binding rules
 for these system controllers:
 
-Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
+Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
 
 Required Properties:
 
MAINTAINERS +4 -5
index 17ca7c8490a9..2cfcfa010b06 100644
@@ -978,7 +978,7 @@ M:	Michael Hennerich <[email protected]>
 L:	[email protected]
 S:	Supported
 W:	http://ez.analog.com/community/linux-device-drivers
-F:	Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.txt
+F:	Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.yaml
 F:	drivers/iio/adc/ad7768-1.c
 
 ANALOG DEVICES INC AD7780 DRIVER
@@ -3847,7 +3847,7 @@ M:	Roger Quadros <[email protected]>
 L:	[email protected]
 S:	Maintained
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/peter.chen/usb.git
-F:	Documentation/devicetree/bindings/usb/cdns-usb3.txt
+F:	Documentation/devicetree/bindings/usb/cdns,usb3.yaml
 F:	drivers/usb/cdns3/
 
 CADET FM/AM RADIO RECEIVER DRIVER
@@ -7898,7 +7898,7 @@ HISILICON LPC BUS DRIVER
 M:	[email protected]
 S:	Maintained
 W:	http://www.hisilicon.com
-F:	Documentation/devicetree/bindings/arm/hisilicon/hisilicon-low-pin-count.txt
+F:	Documentation/devicetree/bindings/arm/hisilicon/low-pin-count.yaml
 F:	drivers/bus/hisi_lpc.c
 
 HISILICON NETWORK SUBSYSTEM 3 DRIVER (HNS3)
@@ -14872,7 +14872,6 @@ RENESAS ETHERNET DRIVERS
 R:	Sergei Shtylyov <[email protected]>
 L:	[email protected]
 L:	[email protected]
-F:	Documentation/devicetree/bindings/net/renesas,*.txt
 F:	Documentation/devicetree/bindings/net/renesas,*.yaml
 F:	drivers/net/ethernet/renesas/
 F:	include/linux/sh_eth.h
@@ -18060,7 +18059,7 @@ M:	Yu Chen <[email protected]>
 M:	Binghui Wang <[email protected]>
 L:	[email protected]
 S:	Maintained
-F:	Documentation/devicetree/bindings/phy/phy-hi3660-usb3.txt
+F:	Documentation/devicetree/bindings/phy/hisilicon,hi3660-usb3.yaml
 F:	drivers/phy/hisilicon/phy-hi3660-usb3.c
 
 USB ISP116X DRIVER
drivers/staging/wfx/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml +1 -1
index 43b5630c0407..510edd12ed19 100644
@@ -24,7 +24,7 @@ description:
     In addition, it is recommended to declare a mmc-pwrseq on SDIO host above
     WFx. Without it, you may encounter issues with warm boot. The mmc-pwrseq
     should be compatible with mmc-pwrseq-simple. Please consult
-    Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.txt for more
+    Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.yaml for more
     information.
 
   For SPI':'

Thanks,
Mauro

#6 lore raw

PATCH 2/2 crypto: sun8x-ce*: update entries to its documentation

In reply to Mauro Carvalho Chehab

The README file was converted to ReST format. Update the references for it accordingly.

---
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c | 2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c | 2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c +1 -1
index fa2f1b4fad7b..a94bf28f858a 100644
@@ -7,7 +7,7 @@
  *
  * This file add support for MD5 and SHA1/SHA224/SHA256/SHA384/SHA512.
  *
- * You could find the datasheet in Documentation/arm/sunxi/README
+ * You could find the datasheet in Documentation/arm/sunxi.rst
  */
 #include <linux/dma-mapping.h>
 #include <linux/pm_runtime.h>
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c +1 -1
index 78503006949c..cfde9ee4356b 100644
@@ -7,7 +7,7 @@
  *
  * This file handle the PRNG
  *
- * You could find a link for the datasheet in Documentation/arm/sunxi/README
+ * You could find a link for the datasheet in Documentation/arm/sunxi.rst
  */
 #include "sun8i-ce.h"
 #include <linux/dma-mapping.h>
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c +1 -1
index 654328160d19..5b7af4498bd5 100644
@@ -7,7 +7,7 @@
  *
  * This file handle the TRNG
  *
- * You could find a link for the datasheet in Documentation/arm/sunxi/README
+ * You could find a link for the datasheet in Documentation/arm/sunxi.rst
  */
 #include "sun8i-ce.h"
 #include <linux/dma-mapping.h>
Signature · 1 line
2.26.2
maintainer Acked-by on v1 2/2
#7 lore raw

Re: [PATCH 2/2] crypto: sun8x-ce*: update entries to its documentation

Quoted 52 lines · Mauro Carvalho Chehab

The README file was converted to ReST format. Update the references for it accordingly.

---
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c | 2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c | 2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c +1 -1
index fa2f1b4fad7b..a94bf28f858a 100644
@@ -7,7 +7,7 @@
  *
  * This file add support for MD5 and SHA1/SHA224/SHA256/SHA384/SHA512.
  *
- * You could find the datasheet in Documentation/arm/sunxi/README
+ * You could find the datasheet in Documentation/arm/sunxi.rst
  */
 #include <linux/dma-mapping.h>
 #include <linux/pm_runtime.h>
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c +1 -1
index 78503006949c..cfde9ee4356b 100644
@@ -7,7 +7,7 @@
  *
  * This file handle the PRNG
  *
- * You could find a link for the datasheet in Documentation/arm/sunxi/README
+ * You could find a link for the datasheet in Documentation/arm/sunxi.rst
  */
 #include "sun8i-ce.h"
 #include <linux/dma-mapping.h>
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c +1 -1
index 654328160d19..5b7af4498bd5 100644
@@ -7,7 +7,7 @@
  *
  * This file handle the TRNG
  *
- * You could find a link for the datasheet in Documentation/arm/sunxi/README
+ * You could find a link for the datasheet in Documentation/arm/sunxi.rst
  */
 #include "sun8i-ce.h"
 #include <linux/dma-mapping.h>
Signature · 1 line
2.26.2

Hello

Thanks