import queue(3) man page ?

import queue(3) man page ?

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 296 bytes --]

how do people feel about importing the queue(3) man page from FreeBSD ?  glibc 
provides the queue.h and related headers from FreeBSD, so i think it makes 
sense if we include relevant documentation as well ...
http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man3/queue.3?rev=1.42
-mike

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 835 bytes --]

Re: import queue(3) man page ?

[Christoph Hellwig]

On Sun, Oct 26, 2008 at 12:58:01AM -0400, Mike Frysinger wrote:
> how do people feel about importing the queue(3) man page from FreeBSD ?  glibc 
> provides the queue.h and related headers from FreeBSD, so i think it makes 
> sense if we include relevant documentation as well ...
> http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man3/queue.3?rev=1.42

We have queue(3).  I submitted it based on a FreeBSD one back in the
days when Andries maintained the man pages.  Note that it's not a
straight import all modern BSDs have a lot of changes over the old 4.4BSD
version we're using.

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: import queue(3) man page ?

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 907 bytes --]

On Sunday 26 October 2008, Christoph Hellwig wrote:
> On Sun, Oct 26, 2008 at 12:58:01AM -0400, Mike Frysinger wrote:
> > how do people feel about importing the queue(3) man page from FreeBSD ? 
> > glibc provides the queue.h and related headers from FreeBSD, so i think
> > it makes sense if we include relevant documentation as well ...
> > http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man3/queue.3?rev=1.42
>
> We have queue(3).  I submitted it based on a FreeBSD one back in the
> days when Andries maintained the man pages.  Note that it's not a
> straight import all modern BSDs have a lot of changes over the old 4.4BSD
> version we're using.

it's the "updated" part that's the rub.  stock glibc has an ancient queue.h 
while we've been updating it in Gentoo.  i thought i checked and found that 
man-pages simply didnt have one, but it's more a matter of it being old.
-mike

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 835 bytes --]

Re: import queue(3) man page ?

[Christoph Hellwig]

On Sun, Oct 26, 2008 at 04:22:46AM -0400, Mike Frysinger wrote:
> it's the "updated" part that's the rub.  stock glibc has an ancient queue.h 
> while we've been updating it in Gentoo.  i thought i checked and found that 
> man-pages simply didnt have one, but it's more a matter of it being old.

When I imported queue.h it matches what was in glibc back then.  I tried
updating queue.h in glibc around the same time, but Uli doesn't like it.

Updating the man page to reflected some distro fork of the header
doesn't seem like a good idea.

And at least five year ago all the maintained BSDs actually had quite
different additions to queue.h, so which one to pick would be rather
hard and I at least partially understand Uli's rejection.

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: import queue(3) man page ?

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 1045 bytes --]

On Sunday 26 October 2008, Christoph Hellwig wrote:
> On Sun, Oct 26, 2008 at 04:22:46AM -0400, Mike Frysinger wrote:
> > it's the "updated" part that's the rub.  stock glibc has an ancient
> > queue.h while we've been updating it in Gentoo.  i thought i checked and
> > found that man-pages simply didnt have one, but it's more a matter of it
> > being old.
>
> When I imported queue.h it matches what was in glibc back then.  I tried
> updating queue.h in glibc around the same time, but Uli doesn't like it.

yeah, it should get updated or punted already.

> Updating the man page to reflected some distro fork of the header
> doesn't seem like a good idea.

i wasnt suggesting we do that.  i was explaining why i started this thread in 
the first place.

> And at least five year ago all the maintained BSDs actually had quite
> different additions to queue.h, so which one to pick would be rather
> hard and I at least partially understand Uli's rejection.

meh, having an outdated one is just as bad i think.
-mike

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 835 bytes --]

Re: import queue(3) man page ?

[Michael Kerrisk]

Mike,

Mike Frysinger wrote:
> On Sunday 26 October 2008, Christoph Hellwig wrote:
>> On Sun, Oct 26, 2008 at 04:22:46AM -0400, Mike Frysinger wrote:
>>> it's the "updated" part that's the rub.  stock glibc has an ancient
>>> queue.h while we've been updating it in Gentoo.  i thought i checked and
>>> found that man-pages simply didnt have one, but it's more a matter of it
>>> being old.
>> When I imported queue.h it matches what was in glibc back then.  I tried
>> updating queue.h in glibc around the same time, but Uli doesn't like it.
> 
> yeah, it should get updated or punted already.
> 
>> Updating the man page to reflected some distro fork of the header
>> doesn't seem like a good idea.
> 
> i wasnt suggesting we do that.  i was explaining why i started this thread in 
> the first place.
> 
>> And at least five year ago all the maintained BSDs actually had quite
>> different additions to queue.h, so which one to pick would be rather
>> hard and I at least partially understand Uli's rejection.
> 
> meh, having an outdated one is just as bad i think.

Are there some specific pieces you can see that need fixing in the
upstream page?  If so, would you have the time to write a patch?

thanks,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html