On Sat, Oct 10, 2020 at 3:04 PM Alejandro Colomar via Libc-alpha <libc-alpha@xxxxxxxxxxxxxx> wrote: > > I think this page needs a big overhaul. > > First of all, it's a very big page, > where it's a bit difficult to go to the subsection you want. > Then, the examples are incomplete. > And also, the language of the page is weird. <sys/queue.h> was, IIUC, originally an implementation detail of the original BSD kernel, not intended for use elsewhere. Elsewhere started using it anyway, and that's why glibc has it; there was, at one time, enough user space software that assumed its existence to make a compatibility implementation worthwhile. But I don't think its use should be encouraged in new software, and in fact I'm not sure it should be documented at all. zw