Re: [PATCH] execveat.2: srcfix

Alejandro Colomar (man-pages)
2021-01-01T13:50:12Z

On 1/1/21 12:41 PM, Michael Kerrisk (man-pages) wrote:
> On 12/31/20 7:55 PM, Alejandro Colomar (man-pages) wrote:
>> Hi Michael,
>>
>> I'm not sure about some cases, but have a look at this:
>>
>> a64l.3: compact

Oops, I meant s/compact/ffix!!/

That one made it into the page, so ffix!!

>> atan.3: wsfix

still wsfix: s/( long/(long/

>> backtrace.3: compact>> bstring.3: compact? (and maybe align names?)
>
> Not sure about this one. Nothing done yet.
>
>> catopen.3: compact
>> envz_add.3: compact?
>> fseeko.3: compact
>> fts.3: compact (and maybe align?)
>
> Not sure about this one. Nothing done yet.
>
>> getaddrinfo_a.3: fix alignment (and maybe compact?)
>
> Not sure about this one. Nothing done yet.

see also getaddrinfo.3

>
>> getdirentries.3: ffix!

Fit into 78-col terminal
>> getmntent.3: compact
>
> Not sure about this one. Nothing done yet.
>
>> getspnam.3: compact or group
>
> Grouped.

Fix alignment too (*_r functions)
>> gsignal.3: group
>
> Not sure about that. I'll leave this for now.
>
>> key_setsecret.3: compact
>
> Group.
>
>> login.3: group

ffix!!

The following may help:

$ for p in $(git grep -l '.SH SYN' man?); do \
echo "===================== $p"; \
man -l $p 2> /dev/null \
|sed -n '/^SYNOP/,/DESCR/p' \
|sed '/Feat/,$d'; \
done \
|grep '); *[a-zA-Z_]' \
|grep -v -e 'Note:' -e NOTES;
int brk(void *addr); void *sbrk(intptr_t increment);
set); ssize_t pwrite(int fd, const void *buf, size_t
long a64l(const char *str64); char *l64a(long value);
double fmax(double x, double y); float fmaxf(float x,
float y); long double fmaxl(long double x, long double
void login(const struct utmp *ut); int logout(const char
place the result(s); inproc is used to encode the
dress of where to place the result(s); inproc is
ter(s); procname should return a pointer to its
static result(s); inproc is used to decode the pa‐
RPC socket(s); rdfds is the resultant read file
int wordexp(const char *s, wordexp_t *p, int flags); void
sp,MAXUN.UNSIGNED ); where MAXUN.UNSIGNED is the
(SIGEV_THREAD_ID); Linux-specific */

>> malloc_hook.3: compact
>
> That feels too busy. No change (yet).
>
>> mq_getattr.3: compact and fix alignment

Fix alignment
>> random[_r].3: group or compact
>
> Group.

see random_r.3 too

>> recno.3: There are no APIs? Why not?
>> regex.3: compact?
>
> Not sure about this one. Nothing done yet.
>
>> I didn't read past that.

Still I didn't read past that :)

>
> Well thanks! What you did read was helpful!

Thanks!

I removed from the reply those already fixed,
so what you see in this email is still pending
(minus a few that I may have forgotten to remove).

Cheers,

Alex

> Thanks,
>
> Michael
>
>

--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/