Start of man-pages-3.18: updating Changes and Changes.old

This commit is contained in:
Michael Kerrisk 2009-01-19 17:33:04 +13:00
parent 72c0b5a904
commit 32e2ca460b
2 changed files with 255 additions and 219 deletions

223
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.17 ====================
==================== Changes in man-pages-3.18 ====================
Released: 2009-01-19, Hobart
Released: ????-??-??, Christchurch
Contributors
@ -9,17 +9,6 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Adeodato Simó <dato@net.com.org.es>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Davide Libenzi <davidel@xmailserver.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
Mads Martin Joergensen <mmj@mmj.dk>
Marc Lehmann <schmorp@schmorp.de>
Martin (Joey) Schulze <joey@infodrom.org>
Michael Kerrisk <mtk.manpages@gmail.com>
Petr Baudis <pasky@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Vegard Nossum <vegard.nossum@gmail.com>
Apologies if I missed anyone!
@ -27,223 +16,19 @@ 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
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
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
---------------------------------------------
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
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
Global changes
--------------
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
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
Michael Kerrisk
Various wording changes to improve clarity and consistency

View File

@ -17306,3 +17306,254 @@ nscd.8
glibc-2.1 and glibc-2.1.3 when nscd -i was not available,
I don't think it's worth muddling the point of the page
with that, though.
==================== 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ó <dato@net.com.org.es>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Davide Libenzi <davidel@xmailserver.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
Mads Martin Joergensen <mmj@mmj.dk>
Marc Lehmann <schmorp@schmorp.de>
Martin (Joey) Schulze <joey@infodrom.org>
Michael Kerrisk <mtk.manpages@gmail.com>
Petr Baudis <pasky@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Vegard Nossum <vegard.nossum@gmail.com>
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
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
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
---------------------------------------------
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
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
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
Michael Kerrisk
Various wording changes to improve clarity and consistency