Start of 2.19

[thirdparty/man-pages.git] / Changes.old

The following are changes in previous 2.xx man page releases.

==================== Changes in man-pages-2.00 ====================

Released: 2004-12-16 (why wait for the kernel?)

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

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

Alberto Bertogli <albertogli@telpin.com.ar>
Anand Kumria <wildfire@progsoc.org>
Andrey Kiselev <dron@ak4719.spb.edu>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Chris Green <cmg@dok.org>
Branden Robinson <branden@debian.org>
Emmanuel Colbus <emmanuel.colbus@ensimag.imag.fr>
Enrico Zini <enrico@debian.org>
Eric Estievenart <eric.estievenart@free.fr>
Fabian Kreutz <kreutz@dbs.uni-hannover.de>
Florian Weimer <fw@deneb.enyo.de>
Jan Kuznik <kuznik@gepro.cz>
Joey (Martin) Schulze <joey@infodrom.org>
Johannes Berg <johannes@sipsolutions.de>
John V. Belmonte <jbelmonte@debian.org>
Karel Kulhavy <clock@twibright.com>
Luis Javier Merino Morán <ljmerino@pandasoftware.es>
Martin Pool <mbp@sourcefrog.net>
Richard Kreckel <Richard.Kreckel@ginac.de>
Vasya Pupkin <ptushnik@gmail.com>

Apologies if I missed anyone!

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

Many math pages had their synopses compressed, as per suggestion
from Fabian Kreutz.

Many minor content and formatting bug fixes were made to the math
pages, following suggestions from Fabian Kreutz (who recently 
translated many of the 1.70 math pages into German) and 
Andries Brouwer.

For consistency, all instances "super-user" were changed to the more 
common "superuser".

After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS
of several Section 2 pages using the _syscallN() macros.  

    In addition:
        -- erroneous semicolons at the end of _syscallN() were removed
           on various pages.

        -- types such as "uint" in syscalN() declarations were changed
           to "unsigned int", etc.

        -- various other minor breakages in the synopses were fixed.

   The affected pages are:

                getdents.2
                gettid.2
                llseek.2
                mmap2.2
                modify_ldt.2
                pivot_root.2
                quotactl.2
                readdir.2
                sysctl.2
                syslog.2
                tkill.2

Typographical or grammatical errors have been corrected in several
other places.

Individual pages
----------------

bind.2
    Florian Weimer
        Added 'const' to declaration of 'my_addr' in prototype.
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762

fcntl.2
    Martin Pool
        Added O_NOATIME to list of flags that can be changed via F_SETFL.
    mtk/aeb
        Noted F_GETOWN bug after suggestion from aeb.
        See also:
        http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2

getrlimit.2
    mtk
        Material on getrusage.2 has been separated out into its own page.
        Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
            2.6.9 changes.
        Added note on RLIMIT_CPU error in older kernels.
        Added RLIMIT_SIGPENDING
        Also made a few other minor changes.

getrusage.2
    mtk
        This page is new(ish) -- it was created by splitting
            getrlimit.2.

        Repaired note on SIGCHLD behaviour to note that the
            POSIX non-conformance has been fixed in 2.6.9.

kill.2
    Modified after suggestion from Emmanuel Colbus
        Changed wording of sentence under NOTES describing
            when signals can be sent to init.

mlock.2, munlock.2, mlockall.2, munlockall.2
        These have been consolidated into a single mlock.2 page.
        In the process, much duplication was eliminated
            and new information was added about RLIMIT_MEMLOCK
            and the changes in memory locking in kernel 2.6.9,

mmap.2
    mtk
        Added cross-ref to setrlimit(2) concerning memory locking limits.
    Eric Estievenart
        Note that MAP_FIXED replaces existing mappings

msgctl.2
   mtk
        Substantial language and formatting clean-ups.
        Added msqid_ds and ipc_perm structure definitions.

msgget.2
   mtk
        Substantial language and formatting clean-ups.
        Added notes on /proc files.

msgop.2
   mtk
        Substantial language and formatting clean-ups.
        Added notes on /proc files.

open.2
    Martin Pool
        Added O_NOATIME (new in Linux 2.6.8)
    mtk
        Reordered list of 'flags' description alphabetically

personality.2
   2004-11-03 applied patch from Martin Schulze

semctl.2
   mtk
        Substantial language and formatting clean-ups.
        Rewrote semun text.
        Added semid_ds and ipc_perm structure definitions.

semget.2
   mtk
        Substantial language and formatting clean-ups.
        Added notes on /proc files.
        Rewrote BUGS note about semget()'s failure to initialise
            semaphore values.

semop.2
   mtk
        Substantial language and formatting clean-ups.
        Added notes on /proc files.

shmctl.2
   mtk
        Substantial language and formatting clean-ups.
        Updated shmid_ds structure definitions.
        Added information on SHM_DEST and SHM_LOCKED flags.
        Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK
            since kernel 2.6.9.
        Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
        Added RLIMIT_SIGPENDING (new in Linux 2.6.8)

shmget.2
   mtk
        Substantial language and formatting clean-ups.
        Added notes on /proc files.

shmop.2
   mtk
        Substantial language and formatting clean-ups.
        Changed wording and placement of sentence regarding attachment
            of segments marked for destruction.

sigaction.2
   mtk
        Added mention of SIGCONT under SA_NOCLDSTOP.
        Added SA_NOCLDWAIT.
        Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
        Noted that CLD_CONTINUED is supported since Linux 2.6.9.
        Added SI_TKILL (new in Linux 2.4.19).
        Other minor changes.

signal.2
    mtk
        Removed text on ignoring SIGCHLD; replaced with pointer 
            to sigaction.2.

sigwaitinfo.2
    After bug report from Andrey Kiselev
        Fixed prototype: "timeout" --> "*timeout"
        as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145

stat.2
    Enrico Zini
        Added text to clarify that S_IS*() macros should be applied to 
        st_mode field.
        as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698

swapon.2
    After bug report from Anand Kumria
        Added "no swap space signature" to EINVAL error
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi
    mtk
        Added EINVAL error for swapoff() ("not currently a swap area").
        Added EBUSY error for swapon().
        A few formatting fixes.

times.2
    mtk
        In Linux 2.6, the return value of times changed; it is no 
            longer time since boot, but rather:

                boot_time + 2^32 / HZ - 300

        Repaired note on SIGCHLD behaviour to note that the
            POSIX non-conformance has been fixed in 2.6.9.
        Some formatting fixes.

undocumented.2
    After bug report from Johannes Berg
        Changed
            .TH UNIMPLEMENTED
        to:
            .TH UNDOCUMENTED
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741

wait.2
    mtk
        Added waitid(2).
        Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
        Added text on SA_NOCLDSTOP.
        Updated discussion of SA_NOCLDWAIT to reflect 2.6 behaviour.
        Much other text rewritten.

