@typeswitch Your criticism is dead on accurate. I’ve made one of my life goals to write C like someone who actually wants a human being to comprehend it.
I design opaque types that get passed around as pointers with no direct access to member variables, only through a tailored API. I use proper structural return types (result/status tuple structures). I use GC or manual retain release with deinit functions instead of malloc/free wrappers to manage lifetimes. I strive to be an example of what C can be if effort is applied.
@mos_8502 @typeswitch All that being said, I still like the man-page formatting for reference documentation. You can have the most pristinely architected C code in the world, but if I can't wrap my head around the over-arching architecture and/or how pieces fit together, the first place I will go to will be the API documentation for help.