[v2] dt-bindings: serial: rs485: remove deprecated .txt binding stub

[PATCH v2] dt-bindings: serial: rs485: remove deprecated .txt binding stub

Posted by Akash Sukhavasi 3 days, 3 hours ago

The plain text binding file was superseded by the YAML schema in
commit d50f974c4f7f ("dt-bindings: serial: Convert rs485 bindings
to json-schema"). The file now contains only a redirect notice.
Remove it, and update references in serial_core.c and
serial-rs485.rst to point to the YAML schema.

Signed-off-by: Akash Sukhavasi <akash.sukhavasi@gmail.com>
---
Changes in v2:
- Update references in serial_core.c and serial-rs485.rst to point
  to rs485.yaml (Sashiko review).

v1: https://lore.kernel.org/all/20260521150748.4816-1-akash.sukhavasi@gmail.com/

 Documentation/devicetree/bindings/serial/rs485.txt | 1 -
 Documentation/driver-api/serial/serial-rs485.rst   | 2 +-
 drivers/tty/serial/serial_core.c                   | 2 +-
 3 files changed, 2 insertions(+), 3 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/serial/rs485.txt

diff --git a/Documentation/devicetree/bindings/serial/rs485.txt b/Documentation/devicetree/bindings/serial/rs485.txt
deleted file mode 100644
index a7fe93efc..000000000
--- a/Documentation/devicetree/bindings/serial/rs485.txt
+++ /dev/null
@@ -1 +0,0 @@
-See rs485.yaml
diff --git a/Documentation/driver-api/serial/serial-rs485.rst b/Documentation/driver-api/serial/serial-rs485.rst
index dce061ef7..f53043d21 100644
--- a/Documentation/driver-api/serial/serial-rs485.rst
+++ b/Documentation/driver-api/serial/serial-rs485.rst
@@ -132,4 +132,4 @@ RS485 Serial Communications
 6. References
 =============
 
-.. [#DT-bindings]	Documentation/devicetree/bindings/serial/rs485.txt
+.. [#DT-bindings]	Documentation/devicetree/bindings/serial/rs485.yaml
diff --git a/drivers/tty/serial/serial_core.c b/drivers/tty/serial/serial_core.c
index 89cebdd27..df4589880 100644
--- a/drivers/tty/serial/serial_core.c
+++ b/drivers/tty/serial/serial_core.c
@@ -3496,7 +3496,7 @@ EXPORT_SYMBOL_GPL(uart_try_toggle_sysrq);
  * @port: uart device's target port
  *
  * This function implements the device tree binding described in
- * Documentation/devicetree/bindings/serial/rs485.txt.
+ * Documentation/devicetree/bindings/serial/rs485.yaml.
  */
 int uart_get_rs485_mode(struct uart_port *port)
 {
-- 
2.54.0

Re: [PATCH v2] dt-bindings: serial: rs485: remove deprecated .txt binding stub

Posted by Conor Dooley 3 days, 2 hours ago

On Thu, May 21, 2026 at 11:21:35AM -0500, Akash Sukhavasi wrote:
> The plain text binding file was superseded by the YAML schema in
> commit d50f974c4f7f ("dt-bindings: serial: Convert rs485 bindings
> to json-schema"). The file now contains only a redirect notice.
> Remove it, and update references in serial_core.c and
> serial-rs485.rst to point to the YAML schema.
> 
> Signed-off-by: Akash Sukhavasi <akash.sukhavasi@gmail.com>

Unless I am missing something about how docs.kernel.org redirects
magically work or something along those lines,
Acked-by: Conor Dooley <conor.dooley@microchip.com>
pw-bot: not-applicable

Cheers,
Conor.

> ---
> Changes in v2:
> - Update references in serial_core.c and serial-rs485.rst to point
>   to rs485.yaml (Sashiko review).
> 
> v1: https://lore.kernel.org/all/20260521150748.4816-1-akash.sukhavasi@gmail.com/
> 
>  Documentation/devicetree/bindings/serial/rs485.txt | 1 -
>  Documentation/driver-api/serial/serial-rs485.rst   | 2 +-
>  drivers/tty/serial/serial_core.c                   | 2 +-
>  3 files changed, 2 insertions(+), 3 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/serial/rs485.txt
> 
> diff --git a/Documentation/devicetree/bindings/serial/rs485.txt b/Documentation/devicetree/bindings/serial/rs485.txt
> deleted file mode 100644
> index a7fe93efc..000000000
> --- a/Documentation/devicetree/bindings/serial/rs485.txt
> +++ /dev/null
> @@ -1 +0,0 @@
> -See rs485.yaml
> diff --git a/Documentation/driver-api/serial/serial-rs485.rst b/Documentation/driver-api/serial/serial-rs485.rst
> index dce061ef7..f53043d21 100644
> --- a/Documentation/driver-api/serial/serial-rs485.rst
> +++ b/Documentation/driver-api/serial/serial-rs485.rst
> @@ -132,4 +132,4 @@ RS485 Serial Communications
>  6. References
>  =============
>  
> -.. [#DT-bindings]	Documentation/devicetree/bindings/serial/rs485.txt
> +.. [#DT-bindings]	Documentation/devicetree/bindings/serial/rs485.yaml
> diff --git a/drivers/tty/serial/serial_core.c b/drivers/tty/serial/serial_core.c
> index 89cebdd27..df4589880 100644
> --- a/drivers/tty/serial/serial_core.c
> +++ b/drivers/tty/serial/serial_core.c
> @@ -3496,7 +3496,7 @@ EXPORT_SYMBOL_GPL(uart_try_toggle_sysrq);
>   * @port: uart device's target port
>   *
>   * This function implements the device tree binding described in
> - * Documentation/devicetree/bindings/serial/rs485.txt.
> + * Documentation/devicetree/bindings/serial/rs485.yaml.
>   */
>  int uart_get_rs485_mode(struct uart_port *port)
>  {
> -- 
> 2.54.0
>