wait4.2
    mtk
        Rewrote this page, removing much duplicated information,
            and replacing with pointers to wait.2.
    Luis Javier Merino Morán / mtk
        CONFORMING TO said "SVr4, POSIX".  Changed to "4.3BSD"

waitid.2
    mtk
        New link to wait.2

assert.3
    After bug report from Branden Robinson
        The assert() failure message goes to stderr not stdout.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
        
ctime.3
    mtk
        Noted that 0 in tm_mday is interpreted to mean the last day 
            of the preceding month.

getnameinfo.3
    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618
        getnameinfo() does not set errno, it returns a non-zero
        value indicating the error.
    mtk
        added EAI_OVERFLOW error

killpg.3
    mtk
        Minor changes to SEE ALSO and CONFORMING TO.

lseek64.3
    aeb
        New page by Andries Brouwer

tzset.3
    Richard Kreckel
        Change "NULL" to "empty" when talking about the value of TZ.
        http://sources.redhat.com/bugzilla/show_bug.cgi?id=601

printf.3
    After bug report from Jan Kuznik 
        http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
        Fixed bad realloc() use in snprintf() example

realpath.3
    mtk
        Added discussion of resolved_path == NULL.

random.4
    After bug report from John V. Belmonte
        Updated init and quit scripts to reflect kernel 2.4/2.6 reality
        (Scripts taken from drivers/char/random.c)
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779

proc.5
    mtk
        Updated description of /proc/loadavg to include
            nr_running(), nr_threads, last_pid.

        rtsig-max and rtsig-nr went away in 2.6.8

        updated statm, and fixed error in order of list

boot.7
    applied patch from Martin Schulze

capabilities.7
    mtk
        Added O_NOATIME for CAP_FOWNER

netdevice.7 
    Karel Kulhavy and AEB
        formatting fix after note from Karel Kulhavy and AEB, plus a 
            few wording fixes.
   
signal.7
    mtk
        /proc/sys/kernel/rtsig-* were superceded by RLIMIT_SIGPENDING
            in kernel 2.6.8.
            
tcp.7
   mtk/aeb
        Updated details of interaction of TCP_CORK and TCP_NODELAY.

==================== Changes in man-pages-2.01 ====================

Released: 2004-12-20 (a quick one before Christmas)

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

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

Carsten Hey <c.hey@web.de>
Johannes Berg <johannes@sipsolutions.de>
Joshua Kwan <joshk@triplehelix.org>
Marek Habersack <grendel@debian.org>
Martin Schulze <joey@infodrom.org>
Matthew Dempsky <jivera@flame.org>
Matthew Gregan <kinetik@orcon.net.nz>
Pedro Zorzenon Neto <pzn@terra.com.br>
Tony Crawford <tony@klosterdorf.de>

Apologies if I missed anyone!

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

Matthew Dempsky, mtk
    triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
    The wording describing how errno is set was fixed up in the
    following pages:

            accept.2
            close.2
            send.2
            setsid.2
            socket.2
            closedir.3
            initgroups.3
            mkstemp.3
            opendir.3
            readdir.3
            telldir.3

Typographical or grammatical errors have been corrected in several
other places.

Individual pages
----------------

sendfile.2
    mtk
        Adjusted descriptions of argument file types to be closer to 
            2.6 reality.
        Wording and formatting changes

ctan.3
ctanh.3
    Tony Crawford
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
        Formulae on the pages should be T = S / C not T = C / S.

errno.3
    Martin Schulze, mtk
        Removed errno declaration from prototype, added notes
            on historical need for this declaration.
        http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175

aio_return.3
   as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
       Changed erroneous "aio_return(2)" to "aio_return(3)"

posix_openpt.3
    mtk
        New by mtk

ptsname.3
    mtk
        Added description of ptsname_r().
        Added ERRORS.

ptsname_r.3
    mtk
        New link to ptsname.3.

shm_open.3
    Matthew Gregan
        add <fcntl.h> to synopsis
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243

strcasecmp.3
    Marek Habersack <grendel@debian.org>
            .SH "CONFORMING TO"
            -BSD 4.4
            +BSD 4.4, SUSv3
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
        
strfry.3
    Joshua Kwan
        Added _GNU_SOURCE to prototype
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
                
strftime.3
    Cartsen Hey
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248

        Changed range for "%S" from 0..61 to 0..0.

        SUSv3 says 0..60.  I think the manual page probably says 
        0..61, because that's what SUSv2 said.
        (Some other implementations' man pages also say 0..61 -- 
        e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)

        The glibc manual currently says 0..60.

        Given that SUSv3 says 0..60, I've changed the 
        manual page to also say this:

            -The second as a decimal number (range 00 to 61).
            +The second as a decimal number (range 00 to 60).
            +(The range is up to 60 to allow for occasional leap seconds.)

sysconf.3
    Johannes Berg / http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
        -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
        +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV

system.3
    Pedro Zorzenon 
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
        Noted use of _XOPEN_SOURCE to get macros <sytdlib.h> 
        as for wait(2).

    mtk
        Changed name of argument from 'string' to 'command' (like POSIX).

        Noted that glibc does nowadays explicitly check for the existence
        of the shell if 'command' is NULL, rather than the older behaviour
        of assuming the shell exists and always returning 1 if
        'command' is NULL.

        Other wording and formatting clean-ups.

undocumented.3
    Remove some functions names that *are* documented.


==================== Changes in man-pages-2.02 ====================

Released: 2005-04-14

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

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

Andries Brouwer <Andries.Brouwer@cwi.nl>
Branden Robinson <branden@debian.org>
Colin Watson <cjwatson@debian.org>
David Lloyd <dmlloyd@tds.net>
Gordon Jin <gordon.jin@intel.com> 
Heikki Orsila <shd@modeemi.cs.tut.fi>
Jamie Lokier <jamie@shareable.org>
Johan Walles
Kai Makisara <Kai.Makisara@kolumbus.fi>
Marko Kohtala <marko.kohtala@gmail.com>
Martin Pool <mbp@sourcefrog.net>
Martin (Joey) Schulze <joey@infodrom.org>
Matthias Lang <matthias@corelatus.se>
Michael Haardt <michael@moria.de>
Michael Mühlebach <michael@anduin.ch>
Mike Frysinger <vapier@gentoo.org>
Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
Serguei Leontiev <leo@sai.msu.ru>

Apologies if I missed anyone!

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

Martin (Joey) Schulze
    Removed SEE ALSO reference to non-existent newctime(3) from:

        ctime.3
        tzselect.8
        zdump.8
        zic.8

        See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884

Typographical or grammatical errors have been corrected in several
other places.

Individual pages
----------------

clone.2
    mtk
        Noted the PID caching behaviour of NPTL's getpid()
        wrapper under BUGS.

        Added futex(2), set_thread_area(2), set_tid_address(2), 
        tkill(2) under SEE ALSO.

epoll_ctl.2
epoll_create.2
    Marko Kohtala  / mtk
        Improved various error descriptions.

epoll_wait.2
    David Lloyd / Mike Frysinger, Marko Kohtala
        Added EINTR to errors.

