==================== Changes in man-pages-3.18 ====================

Released: 2009-02-10, Christchurch


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

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

Andi Kleen <andi@firstfloor.org>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
Christopher Head <chead@telus.net>
Florentin Duneau <fduneau@gmail.com>
Guillem Jover <guillem@debian.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
Lucio Maciel <luciofm@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Peter Zijlstra <peterz@infradead.org>
Petr Baudis <pasky@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Satyam Sharma <ssatyam@cse.iitk.ac.in>
Sebastian Kienzl <seb@riot.org>
Timo Sirainen <tss@iki.fi>
Vegard Nossum <vegard.nossum@gmail.com>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

armscii-8.7
    Lefteris Dimitroulakis
        New page documenting ArmSCII-8 character set

iso_8859-11.7
    Lefteris Dimitroulakis
        New page documenting ISO 8859-11 character set

iso_8859-4.7
    Lefteris Dimitroulakis
        New page documenting ISO 8859-4 character set

iso_8859-6.7
    Lefteris Dimitroulakis
        New page describing ISO 8859-6 character set

pthread_kill.3
    Michael Kerrisk
        New page documenting pthread_kill(3)

pthread_kill_other_threads_np.3
    Michael Kerrisk
        New page documenting pthread_kill_other_threads_np(3)

pthread_sigmask.3
    Michael Kerrisk
        New page documenting pthread_sigmask(3)


Newly documented interfaces in existing pages
---------------------------------------------

clock_getres.3
    Michael Kerrisk
        Document CLOCK_MONOTONIC_RAW, new in 2.6.28


New and changed links
---------------------

clock_gettime.2
clock_settime.2
clock_getres.3
clock_gettime.3
clock_settime.3
    Michael Kerrisk
        Update links to reflect the fact that clock_* pages are now in
        Section 2

iso-8859-11.7
iso_8859_11.7
    Michael Kerrisk
        New links to new iso_8859-11.7

iso-8859-4.7
iso_8859_4.7
latin4.7
    Michael Kerrisk
        New links to new iso_8859-4.7

iso-8859-6.7
iso_8859_6.7
    Michael Kerrisk
        New links to new iso_8859-6.7

tis-620.7
    Michael Kerrisk
        New link to new iso_8859-11.7


Global changes
--------------

clock_nanosleep.2
getrusage.2
timerfd_create.2
clock.3
clock_getcpuclockid.3
ftime.3
pthread_create.3
pthread_getcpuclockid.3
pthread_tryjoin_np.3
sem_wait.3
time.7
    Michael Kerrisk
        Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2

clock_nanosleep.2
execve.2
fork.2
nanosleep.2
sigaction.2
timerfd_create.2
pthread_getcpuclockid.3
ualarm.3
usleep.3
pthreads.7
time.7
    Michael Kerrisk
        Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
            The POSIX timers API is implemented (mostly) within the kernel,
            so thse interfaces are system calls.  Although there are as yet
            no man pages, when they are added they should be in Section 2,
            not 3.  Therefore fix those pages that currently refer to these
            interfaces as being in Section 3.


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

capget.2
    Andi Kleen
        Add some details and relocate a paragraph
            While writing a little program using capset
            I found the capset manpage quite light on crucial
            details and I had to resort to RTFS.

            This patch improves the points I found unclear
            and also moves one misplaced paragraph around.

clock_getres.2
    Michael Kerrisk
        Move page from Section 3 to Section 2

eventfd.2
    Michael Kerrisk
        glibc eventfd() supports the use of eventfd2() since version 2.9

fork.2
    Michael Kerrisk
        SEE ALSO: add daemon(3)

getdents.2
    Michael Kerrisk
        Remove unneeded HAVE_D_TYPE from example program
            Since d_type will always just return DT_UNKNOWN before
            kernel 2.6.4, we don't need to use a conditional for
            determining whether we use this flag.

nanosleep.2
    Michael Kerrisk
        Relocated misplaced BUGS heading

select_tut.2
    Michael Kerrisk
        Clean up error checking in example program (no semantic changes)
    Michael Kerrisk
        Many parts tidied and rewritten
            Remove some redundant text, clarify various pieces,
            tidy example code, etc.
    Michael Kerrisk
        Bug fixes + rewrites in example program
            Sebastien pointed out that the first example program
            wrongly thinks it can count signals.
            Also, some further rewrites by mtk.

socket.2
    Michael Kerrisk
        BUGS: Remove discussion SOCK_UUCP
            As time goes on, this sentence becomes less a piece of humor,
            and more a puzzle.

