man-pages-3.17 released

DISCUSSION Michael Kerrisk 1 participant 1 message Jan 21, 2009 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore

Share & tools

lore

Michael Kerrisk

author

2009-01-21 12:25 UTC #0 lore raw

Gidday,

The Linux man-pages maintainer proudly announces:

man-pages-3.17.tar.gz - man pages for Linux

This release is now available for download at:

http://www.kernel.org/pub/linux/docs/man-pages
or ftp://ftp.kernel.org/pub/linux/docs/man-pages

The online changelog is available at
http://www.kernel.org/doc/man-pages/changelog.html
(blogged at
http://linux-man-pages.blogspot.com/2009/01/man-pages-317-is-released.html)
and the current version of the pages is browsable at
http://www.kernel.org/doc/man-pages/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to [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.17 ====================

Released: 2009-01-19, Hobart

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

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

Adeodato Simó <[email protected]> Bastien ROUCARIES <[email protected]> Davide Libenzi <[email protected]> Lefteris Dimitroulakis <[email protected]> Mads Martin Joergensen <[email protected]>
Marc Lehmann <[email protected]> Martin (Joey) Schulze <[email protected]> Michael Kerrisk <[email protected]> Petr Baudis <[email protected]>
Sam Varshavchik <[email protected]> Vegard Nossum <[email protected]>

Apologies if I missed anyone!

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

endian.3
Michael Kerrisk
New page documenting byte order conversion functions
Document functions (new in glibc 2.9) for conversion between host byte order and big-/little- endian byte order:
htobe16(), htole16(), be16toh(), le16toh(), htobe32(), htole32(), be32toh(), le32toh(), htobe64(), htole64(), be64toh(), le64toh()

getifaddrs.3
Petr Baudis
New page documenting getifaddrs(3) and freeifaddrs(3)
Many edits and changes of Petr's initial draft by mtk

cp1251.7
Lefteris Dimitroulakis
New page documenting CP 1251 (Windows Cyrillic) character set

iso-8859-10.7
Lefteris Dimitroulakis
New page documenting ISO 8859-10 character set

iso_8859-13.7
Lefteris Dimitroulakis
New page documenting ISO 8859-13 character set

iso_8859-14.7
Lefteris Dimitroulakis
New page documenting ISO 8859-14 character set

iso_8859-3.7
Lefteris Dimitroulakis
New page documenting ISO 8859-3 character set

iso_8859-5.7
Lefteris Dimitroulakis
New page documenting ISO 8859-5 character set

iso_8859-8.7
Lefteris Dimitroulakis
New page documenting ISO 8859-8 character set

koi8-u.7
Lefteris Dimitroulakis
New page documenting KOI8-U character set

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

epoll.7
Michael Kerrisk
Document /proc interfaces for limiting kernel memory usage
Document the following /proc files that were added in Linux 2.6.28:
/proc/sys/fs/epoll/max_user_instances /proc/sys/fs/epoll/max_user_watches

netdevice.7

    Michael Kerrisk
        Document recently added interface flags
            IFF_LOWER_UP (since Linux 2.6.17)
            IFF_DORMANT (since Linux 2.6.17)
            IFF_ECHO (since Linux 2.6.25)

            Documentation taken from comments in <linux/if.h>

New and changed links
---------------------

freeifaddrs.3
Michael Kerrisk
New link to new getifaddrs.3

htobe16.3
htole16.3
be16toh.3
le16toh.3
htobe32.3
htole32.3
be32toh.3
le32toh.3
htobe64.3
htole64.3
be64toh.3
le64toh.3
Michael Kerrisk
New links to new endian.3

iso-8859-10.7
iso_8859_10.7
latin6.7

    Michael Kerrisk
        New links to new iso_8859-10.7

iso-8859-13.7
iso_8859_13.7
latin7.7

    Michael Kerrisk
        New links to new iso_8859-13.7

iso-8859-14.7
iso_8859_14.7
latin8.7

    Michael Kerrisk
        New links to new iso_8859-14.7

iso-8859-3.7
iso_8859_3.7
latin3.7

    Michael Kerrisk
        New links to new iso_8859-3.7

iso-8859-5.7
iso_8859_5.7

    Michael Kerrisk
        New links to new iso_8859-5.7

iso-8859-8.7
iso_8859_8.7

    Michael Kerrisk
        New links to new iso_8859-8.7

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

bind.2
Michael Kerrisk
SEE ALSO: Add getifaddrs(3)

epoll_create.2
Michael Kerrisk
Document EMFILE error
This error is encountered when the limit imposed by /proc/sys/fs/epoll/max_user_instances is encountered.
Michael Kerrisk
Clarify distinction between epoll instance and epoll file descriptor
Reword so that the notion of an epoll instance is made clear, and made distinct from the notion of an epoll file descriptor. Some other minor rewordings also.

epoll_ctl.2
Michael Kerrisk
Reordered parts of the text
Michael Kerrisk
Introduce notion of epoll instance
Introduce notion of epoll instance as distinct from epoll file descriptor. Plus other wording clean-ups.
Michael Kerrisk
Document ENOSPC error (new in Linux 2.6.28)
This error results when the limit imposed by /proc/sys/fs/epoll/max_user_watches is encountered.

epoll_wait.2
Michael Kerrisk
Introduce the notion of an epoll instance into text

getdents.2
Michael Kerrisk
Before kernel < 2.6.4, 'd_type' was effectively always DT_UNKNOWN

gethostid.2
Michael Kerrisk
Rename file (was misnamed gethostd.2 in previous release)

getsockname.2
Michael Kerrisk
SEE ALSO: Add getifaddrs(3)

signalfd.2
Michael Kerrisk
Fix description of fork() semantics
The page text described the semantics of the initial implementation of signalfd(). These were changed early on, but the man page wasn't updated.

byteorder.3
Michael Kerrisk
SEE ALSO: add endian(3)

longjmp.3
Michael Kerrisk
Clarify wording re saving/restoring signal mask
Michael Kerrisk
siglongjmp() restores signal mask iff 'savesigs' was non-zero
Note that siglongjmp() restores signal mask if, and only if, 'savesigs' argument of sigsetjmp() was non-zero. (Previous text omitted the "and only if".)

memccpy.3
Michael Kerrisk
Fix CONFORMING TO: s/C99/POSIX.1-2001/
Michael Kerrisk
If the memory areas overlap, the results are undefined

sethostid.3
Michael Kerrisk
Rename file (was misnamed sethostd.3 in previous release)

setjmp.3
Michael Kerrisk
Clarify wording re saving/restoring signal mask
Michael Kerrisk
Clarify when setjmp() provides BSD vs System V signal mask semantics

strsep.3
Michael Kerrisk
BUGS: explicitly list problems afflicting strsep()
Previously, the page said this function suffered the same problems as strtok(), but in fact strsep() doesn't suffer from all of the same problems as strtok(), so explicitly list just the problems of strsep() in the strsep.3 page.

proc.5
Michael Kerrisk
Add pointer to epoll(7) for description of epoll /proc files

epoll.7
Michael Kerrisk
Various wording changes to improve clarity and consistency

--
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