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

From: Kent Gibson
Date: Sun Jan 14 2024 - 20:37:09 EST


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@xxxxxxxxx> 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.