man-pages-4.05 is released

[Michael Kerrisk (man-pages)]

Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-4.05 - man pages for Linux

This release includes input and contributions from
nearly 70 people. Over 400 pages saw changes, ranging
from typo fixes through to page rewrites and newly
created pages.

Tarball download:
    http://www.kernel.org/doc/man-pages/download.html
Git repository:
    https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
    http://man7.org/linux/man-pages/changelog.html#release_4.05

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2016/03/man-pages-405-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

A selection of changes in this release that may be of interest
yo readers on LKML is shown below.

Cheers,

Michael


==================== Changes in man-pages-4.05 ====================


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

copy_file_range.2
    Anna Schumaker  [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk]
        New page documenting copy_file_range()

personality.2
    Michael Kerrisk
        This page has been greatly expanded, to add descriptions of
        personality domains.

fmemopen.3
    Michael Kerrisk  [Adhemerval Zanella]
        Significant reworking of this page:
        * Rework discussion of the (obsolete) binary mode
        * Split open_memstream(3) description into a separate page.
        * Note various fmemopen() bugs that were fixed in glibc 2.22
        * Greatly expand description of 'mode' argument
        * Rework description of 'buf' and 'len' arguments
        * Expand discussion of "current position" for fmemopen() stream

ntp_gettime.3
    Michael Kerrisk
        New page describing ntp_gettime(3) and ntp_gettimex(3)

open_memstream.3
    Michael Kerrisk
        New page created by split of fmemopen(3).
        At the same time, add and rework a few details in the text.

posix_spawn.3
    Bill O. Gallmeister, Michael Kerrisk
        New man page documenting posix_spawn(3) and posix_spawnp(3)

readdir.3
    Michael Kerrisk  [Florian Weimer]
        Split readdir_r() content into separate page
    Michael Kerrisk
        Near complete restructuring of the page and add some further details
    Michael Kerrisk  [Florian Weimer, Rich Felker, Paul Eggert]
        Add a lot more detail on portable use of the 'd_name' field

readdir_r.3
    Michael Kerrisk  [Florian Weimer]
        New page created after split of readdir(3).
    Michael Kerrisk  [Florian Weimer]
        Explain why readdir_r() is deprecated and readdir() is preferred

lirc.4
    Alec Leamas
        New page documenting lirc device driver


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

epoll_ctl.2
    Michael Kerrisk  [Jason Baron]
        Document EPOLLEXCLUSIVE

madvise.2
    Minchan Kim  [Michael Kerrisk]
        Document MADV_FREE
            Document the MADV_FREE flag added to madvise() in Linux 4.5.

proc.5
    Michael Kerrisk
        Document CmaTotal and CmaFree fields of /proc/meminfo
    Michael Kerrisk
        Document additional /proc/meminfo fields
            Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G
    Michael Kerrisk
        Document MemAvailable /proc/meminfo field
    Michael Kerrisk
        Document inotify /proc/PID/fdinfo entries
    Michael Kerrisk
        Document fanotify /proc/PID/fdinfo entries
    Michael Kerrisk
        Add some kernel version numbers for /proc/PID/fdinfo entries
    Michael Kerrisk  [Patrick Donnelly]
        /proc/PID/fdinfo displays the setting of the close-on-exec flag
            Note also the pre-3.1 bug in the display of this info.

socket.7
    Craig Gallek  [Michael Kerrisk, Vincent Bernat]
        Document some BPF-related socket options
            Document the behavior and the first kernel version for each of the
            following socket options:

                SO_ATTACH_FILTER
                SO_ATTACH_BPF
                SO_ATTACH_REUSEPORT_CBPF
                SO_ATTACH_REUSEPORT_EBPF
                SO_DETACH_FILTER
                SO_DETACH_BPF
                SO_LOCK_FILTER


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

Many, many pages
    Michael Kerrisk
        Update, simplify and correct feature test macro requirements


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

adjtimex.2
    Michael Kerrisk  [John Stultz]
        Various improvements after feedback from John Stultz


syscall.2
    Mike Frysinger
        Add more architectures and improve error documentation
            Move the error register documentation into the main table rather
            than listing them in sentences after the fact.

            Add sparc error return details.

            Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
            tile/xtensa.

feature_test_macros.7
    Michael Kerrisk
        Add a summary of some FTM key points
    Michael Kerrisk
        Give an early hint about some macros being defined by default
    Michael Kerrisk
        Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
            Emphasize that defining _XOPEN_SOURCE >=500 produces same
            effects as defining  _XOPEN_SOURCE_EXTENDED.
    Michael Kerrisk
        Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
            As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
            has generally been removed from the man pages.
    Michael Kerrisk
        Note effects of "cc -std=c99" and "cc -std=c11"
    Michael Kerrisk
        Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
    Michael Kerrisk
        Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
            Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
            in the standard.

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/