GUnixFDList looks like it is platform-specific, but it is not
Unlike all the other symbols starting with GUnix
or g_unix_
, GUnixFDList is not platform-specific. From the documentation:
Before 2.74,
<gio/gunixfdlist.h>
belonged to the UNIX-specific GIO interfaces, thus you had to use thegio-unix-2.0.pc
pkg-config file when using it.Since 2.74, the API is available for Windows.
Since 2.80 the platform-specific symbols are in a separate GioUnix introspection namespace, although they are also preserved in the original Gio namespace for backwards compatibility (see !3892 (merged).)
We'd like to encourage GJS users to migrate their code (see gjs!918 (merged).) This exception for GUnixFDList means that we can't easily document for users how to migrate, because the rule is not simply Gio.UnixFoo
→ GioUnix.Foo
.
Is there anything to be done about this? If the answer is "no," then it is what it is, but in that case is GUnixFDList the only API for which an exception needs to be made?