==================== Changes in man-pages-2.65 ====================

Released: 2007-09-17


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

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

Aleksandr Koltsoff <czr@iki.fi>
Andi Kleen <ak@suse.de>
Anton Blanchard <anton@samba.org>
Ari Entlich <lmage11@twcny.rr.com>
Carsten Emde <Carsten.Emde@osadl.org>
François Diakhate <diakhate@enseirb.fr>
Geoff Clare <gclare@gclare.org.uk>
Jon Burgess <jburgess777@googlemail.com>
Julien Cristau <jcristau@debian.org>
Lee Schermerhorn <Lee.Schermerhorn@hp.com>
Mats Wichmann <mats.d.wichmann@intel.com>
Maxime Bizon <mbizon@freebox.fr>
Maxime Vaudequin <maxime.vaudequin@gmail.com>
Michael Prokop <mika@grml.org>
Mike Frysinger <vapier@gentoo.org>
Nicolas François <nicolas.francois@centraliens.net>
Nicolas George <nicolas.george@ens.fr>
Paul Brook <paul@nowt.org>
Reuben Thomas <rrt@sc3d.org>
Sam Varshavchik <mrsam@courier-mta.com>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Thomas Huriaux <thomas.huriaux@gmail.com>
Tolga Dalman <tdalman@project-psi.org>
Ulrich Drepper <drepper@redhat.com>
Vincent Lefevre <vincent@vinc17.org>

Apologies if I missed anyone!


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

Typographical or grammatical errors have been corrected in several
places.

Various pages
    mtk
        Use 'glibc' consistently to refer to GNU C library.

Various pages
    mtk
        Order errors under ERRORS alphabetically.

Various pages
    Nicolas François
        Spelling and formatting fixes, as per Debian bug 439560.

intro.2
select.2
fmtmsg.3
getgrent_r.3
envz_add.3
rtime.3
strptime.3
wordexp.3
    Maxime Vaudequin
        Add "#include <stdlib.h>" (to declare exit(3)) to example program.


New pages
---------

timeradd.3
    mtk
        Description of timeradd(), timersub(), timerclear(),
        timerisset(), timercmp() macros for operating on
        struct timeval.


Removed pages
-------------

fdatasync.2
    mtk
        Somehow, over time, material on fdatasync(2) crept into
        fsync.2, and fdatasync also got added to the NAME section
        of fsync.2.  All of the material in fdatasync.2 that was
        not already in fsync.2 has now been moved there, and
        the former page has been removed.
        In place of the content there, is now a link to fsync.2.


New links
---------

clock_getres.2
clock_gettime.2
clock_settime.2
    mtk
        Link to man3/clock_getres.3.

fdatasync.2
    mtk
        Link to fsync.2.

fdopendir.3
    mtk
        Link to opendir.3.

gethostbyaddr_r.3
    Mats Wichmann
        Link to gethostbyaddr.3.

timerclear.3
timercmp.3
timerisset.3
timersub.3
    mtk
       Links to new timeradd.3.


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

Makefile
    Mike Frysinger
        Make the install target of man-pages respect the standard
        "DESTDIR" variable as well as check the exit status of the
        install command so errors aren't ignored.

get_mempolicy.2
    Lee Schermerhorn

        changed the "policy" parameter to "mode" through out the
        descriptions in an attempt to promote the concept that the memory
        policy is a tuple consisting of a mode and optional set of nodes.

        added requirement to link '-lnuma' to synopsis

        rewrite portions of description for clarification.

        added all errors currently returned by sys call.

        removed cautionary note that use of MPOL_F_NODE|MPOL_F_ADDR
        is not supported.  This is no longer true.

        added mmap(2) to See Also list.

getitimer.2
    mtk
       Since kernel 2.6.22, Linux setitimer() now conforms to POSIX.1,
       giving an EINVAL error for a non-canonical tv_usec value.

gettimeofday.2
    mtk
        Replace discussion of timer* macros with a pointer
        to new page timeradd.3.

ioctl_list.2
    Nicolas George
        Fixed argument type for BLKGETSIZE.

