man-pages-3.23 is released

man-pages-3.23 is released

[Michael Kerrisk]

Gidday,

The Linux man-pages maintainer proudly announces:

   man-pages-3.23.tar.gz - man pages for Linux

This release is now available for download at:

 http://www.kernel.org/pub/linux/docs/man-pages
 or ftp://ftp.kernel.org/pub/linux/docs/man-pages

The online changelog is available at
http://www.kernel.org/doc/man-pages/changelog.html
(blogged at
http://linux-man-pages.blogspot.com/2009/10/man-pages-323-release-my-book.html )
and the current version of the pages is browsable at
http://www.kernel.org/doc/man-pages/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org (*).

c) I have information (possibly inaccurate) that you are the maintainer of
a translation of the manual pages, or are the maintainer of the manual
pages set in a particular distribution, or have expressed interest in
helping with man-pages maintenance, or have otherwise expressed interest in
being notified about man-pages releases.  If you don't want to receive such
messages from me, or you know of some other translator or maintainer who
may want to receive such notifications, send me a message.

Cheers,

Michael

Gidday,

==================== Changes in man-pages-3.23 ====================

Released: 2009-09-30, Munich


Contributors
------------

The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:

Aaron Gardner <aaron.j.gardner-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Andrey Vihrov <vihrov-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Christoph Hellwig <hch-jcswGhMUV9g@public.gmane.org>
Georg Sauthoff <gsauthof-If1cxaH3S3JVgF+RW+Bo1SZEdBbF94EN@public.gmane.org>
Leslie P. Polzer <sky-A/mCt7huS1RhCjiJDEAuBxvVK+yQ3ZXh@public.gmane.org>
Marc Lehmann <debian-reportbug-zsXavz5zCAg@public.gmane.org>
Mark Hills <mark-UrrBsZIrrsb10XsdtD+oqA@public.gmane.org>
Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org>
Nicolas François <nicolas.francois-Fa7rcPG4DJn7nK0/Xc0eeg@public.gmane.org>
Serge Hallyn <serue-r/Jw6+rmf7HQT0dZR+AlfA@public.gmane.org>
Siward de Groot <siward-nv30jWqA7Mk@public.gmane.org>
rui rlex <rui.rlex-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>

Apologies if I missed anyone!


Changes to individual pages
---------------------------

execve.2
pipe.2
tee.2
fmemopen.3
mq_notify.3
qsort.3
    Michael Kerrisk
        Replace use of assert() by code that checks argc
            See http://bugzilla.kernel.org/show_bug.cgi?id=13569

            As noted by Andrey:
            The purpose of the assert macro, defined in <assert.h>,
            is to provide a tool to check for programming mistakes
            or program logic errors. However, the assert macro must
            never be used to perform checks for run time errors,
            since, with the NDEBUG macro defined, expressions within
            the assert macro invocations are not evaluated/checked
            for, resulting in behavior that was not originally intended.
            ...
            The pages affected in the core package are

            execve(2)
            pipe(2)
            tee(2)
            fmemopen(3)
            mq_notify(3)
            qsort(3)

getrusage.2
    Michael Kerrisk
        ru_inblock and ru_oublock are now implemented
            These fields of the rusage structure are filled in since
            Linux 2.6.22.

mmap.2
    Michael Kerrisk
        Add brief documentation of MAP_HUGETLB
            This flag is new in 2.6.32, and serves a similar
            purpose to the shmget() SHM_HUGETLB flag.

open.2
    Christoph Hellwig
        add some comments on O_SYNC and friends

poll.2
    Michael Kerrisk
        Clarify wording describing of 'nfds' argument.
            reported by: rui rlex <rui.rlex-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>

semctl.2
    Nicolas François
        Remove some redundant words

setpgid.2
    Michael Kerrisk
        Add an explanation of orphaned process groups

splice.2
tee.2
vmsplice.2
    Mark Hills
        Fix return type
            Since glibc 2.7, the return type for these functions
            is ssize_t (formerly it was long).

stat.2
    Nicolas François
        Fix small bug in example program
            Since it is a failure, EXIT_FAILURE looks more appropriate
            than EXIT_SUCCESS.

umount.2
    Michael Kerrisk
        glibc only exposes MNT_DETACH and MNT_EXPIRE since version 2.11
            See http://sourceware.org/bugzilla/show_bug.cgi?id=10092

exit.3
    Michael Kerrisk
        Add a pointer to explanation of orphaned process groups in setpgid(2)

fflush.3
    Michael Kerrisk
        fflush() discards buffered input

ffs.3
    Michael Kerrisk
        Clarify that ffsl() and ffsll() are GNU extensions

getaddrinfo.3
    Michael Kerrisk
        Note nonstandard assumed hints.ai_flags value when hints is NULL
            When hints is NULL, glibc assumes hints.ai_flags is
            AI_V4MAPPED|AI_ADDRCONFIG whereas POSIX says 0.
            According to Ulrich Drepper, glibc's behavior is better.

getmntent.3
    Mike Frysinger
        setmntent() argument is 'filename' not 'fp'
            The description of setmntent() formerly used the wrong
            argument name.

posix_fallocate.3
    Nicolas François
        Fix reference to POSIX.1-2008
            The sentence mentions twice POSIX.1-2001.
            I guess the second one should be POSIX.1-2008.
            This should be checked in the standard.

setenv.3
    Michael Kerrisk
        Improve ERRORS section
            Add ENOMEM error; improve EINVAL description. Also, make
            RETURN VALUE section a little more accurate in its mention
            of errno.

