[PATCH v2 9/9] Documentation: gpio: move gpio-mockup into obsolete section

Kent Gibson posted 9 patches 1 year, 11 months ago
[PATCH v2 9/9] Documentation: gpio: move gpio-mockup into obsolete section
Posted by Kent Gibson 1 year, 11 months ago
The gpio-mockup has been obsoleted by the gpio-sim, so relocate its
documentation into the obsolete section of the admin-guide book.

Signed-off-by: Kent Gibson <warthog618@gmail.com>
---
 Documentation/admin-guide/gpio/index.rst    | 1 -
 Documentation/admin-guide/gpio/obsolete.rst | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/admin-guide/gpio/index.rst b/Documentation/admin-guide/gpio/index.rst
index 3f6d5a76702b..460afd29617e 100644
--- a/Documentation/admin-guide/gpio/index.rst
+++ b/Documentation/admin-guide/gpio/index.rst
@@ -9,7 +9,6 @@ GPIO
 
     Character Device Userspace API <../../userspace-api/gpio/chardev>
     gpio-aggregator
-    gpio-mockup
     gpio-sim
     Obsolete APIs <obsolete>
 
diff --git a/Documentation/admin-guide/gpio/obsolete.rst b/Documentation/admin-guide/gpio/obsolete.rst
index 5926e5440207..5adbff02d61f 100644
--- a/Documentation/admin-guide/gpio/obsolete.rst
+++ b/Documentation/admin-guide/gpio/obsolete.rst
@@ -9,4 +9,5 @@ Obsolete GPIO APIs
 
     Character Device Userspace API (v1) <../../userspace-api/gpio/chardev_v1>
     Sysfs Interface <../../userspace-api/gpio/sysfs>
+    Mockup Testing Module <gpio-mockup>
 
-- 
2.39.2
Re: [PATCH v2 9/9] Documentation: gpio: move gpio-mockup into obsolete section
Posted by Andy Shevchenko 1 year, 11 months ago
On Mon, Jan 15, 2024 at 2:50 AM Kent Gibson <warthog618@gmail.com> wrote:
>
> The gpio-mockup has been obsoleted by the gpio-sim, so relocate its
> documentation into the obsolete section of the admin-guide book.

...

>      Character Device Userspace API (v1) <../../userspace-api/gpio/chardev_v1>
>      Sysfs Interface <../../userspace-api/gpio/sysfs>
> +    Mockup Testing Module <gpio-mockup>

Not because of the alphabetical ordering, but
historically/semantically shouldn't this be in between?
(I'm fine with either way, just asking)

-- 
With Best Regards,
Andy Shevchenko
Re: [PATCH v2 9/9] Documentation: gpio: move gpio-mockup into obsolete section
Posted by Kent Gibson 1 year, 11 months ago
On Mon, Jan 15, 2024 at 03:20:08AM +0200, Andy Shevchenko wrote:
> On Mon, Jan 15, 2024 at 2:50 AM Kent Gibson <warthog618@gmail.com> wrote:
> >
> > The gpio-mockup has been obsoleted by the gpio-sim, so relocate its
> > documentation into the obsolete section of the admin-guide book.
>
> ...
>
> >      Character Device Userspace API (v1) <../../userspace-api/gpio/chardev_v1>
> >      Sysfs Interface <../../userspace-api/gpio/sysfs>
> > +    Mockup Testing Module <gpio-mockup>
>
> Not because of the alphabetical ordering, but
> historically/semantically shouldn't this be in between?
> (I'm fine with either way, just asking)
>

It is in order of most interest to the reader, hopefully.
The first two are arguable, but the mockup is clearly last there.
sysfs may actually be of more interest on average, but anyone still
hanging on to sysfs deserves what they get.
If the list were longer I would switch to alphabetical.

Cheers,
Kent.