mbind.2
    Lee Schermerhorn

        changed the "policy" parameter to "mode" throughout the
        descriptions in an attempt to promote the concept that the memory
        policy is a tuple consisting of a mode and optional set of nodes.

        rewrite portions of description for clarification.

            clarify interaction of policy with mmap()'d files and shared
            memory regions, including SHM_HUGE regions.

            defined how "empty set of nodes" specified and what this
            means for MPOL_PREFERRED.

            mention what happens if local/target node contains no
            free memory.

            clarify semantics of multiple nodes to BIND policy.
            Note:  subject to change.  We'll fix the man pages when/if
                   this happens.

        added all errors currently returned by sys call.

        added mmap(2), shmget(2), shmat(2) to See Also list.

mmap.2
mprotect.2
    François Diakhate
        Add text noting that PROT_WRITE may (and on x86 does)
        imply PROT_READ.
        See Debian bug 441387.

nfsservctl.2
    Aleksandr Koltsoff
        Fix prototype.

oldfstat.2
oldlstat.2
oldstat.2
    mtk
        Fix broken link

prctl.2
    mtk
        Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.

readahead.2
    mtk
        Removed SEE ALSO reference to nonexistent fadvise.2.

reboot.2
    mtk
        Place SYNOPSIS comments inside C comments (/* ... */).

sched_setaffinity.2
    Samuel Thibault
        Note what thread is affected if 'pid' is specified
        as 0, or as the value returned by getpid().

sched_setscheduler.2
    Carsten Emde
        Add text on real-time features of mainline Linux kernel.

select.2
    mtk
        sync SYNOPSIS with select.2

set_mempolicy.2
    Lee Schermerhorn

        changed the "policy" parameter to "mode" throughout the
        descriptions in an attempt to promote the concept that the memory
        policy is a tuple consisting of a mode and optional set of nodes.

        added requirement to link '-lnuma' to synopsis

        rewrite portions of description for clarification.

            clarify interaction of policy with mmap()'d files.

            defined how "empty set of nodes" specified and what this
            means for MPOL_PREFERRED.

            mention what happens if local/target node contains no
            free memory.

            clarify semantics of multiple nodes to BIND policy.
            Note:  subject to change.  We'll fix the man pages when/if
                   this happens.

        added all errors currently returned by sys call.

        added mmap(2) to See Also list.

sigaction.2
    mtk
        s/si_sign/si_errno/ in statement about which field is unused.
    Ari Entlich
        s/SIGILL/SIGCHLD/ for paragraph describing SIGCHLD.

stat.2
    mtk
        Improve text describing underlying system calls.

swapon.2
    Michael Prokop
        EINVAL also occurs if target path is on tmpfs or similar.
        See Debian bug 435885.

sync.2
    mtk
        Incorporated material from now deleted fdatasync.2.

syscall.2
    mtk
        Small fix in example program.

uname.2
    mtk
        Improve text describing underlying system calls.

utime.2
    Vincent Lefevre / mtk
        Clarify utimes() behaviour when 'times' is NULL.
        See Debian bug 431480.
    mtk
        Other minor clarifications of description of utimes().

copysign.3
    Vincent Lefevre
        s/sign/sign bit/ to remove ambiguity in description.
        See Debian bug 435415.

euidaccess.3
    mtk
        Changed NOTES to VERSIONS.

ffsl.3
    mtk
        Add ffsl and ffsll to NAME line.

fts.3
    mtk
        Removed statement that fts functions are expected to appear
        soon in POSIX; it's years old and has not yet come to pass.

ftw.3
    mtk / Geoff Clare
        Fixes/improvements for example program.

getdate.3
    mtk
        Add getdate_r to NAME section.

getaddrinfo.3
    mtk / Geoff Clare
        Fixes/improvements for example program.

gethostbyaddr.3
    Mats Wichmann
        Add documentation for gethostbyaddr_r().
        Plus a few other small fixes.

gethostbyname.3
    mtk
        Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
        gethostent_r to NAME line.

getmntent.3
    mtk
        Fix misnamed function references.

getopt.3
    Jon Burgess
        Fix small error in example program.

getrpcent.3
    mtk
        Add setrpcent and endrpcent to NAME line.

gsignal.3
    Aleksandr Koltsoff
        Fix gsignal() prototype.

hsearch.3
    mtk
        Add hcreate_r, hdestroy_r, hsearch_r to NAME line.

inet.3
    Maxime Bizon
        Correct definition of "struct in_addr".

isatty.3
    mtk
        Minor wording fix.

isgreater.3
    mtk
        Add islessequal to NAME line.

