Re: [PATCH] execveat.2: srcfix

Michael Kerrisk (man-pages)
2021-01-01T11:42:13Z

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
> asprintf.3: compact
> atan.3: wsfix
> backtrace.3: compact
> bstring.3: compact? (and maybe align names?)

Not sure about this one. Nothing done yet.

> byteorder.3: compact
> catopen.3: compact
> closedir.3: compact
> cmsg.3: separate headers from declarations
> dl_iterate_phdr.3: wsfix: 's/) (/)(/'

Done

> drand48.3: group functions as in DESCRIPTION

Done

> drand48_r.3: ^

^
> envz_add.3: compact?
> fgetc.3: compact

I grouped and rearranged.

> fseek.3: ffix!!

Oops!

> and then compact
> fseeko.3: compact
> fts.3: compact (and maybe align?)

Not sure about this one. Nothing done yet.

> futimes.3: compact
> getaddrinfo_a.3: fix alignment (and maybe compact?)

Not sure about this one. Nothing done yet.

> getdirentries.3: ffix!
> getfsent.3: compact

Done, with some rearrangement.

> getgrent.3: compact
> getgrent_r.3: compact?

Yes.

> getgrnam.3: compact? or sort? or nothing? not sure

Some compacting.

> gethostbyname.3: separate headers from declarations?

Yes, plus some grouping.

> getline.3: compact
> getmntent.3: compact

Not sure about this one. Nothing done yet.

> getspnam.3: compact or group

Grouped.

> getttyent.3: ffix!!

Ooops. Fixed.

> gsignal.3: group

Not sure about that. I'll leave this for now.

> hsearch.3: group

grouped and reordered.

> if_nametoindex.3: group
> inet.3: group

Did some grouping.

> insque.3: group
> isgreater.3: compact or group

Compact.

> key_setsecret.3: compact

Group.

> login.3: group
> makecontext.3: compact
> malloc_get_state.3: compact
> malloc_hook.3: compact

That feels too busy. No change (yet).

> mcheck.3: compact

Group

> memchr.3: compact
> mkstemp.3: compact
> mpool.3: compact

Some grouping.

> mq_getattr.3: compact and fix alignment
> mtrave.3: compact
> newlocale.3: compact
> pthread_attr_setschedpolicy.3: ffix: fit into 78-col terminal per
> Branden's advise.

Done.

> pthread_cleanup_push.3: ffix: Join lines
> pthread_cleanup_push_defer_np.3: ffix: Join lines
> pthread_setname_np.3: ffix: Join lines> pthread_tryjoin_np.3: compact
> puts.3: compact

I grouped and reordered the SYNOPSIS and the page text.

> rand.3: compact or group

Compact.

> random[_r].3: group or compact

Group.

> re_comp.3: compact
> 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.

Well thanks! What you did read was helpful!

> BTW, Why didn't you include man2?

Oh -- I cut and pasted the wrong line into the mail message.

I've made a commit that changed ~140 pages, and pushed.

Thanks,

Michael

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/