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

[Jon Turney]

On 13/01/2025 13: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.
> 
> 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.
> 
> 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.

Well, I'd just go for one function per line, in alphabetical order, 
because it's unambiguous if we've done that correctly.

Otherwise, it devolves into arguments about "I think it looks nicer this 
way", which... well, "de gustibus non est disputandum".