stat.2
    Michael Kerrisk
        Note that open(O_NOATIME) also causes st_atime not to be updated

timerfd_create.2
    Michael Kerrisk
        Add BUGS noting that timerfd supports fewer clock types than
        timer_create()

btowc.3
    Michael Kerrisk
        SEE ALSO: add wctob(3)

clock_getcpuclockid.3
    Michael Kerrisk
        SEE ALSO: add pthread_getcpuclockid(3)

cos.3
    Michael Kerrisk
        SEE ALSO: add sincos(3)

fexecve.3
    Timo Sirainen
        Note that fexecve() depends on a mounted /proc
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043
    Michael Kerrisk
        CONFORMING TO: note addition of fexecve() in POSIX.1-2008
    Michael Kerrisk
        'fd' must be opened read-only and refer to a file that is executable

fmemopen.3
    Michael Kerrisk
        CONFORMING TO: note that these functions are in POSIX.1-2008

getifaddrs.3
    Lucio Maciel
        Fix memory leak in example program
    Petr Baudis
        Various small fixes

getpwnam.3
    Michael Kerrisk
        SEE ALSO: add getspnam(3)

getumask.3
    Michael Kerrisk
        Updated glibc version number in NOTES

ilogb.3
    Michael Kerrisk
        SEE ALSO: add significand(3)

intro.3
    Michael Kerrisk
        SEE ALSO: add libc(7)

isalpha.3
    Michael Kerrisk
        Fix statement that isalpa() is obsolete; should be isascii()
            http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709
    Michael Kerrisk
        SEE ALSO: add toascii(3)

mq_notify.3
    Michael Kerrisk
        Add cross reference to pthread_attr_init(3)

pthread_attr_setaffinity_np.3
    Michael Kerrisk
        SYNOPSIS: Fix declaration of 'attr'

pthread_getcpuclockid.3
    Michael Kerrisk
        SYNOPSIS: fix type of 'thread'

qsort.3
    Michael Kerrisk
        EXAMPLE: remove unnecessary "#include <stdlib.h>"

random.3
    Michael Kerrisk
        SEE ALSO: add random_r(3)

remainder.3
    Michael Kerrisk
        SEE ALSO: add div(3)

scandir.3
    Michael Kerrisk
        CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
    Michael Kerrisk
        CONFORMING TO: note that versionsort() was added to glibc in
        version 2.1

sem_wait.3
    Michael Kerrisk
        SEE ALSO: add clock_getime(2)

significand.3
    Michael Kerrisk
        Add CONFORMING TO noting that this function is unstandardized

sigwait.3
    Michael Kerrisk
        Add EXAMPLES section referring to pthread_sigmask(3)

sin.3
    Michael Kerrisk
        SEE ALSO: add sincos(3)

stpcpy.3
    Michael Kerrisk
        Add BUGS section noting the possibility of buffer overruns
    Michael Kerrisk
        Add missing pieces/fix various problems in example program
    Michael Kerrisk
        CONFORMING TO: stpcpy() is nowadays on the BSDs
    Michael Kerrisk
        wspfix
    Michael Kerrisk
        SEE ALSO: add stpcpy.3

wcscasecmp.3
    Michael Kerrisk
        CONFORMING TO: note that this function is added in POSIX.1-2008

wcsdup.3
    Michael Kerrisk
        CONFORMING TO: note that this function was added in POSIX.1-2008

wcsncasecmp.3
    Michael Kerrisk
        CONFORMING TO: note that this function is added in POSIX.1-2008

wctob.3
    Michael Kerrisk
        SEE ALSO: add btowc(3)

proc.5
    Michael Kerrisk
        Remove mention of epoll/max_user_instances
            (Since this interface appeared in 2.6.28, and then
            disappeared in 2.6.29.)

ascii.7
    Michael Kerrisk
        Update SEE ALSO list to include pages added in 3.17
    Michael Kerrisk
        SEE ALSO: add recently added iso_8859-*(7) pages

epoll.7
    Michael Kerrisk
        remove documentation of /proc/sys/fs/epoll/max_user_instances
            This /proc interface appeared in 2.6.28. but will be
            removed in 2.6.29.

            Also, document change in default value of
            /proc/sys/fs/epoll/max_user_watches (was 1/32 of lowmem,
            now 1/25 of lowmem).

koi8-r.7
    Michael Kerrisk
        SEE ALSO: add koi8-u(7); remove crufty text

standards.7
    Michael Kerrisk
        Update to note that latest POSIX/SUS was ratified in 2008

time.7
    Michael Kerrisk
        SEE ALSO: add pthread_getcpuclockid(3)
