Re: [PATCH v5 6/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 group variants with base

2025-01-12 Thread Jon Turney

On 11/01/2025 00:01, Brian Inglis wrote:

Move circular Ff/Fl and similar functions before hyperbolic Fh? and
similar entries to keep base entries together with their -f -l variants.
'alphabetic ordering except not in some places as an aesthetic choice' 
seems like a terrible idea to me.




Re: [PATCH v5 2/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 new additions available

2025-01-12 Thread Jon Turney

On 11/01/2025 00:01, Brian Inglis wrote:

Add POSIX new additions available with din entries
or interfaces in headers and packages.


What does 'din' mean in this context?





Re: [PATCH v5 4/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 move or remove dropped entries

2025-01-12 Thread Jon Turney

On 11/01/2025 00:01, Brian Inglis wrote:

Move entries no longer in POSIX from the SUS/POSIX section to
Deprecated Interfaces section and mark with (SUSv4).
Remove entries no longer in POSIX from the NOT Implemented section.


[...]
  
-Other UNIX system interfaces, not in POSIX.1-2008 or deprecated:

+Other UNIX® system interfaces, not in POSIX.1-2024, or 
deprecated:
  


Maybe we've reached the point where this could be split into "System 
interfaces deprecated in POSIX.1-2024" and "Other UNIX system 
interfaces, not in POSIX.1-2024"?




Re: [PATCH v5 0/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 TOG Issue 8 ISO 9945 updates

2025-01-12 Thread Jon Turney

On 11/01/2025 00:01, Brian Inglis wrote:

Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 TOG Issue 8 ISO 9945 updates

Brian Inglis (8):
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 TOG Issue 8 ISO 9945 move new
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 new additions available
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 not implemented new additions
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 move or remove dropped 
entries
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 combine multiple notes
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 group variants with base
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 merge function variants on 
one line
   Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 abbrev variants of base 
function


Thanks very much for working on this!



Re: [PATCH v5 2/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 new additions available

2025-01-12 Thread Brian Inglis

On 2025-01-12 10:58, Jon Turney wrote:

On 11/01/2025 00:01, Brian Inglis wrote:

Add POSIX new additions available with din entries
or interfaces in headers and packages.


What does 'din' mean in this context?


POSIX entries which exist as exported symbols in cygwin.din but not mentioned 
elsewhere in posix.xml, so supported but not yet documented as any Unix interface.


Suggestions for better phrasings of these welcome.

$ sed '/\s\+(din)$/!d;s!!!;s!^\s\+!!' posix.xml | xargs apropos -m man,linux
getentropy (3)   - fill a buffer with random bytes
getlocalename_l:nothing appropriate.
in6addr_any:nothing appropriate.
in6addr_loopback:   nothing appropriate.
posix_getdents: nothing appropriate.
timespec_get:   nothing appropriate.

Also is anyone aware of a good html to man page converter to generate Cygwin or 
POSIX man pages from HTML sources available, and are cpp-reference GPL-3 
allowed, or should we prefix the function source with the man doc and generate 
it in newlib?


Looks like getlocalename_l doc needs updated to POSIX.1-2024, added to 
locale/Makefile.inc LIBC_CHEWOUT_FILES, and locale.h feature test to 202405L?


Could CHEW doc be added to cygwin/**/*.cc or elsewhere?

--
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


Re: [PATCH v5 4/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 move or remove dropped entries

2025-01-12 Thread Brian Inglis

On 2025-01-12 11:04, Jon Turney wrote:

On 11/01/2025 00:01, Brian Inglis wrote:

Move entries no longer in POSIX from the SUS/POSIX section to
Deprecated Interfaces section and mark with (SUSv4).
Remove entries no longer in POSIX from the NOT Implemented section.


[...]
-Other UNIX system interfaces, not in 
POSIX.1-2008 or deprecated:
+Other UNIX® system interfaces, not in 
POSIX.1-2024, or deprecated:


Maybe we've reached the point where this could be split into "System interfaces 
deprecated in POSIX.1-2024" and "Other UNIX system interfaces, not in 
POSIX.1-2024"?


Or just drop "deprecated" as these interfaces have been dropped from POSIX 2024, 
which is why I moved getdomainname to Solaris/SunOS and added "(NIS)"!


--
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