Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Mon, 28 Sep 2020 22:52:29 +1000
From:   "G. Branden Robinson" <g.branden.robinson@gmail.com>
To:     Alejandro Colomar <colomar.6.4.3@gmail.com>
Cc:     linux-kernel@vger.kernel.org, linux-man@vger.kernel.org,
        mtk.manpages@gmail.com
Subject: Re: [PATCH 22/24] membarrier.2: Note that glibc does not provide a
 wrapper
Message-ID: <20200928125227.yr2ugl23ib6mid76@localhost.localdomain>
References: <20200927054657.ea2zaiesle6hwjit@localhost.localdomain>
 <562859fd-6740-1068-d9d0-9562140cec33@gmail.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
        protocol="application/pgp-signature"; boundary="bxnq6uigh25hfq4e"
Content-Disposition: inline
In-Reply-To: <562859fd-6740-1068-d9d0-9562140cec33@gmail.com>
User-Agent: NeoMutt/20180716
Precedence: bulk


--bxnq6uigh25hfq4e
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

At 2020-09-27T22:05:14+0200, Alejandro Colomar wrote:
> Hi Branden,
>=20
> * G. Branden Robinson via linux-man:
>=20
> 1)
>=20
> > .EX
> > .B int fstat(int \c
> > .IB fd , \~\c
> > .B struct stat *\c
> > .IB statbuf );
> > .EE
>=20
> 2)
>=20
> > .EX
> > .BI "int fstat(int " fd ", struct stat *" statbuf );
> > .EE
>=20
> 3)
>=20
> > .EX
> > .BI "int fstat(int\~" fd ", struct stat *" statbuf );
> > .EE
>=20
> I'd say number 2 is best.  Rationale: grep :)
> I agree it's visually somewhat harder, but grepping is way easier.

I don't see how (2) is any tougher to grep than (3)...?

If I'm grepping, I'm usually concerned with things like
variable/function names and not with punctuation, so if I were grepping
for the above function signature I'd probably write:

$ grep 'fstat.*fd.*statbuf' man2/*

=2E..which would catch either of the above just fine.

Am I missing something?

Regards,
Branden

--bxnq6uigh25hfq4e
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAl9x3IsACgkQ0Z6cfXEm
bc52tw/9HKtno49CUQ4+ViAvR6viNlcMwHVxJrJJc22XkN2A9aGUAw8+z0Y6Pt8S
9QxdQl2WNZ+MOdAmUUH+WIBUVbMrbWUBgqPsJ6G/G0BONqDTc7rMmJsVKXQw2S+I
hDs4yHq7EnYSXjtwSvZP79gYke9YDQItIfCoa915kn8BNbg67/Ps2uYx4Q9GacOM
2weUV7gN5SaZErlPHrWCKsxP3pRslIgdcgBj/jcwdLb1v/NguihDW+rQj6qxvvDs
yqybmf244RIP73v18KOCcgot7SuwTjgl0/ybyMaSWt49y0drXzYjXIiDzHuB6Hl1
EF9ZWjte68CzFHP0rRloCPbdYh/PaerNa5+yNU2v/LOmf7E+yjrV9Zb2HwTY7qDg
lRWsX8DWSRc6LD9xdbDeUASRrjbeOhqyX0KAfmAg5vn/b+DbiUZ6hadrt6O8TPO1
ZOZGTuNsCc5fiR1MOhAfl5AmWaNxYKWJk7XAp8l+6WqWqXFdzIdwtOgEzAErilZv
R17UYCyqLOqSxUXLeHpNbZL3X7L2LXnWnNMg+10O2wlbT7FUqn7OEixmT/M1GGUa
YtilI020FMH3JAOXH/Z/xwFP+Ni8GPorHxWxR12ahC5BmlvuUNwKRdbpX2cWQVpQ
xgClqT/edX7q2DLJrrqjt7m5WS6ABAIMUHrgQDce80uw5F14tJ4=
=dzTk
-----END PGP SIGNATURE-----

--bxnq6uigh25hfq4e--