fcntl.2
    Jamie Lokier / mtk
        Improved discussion of F_SETOWN and F_SETSIG with respect to
        multi-threaded programs.
        Generally cleaned up the discussion of F_SETOWN.

        Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
        now in POSIX.

link.2
    mtk
        Noted discrepancy between Linux and POSIX.1 when oldpath
        is a symbolic link.
        See: http://bugs.linuxbase.org/show_bug.cgi?id=367
        and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html

    Michael Haardt / mtk
        Clarified EXDEV error description: it isn't possible to link
        across mount points, even if the mount points refer to the same
        file system.

mincore.2
    mtk, after note from Gordon Jin
        Updated ERRORS

pipe.2
    As per message from Serguei Leontiev
        Removed SVr2, AT&T, and BSD from CONFORMING TO, since
        a pipe on those systems is actually bidirectional.
        (Pipes are implemented as STREAMS on the former, and 
        sockets on the latter.)

posix_fadvise.2
    mtk
        Noted kernel version where posix_fadvise() appeared and
        noted bug in handling of 'len' in kernels < 2.6.6.

rename.2
    Michael Haardt
        Clarified EXDEV error description: it isn't possible to rename
        a file across mount points, even if the mount points refer to 
        the same file system.

semop.2
    mtk
        Noted kernel version numbers for semtimedop().

setitimer.2
    Matthias Lang, mtk
        Noted MAX_SEC_IN_JIFFIES ceiling.
        Added note about treatment of out-of-range tv_usec values.

sigqueue.2
    Johan Walles, Martin (Joey) Schulze
        Added sigqueue.2 to SEE ALSO

times.2
    mtk
        Added notes on non-standard behaviour: Linux allows 'buf' to
        be NULL, but POSIX.1 doesn't specify this and it's non-portable.

uselib.2
    Andries Brouwer
        Improved DESCRIPTION; clarified distinction between
        EACCES and ENOEXEC.

bcopy.3
    Heikki Orsila
        bcopy() handles overlapping case, but memcpy() does not,
        so for consistency memmove() should be also mentioned.

getmntent_r.3
    Martin (Joey) Schulze
        New link to man3/getmntent.3.

memcpy.3
    Small wording change after suggestion from Sasa Stevanovic.

strcasestr.3
    mtk
        Created as link to strstr.3.

strftime.3
    mtk
        Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.

strstr.3
    mtk
        Added description of strcasestr().

random.4
    aeb
        Improved description of read from /dev/urandom.

st.4
    Kai Makisara
        Substantial updates.

man.7
    Martin Schulze <joey@infodrom.org>
    Branden Robinson <branden@debian.org>
    Colin Watson <cjwatson@debian.org>
        Mention the .URL macro more verbosely.


==================== Changes in man-pages-2.03 ====================

Released: 2005-06-02

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

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

Andries Brouwer <Andries.Brouwer@cwi.nl>
Joey (Martin) Schulze <joey@infodrom.org>
Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Klaus Ethgen <Klaus@Ethgen.de>
Pavel Heimlich <tropikhajma@seznam.cz>
Ross Boylan <RossBoylan@stanfordalumni.org>
Vincent Fourmond <vincent.fourmond@9online.fr>

Apologies if I missed anyone!

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

Pavel Heimlich
    Change `ttys(4)' to `ttyS(4)' in:
        tty.4 mouse.4 vcs.4 console_ioctl.4 console.4

Typographical or grammatical errors have been corrected in several
places.

Individual pages
----------------

clone.2
    mtk
        Substantially enhanced discussion of CLONE_THREAD.

        Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED.

        Other minor fixes.

execve.2
    aeb
        Noted effect of ptracing when execing a set-UID program.
        
fcntl.2
    Johannes Nicolai / mtk
        Noted F_SETOWN bug for socket file descriptor in Linux 2.4
        and earlier.

        Added text on permissions required to send signal to owner.

flock.2
    mtk
        Noted that lock conversions are not atomic.

getrusage.2
    mtk
        ru_nswap has never contained useful information.
        Kernel 2.6.6 clarified that with a patch 
        ("[PATCH] eliminate nswap and cnswap").  See also:
        http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html

kill.2
    mtk
        Clarified wording of the 'pid == -1' case.

mount.2
    mtk
        Added MNT_EXPIRE, plus a few other tidy-ups.

sched_setaffinity.2
    mtk
        Added text to note that sched_setaffinity() will migrate the 
        affected process to one of the specified CPUs if necessary.

        Added a NOTE to point out that the affinity mask is actually a 
        per-thread attribute that can be adjusted independently for 
        each thread in a thread group.

shmctl.2
    mtk
        Noted aberrant Linux behaviour with respect to new attaches to a 
        segment that has already been marked for deletion.

        Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.

wait.2
    mtk
        Noted that the __W* flags can't be used with waitid().

getconf.3
    mtk
        Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.

hosts.5 
    Ross Boylan / Martin Schulze
        various changes as per 
        http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242

proc.5
    mtk
        Minor changes to discussion of /proc/PID/stat signal fields.
        Added 'rt_priority' and 'policy' to /proc/PID/stat.

capabilities.7
    mtk
        1,$s/inherited/inheritable/g

regex.7
    Vincent Fourmond / Joey (Martin) Schulze
        Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
        not seem to be in the glibc implementation.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666

tzselect.8
    Joey (Martin) Schulze / Klaus Ethgen
        The default zoneinfo directory is now /usr/share/zoneinfo.
        (was: /usr/local/etc/zoneinfo)
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471


==================== Changes in man-pages-2.04 ====================

Released: 2005-06-21

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

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

Andries Brouwer <Andries.Brouwer@cwi.nl>
Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
Dave Love <d.love@dl.ac.uk>
Dieter Brueggemann <dieter.brueggemann@entitec.de>
Geoff Clare <gclare@gclare.org.uk>
Guido Trotter <ultrotter@debian.org>
kabloom <kabloom@ucdavis.edu>
Kevin Ryde <user42@zip.com.au>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Mike Furr <mfurr@debian.org>
Olivier Croquette <ocroquette@free.fr>
Olivier Guilyardi <ylf@xung.org>
Peter Cordes <peter@llama.nslug.ns.ca>
Philipp Spitzer <philipp@toastfreeware.priv.at>
Tanaka Akira <akr@m17n.org>
Thierry Excoffier <exco@bat710.univ-lyon1.fr>
Thomas Hood <jdthood@yahoo.co.uk>
Vincent Lefevre <vincent@vinc17.org>
Walter Harms <walter.harms@informatik.uni-oldenburg.de>

Apologies if I missed anyone!

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

For consistency across pages:

    1,$s/nonzero/non-zero/g

Typographical or grammatical errors have been corrected in several
places.


New pages
---------

pthreads.7
    mtk
        An overview of the Linux implementations of POSIX threads.


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

_exit.2
    mtk
        Various minor changes

