* [PATCH] docs: driver-api: gpio: Fix filename mismatch
@ 2022-06-12 19:01 Tom Schwindl
2022-06-13 16:12 ` Bartosz Golaszewski
0 siblings, 1 reply; 2+ messages in thread
From: Tom Schwindl @ 2022-06-12 19:01 UTC (permalink / raw)
To: corbet; +Cc: linus.walleij, brgl, linux-doc, linux-gpio, linux-kernel
The filenames were changed a while ago, but board.rst, consumer.rst and
intro.rst still refer to the old names. Fix those references to match the
Actual names and avoid possible confusion.
Signed-off-by: Tom Schwindl <schwindl@posteo.de>
---
Documentation/driver-api/gpio/board.rst | 2 +-
Documentation/driver-api/gpio/consumer.rst | 6 +++---
Documentation/driver-api/gpio/intro.rst | 6 +++---
3 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/Documentation/driver-api/gpio/board.rst b/Documentation/driver-api/gpio/board.rst
index 4e3adf31c8d1..b33aa04f213f 100644
--- a/Documentation/driver-api/gpio/board.rst
+++ b/Documentation/driver-api/gpio/board.rst
@@ -6,7 +6,7 @@ This document explains how GPIOs can be assigned to given devices and functions.
Note that it only applies to the new descriptor-based interface. For a
description of the deprecated integer-based GPIO interface please refer to
-gpio-legacy.txt (actually, there is no real mapping possible with the old
+legacy.rst (actually, there is no real mapping possible with the old
interface; you just fetch an integer from somewhere and request the
corresponding GPIO).
diff --git a/Documentation/driver-api/gpio/consumer.rst b/Documentation/driver-api/gpio/consumer.rst
index 47869ca8ccf0..72bcf5f5e3a2 100644
--- a/Documentation/driver-api/gpio/consumer.rst
+++ b/Documentation/driver-api/gpio/consumer.rst
@@ -4,7 +4,7 @@ GPIO Descriptor Consumer Interface
This document describes the consumer interface of the GPIO framework. Note that
it describes the new descriptor-based interface. For a description of the
-deprecated integer-based GPIO interface please refer to gpio-legacy.txt.
+deprecated integer-based GPIO interface please refer to legacy.rst.
Guidelines for GPIOs consumers
@@ -78,7 +78,7 @@ whether the line is configured active high or active low (see
The two last flags are used for use cases where open drain is mandatory, such
as I2C: if the line is not already configured as open drain in the mappings
-(see board.txt), then open drain will be enforced anyway and a warning will be
+(see board.rst), then open drain will be enforced anyway and a warning will be
printed that the board configuration needs to be updated to match the use case.
Both functions return either a valid GPIO descriptor, or an error code checkable
@@ -270,7 +270,7 @@ driven.
The same is applicable for open drain or open source output lines: those do not
actively drive their output high (open drain) or low (open source), they just
switch their output to a high impedance value. The consumer should not need to
-care. (For details read about open drain in driver.txt.)
+care. (For details read about open drain in driver.rst.)
With this, all the gpiod_set_(array)_value_xxx() functions interpret the
parameter "value" as "asserted" ("1") or "de-asserted" ("0"). The physical line
diff --git a/Documentation/driver-api/gpio/intro.rst b/Documentation/driver-api/gpio/intro.rst
index 2e924fb5b3d5..c9c19243b97f 100644
--- a/Documentation/driver-api/gpio/intro.rst
+++ b/Documentation/driver-api/gpio/intro.rst
@@ -14,12 +14,12 @@ Due to the history of GPIO interfaces in the kernel, there are two different
ways to obtain and use GPIOs:
- The descriptor-based interface is the preferred way to manipulate GPIOs,
- and is described by all the files in this directory excepted gpio-legacy.txt.
+ and is described by all the files in this directory excepted legacy.rst.
- The legacy integer-based interface which is considered deprecated (but still
- usable for compatibility reasons) is documented in gpio-legacy.txt.
+ usable for compatibility reasons) is documented in legacy.rst.
The remainder of this document applies to the new descriptor-based interface.
-gpio-legacy.txt contains the same information applied to the legacy
+legacy.rst contains the same information applied to the legacy
integer-based interface.
--
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH] docs: driver-api: gpio: Fix filename mismatch
2022-06-12 19:01 [PATCH] docs: driver-api: gpio: Fix filename mismatch Tom Schwindl
@ 2022-06-13 16:12 ` Bartosz Golaszewski
0 siblings, 0 replies; 2+ messages in thread
From: Bartosz Golaszewski @ 2022-06-13 16:12 UTC (permalink / raw)
To: Tom Schwindl
Cc: Jonathan Corbet, Linus Walleij, linux-doc,
open list:GPIO SUBSYSTEM, Linux Kernel Mailing List
On Sun, Jun 12, 2022 at 9:01 PM Tom Schwindl <schwindl@posteo.de> wrote:
>
> The filenames were changed a while ago, but board.rst, consumer.rst and
> intro.rst still refer to the old names. Fix those references to match the
> Actual names and avoid possible confusion.
>
> Signed-off-by: Tom Schwindl <schwindl@posteo.de>
> ---
> Documentation/driver-api/gpio/board.rst | 2 +-
> Documentation/driver-api/gpio/consumer.rst | 6 +++---
> Documentation/driver-api/gpio/intro.rst | 6 +++---
> 3 files changed, 7 insertions(+), 7 deletions(-)
>
> diff --git a/Documentation/driver-api/gpio/board.rst b/Documentation/driver-api/gpio/board.rst
> index 4e3adf31c8d1..b33aa04f213f 100644
> --- a/Documentation/driver-api/gpio/board.rst
> +++ b/Documentation/driver-api/gpio/board.rst
> @@ -6,7 +6,7 @@ This document explains how GPIOs can be assigned to given devices and functions.
>
> Note that it only applies to the new descriptor-based interface. For a
> description of the deprecated integer-based GPIO interface please refer to
> -gpio-legacy.txt (actually, there is no real mapping possible with the old
> +legacy.rst (actually, there is no real mapping possible with the old
> interface; you just fetch an integer from somewhere and request the
> corresponding GPIO).
>
> diff --git a/Documentation/driver-api/gpio/consumer.rst b/Documentation/driver-api/gpio/consumer.rst
> index 47869ca8ccf0..72bcf5f5e3a2 100644
> --- a/Documentation/driver-api/gpio/consumer.rst
> +++ b/Documentation/driver-api/gpio/consumer.rst
> @@ -4,7 +4,7 @@ GPIO Descriptor Consumer Interface
>
> This document describes the consumer interface of the GPIO framework. Note that
> it describes the new descriptor-based interface. For a description of the
> -deprecated integer-based GPIO interface please refer to gpio-legacy.txt.
> +deprecated integer-based GPIO interface please refer to legacy.rst.
>
>
> Guidelines for GPIOs consumers
> @@ -78,7 +78,7 @@ whether the line is configured active high or active low (see
>
> The two last flags are used for use cases where open drain is mandatory, such
> as I2C: if the line is not already configured as open drain in the mappings
> -(see board.txt), then open drain will be enforced anyway and a warning will be
> +(see board.rst), then open drain will be enforced anyway and a warning will be
> printed that the board configuration needs to be updated to match the use case.
>
> Both functions return either a valid GPIO descriptor, or an error code checkable
> @@ -270,7 +270,7 @@ driven.
> The same is applicable for open drain or open source output lines: those do not
> actively drive their output high (open drain) or low (open source), they just
> switch their output to a high impedance value. The consumer should not need to
> -care. (For details read about open drain in driver.txt.)
> +care. (For details read about open drain in driver.rst.)
>
> With this, all the gpiod_set_(array)_value_xxx() functions interpret the
> parameter "value" as "asserted" ("1") or "de-asserted" ("0"). The physical line
> diff --git a/Documentation/driver-api/gpio/intro.rst b/Documentation/driver-api/gpio/intro.rst
> index 2e924fb5b3d5..c9c19243b97f 100644
> --- a/Documentation/driver-api/gpio/intro.rst
> +++ b/Documentation/driver-api/gpio/intro.rst
> @@ -14,12 +14,12 @@ Due to the history of GPIO interfaces in the kernel, there are two different
> ways to obtain and use GPIOs:
>
> - The descriptor-based interface is the preferred way to manipulate GPIOs,
> - and is described by all the files in this directory excepted gpio-legacy.txt.
> + and is described by all the files in this directory excepted legacy.rst.
> - The legacy integer-based interface which is considered deprecated (but still
> - usable for compatibility reasons) is documented in gpio-legacy.txt.
> + usable for compatibility reasons) is documented in legacy.rst.
>
> The remainder of this document applies to the new descriptor-based interface.
> -gpio-legacy.txt contains the same information applied to the legacy
> +legacy.rst contains the same information applied to the legacy
> integer-based interface.
>
>
> --
>
Applied, thanks!
Bart
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2022-06-13 18:59 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-06-12 19:01 [PATCH] docs: driver-api: gpio: Fix filename mismatch Tom Schwindl
2022-06-13 16:12 ` Bartosz Golaszewski
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).