Re: [PATCH trivial] reset: Improve reset controller kernel docs

[Geert Uytterhoeven]

Hi Philipp,

On Mon, Oct 8, 2018 at 2:55 PM Philipp Zabel <p.zabel@xxxxxxxxxxxxxx> wrote:
> On Mon, 2018-10-08 at 13:15 +0200, Geert Uytterhoeven wrote:
> > Grammar and indentation fixes.
> >
> > Signed-off-by: Geert Uytterhoeven <geert+renesas@xxxxxxxxx>
> > ---
> >  include/linux/reset.h | 8 ++++----
> >  1 file changed, 4 insertions(+), 4 deletions(-)
> >
> > diff --git a/include/linux/reset.h b/include/linux/reset.h
> > index 29af6d6b2f4b8103..d01ea059e2beee6e 100644
> > --- a/include/linux/reset.h
> > +++ b/include/linux/reset.h
> > @@ -138,7 +138,7 @@ __must_check reset_control_get_exclusive(struct device *dev, const char *id)
> >   *
> >   * Returns a struct reset_control or IS_ERR() condition containing errno.
> >   * This function is intended for use with reset-controls which are shared
> > - * between hardware-blocks.
> > + * among hardware blocks.
>
> To my ears "between" sounds better, because it evokes the idea that each
> hardware block individually must take care not to disturb any of the
> others (like sharing a bike between a few riders, instead of among
> them). Also, in many cases the sharing occurs between just two hardware
> blocks, which makes "among" sound weird.
> Of course I'm not a native speaker, so maybe I'm completely wrong.

I'm not a native speaker.
But I was taught "between" is used for exactly 2 items, and "among" for more
than 2.

Gr{oetje,eeting}s,

                        Geert

-- 
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@xxxxxxxxxxxxxx

In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
                                -- Linus Torvalds