Hi Michael, When I refactored queue.3, I found out that there was no documentation for SIMPLEQ. I didn't do anything about it because I've never used it and didn't understand what it was, and more importantly why. Now I found out that it only exists because of historical reasons [1], but it is identical to STAILQ (minus a missing SIMPLEQ equivalent for STAILQ_CONCAT()). So I'd add links simpleq.3, SIMPLEQ_*.3 -> STAILQ.3, and add a paragraph to queue.7 and another one to stailq.3. What do you think about the following? Also I don't know if we should encourage one of them. STAILQ seems to be more complete. What would you do about it? Thanks, Alex [1]: <https://gitlab.freedesktop.org/libbsd/libbsd/-/issues/5> --- $ git diff diff --git a/man7/queue.7 b/man7/queue.7 index f92887a36..c3facafd0 100644 --- a/man7/queue.7 +++ b/man7/queue.7 @@ -138,6 +138,15 @@ Not in POSIX.1, POSIX.1-2001, or POSIX.1-2008. Present on the BSDs. .I <sys/queue.h> macros first appeared in 4.4BSD. +.SH NOTES +Some BSDs provide SIMPLEQ instead of STAILQ. +The interfaces are identical, but for historical reasons +they were named differently on different BSDs. +STAILQ originated on FreeBSD, and SIMPLEQ originated on NetBSD. +For compatibility, glibc provides both sets of macros. .SH SEE ALSO .BR circleq (3), .BR insque (3), -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/