strftime.3
    Nicolas François
        Fix error in description: s/Monday/Thursday/

proc.5
    Nicolas François
        Fix page cross reference
            max_user_watches is better explained in epoll(7) than inotify(7).

proc.5
    Michael Kerrisk
        dmesg is in section 1, not section 8

capabilities.7
    Michael Kerrisk
        FS UID manipulations affect CAP_LINUX_IMMUTABLE and CAP_MKNOD
            Nowadays, file system UID manipulations also affect
            CAP_LINUX_IMMUTABLE (since 2.6.3) and CAP_MKNOD (since 2.6.29).

capabilities.7
    Michael Kerrisk
        Fix version number for CAP_MKNOD in DS UID manipulations
            A recent patch said "since 2.6.29". It should have
            been "since 2.6.30".

capabilities.7
    Nicolas François
        Reword a bad sentence in description of capability bounding set.

mq_overview.7
    Michael Kerrisk
        Change documented ranges for msg_max and msgsize_max
            Linux 2.6.28 changed the permissible ranges for
            these /proc files.

tcp.7
udp.7
    Nicolas François
        Replace references to syctl interfaces with /proc

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Watch my Linux system programming book progress to publication!
http://blog.man7.org/
--
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: man-pages-3.23 is released

[Petr Baudis]

  Hi!

On Sat, Oct 03, 2009 at 08:13:30AM +0200, Michael Kerrisk wrote:
> The Linux man-pages maintainer proudly announces:
> 
>    man-pages-3.23.tar.gz - man pages for Linux

  Seeing how many patches seem to be left on the floor, do you need some
help with the maintenance? I don't really have that much time myself,
but maybe just making the process a bit more open and liberal could
help... (If it's wrong, sooner or later someone will send in a patch to
fix it. ;-)

  It's rather sad when people spend many hours composing a manpage, only
to see their work ignored.

  Kind regards,

-- 
				Petr "Pasky" Baudis
A lot of people have my books on their bookshelves.
That's the problem, they need to read them. -- Don Knuth
--
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: man-pages-3.23 is released

[Michael Kerrisk]

Hi Petr,

On Fri, Oct 9, 2009 at 9:02 AM, Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org> wrote:
>  Hi!
>
> On Sat, Oct 03, 2009 at 08:13:30AM +0200, Michael Kerrisk wrote:
>> The Linux man-pages maintainer proudly announces:
>>
>>    man-pages-3.23.tar.gz - man pages for Linux
>
>  Seeing how many patches seem to be left on the floor, do you need some
> help with the maintenance? I don't really have that much time myself,
> but maybe just making the process a bit more open and liberal could
> help... (If it's wrong, sooner or later someone will send in a patch to
> fix it. ;-)

Well, I could do with some good help right now, but there are few volunteers.

My observation about being liberal in accepting patches is that enough
bad patches come in that this would be a mistake. And I've in the past
found some mistakes that lived in man pages for years.

>  It's rather sad when people spend many hours composing a manpage, only
> to see their work ignored.

Yeay. I don't feel great about it either. However the work isn't
ignored. It's just in a very long queue. Towards the end of this year,
things should ease considerably, and if I don't otherwise get help
before then, I'll start working through the backlog then. (In the
meantime, I pick away at the queue now and then.)

And, again, my apologies to you personally, since I know you have a
few queued patches.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
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: man-pages-3.23 is released

[Petr Baudis]

  Hi!

On Fri, Oct 09, 2009 at 11:24:27AM +0200, Michael Kerrisk wrote:
> On Fri, Oct 9, 2009 at 9:02 AM, Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org> wrote:
> >  Hi!
> >
> > On Sat, Oct 03, 2009 at 08:13:30AM +0200, Michael Kerrisk wrote:
> >> The Linux man-pages maintainer proudly announces:
> >>
> >>    man-pages-3.23.tar.gz - man pages for Linux
> >
> >  Seeing how many patches seem to be left on the floor, do you need some
> > help with the maintenance? I don't really have that much time myself,
> > but maybe just making the process a bit more open and liberal could
> > help... (If it's wrong, sooner or later someone will send in a patch to
> > fix it. ;-)
> 
> Well, I could do with some good help right now, but there are few volunteers.

  Ok, how can we help?

> My observation about being liberal in accepting patches is that enough
> bad patches come in that this would be a mistake. And I've in the past
> found some mistakes that lived in man pages for years.

  Then again, if noone noticed the mistake, perhaps the mistake is not
really important. :-) I think "best is the enemy of good" is perhaps the
problem here.

-- 
				Petr "Pasky" Baudis
A lot of people have my books on their bookshelves.
That's the problem, they need to read them. -- Don Knuth
--
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: man-pages-3.23 is released

[Michael Kerrisk]

Hi Petr,

>> >  Seeing how many patches seem to be left on the floor, do you need some
>> > help with the maintenance? I don't really have that much time myself,
>> > but maybe just making the process a bit more open and liberal could
>> > help... (If it's wrong, sooner or later someone will send in a patch to
>> > fix it. ;-)
>>
>> Well, I could do with some good help right now, but there are few volunteers.
>
>  Ok, how can we help?

Review incoming patches and ACK/NAK them. See if you can find someone
to do the same for your patches.

Nothing is dropped, but my queue is long. Around February, I'll become
much more responsive. Sorry about this. Completely overloaded these
days as I make the last push to get the book out the door (while also
carrying a day job and being a parent)

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
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