Re: [PATCH 22/24] membarrier.2: Note that glibc does not provide a wrapper
From: Alejandro Colomar
Date: Mon Sep 28 2020 - 09:33:26 EST
On 2020-09-28 14:52, G. Branden Robinson wrote:
> At 2020-09-27T22:05:14+0200, Alejandro Colomar wrote:
>> Hi Branden,
>>
>> * G. Branden Robinson via linux-man:
>>
>> 1)
>>
>>> .EX
>>> .B int fstat(int \c
>>> .IB fd , \~\c
>>> .B struct stat *\c
>>> .IB statbuf );
>>> .EE
>>
>> 2)
>>
>>> .EX
>>> .BI "int fstat(int " fd ", struct stat *" statbuf );
>>> .EE
>>
>> 3)
>>
>>> .EX
>>> .BI "int fstat(int\~" fd ", struct stat *" statbuf );
>>> .EE
>>
>> 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/*
>
> ...which would catch either of the above just fine.
>
> Am I missing something?
>
> Regards,
> Branden
>
There are a few cases: if I want to find declarations of type int,
I'd start with:
$ grep -rn "int\s"
or something like that. "int\~" would break the ability to do that.
Regards,
Alex