lgamma.3
    Vincent Lefevre
        Fix CONFORMING TO section.
        See Debian bug 417592.

log1p.3
    mtk
        Add log1pf and log1pl to NAME line.

longjmp.3
    Paul Brook / mtk
        After a call to longjmp(), the values of modified, non-volatile
        variables in the function that called setjmp() are unspecified.

makecontext.3
    Aleksandr Koltsoff
        Fix makecontext() prototype.

malloc.3
    mtk / Tolga Dalman
        Explain what happens for malloc(0), or calloc() where one of the
        arguments is 0.
    mtk
        Added notes on malloc()'s use of sbrk() and mmap().
    mtk
        Add mmap(2), alloca(3) to SEE ALSO.

mq_close.3
mq_getattr.3
mq_notify.3
mq_open.3
mq_receive.3
mq_send.3
mq_unlink.3
    mtk
        Add "Link with -lrt." to SYNOPSIS.

opendir.3
    Ulrich Drepper; some edits and additional text by mtk
        Document fdopendir().

readdir.3
    mtk, after a note by Andi Kleen
        Document DT_* constants for d_type.
    Ulrich Drepper / mtk
        Rework discussion of non-standard structure fields.

sem_wait.3
    mtk
        Minor improvements to example program.

syslog.3
    mtk
        Add vsyslog to NAME section.

termios.3
    Nicolas François
        Fix XCASE feature test macro description.

wcsspn.3
    Aleksandr Koltsoff
        Add return type to prototype.

proc.5
    mtk
        Improve description of num_threads field under /proc/PID/stat.
    Maxime Vaudequin
        Fix path error (s%proc/sys%proc/sys/kernel%) in mentions of
        /proc/sys/ostype, /proc/sys/osrelease and proc/sys/version.
    Maxime Vaudequin
        I noticed things to correct and to clarify in subsection
        "/proc/filesystems" of proc.5:
        - clarify filesystems listing: not only FS compiled
          into the kernel, also FS kernel modules currently loaded
        - add a reference to fs(5)
        - add an explanation for FS marked with "nodev"
        - s/mount(1)/mount(8)/, also corrected in section "SEE ALSO"
        - clarify usage by mount: the current wording may lead to
          think /proc/filesystems is always used by mount when no FS
          is specified. So, usage of "may" which IMHO is more
          appropriate + additional explanations
          In mount(8) we can see:

               If no -t option is given, or if the auto type is
               specified, mount will try to guess the desired type.
               If mount was compiled with the blkid library, the
               guessing is done by this library. Otherwise, mount
               guesses itself by probing the superblock; if that
               does not turn up anything that looks familiar,
               mount will try to read the file /etc/filesystems,
               or, if that does not exist, /proc/filesystems.
               All of the filesystem types listed there will be
               tried, except for those that are labeled "nodev"
               (e.g., devpts, proc and nfs). If /etc/filesystems
               ends in a line with a single * only, mount will
               read /proc/filesystems afterwards.
    Samuel Thibault
        Since linux 2.6.11, /proc/stat has an eighth value for cpu
        lines: stolen time, which is the time spent in other operating
        systems when running in a virtualized environment.

arp.7
        Updated BUGS text referring to jiffies; refer to time.7 instead.

credentials.7
    mtk
        Add words to note that file system ID is Linux specific.

hier.7
    Maxime Vaudequin
        This is some corrections for hier.7:
        - missing period for /media and /mnt
        - /mnt description is not totally correct, it is true for some
          distributions but in others /mnt is used as a temporary FS
          mount point, as it is specified by FHS:
          http://www.pathname.com/fhs/pub/fhs-2.3.html#
                      MNTMOUNTPOINTFORATEMPORARILYMOUNT
        - s/X-Windows/X-Window/ (3 occurrences)
        - section "SEE ALSO": s/mount(1)/mount(8)/

man-pages.7
man.7
mdoc.7
mdoc.samples.7
    mtk / Nicolas François
        Nowadays tmac.XXX are called XXX.tmac.

pthreads.7
    mtk
        Update text about modern threading implementations
        (NPTL vs LinuxThreads).

socket.7
    mtk, after a note by Andi Kleen
        Clarify that SO_SNDTIMEO and SO_RCVTIMEO only have effect for
        socket I/O calls; not for multiplexing system calls like
        select() and poll().

time.7
    mtk
        Add SEE ALSO reference to new timeradd.3.