epoll_ctl.2
    Mike Furr <mfurr@debian.org>
        BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
        'event', even though this argument is ignored.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517.

flock.2
   mtk / Kevin Ryde
       Clarified semantics of relationship between flock() locks
       and open file entries and file descriptors.
       See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121
       
getitimer.2
    Olivier Croquette, Thierry Excoffier
        Noted the existence of the short sleep bug (up to 1 jiffy).

getrlimit.2
    mtk
        RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".

getrusage.2
    Geoff Clare
        Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.

nice.2
    mtk / Guido Trotter
        Rewrote description of return value.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183

open.2
    Walter Harms
        O_DIRECT needs _GNU_SOURCE.
    mtk
        O_ASYNC works for pipes and FIFOs in Linux 2.6
        Various minor fixes

atexit.3
    mtk
        Various minor changes

exit.3
    mtk
        Various minor changes

getopt.3
   mtk / Philipp Spitzer
       Fix description of return value.
       See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
       
hsearch.3
    mtk
        Changed (char *) to (void *) in example.
        See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607

log1p.3
    Justin Pryzby
        make log(3) SEE ALSO log1p(3)
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578

makecontext.3
    Tanaka Akira
        Fix description of RETURN VAUE for makecontext()
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800

on_exit.3
    mtk
        Various minor changes

rand.3
    kabloom@ucdavis.edu
        Small fix to a code example
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842.

realpath.3
    mtk / Thomas Hood
        When specifying resolved_path as NULL, realpath()
        will (still) only allocate up to PATH_MAX bytes.
        Plus other minor changes.
        See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424

rcmd.3
    Dave Love
        The required header file for these functions on Linux is <netdb.h>
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680

scanf.3
    Olivier Guilyardi
        Arg for %p is a pointer to _a pointer to_ void.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109

stdin.3
    Vincent Lefevre
        freopen() can change the descriptors associated with
        stdin/stdout/stderr.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859.

strerror.3
    Baurjan Ismagulov
        strerror_r(3) requires #define _XOPEN_SOURCE 600
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880

sysconf.3
     Peter Cordes / mtk
         Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV"

proc.5
    mtk
        Added pointers under /proc/sys/net to tcp.7 and ip.7

ip.7
    mtk
        Various wording and formatting fixes.
        Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.

tcp.7
    Dieter Brueggemann / mtk
        Fixes to the discussion of SIOCATMARK and tcp_stdurg
    mtk
        Various wording and formatting fixes.
        Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
        from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.


==================== Changes in man-pages-2.05 ====================

Released: 2005-06-27

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

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

A Costa <agcosta@gis.net>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Bas Zoetekouw <bas@debian.org>
Dan Jacobson <jidanni@jidanni.org>
Delian Krustev <krustev@krustev.net>
Dora Anna Volgyesi <volgyesi@elte.hu>
Martin (Joey) Schulze <joey@infodrom.org>
Ove Kaaven <ovek@arcticnet.no>

Apologies if I missed anyone!

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

Typographical or grammatical errors have been corrected in several
places.  (Special thanks to A Costa.)


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

_exit.2
    mtk / aeb
        Reversed 2.04 introduction of the term "process termination
            function".

close.2
    mtk
        Clarified what type of lock close() affects.
        Minor formatting changes.

dup.2
    mtk
        Consistent use of terms "open file description",
            "file status flags", and "file decriptor flags"
        Removed mention of lock sharing -- it was not
            accurate.
        Minor formatting fixes

fcntl.2
    mtk
        Consistent use of terms "open file description",
            "file status flags", and "file decriptor flags"
        Some rewriting of discussion of file descriptor flags
        Under F_DUPFD, replaced some text duplicated in dup.2
            with a cross ref to dup.2
        Minor wording and formatting fixes

fpclassify.3
    mtk / Martin (Joey) Schulze / Bas Zoetekouw
        The return value of isinf() changed in glibc 2.02
        to differentiate positive and neagtive infinity.
        See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765

getgid.2
getuid.2
    Delian Krustev
        Remove confusing text describing real and effective IDs.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852

getitimer.2
    mtk
       The short sleep bug (up to 1 jiffy) that was newly noted in
       man-pages-2.04 has just been fixed in 2.6.12.

getpriority.2
   mtk
       Changed range documented in main text from -20..20 to -20..19.
       Noted that the range is -20..20 on some systems.

open.2
    mtk / aeb
        Clarification of term "open file description" along with
            explanation of what information it maintains.
        Other wording improvements
        Various minor wording changes

atexit.3
    mtk / aeb
        Reversed 2.04 introduction of the term "process termination
            function".
    mtk
        Noted use of atexit() for establishing function to be invoked on
            shared library unload.
        Noted that atexit()-registered functions are not invoked on
            abnormal termination.
        Formatting fixes.

exit.3
    mtk / aeb
        Reversed 2.04 introduction of the term "process termination
            function".
    mtk
        Minor rewording and formatting changes.

getloadavg.3
    mtk
        Added #define _BSD_SOURCE to prototype

log2.3
    Martin (Joey) Schulze
        Add ERANGE error.

readdir.3
    mtk
        Added definition of Linux dirent structure.
        Some formatting cleanups.

strtod.3
    Dora Anna Volgyesi/ mtk
        strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668

tdestroy.3
    mtk
        New link to tsearch.3

tsearch.3
    mtk
        Added tdestroy to .TH line

mem.4
    mtk
        Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem"

null.4
    mtk
        Change "chown root:mem /dev/null /dev/zero" to
            "chown root:root /dev/null /dev/zero"

vcs.4
    Dan Jacobson / Martin (Joey) Schulze
        Replaced "selection(1)" by "gpm(8)" under SEE ALSO
        See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515

signal.7
    Ove Kaaven
        SA_SIGACTION should be SA_SIGINFO
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369

urn.7
    mtk
        New link to uri.7


==================== Changes in man-pages-2.06 ====================

Released: 2005-07-15

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

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

Alain Portal <aportal@univ-montp2.fr>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Bhavesh P Davda <bhavesh@avaya.com>
Clau Weber <claus@jambit.com>
Dov Murik <dov@dv-networks.com>
David Lloyd <dlloyd@microbits.com.au>
Frederik Deweerdt <frederik.deweerdt@gmail.com>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Lars Wirzenius <liw@iki.fi>
Martin Pool <mbp@sourcefrog.net>
Mike Frysinger <vapier@gentoo.org>
Petter Reinholdtsen <pere@hungry.com>
Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
Walter Harms <walter.harms@informatik.uni-oldenburg.de>

Apologies if I missed anyone!

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

Typographical or grammatical errors have been corrected in several
places.

Many uses of hyphens and dashes were corrected.


New pages
---------

canonicalize_file_name.3
    Walter Harms / mtk

Removed Pages
-------------

sstk.2
    mtk
        AFAIK, this sytem call has never actually done anything (other
            than be a stub) on any Unix.

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

accept.2
    mtk
        Various wording and formatting fixes.

