gnome.glib

// ⭐ THE MODULE, WHICH IS WHAT THE NAMESPACE PROMISES.
//
// In this index the namespace is the contract: `compat.xxx` is consumed with
// `#include`, an owner namespace like `gnome.xxx` exposes `import`. glib.cpp
// next to this file takes the header route; this one takes the module, so both
// doors are tested rather than assumed.
//
// ─────────────────────────────────────────────────────────────────────────
// ⚠️ THE TWO DOORS DO NOT COMPOSE, AND THAT IS GCC'S RULE, NOT A CHOICE HERE.
//
// A TU that imports gnome.glib AND textually includes a glib header reaches
// `<time.h>` twice — once through the module's global fragment, once directly
// — and the same `struct tm` from the same file becomes two entities:
//
//     error: conflicting declaration 'struct tm'
//     note: previous declaration as 'struct tm'   (of module gnome.glib)
//
// repeated for every type in it. So a consumer picks ONE route.
//
// WHAT THAT MEANS IN PRACTICE, stated plainly because it decides which route
// to pick: a module cannot carry macros, and glib's macros are half its API
// (1,337 `#define` against 1,312 declarations; for gio 1,679 against 1,753).
// …