man-pages-3.58 released

Gidday,

The Linux man-pages maintainer proudly announces:

man-pages-3.58 - man pages for Linux

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_3.58

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2014/02/man-pages-358-is-released.html

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

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man-u79uwXL29TaiAVqoAR/[email protected]

c) I have information (possibly inaccurate) that you are the maintainer of a translation of the manual pages, or are the maintainer of the manual pages set in a particular distribution, or have expressed interest in helping with man-pages maintenance, or have otherwise expressed interest in being notified about man-pages releases. If you don't want to receive such messages from me, or you know of some other translator or maintainer who may want to receive such notifications, send me a message.

Cheers,

Michael

==================== Changes in man-pages-3.58 ====================

Released: 2014-02-11, Munich

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

The following people contributed patches/fixes or (noted in brackets in the changelog below) reports, notes, and ideas that have been incorporated in changes in this release:

Cyril Hrubis <[email protected]>
Daniel Borkmann <[email protected]> David Prévot <[email protected]> Fabrice Bauzac <[email protected]> Michael Kerrisk <[email protected]> Mike Frysinger <[email protected]> Network Nut <[email protected]> Ola Olsson <[email protected]> Peng Haitao <[email protected]> Peter Schiffer <[email protected]> Simone Piccardi <[email protected]> Simon Paillard <[email protected]> Yuri Kozlov <[email protected]> Марк Коренберг <[email protected]> 未卷起的浪 <[email protected]>

Apologies if I missed anyone!

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

pipe.2
Michael Kerrisk
Document the pipe2() O_DIRECT flag added in Linux 3.4

packet.7

    Daniel Borkmann
        Document PACKET_QDISC_BYPASS
            New in Linux 3.14.

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

Various pages
Simon Paillard
Formatting fix: add space between function and () if BR or IR
Detected through the regex:
git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'

Various pages
Simon Paillard
Formatting fix: add space between word and punctuation if BR or IR
Detected through the regex:
git grep -P '^\.(BR|IR) [^ ]*[,\.]$'

Could probably be extended to match more cases and fix in perl.

Various pages
Michael Kerrisk
Use Oxford comma

gettid.2
restart_syscall.2
passwd.5
socket.7
Michael Kerrisk
Fix order of SEE ALSO entries

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

epoll_wait.2
Michael Kerrisk [Network Nut]
Remove word "minimum" from the description of 'timeout'

epoll_wait.2
poll.2
select.2
Michael Kerrisk
Go into more detail on timeout and when call will cease blocking

getxattr.2
listxattr.2
removexattr.2
setxattr.2
Michael Kerrisk [Fabrice Bauzac]
Correct header file is <sys/xattr.h> (not <xattr/xattr.h>)
See https://bugzilla.kernel.org/show_bug.cgi?id=70141

msgctl.2
Cyril Hrubis
Add note about ignored arg to IPC_RMID

prctl.2
Michael Kerrisk [Марк Коренберг]
PR_SET_PDEATHSIG value is preserved across execve(2)

recv.2
Michael Kerrisk
Rework and reorganize the text in various parts of the page. Isolate details specific to recv() vs recvfrom() vs recvmsg()
Place details specific to each system call under a
a separate subheading.
Rework discussion of 'src_addr' and 'addrlen' for recvfrom() Add description of 'buf' and 'len' in recvfrom() section 'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL Improve text describing recvfrom() call that is equivalent to recv()
Michael Kerrisk [未卷起的浪]
Describe the various cases where the return value can be 0

shmctl.2
Michael Kerrisk
Note that 'buf' is ignored for IPC_RMID

symlinkat.2
Michael Kerrisk
Make argument names consistent with symlink(2) page

isalpha.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions isalnum(), isalpha(), isascii(), isblank(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper() and isxdigit() are thread safe.

isatty.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function isatty() is thread safe.

isgreater.3
Peng Haitao
ATTRIBUTES: Note macros that are thread-safe
The macros isgreater(), isgreaterequal(), isless(), islessequal(), islessgreater() and isunordered() are thread safe.

iswalnum.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function iswalnum() is thread safe with exceptions.

iswalpha.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function iswalpha() is thread safe with exceptions.

iswblank.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function iswblank() is thread safe with exceptions.

iswcntrl.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function iswcntrl() is thread safe with exceptions.

lockf.3
Michael Kerrisk [Simone Piccardi]
Fix incorrect argument mentioned under EINVAL error

pthread_kill.3
Michael Kerrisk
Add feature test macro requirements

pthread_sigmask.3
Michael Kerrisk
Add feature test macro requirements

strtoul.3
Peng Haitao
ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtoul(), strtoull() and strtouq() are thread safe with exceptions.

nscd.conf.5
Peter Schiffer
Add note about default values

proc.5
Michael Kerrisk
SEE ALSO: Add some further kernel Documentation/sysctl files

man-pages.7
Michael Kerrisk
ATTRIBUTES sections come after VERSIONS
Peng Haitao has consistently ordered the ATTRIBUTES after VERSIONS, so adjust the text in man-pages.7

vdso.7
Michael Kerrisk
Add words "virtual dynamic shared object" in DESCRIPTION

Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html