[PATCH v5 7/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 merge function variants on one line

[Brian Inglis]

On 2025-01-13 12:07, brian.inglis@systematicsw.ab.ca wrote:
> On 2025-01-13 06:38, Corinna Vinschen wrote:
>> On Jan 10 17:01, Brian Inglis wrote:
>>> Move circular F/Ff/Fl and similar functions to put
>>> base entries and -f -l variants on the same line.
>>>
>>> Signed-off-by: Brian Inglis <Brian.Inglis@SystematicSW.ab.ca>
>>> ---
>>>   winsup/doc/posix.xml | 336 +++++++++++--------------------------------
>>>   1 file changed, 84 insertions(+), 252 deletions(-)
>>
>> Hmm.  This makes more sense than the previous patch.
> 
> This is part 1/3 of order/combine/abbreviate, submitted separately to ignore or 
> change.
> 
>> However, it doesn't make sense if only the math functions are affected
>> If you want to do this systematically, you'd have to group them
>> following the Open Group Base Spec Issue 8.
>                      or SUS V5 or POSIX 2024 or ... ;^>
> 
>> That would also imply merging stuff like
>>
>>    iswalnum/iswalnum_l        -- page 1280
>>    le16toh/le32toh/le64toh    -- page 1327
>>    localtime/localtime_r        -- page 1354
>>    mlock/munlock            -- pages 1433, 1488
>>    sig2str/str2sig        -- page 2040
>>
>> etc. etc.
>>
>> Nevertheless, while this has a certain charm and I don't see
>> a disadvantage, I'd like to get Jon's input to this as well.
> 
> Okay with other _l _r _s suffixes, not sure about bits, un, or <-> flips?

Looked at the Refer to entries in some man pages for groups, and looked at the 
functions in the referred to man pages, and grouped by those criteria.

Looking at the end/get/set...ent groups, endhostent/sethostent are implemented 
and gethostent is not implemented - should we keep them separate or combine in 
one section or the other?

-- 
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher  but when there is no more to cut
                                 -- Antoine de Saint-Exupéry