bind.2
    mtk
        Minor formatting changes

clone.2
    mtk
        Various minor wording improvements; some formatting fixes

connect.2
    mtk
        Various wording and formatting fixes.

epoll_create.2
    Bhavesh P Davda
        s/positive/non-negative/      [for file descriptor]

getrlimit.2
    mtk
        Documented RLIMIT_MSGQUEUE limit.
        RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
            (It already didn't have any effect in 2.2.x and 2.6.x.)
        s/MADVISE_WILLNEED/MADV_WILLNEED/

listen.2
    mtk
        Removed historic comment on BSD backlog ceiling.
        Minor wording and formatting changes.

semop.2
    mtk
        Added BUG: in some circumstances, a process that is
        waiting for a semaphore to become zero is not not woken
        up when the value does actually reach zero.
        http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
        http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2

socket.2
    mtk
         Various minor wording improvements

umask.2
    mtk
        Added mkdir(2) to discussion, made term "file mode creation
            mask" clearer.
        Various, mostly small, wording changes

errno.3
    Martin Pool
        Change description for ESTALE
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344

fgetgrent.3
getgrent.3
getgrent_r.3
    David Lloyd
        Added SEE ALSO putgrent(3)
        See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336

getgrent.3
getgrnam.3
getpwent.3
getpwnam.3
    Lars Wirzenius / mtk
        Replace mention of /etc/{passwd,group} by references to
            "passwd/group database", and LDAP and NIS.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
    mtk
        Miscellaneous wording improvements
        Consistent DESCRIPTION and ERRORS wording across these pages.

getnameinfo.3
   mtk
       Relocate misplaced text describing gai_strerror().

getnetent.3
    Petter Reinholdtsen
        s/endservent/endnetent/
        As per Debian Bug#316517

getspnam.3
    Lars Wirzenius / mtk
        Replace mention of /etc/shadow by references to
            "shadow password database", and LDAP and NIS.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
    mtk, Claus Weber
        Miscellaneous wording improvements
        Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.

hsearch.3
    Frederik Deweerdt
        Fix hsearch_r() prototype

scanf.3
    Justin Pryzby / mtk
        Fix description of RETURN VALUE
        As per Debian Bug#317037
    mtk
        various parts substantially rewritten; added description of
        %n$ form; various text incorporated from the GNU C library
        documentation ((C) The Free Software Foundation).

shm_open.3
    mtk
        Modified details of how user and group ownership of a new
            object are set.
        Various minor wording and formatting cleanups.

elf.5
    Mike Frysinger
        tweaked the short description to include definition of 'ELF'
        add ELFOSABI_NONE to the ELFOSABI_ list
        tweak/add more machines to EM_ list for ehdr->e_machine
        fix indenting to be consistent
        tweak the display of the ELF_ST_* macros
        document the Elf_Dyn structure

proc.5
    mtk
        Updated discussion of /proc/stat. 
        Added text on the /proc/sys/fs/mqueue/* files.

ip.7
    Steven Murdoch
        Change protocol in UDP prototype.
        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635

tcp.7
    Dov Murik
        The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
        makes no grammatical sense (and possibly also no technical sense).
        It has been removed.


==================== Changes in man-pages-2.07 ====================

Released: 2005-07-19

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

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

Andries Brouwer <Andries.Brouwer@cwi.nl>
Mike Frysinger <vapier@gentoo.org>

Apologies if I missed anyone!

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

The terms "set-user-ID" and "set-group-ID" are now used consistently
(no abbreviations) across all manual pages.

Consistent use of "saved set-user-ID" and "saved set-group-ID"
(no more "saved user ID", "saved effective UID", saved group ID", etc.)

Global fixes in textual descriptions:

        uid --> UID
        gid --> GID
        pid --> PID
        id --> ID

Consistent use of st_atime, st_ctime, st_mtime, with explanatory text, 
instead of atime/ctime/mtime.

Classical BSD versions are now always named x.yBSD (formerly
there was a mix of x.yBSD and BSD x.y).

Typographical or grammatical errors have been corrected in several
places.


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

setresuid.2
    mtk
        Some rewording.

stat.2
    Mike Frysinger
        Improve description of st_dev and st_rdev.
    mtk
        Various wording and formatting improvements.

truncate.2
    mtk
        Some formatting fixes


==================== Changes in man-pages-2.08 ====================

Released: 2005-09-21

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

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

Adrian Bunk <bunk@stusta.de>
Alain PORTAL <aportal@univ-montp2.fr>
Andrew Pimlott <andrew@pimlott.net>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Baurzhan Ismagulov <ibr@radix50.net>
Bernhard R. Link <brlink@debian.org>
Bodo Stroesser <bstroesser@fujitsu-siemens.com>
David N. Welton <davidw@eidetix.com>
Dov Murik <dov@dv-networks.com>
Heikki Orsila <shd@modeemi.cs.tut.fi>
Hasso Tepper <hasso@estpak.ee>
Hrvoje Niksic <hniksic@xemacs.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Ludovic Courtes <ludovic.courtes@laas.fr>
Mike Frysinger <vapier@gentoo.org>
Nicolas Francois <nicolas.francois@centraliens.net>
Norbert Buchmuller <norbi.spam@nix.hu>
Paul Brook <paul@nowt.org>
Ramiro Aceves <ea1abz@gmail.com>
Tommy Pettersson <ptp@lysator.liu.se>
Walter Harms <walter.harms@informatik.uni-oldenburg.de>

Apologies if I missed anyone!

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

RFC references are now always written as "RFC\ nnn" (not "RFC nnn" or 
"RFCnnn").

Typographical or grammatical errors have been corrected in several
places.


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

du.1
    Mike Frysinger
        To get an effect like "-h", BLOCKSIZE must start with "human", 
            not "HUMAN".

time.1
    Mike Frysinger
        s/standard output/standard error/
    
clone.2
    Paul Brook / mtk
        Fix small error in description of CLONE_PARENT_SETTID

connect.2
    Heikki Orsila
        Add EINTR error
        See http://lkml.org/lkml/2005/7/12/254

getpriority.2
    mtk
        Expanded discussion of relationship between user and kernel 
            representations of the nice value.

        Added discussion of RLIMIT_NICE and a cross reference to 
            getrlimit.2 under the description of the EACCES error.

        Noted 2.6.12 change in credentials checking for setpriority().

getrlimit.2
    mtk
        Added description of RLIMIT_RTPRIO

        Added description of RLIMIT_NICE

mmap.2
    mtk
        Noted bug in MAP_POPULATE for kernels before 2.6.7.
        
mremap.2
   mtk
        Added _GNU_SOURCE to prototype.
        Rewrote description of MREMAP_MAYMOVE.
        Rewrote description of EAGAIN error.
        Added discussion of resizing of memory locks.
        Added entries to SEE ALSO.
        Some formatting fixes.

msgctl.2
    mtk
        Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.

nanosleep.2
    Baurzhan Ismagulov
        Add to prototype: define _POSIX_C_SOURCE 199309
        As per Debian bug 314435

nice.2
    mtk
        Added sentence noting that range of the nice value is described 
            in getpriority.2.
        Added cross-reference to setrlimit(2) for discussion on 
            RLIMIT_NICE.
    
outb.2
    David N. Welton / Justin Pryzby / mtk
        Clarified the order of value and port arguments;
        As per Debian bug 263756

pause.2
    mtk
        Added SEE ALSO for sigsuspend.2
        Some formatting fixes.

poll.2
    Tommy Pettersson
        nfds should be prototyped as nfds_t
        As per Debian bug 322934

    mtk
        Some wording and formatting improvements.

prctl.2
    mtk
        Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.

rand.3
    Hrvoje Niksic / mtk
        Remove misleading text describing FreeBSD's sranddev() function.
        As per debian bug 328629
        
readv.2
    mtk / Walter harms
        Added LINUX NOTES on trickery performed by glibc when
        vector size exceeds IOV_MAX.

        Formatting clean-ups.
        
remap_file_pages.2
    mtk
        Added text to note that start and size are both rounded downwards.

sched_setparam.2
    mtk
       Modified discussion of privileges; added pointer to 
           sched_setscheduler.2 for a discussion of privileges and 
           resource limits.

sched_setscheduler.2
   mtk
       Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.

semctl.2
    mtk
        Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.

shmctl.2
    mtk
        Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.

sigaction.2
    mtk
        Split sigpending(), sigprocmask(), and sigsuspend() out
        into separate new pages.

        Other minor changes

    mtk
        NOTES: described SA_NODEFER / sa_mask bug which was present in 
                all kernels up to and including 2.6.13.
        See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2
        and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2
        List:       linux-kernel
        Subject:    Signal handling possibly wrong
        From:       Bodo Stroesser
        Date:       2005-08-09 17:44:06

signal.2
    mtk
        Updated SEE ALSO to reflect splitting of sigaction.2 into
        sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2

sigpending.2
    mtk
        New page created by splitting out from sigaction.2
        Changed CONFORMING TO.

sigprocmask.2
    mtk
        New page created by splitting out from sigaction.2
        Added text on effect of NULL for 'set' argument.
        Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL, 
                and SIGSEGV.
        Noted that sigprocmask() can't be used in multithreaded process.
        Fixed EINVAL error diagnostic.
        Changed CONFORMING TO.

sigsuspend.2
    mtk
        New page created by splitting out from sigaction.2
        Added NOTES on usage.
        Added new text to DESCRIPTION.
        Changed CONFORMING TO.

stat.2
    Mike Frysinger
        Improve st_blocks description.

carg.3 
    Ramiro Aceves / aeb
        Change:
                One has carg(z) = atan(creal(z) / cimag(z))
        to:
                One has tan(carg(z)) = cimag(z) / creal(z)

        As per Debian bug 326720
    
cmsg.3
    mtk
        s/SOL_TCP/IPPROTO_TCP/          (POSIX standard name)

dlopen.3
    Alain Portal
        s/-nostartupfiles/-nostartfiles/

getaddrinfo.3
    mtk
        Nowadays (since 2.3.4) glibc only sets the first ai_canonname 
        field if AI_CANONNAME was specified (the current behavior
        is all that SUSv3 requires).

        1,$s/PF_/AF_/g

        Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED, 
        and AI_NUMERICSERV.

        Some wording and formatting fixes.

getpwnam.3
    Bernhard R. Link / mtk
        Add NOTES text describing relationship of pw_dir and HOME and 
            pointing out that applications should preferentially 
            inspect HOME

inet.3
    Mike Frysinger
        Mention "little endian" and "big endian".
        Added note about octal and hex interpretation of 
             numbers-and-dots notation.

rpc.3
    mtk / Ludovic Courtes 
        Commented out references to rpc_secure(3) -- we don't currently 
            have such a page in the man-pages set.
        In response to Debian bug report 325115

setenv.3
    mtk
        glibc 2.3.4 fixed the "name contains '='" bug

strnlen.3
    Mike Frysinger
        Added "#define _GNU_SOURCE" to prototype.
        
initrd.4
    Norbert Buchmuller / mtk
        Added text noting that the use or real-root-dev for changing 
        the root device is obsolete, in favour of pivot root.  
        (However, the page still needs to be rewritten to actually 
        describe the pivot_root method...)
        As per Debian bug 323621.

proc.5
    mtk
        Improve text describing /proc/sys/fs/mqueue/* files 
                                                      
        Describe /proc/sys/fs/suid_dumpable (new in 2.6.13)

        Added placeholder mention of /proc/zoneinfo (new in 2.6.13)
            More needs to be said about this file

        Repaired earlier cut and paste mistake which resulted 
            in part of the text of this page being duplicated.

utmp.5
    Mike Frysinger
        Added text on biarch details for ut_session and ut_tv.

capabilities.7
    mtk
        Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.

ip.7
    mtk / Andrew Pimlott
        Add a couple of words to make it clear that port is a 16-bit number.
        Reformat long source lines (no text changed).
        
        s/SOL_IP/IPPROTO_IP/            (POSIX standard name)

    Hasso Tepper
        Fix discussion of IPC_RECVTTL / IP_TTL

signal.7
    mtk
        Updated SEE ALSO to reflect splitting of sigaction.2 into
        sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2

socket.7
    mtk
        Clarified details of use of SO_PEERCRED.

tcp.7
    mtk
        s/SOL_TCP/IPPROTO_TCP/          (POSIX standard name)
        s/SOL_IP/IPPROTO_IP/            (POSIX standard name)

udp.7
    mtk
        Added description of UDP_CORK socket option

        s/SOL_UDP/IPPROTO_UDP/          (POSIX standard name)
        s/SOL_IP/IPPROTO_IP/            (POSIX standard name)


==================== Changes in man-pages-2.09 ====================

Released: 2005-10-13

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

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

Justin Pryzby <pryzbyj@justinpryzby.com>
Peter Chubb <peterc@gelato.unsw.edu.au>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Tomas Pospisek <tpo_deb@sourcepole.ch>
Trond Myklebust <trond.myklebust@fys.uio.no>

Apologies if I missed anyone!

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

ptsname.3
getpt.3
unlockpt.3
openpty.3
posix_openpt.3
grantpt.3
pts.4
tty_ioctl.4
    mtk
        Added SEE ALSO for new pty.7 page

Typographical or grammatical errors have been corrected in several
places.


New pages
---------

pty.7
   mtk
      Overview of Unix 98 and BSD pseudo-terminals.


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

ldd.1
   mtk
       Remove "-V" option (fix from Fedora man-pages-2.07-7).

fcntl.2
    Peter Chubb / Trond Myklebust / mtk
        Since kernel 2.6.10, a read lease can only be placed on a 
            file descriptor that is opened read-only.
        See the following LKML thread of Aug 2005 
        ("fcntl(F GETLEASE) semantics??"):
        http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
        http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
        http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
        http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2

mprotect.2
    mtk
        Add new text to ENOMEM error

mremap.2
    mtk
        Added description of MREMAP_FIXED and 'new_address' argument
            under NOTES.
        Revised text of EINVAL error.

read.2
    Samuel Thibault / mtk
        read() can fail with EINVAL when using O_DIRECT
    mtk
        Added open(2) to SEE ALSO
        
shmget.2
    mtk
        s/int/size_t/ for type of 'size' argument (fix from 
            Fedora man-pages-2.07-7).

write.2
    Samuel Thibault / mtk
        write() can fail with EINVAL when using O_DIRECT
        
atanh.3
    mtk
        Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7)

fopen.3
    mtk
        Improved "a+" description (fix from Fedora man-pages-2.07-7).

getrpcent.3
    mtk
        s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
        
stdio.3
    mtk / Justin Pryzby
        Removed references to fropen() and fwopen(), which are 
            BSDisms that don't appear in glibc.
            As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
    
strftime.3
    mtk
        Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from 
            Fedora man-pages-2.07-7).

nsswitch.conf.5
    mtk
        s/network/networks/ (fix from Fedora man-pages-2.07-7).

proc.5
    mtk
        Added description of /proc/sys/vm/legacy_va_layout.

socket.7
    mtk 
        Update description of SO_RCVLOWAT and SO_SNDLOWAT.
        (fix derived from Fedora man-pages-2.07-7).


==================== Changes in man-pages-2.10 ====================

Released: 2005-10-19

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

The changes in this release consist *solely* of formatting fixes, with 
the aim bringing greater consistency to the manual pages according to 
the following rules:

-- Function name references should *always* be followed by 
   parentheses, "()" (possibly containing a manual page section
   number).

-- The parentheses following a function name should *not* be 
   formatted.  Thus, for example, instead of:

       .B name()

   one should write:

       .BR name ()

Much of the change was automated using two scripts: 
add_parens_for_own_funcs.sh and unformat_parens.sh.
For the (possible) benefit of downstream manual page maintainers and 
translators, I have placed these scripts in a new subdirectory 'scripts'.

NOTE THE FOLLOWING POINTS WELL:

-- These scripts provide a computer-assisted solution to the above
   two goals.  However, they are not perfect, and their output should
   be scanned by a human.  (To see what changes the two scripts 
   *would* make, without making them, use the "-n" command line option.)

-- The scripts do not fix all instances that violate the above rules:
   some manual fixes are required.  Two further scripts are provided
   to help find remaining instances of function names without 
   following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.

The following changes were made:

-- add_parens_for_own_funcs.sh was applied to the pages in Sections 
   2 and 3.

-- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7 
   (the only sections where such changes were required).

-- further changes (not so very many) were performed by hand.
   (found places to fix with the assistance of find_dots_no_parens.sh 
   and find_slashes_no_parens.sh).


==================== Changes in man-pages-2.11 ====================

Released: 2005-10-24

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

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

Alain PORTAL <aportal@univ-montp2.fr>

Apologies if I missed anyone!

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

Most instances of the constant "NULL" are not formatted (bolded) in 
man pages, but a few are.  For consistency, formatting on "NULL" has 
been removed where it occurred.

Many minor formatting fixes were made.

Typographical or grammatical errors have been corrected in several
places.


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

getrlimit.2
    mtk
        Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().

path_resolution.2
    mtk
        Repaired discussion of capabilities and file system UID, which
        mistakenly had involved exec() in the discussion.
  
prctl.2
    mtk
        Removed text saying there is no library interface.  There 
        is nowadays.

mkfifo.3
    mtk
        Minor change to RETURN VALUE text.

sk98lin.4
    Alain Portal
        Formatting fixes

capabilities.7
    mtk
        Minor changes


==================== Changes in man-pages-2.12 ====================

Released: 2005-10-31

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

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

Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
herbert@gondor.apana.org.au
Martin Landers <martin.landers@treibgut.net>
Michael Benedict <benedict@starbak.net>

Apologies if I missed anyone!

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

Typographical or grammatical errors have been corrected in several
places.


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

mlock.2
    mtk
        Reworded text around PAGESIZE, noting also that 
        sysconf(_SC_PAGESIZE) can be used.

path_resolution.2
   mtk / aeb
       Removed words "as well" (added in 2.11) from the phrase
       "and it gets these last five capabilities if its fsuid is 0 as well"
       since there are (unusual) situations in which fsuid can be 0 while
       the effective UID is not.

       Reworked (cut down) discussion of capabilities, moving part of 
       it into capabilities.7

setresuid.2
    mtk
        Add text to note that setresuid() always modifies the file 
        system UID, and setresgid() likewise always modifies the file 
        system GID.

shmget.2
    mtk
        Added (brief) description of SHM_HUGETLB.

sigaltstack.2
    mtk / Martin Landers
        Noted that ss_sp is automatically aligned by the kernel.

byteorder.3
    Brian M. Carlson  / herbert@gondor.apana.org.au
        Change <netinet/in.h> to <arpa/inet.h> in prototype; add text 
            explaining that some systems need the former header.
            As per Debian bug 265244

capabilities.7
    mtk
        Reworked part of the discussion of exec() and capabilities.
        Added sub-section "Effect of User ID Changes on Capabilities".
        Reworked discussion of CAP_SYS_ADMIN and file-max.


==================== Changes in man-pages-2.13 ====================

Released: 2005-11-03

This release consists entirely of formatting and typographical fixes.

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

Typographical or grammatical errors have been corrected in several
places.

Function and page cross references that were italicised were made bold
(which is how the majority of function and page cross references 
were already done).

Instances of things like "NULL-terminated string" were changed to
"null-terminated string".

Pathnames, structures, arguments, and <header-files> that were bold 
were changed to italics.

Instances of the constant "NULL" that were bold-faced were made 
unformatted (which is how most instances of "NULL" were already
formatted.)


==================== Changes in man-pages-2.14 ====================

Released: 2005-11-17

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

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

Angelo <ang3l0@katamail.com>
Avery Pennarun <apenwarr@nit.ca>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Martin (Joey) Schulze <joey@infodrom.org>
Stefan Brüns <stefan.bruens@rwth-aachen.de>
Volker Reichelt <reichelt@igpm.rwth-aachen.de>

Apologies if I missed anyone!

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

Typographical or grammatical errors have been corrected in several
places.

New pages
---------

rexec.3
    mtk / Justin Pryzby
         This page is taken as is from the FreeBSD 5.4 distribution.
         (Not checked against Linux reality, but likely things are 
         the same.)
         See also Debian bug 336875.
         
Changes to individual pages
---------------------------

arch_prctl.2
    mtk
        Updated discussion about lack of prototype in glibc.

execve.2
    mtk
        Improved description of E2BIG error: it relates to the sum
        of the bytes in both environment and argument list.

fcntl.2
    mtk
        Clarified parts of the discussion of file leases,
        noting effect of open(O_NONBLOCK), interruption
        by signal handler, or termination by signal in
        lease breaker.
        In response to Debian bug 339037.

stat.2
    mtk / Stefan Brüns
        Added LINUX NOTES describing nanosecond timestamps.

frexp.3
    Volker Reichelt / mtk
        Fixed to point out that that frexp() returns a number whose 
        *absolute* value is >= 0.5 and < 1.  Amended the example 
        program to demonstrate this.

open.2 
    mtk / Avery Pennarun
        Add EWOULDBLOCK error for file leases.
        In response to Debian bug 339037.

putenv.3
    mtk
        Although the glibc implementation returns -1 on error (and some 
        other man pages (e.g., the BSDs) also document that value for 
        error returns), SUSv3 merely says "non-zero" (and this is
        what manual pages on many implementations also say).

posix_memalign.3
    mtk
        Formerly, the page said that all systems declare memalign() in 
        <malloc.h>.  In fact, many declare it in <stdlib.h>.

strtok.3
    mtk
        Almost a complete rewrite after Angelo pointed out 
        that the existing page was deficient.

sd.4
    Martin Schulze    
        Remove SEE ALSO for non-existent scsi.4.

proc.5
    mtk
        Updated discussion of /proc/sys/kernel/pid_max.

signal.7
    mtk
        Added pthreads.7 to SEE ALSO.
        
ld.so.8
    mtk
        Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/


==================== Changes in man-pages-2.15 ====================

Released: 2005-11-30

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

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

Andries Brouwer <Andries.Brouwer@cwi.nl>
James Vega <jamessan@debian.org>
Malcolm Scott <mas90@io.malc.org.uk>
Senthil Kumar <senthilkumar_sen@hotpop.com>

Apologies if I missed anyone!

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

Typographical or grammatical errors have been corrected in several
places.

New pages
---------

sigvec.3 -- for details, see below.

sigset.3 -- for details, see below.

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

kill.2
    mtk
        Added text describing the 2.6.[0-7] EPERM bug that occurred 
        when sending signals to a process group.

sigaction.2
   mtk
      Noted that si_signo is unused on Linux.

sigpending.2
    mtk
        Added BUGS noting wrapper function problem that existed
        in glibc versions <= 2.2.1.

sigpause.2
    mtk
        Moved to section 3; see also sigpause.3 below.

sigsetops.3
    mtk
        Added a GLIBC NOTES section describing sigisemptyset(), 
        sigandset(), and sigorset().

sigvec.2
sigblock.2
    mtk
        These pages have been deleted, and replaced by a new sigvec.3 
        man page that more fully describes the BSD signal API.

siggetmask.2
sigmask.2
sigsetmask.2
    mtk
        These links to the now-deleted sigblock.2 have been also been 
        deleted.  They are replaced by corresponding links in Section 3:
        sigmask.3, sigsetmask.3, siggetmask.3.

sigvec.3
    mtk
        This new page is provides a fuller description of the
        BSD signal API than was provided in the now-deleted sigvec.2
        and sigblock.2.
        
sigblock.3
siggetmask.3
sigmask.3
sigsetmask.3
    mtk
        Created as links to sigvec.3.

sigpause.3
    mtk
        Moved here from Section 2.

        Some minor wording fixes; clarified System V origins of 
        X/Open flavour of this function.

sigset.3
    mtk
        New page describing the System V signal API: sigset(), sighold(), 
        sigrelse(), sigignore().

strftime.3
    James Vega
        Add further text clarifying that %+ specifier is not supported in 
        glibc2.
    mtk
        Added GLIBC NOTES section describing optional 'flag' and 'width' 
            components of conversion specifiers.
        Some wording changes to bring terminology closer to SUSv3.
        Added an example program.

vm86old.2
   mtk / aeb
       Add as new linik to vm86.2.

intro.7
    mtk
        Added a few words to reflect the fact that several of the section
        7 pages provide overviews of various topics.

signal.7
    mtk
        Added some SEE ALSO entries.
       
socket.7
    Senthil Kumar / mtk
        Added text noting that select()/poll() do not respect SO_RCVLOWAT.

udp.7
    Malcolm Scott
       s/tcp_socket/udp_socket/ in example
       Fixes Debian bug 340927


==================== Changes in man-pages-2.16 ====================

Released: 2005-12-02

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

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

Alan Stern <stern@rowland.harvard.edu>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Urs Thuermann <urs@isnogud.escape.de>

Apologies if I missed anyone!

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

Typographical or grammatical errors have been corrected in several
places.


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

HOWTOHELP
    Urs Thuermann
        Added instructions for finding maintainer in Debian package.

poll.2
   mtk
       Added NOTES about INFTIM contant provided on some other 
       implementations.
       
shmop.2
    Alan Stern
        The -1 error return of shmat() should be cast "(void *)".
    
strftime.r
    aeb
        Remove junk text (actually intended as source code comment 
        in page).

ip.7
    Urs Thuermann
        Fix a typo: s/SOCK_RAW/SOCK_PACKET/

packet.7
    Urs Thuermann
        Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%


==================== Changes in man-pages-2.17 ====================

Released: 2005-12-13

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

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

Justin Pryzby <justinpryzby@users.sourceforge.net>
Michael Haardt <michael@moria.de>
Urs Thuermann <urs@isnogud.escape.de>
Walter Harms <walter.harms@informatik.uni-oldenburg.de>

Apologies if I missed anyone!


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

Typographical or grammatical errors have been corrected in several
places.


New pages
---------

fmemopen.3
    Walter Harms / mtk
        New documentation for the glibc-specific fmemopen() and
        open_memstream().  Based on glibc info page.

open_memstream.3
    mtk
        New link to new fmemopen.3

pipe.7
    mtk (with prompting and suggestions for improvements by 
    Michael Haardt)
        New page providing overview of pipes and FIFOs.
        

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

HOWTOHELP
    mtk
        Added notes on how to write example programs for manual pages.

fork.2
    mtk
        Added pointers to examples of fork() in wait.2 and pipe.2.

pipe.2
    mtk
       Added an example program.
       Added SEE ALSO for new pipe.7 page.

wait.2
    mtk
        Added example program demonstrating use of fork() and waitpid().

carg.3
    Justin Pryzby
        Delete line that should have been deleted when applying 
        2.08 fix for this page. 

getaddrinfo.3
    mtk
        Rearranged EAI_* list alphabetically.

inet.3
    mtk
        Added GLIBC NOTES describing feature test macros required
        to expose declaration of inet_aton().

fifo.4
   mtk
       Added SEE ALSO for new pipe.7 page.

environ.5
    mtk
        Removed BROWSER, since it seems not in fact to be common.

socket.7
    Urs Thuermann
        Added documentation of SO_TIMESTAMP.

tcp.7
    mtk
        Noted 200 millisecond ceiling imposed on TCP_CORK.

udp.7
    mtk
        Rearranged options into something approximating alphabetical order.