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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <CAMuHMdVQSsVwaCNy9UCDQErymhHEFBycs2mcps2p-0CLmc7AYA@mail.gmail.com>
Date:   Tue, 13 Nov 2018 16:12:13 +0100
From:   Geert Uytterhoeven <geert@...ux-m68k.org>
To:     Philipp Zabel <p.zabel@...gutronix.de>
Cc:     Geert Uytterhoeven <geert+renesas@...der.be>,
        Jiri Kosina <trivial@...nel.org>,
        Linux Kernel Mailing List <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH trivial] reset: Improve reset controller kernel docs

Hi Philipp,

On Mon, Oct 8, 2018 at 2:55 PM Philipp Zabel <p.zabel@...gutronix.de> wrote:
> On Mon, 2018-10-08 at 13:15 +0200, Geert Uytterhoeven wrote:
> > Grammar and indentation fixes.
> >
> > Signed-off-by: Geert Uytterhoeven <geert+renesas@...der.be>
> > ---
> >  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@...ux-m68k.org

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