Re: [PATCH] execveat.2: srcfix

Michael Kerrisk (man-pages)
2021-01-04T13:22:36Z

Hi Alex,

On 1/4/21 1:59 PM, Alejandro Colomar (man-pages) wrote:
> Hi Michael,
>
> On 1/3/21 1:11 PM, Michael Kerrisk (man-pages) wrote:
>> Hi Alex,
>>
>> On 1/2/21 10:40 PM, Alejandro Colomar (man-pages) wrote:

[...]

>>> circleq.3, list.3, slist.3, tailq.3, stailq.3: group?
>>
>> I've taken a shot at that. You may have improvements to
>> suggest, or even reorderings to suggest (as patches).
>
> I'd group _FIRST, _LAST, _NEXT, _PREV; or at least _FIRST with _LAST.
> And I don't know which ordering to use within that group.
> Any ideas? FLNP? FNPL? FPNL? FL NP? NP FL?
> To be consistent with the ordering you used for _INSERT_,
> we could use 'NP FL',
> and put those 2 groups after the 2 _INSERT_ groups.

I'll go with whatever you think is best. Maybe FLPN?

>
>>> exec.3: consistency with commas; execvpe can be joined
>> Done; done
>
> wsfix: g/char */s//char */

Fixed.

[...]

>>> xdr.3: wsfix: g/) (/s//)(/
>>> (See if there are any other pages with this
>>> that I may haven't seen.)
>>
>> Done.
>>
>> Plus: error.3, ftw.3, glob.3, pthread_create.3, rpc.3
>
> A few more:
> signal.3 (NOTES)

For better or worse, I think the author there was using extravagant
white space to make the signature easier to read. I'll leave as is.

> malloc_hook.3 (EXAMPLES)

Fixed.

[...]

>>> isw*.3: Rewrite into one page similar to isalpha.3?
>>> Does it really need so many pages?
>>
>> There sure is a lot of repetition across those pages...
>
> I'll add it to my TODO list.

I took another look at those pages, and decided they are not as
repetitious as they first appear. I'm not sure there's anything
actuilly yo do there.

[...]

Thanks,

Michael

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