==================== Changes in man-pages-2.44 ====================

Released: 2007-04-04

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

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

Andre Majorel <aym-naideb@teaser.fr>
Benjamin Gilbert <bgilbert@cs.cmu.edu>
Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
Chuck Ebbert <76306.1226@compuserve.com>
Ivana Varekova <varekova@redhat.com>
Jakub Jelinek <jakub@redhat.com>
John Ward <jward@idealcorp.com>
Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
Julien Blache <jblache@debian.org>
Julien Cristau <jcristau@debian.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Martn Ferrari <martin.ferrari@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nick Piggin <npiggin@suse.de>
Nick Pollitt <npollitt@mvista.com>
Nicolas Franois <nicolas.francois@centraliens.ne>
Pdraig Brady <P@draigBrady.com>
Premysl Hruby <dfenze@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Serge E. Hallyn <serge@hallyn.com>
Thomas Huriaux <thomas.huriaux@gmail.com>
Timo Sirainen <tss@iki.fi>
Val Henson <val_henson@linux.interl.com>

Apologies if I missed anyone!


New pages
---------

termio.7
    mtk, after a bit of prodding by Reuben Thomas
        A brief discussion of the old System V termio interface,
        with pointers to pages that will contain the information
        that the reader probably wants.

scripts/find_repeated_words.sh
    mtk
        Find consecutive duplicate words in a man page, some of
        which may me grammar errors.

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

mtk
    JustinPyzby / mtk
        Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
            faccessat.2
            fchmodat.2
            fchownat.2
            fstatat.2
            futimesat.2
            linkat.2
            mkdirat.2
            mknodat.2
            openat.2
            readlinkat.2
            renameat.2
            symlinkat.2
            unlinkat.2
            mkfifoat.3

mtk 
    Various references to "getty" were changed to "mingetty", since
    that is the manual page more likely to be found on current systems.

mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
    Updated various header pages to accurately reflect which functions 
    are and are not part of C89.  Also fixed/improved a few other 
    CONFORMING TO entries.

mtk
    s/Unices/Unix systems/ on the 5 pages where it appears.

mtk
    Wrapped long source lines in the following files
        man2/getsockopt.2
        man2/mknodat.2
        man2/io_setup.2
        man2/select_tut.2
        man2/select.2
        man2/readlinkat.2
        man2/io_cancel.2
        man2/syslog.2
        man3/wcsncat.3
        man3/getipnodebyname.3
        man3/cmsg.3
        man3/wcpncpy.3
        man3/wcsrtombs.3
        man3/wcstok.3
        man3/fgetwc.3
        man3/wmemcmp.3
        man3/wcsspn.3
        man3/div.3
        man3/modf.3
        man3/stdio_ext.3
        man3/ctermid.3
        man3/des_crypt.3
        man3/wcsncmp.3
        man3/wmemchr.3
        man3/wcsstr.3
        man3/wmemcpy.3
        man3/wprintf.3
        man3/wcsnrtombs.3
        man3/termios.3
        man3/erf.3
        man3/ceil.3
        man3/lround.3
        man3/nextafter.3
        man3/wcsncpy.3
        man3/wmemset.3
        man3/getw.3
        man4/console_ioctl.4
        man4/sk98lin.4
        man7/environ.7
        man7/unix.7
        man7/time.7

mtk
    Added a SEE ALSO reference for feature_test_macros(7) to all
    pages where a feature test macro appears in the SYNOPSIS.

mtk
    Added SEE ALSO entry pointing to time.7
       alarm.2
       nanosleep.2
       ualarm.3
       usleep.3

Justin Pryzby / mtk
    Fixed consecutive duplicate word typos on a number of pages.

Typographical or grammatical errors have been corrected in several
places.  (Special thanks to Nicolas Franois!)


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

access.2
    mtk
        Since 2.6.20, access() honours the MS_NOEXEC mount flag.
    Jorge Peixoto de Morais Neto / mtk
        Improve ENOENT description.

clone.2
    mtk
        Added some detail to the prototype.
        Added some notes on IA-64's clone2().

epoll_ctl.2
    mtk
        Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.

faccessat.2
    Justin Pryzby
        Various fixes as per Debian bug 411177.
        * s/effective/real/ in description test.
        * added <fcntl.h> to synopsis.
        * various other changes.

getrlimit.2
    mtk / Fedora downstream patches; thanks to Ivana Varekova
        Added a few words to note that RLIMIT_NPROC is really a limit on
        threads.

io_cancel.2
io_destroy.2
io_getevents.2
io_setup.2
io_submit.2
    Fedora downstream patches; thanks to Ivana Varekova
        s%linux/aio.h%libaio.h% in SYNOPSIS.
        Changed return type from "long" to "int".

mbind.2
    Samuel Thibault / mtk
        Fix EINVAL description.
        See Debian bug 411777.
       
mincore.2
    Nick Piggin
        Kernel 2.6.21 fixes several earlier bugs in mincore().
    Nick Pollitt
        Remove words "of a file" -- mincore() is describing
        memory residence information, not properties of a file.
    mtk
        Rewrote various parts to make the page clearer.

mmap.2
    mtk
        Rewrote and reorganised various parts to be clearer.
    Taken from Fedora downstream patches; thanks to Ivana Varekova
        Removed text stating that mmap() never returns 0; that's 
        not true.

mount.2
    mtk / Val Henson
        Document MS_RELATIME, new in Linux 2.6.20.
    
