man-pages-2.29 is released

Michael Kerrisk
2006-04-08T21:07:38Z

Gidday,

I recently released man-pages-2.29, which can be found at the
location in the .sig. A list of some notable changes can be found
further down in this message

*** A request ***

Manual pages for the follwoing system calls are notably absent
from the man-pages set. Contributions would be most welcome.

add_key(2) (new in kernel 2.6.10)
keyctl(2) (new in kernel 2.6.10)
request_key(2) (new in kernel 2.6.10)
See:
Documentation/keys.txt
Documentation/keys-request-key.txt

ioprio_get(2) (new in kernel 2.6.13)
ioprio_set(2) (new in kernel 2.6.13)
See:
Documentation/block/ioprio.txt

restart_syscall(2) (new in kernel 2.6)

kexec_load(2) (new in kernel 2.6.13)

migrate_pages(2) (new in kernel 2.6.16)
See Documentation/vm/page_migration

2.29 Changes
============

Changes in this release that may be of interest to readers
of this list include the following:

New pages
---------

mkdirat.2
mtk
New page describing mkdirat(2), new in 2.6.16.

mknodat.2
mtk
New page describing mknodat(2), new in 2.6.16.

core.5
mtk
New page describing core dump files.

mkfifoat.3
mtk
New page describing mkfifoat(3).

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

getrlimit.2
mtk
Added BUGS text on 2.6.x handling of RLIMIT_CPU limit
of zero seconds. See
http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2

==========

The man-pages set contains sections 2, 3, 4, 5, and 7 of
the manual pages. These sections describe the following:

2: (Linux) system calls
3: (libc) library functions
4: Devices
5: File formats and protocols
7: Overview pages, conventions, etc.

As far as this list is concerned the most relevant parts are:
all of sections 2 and 4, which describe kernel-userland interfaces;
in section 5, the proc(5) manual page, which attempts (it's always
catching up) to be a comprehensive description of /proc; and
various pages in section 7, some of which are overview pages of
kernel features (e.g., networking protocols).

If you make a change to a kernel-userland interface, or observe
a discrepancy between the manual pages and reality, would you
please send me (at mtk-manpages@gmx.net ) one of the following
(in decreasing order of preference):

1. An in-line "diff -u" patch with text changes for the
corresponding manual page. (The most up-to-date version
of the manual pages can always be found at
ftp://ftp.win.tue.nl/pub/linux-local/manpages or
ftp://ftp.kernel.org/pub/linux/docs/manpages .)

2. Some raw text describing the changes, which I can then