Gidday, The Linux man-pages maintainer proudly announces: man-pages-3.28.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/2010/10/man-pages-328-is-released.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@xxxxxxxxxxxxxxx (*). 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 ==================== Changes in man-pages-3.28 ==================== Released: 2010-10-04, Munich Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries E. Brouwer <Andries.Brouwer@xxxxxx> Denis Barbier <bouzim@xxxxxxxxx> Jan Kara <jack@xxxxxxx> Landijk <landijk-user@xxxxxxxxx> Lennart Poettering <mzjro@xxxxxxxxxxxx> Michael Haardt <michael@xxxxxxxx> Michael Kerrisk <mtk.manpages@xxxxxxxxx> Petr Baudis <pasky@xxxxxxx> Sam Varshavchik <mrsam@xxxxxxxxxxxxxxx> Apologies if I missed anyone! New and rewritten pages ----------------------- getaddrinfo_a.3 Petr Baudis New page documenting getaddrinfo_a() The page also documents gai_suspend(), gai_cancel(), and gai_error(). aio.7 Michael Kerrisk New page providing an overview of POSIX asynchronous I/O Newly documented interfaces in existing pages --------------------------------------------- exec.3 Michael Kerrisk Document execpe() This function was added to glibc in version 2.11. Also various other small rewrites in the page. New and changed links --------------------- gai_cancel.3 gai_error.3 gai_suspend.3 Petr Baudis New links to new getaddrinfo_a.3 page error_one_per_line.3 Michael Kerrisk Fix misnamed link file (was error_on_per_line.3) execvpe.3 Michael Kerrisk New link to exec.3 sigstack.3 Michael Kerrisk New link to sigaltstack.2 No new programs should use sigstack(3). Point the user to the better sigalstack(2), whose man page briefly mentions sigstack(3). vlimit.3 Michael Kerrisk New link to getrlimit.2 No new programs should use vlimit(3). Point the user to the better setrlimit(2), whose man page briefly mentions vlimit(3). vtimes.3 Michael Kerrisk New link to getrusage.2 No new programs should use vtimes(3). Point the user to the better getrusage(2), whose man page briefly mentions vtimes(3). Global changes -------------- Various pages Michael Kerrisk Switch to American usage: "-wards" ==> "-ward" American English uses "afterward" in preference to "afterwards", and so on chdir.2 chmod.2 chown.2 gethostname.2 getsid.2 pread.2 setpgid.2 sigaltstack.2 stat.2 truncate.2 wait.2 dirfd.3 getsubopt.3 mkdtemp.3 mkstemp.3 siginterrupt.3 strdup.3 Michael Kerrisk Simplify feature test macro requirements Changes to individual pages --------------------------- getrlimit.2 Michael Kerrisk Add mention of the ancient vlimit() function getrusage.2 Michael Kerrisk Add mention of the ancient vtimes() function io_cancel.2 io_destroy.2 io_getevents.2 io_setup.2 io_submit.2 Michael Kerrisk SEE ALSO: add aio(7) sched_setscheduler.2 Michael Kerrisk ERRORS: note that NULL 'param' yields EINVAL stat.2 Michael Kerrisk Note feature test macro requirements for blkcnt_t and blksize_t timer_create.2 Michael Kerrisk Standardize on name 'sevp' for sigevent argument truncate.2 Michael Kerrisk Correct and simplify ftruncate() feature test macro requirements The glibc 2.12 feature test macro requirements for ftruncate() are buggy; see http://sourceware.org/bugzilla/show_bug.cgi?id=12037. Corrected the requirements in the SYNOPSIS, and added a BUGS section describing the problem in glibc 2.12. aio_cancel.3 Michael Kerrisk Add pointer to aio(7) for example program Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section aio_error.3 Michael Kerrisk Wording improvements in RETURN VALUE Add pointer to aio(7) for example program Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section aio_fsync.3 Michael Kerrisk Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section aio_read.3 Michael Kerrisk Various minor rewordings and additions Add pointer to sigevent(7) for details of notification of I/O completion Add pointer to aio(7) for example program Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section aio_return.3 Michael Kerrisk Improve description in RETURN VALUE Add pointer to aio(7) for example program Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section aio_suspend.3 Michael Kerrisk Various additions and rewordings. Give some arguments more meaningful names. More explicitly describe the 'nitems' argument. Explicitly note that return is immediate if an I/O operation has already completed. Note that aio_error(3) should be used to scan the aiocb list after a successful return. Add references to other relevant pages. Various other pieces rewritten. Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section aio_write.3 Michael Kerrisk Add pointer to sigevent(7) for details of notification of I/O completion Various minor rewordings and additions Refer the reader to aio(7) for a description of the aiocb structure CONFORMING TO: Add POSIX.1-2008; add VERSIONS section clearenv.3 Michael Kerrisk Fix error in feature test macro requirements dysize.3 Michael Kerrisk Remove crufty statement about old SCO bug exec.3 Michael Kerrisk Add feature test macro requirements for execvpe() Rewrite description of PATH and mention _CS_PATH Note execvp() and execlp() behavior for filename containing a slash getaddrinfo.3 Michael Kerrisk Add SEE ALSO reference to new getaddrinfo_a.3 page gethostbyname.3 Michael Kerrisk Fix formatting of feature test macros getw.3 Michael Kerrisk Fix feature test macros malloc.3 Landijk Remove editorializing comments on memory overcommitting See https://bugzilla.kernel.org/show_bug.cgi?id=19332 Michael Kerrisk Various minor reorganizations and wording fix-ups mq_notify.3 Michael Kerrisk Standardize on name 'sevp' for sigevent argument nl_langinfo.3 Michael Haardt Make it clear that nl_langinfo() interacts with setlocale() Add an example program posix_openpt.3 Michael Kerrisk Fix feature test macro requirements rand.3 Michael Kerrisk Remove duplicate #include in example program strtok.3 Petr Baudis Add reference to strtok() example in getaddrinfo(3) inotify.7 Michael Kerrisk Added section noting limitations and caveats of inotify sigevent.7 Michael Kerrisk Add SEE ALSO reference to new getaddrinfo_a.3 page Add SEE ALSO referring to new aio(7) page suffixes.7 Michael Kerrisk Change explanation of ".rpm" to "RPM software package" -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