open.2
    Andre Majorel / mtk
        On Linux, the error returned when opening a large file on a 
        32-bit system is actually EFBIG, not EOVERFLOW.

posix_fadvise.2
    Pdraig Brady
        Fix RETURN VALUE description: returns error number of failure.

rename.2
    mtk / Timo Sirainen
        Various improvements to DESCRIPTION.
        See Debian bug 416012.

semop.2
    mtk
        If sops contains multiple operations, then these are performed
        in array order.  All Unix systems that I know of do this,
        and some Linux applications depend on this behaviour.  SUSv3
        made no explicit statement here, but SUSv3 will explicitly 
        require this behaviour.
        Small rewording of explanation of "atomically".

signal.2
    Nicolas Franois
        Fix incorrect argument name in DESCRIPTION.
    mtk
        Small wording improvement.
        
socket.2
    Nicolas Franois
        Add reference to ipv6.7 page.
        
socketcall.2
    Nicolas Franois
        Fix .TH line.

splice.2
    Benjamin Gilbert
        Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.

statvfs.2
    mtk
        Small wording clarification.

symlink.2
    mtk / Nicolas Franois
        Removed cryptic text under CONFORMING to referring to 
        "open(2) and NFS".  There is no relevant text in open.2 as 
        far as I (mtk) can see.

time.2
    mtk / Reuben Thomas
        Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
        This information is old, and probably no longer relevant.
        See Debian bug 403888.

write.2
    mtk, after an idea from a downstream Fedora patch.
        Clarified discussion of /count == 0/ case.

ptrace.2
    Chuck Ebbert
        When the parent receives an event with PTRACE_EVENT_* set, 
        the child is not in the normal signal delivery path.  This 
        means the parent cannot do ptrace(PTRACE_CONT) with a signal 
        or ptrace(PTRACE_KILL).  kill() with a SIGKILL signal can be 
        used instead to kill the child process after receiving one 
        of these messages.
        
sched_setaffinity.2
    mtk
        Fix glibc version number in description of cpusetsize argument.
   
vfork.2
    mtk
        Stripped some excess/outdated text from the BUGS section.
        
basename.3
    mtk / Jorge Peixoto de Morais Neto
        Add text to clarify that the pointer returned by these
        functions may be into some part of 'path'.

dlopen.3
    Taken from Fedora downstream patches; thanks to Ivana Varekova
    + Carlo Marcelo Arenas Belon
        Add "#include <stdlib.h>" to example program.

fclose.3
    mtk
        Complete rewrite.  The existing page was hard to read,
        and the RETURN VALUE description seems to be wrong.

getopt.3
    mtk
        Added getopt() example program.
    mtk
        Add a few words to clarify the operation of the GNU-specific double-colon
        feature, which allows options to have optional arguments.
        See Debian bug352139.

glob.3
    Nicolas Franois
        Fix PROTOTYPE.

inet_network.3
    mtk, after an idea from a downstream Fedora patch.
        Clarified description of inet_network().

log.3
    Nicolas Franois
        Fix .TH line.

log10.3
    Nicolas Franois
        Fix .TH line.

malloc.3
    Nicolas Franois
        Small rewording to mention calloc().
        
posix_openpt.3
    Martn Ferrari
        Fix return type in SYNOPSIS; as per Debian bug 400971.
        Needs _XOPEN_SOURCE == 600; as per Debian bug 400975.
    Julien BLACHE
        s/ptsname/posix_openpt/ in RETURN VALUE
        
re_comp.3
    Taken from Fedora downstream patches; thanks to Ivana Varekova
        Add "#define _REGEX_RE_COMP" to SYNOPSIS.
        
regex.3
    Nicolas Franois
        Fix .TH line.

termios.3
    mtk
        Added .SS headers to give some structure to this page; and a small
        amount of reordering.
    mtk
        Added a section on canonical and non-canonical mode.
    mtk
        Enhanced the discussion of "raw" mode for cfmakeraw().
    mtk
        Document CMSPAR.
    mtk
        Make description of PARODD a little clearer.
    Reuben Thomas
        Add SEE ALSO link to tty_ioctl.4
    mtk
        Add SEE ALSO link to console_ioctl.4

ualarm.3
    mtk
        Removed BSD prototype from synopsis.
        Various rewordings.

usleep.3
    mtk
        Removed BSD prototype from synopsis.
        Various rewordings.

termcap.5
    Taken from Fedora downstream patches; thanks to Ivana Varekova
        s/curses/ncurses/ under SEE ALSO

bootparam.7
    Taken from Fedora downstream patches; thanks to Ivana Varekova
        Documented "mem=nopentium".

feature_test_macros.7
    mtk
        The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
    mtk, after a suggestion by Justin Pryzby
        Added some text warning that the "__" macros the
        <features.h> defines internally should never be
        directly defined by programs.
    mtk, based on notes by Jakub Jelinek
        Document _FORTIFY_SOURCE
        (See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
    mtk
        Document _REENTRANT and _THREAD_SAFE.

mdoc.7
    mtk / Nicolas Franois
        Remove CONFIGURATION section, since this does not seem to be
        true for Linux.
        
svipc.7
    Nicolas Franois
        Fix data types in associated data structures; 
        remove non-existent semzcnt and semncnt fields.

time.7
    mtk
        Since kernel 2.6.20, the software clock can also be 300 HZ.
