Re: [PATCH] execveat.2: srcfix

["Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>]

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/
http://www.alejandro-colomar.es/