[ CC += glibc ] On 2/10/21 4:06 PM, Alejandro Colomar (man-pages) wrote: > 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? BTW, a suggestion for glibc: glibc could simplify the code with things like #define SIMPLEQ_ENTRY(type) STAILQ(type) It would make it more obvious that they're the same thing. > > 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/
