[arch-dev-public] [signoff] man-pages 3.28-1

Stéphane Gaudreault stephane at archlinux.org
Fri Oct 8 18:05:49 EDT 2010


Le vendredi 08 octobre 2010 14:32:17, Andreas Radke a écrit :
> Upstream update. Please signoff.
> 
> -Andy
> 
> ==================== 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 at cwi.nl>
> Denis Barbier <bouzim at gmail.com>
> Jan Kara <jack at suse.cz>
> Landijk <landijk-user at yahoo.com>
> Lennart Poettering <mzjro at 0pointer.net>
> Michael Haardt <michael at moria.de>
> Michael Kerrisk <mtk.manpages at gmail.com>
> Petr Baudis <pasky at suse.cz>
> Sam Varshavchik <mrsam at courier-mta.com>
> 
> 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"

I do not read the man pages, do you ? ;-)

Signoff x86_64

Stéphane


More information about the arch-dev-public mailing list