==================== 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@cwi.nl>
Denis Barbier <bouzim@gmail.com>
Jan Kara <jack@suse.cz>
Landijk <landijk-user@yahoo.com>
Lennart Poettering <mzjro@0pointer.net>
Michael Haardt <michael@moria.de>
Michael Kerrisk <mtk.manpages@gmail.com>
Petr Baudis <pasky@suse.cz>
Sam Varshavchik <mrsam@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"
