mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-3.21: updating Changes and Changes.old
This commit is contained in:
parent
15432f81ba
commit
7650b3fbe5
412
Changes
412
Changes
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-3.20 ====================
|
||||
==================== Changes in man-pages-3.21 ====================
|
||||
|
||||
Released: 2009-03-31, Christchurch
|
||||
Released: ????-??-??, Christchurch
|
||||
|
||||
|
||||
Contributors
|
||||
|
@ -9,30 +9,6 @@ Contributors
|
|||
The following people contributed notes, ideas, or patches that have
|
||||
been incorporated in changes in this release:
|
||||
|
||||
Alan Curry <pacman@kosh.dhis.org>
|
||||
Américo Wang <xiyou.wangcong@gmail.com>
|
||||
Andi Kleen <andi@firstfloor.org>
|
||||
Carlos O'Donell <carlos@systemhalted.org>
|
||||
Chunming Chang <cchang@aerohive.com>
|
||||
Colin Watson <cjwatson@debian.org>
|
||||
Eelco Dolstra <dolstra@tudelft.nl>
|
||||
Jan Engelhardt <jengelh@medozas.de>
|
||||
Jens Thoms Toerring <jt@toerring.de>
|
||||
Johannes Stezenbach <js@sig21.net>
|
||||
Leandro A. F. Pereira <leandro@tia.mat.br>
|
||||
Martin Gebert <martin.gebert@alpha-bit.de>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Miike O'Connor <stew@vireo.org>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Nikanth Karthikesan <knikanth@suse.de>
|
||||
Reuben Thomas <rrt@femur.dyndns.org>
|
||||
Reuben Thomas <rrt@sc3d.org>
|
||||
Roland McGrath <roland@redhat.com>
|
||||
Sam Varshavchik <mrsam@courier-mta.com>
|
||||
Simon Gomizelj <simongmzlg@gmail.com>
|
||||
Tanaka Akira <akr@fsij.org>
|
||||
Teddy Hogeborn <teddy@fukt.bsnet.se>
|
||||
Walter Jontofsohn <wjontofs@atriumberlin.de>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
@ -40,397 +16,19 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
cpuid.4
|
||||
Andi Kleen
|
||||
New page for cpuid access device
|
||||
|
||||
msr.4
|
||||
Andi Kleen
|
||||
New page documenting x86 CPU MSR access device
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
proc.5
|
||||
Américo Wang
|
||||
Document /proc/sys/vm/swappiness
|
||||
Michael Kerrisk
|
||||
Document /proc/sysrq-trigger
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
timer_create.2
|
||||
timer_delete.2
|
||||
timer_getoverrun.2
|
||||
timer_settime.2
|
||||
numa.7
|
||||
Michael Kerrisk
|
||||
Make source layout of 'Link with' text consistent with other pages
|
||||
No actual change to formatted output, but this makes the
|
||||
page sources more consistent for the purpose of grepping, etc.
|
||||
|
||||
mempcpy.3
|
||||
signbit.3
|
||||
significand.3
|
||||
Michael Kerrisk
|
||||
Global fix: acknowledge FSF in copyright
|
||||
These pages are heavily based on original material in
|
||||
glibc info pages, but the comments in the source of the pages
|
||||
did not acknowledge the FRF copyright on the original material.
|
||||
Fix that.
|
||||
|
||||
accept.2
|
||||
read.2
|
||||
recv.2
|
||||
send.2
|
||||
write.2
|
||||
Michael Kerrisk
|
||||
Fix discussion of EAGAIN/EWOULDBLOCK errors
|
||||
For a non-blocking socket, POSIX.1-2001/2008 allow either
|
||||
EAGAIN or EWOULDBLOCK to be returned in cases where a call
|
||||
would have blocked. Although these constants are defined
|
||||
with the same value on most Linux architectures (PA-RISC
|
||||
is the exception), POSIX.1 does not require them to have
|
||||
the same value. Therefore, a portable application using
|
||||
the sockets API should test for both errors when checking
|
||||
this case.
|
||||
|
||||
(NB POSIX.1 only mentions EWOULDBLOCK in the context of
|
||||
the sockets interfaces.)
|
||||
|
||||
Change made after a note cross-posted on linux-arch@vger,
|
||||
http://thread.gmane.org/gmane.linux.debian.ports.hppa/5615
|
||||
and a suggestion for write(2) from Carlos O'Donell
|
||||
|
||||
basename.3
|
||||
getgrent.3
|
||||
getgrnam.3
|
||||
getpwent.3
|
||||
getpwnam.3
|
||||
readdir.3
|
||||
Michael Kerrisk
|
||||
Note that returned pointer should not be given to free()
|
||||
|
||||
armscii-8.7
|
||||
cp1251.7
|
||||
iso_8859-10.7
|
||||
iso_8859-11.7
|
||||
iso_8859-13.7
|
||||
iso_8859-14.7
|
||||
iso_8859-15.7
|
||||
iso_8859-16.7
|
||||
iso_8859-2.7
|
||||
iso_8859-3.7
|
||||
iso_8859-4.7
|
||||
iso_8859-5.7
|
||||
iso_8859-6.7
|
||||
iso_8859-7.7
|
||||
iso_8859-8.7
|
||||
iso_8859-9.7
|
||||
koi8-r.7
|
||||
koi8-u.7
|
||||
Michael Kerrisk
|
||||
Add explicit character set encoding to first line of source
|
||||
Nowadays mandb has provision to understand a character set
|
||||
encoding that is explicitly indicated in the first line
|
||||
of the source. As pointed out by Colin Watson, including
|
||||
such an explicit indication on pages encoded in anything
|
||||
other than ISO 8859-1 or UTF-8 is useful for man-pages
|
||||
that aren't shipped in UTF-8.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519209
|
||||
and for some other background (responded to by Colin Watson
|
||||
in the above report):
|
||||
http://thread.gmane.org/gmane.comp.internationalization.linux/6040
|
||||
("man page encoding", 5 Jul 2005)
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
fallocate.2
|
||||
Michael Kerrisk
|
||||
VERSIONS: glibc support is provided since version 2.10
|
||||
|
||||
fcntl.2
|
||||
Michael Kerrisk
|
||||
Remove mention of EWOULDBLOCK from discussion of mandatory locking
|
||||
In the kernel, the error on encountering a mandatory lock is
|
||||
EAGAIN. Although EAGAIN and EWOULDBLOCK are the same on
|
||||
most Linux architectures, on some they are not, so don't
|
||||
mention EWOULDBLOCK as it is misleading. (Mea culpa.)
|
||||
|
||||
getcontext.2
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 removes the specification of getcontext()
|
||||
|
||||
getitimer.2
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends POSIX timers API instead of this API
|
||||
|
||||
gettimeofday.2
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends clock_gettime() instead of this API
|
||||
|
||||
ptrace.2
|
||||
Michael Kerrisk
|
||||
Note use of 'data' for PTRACE_SYS{CALL,EMU} and PTRACE_*_SINGLESTEP
|
||||
These operations use the 'data' argument as a signal number,
|
||||
like PTRACE_CONT.
|
||||
|
||||
ptrace.2
|
||||
Mike Frysinger
|
||||
only reference <sys/user.h>
|
||||
The kernel no longer installs linux/user.h, so update
|
||||
references to sys/user.h.
|
||||
|
||||
recv.2
|
||||
Michael Kerrisk
|
||||
Add 'iovec' defn to defn of 'msghdr' structure
|
||||
The 'msghdr' structure includes a field of type 'iovec',
|
||||
so show the definition of that structure in this page.
|
||||
|
||||
rename.2
|
||||
Michael Kerrisk
|
||||
Make ENOENT description consistent with POSIX.1-2008
|
||||
|
||||
timerfd_create.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EINVAL for invalid 'flags' for timer_settime()
|
||||
|
||||
truncate.2
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix description of feature test macro requirements
|
||||
After a report by Arvid Norlander.
|
||||
|
||||
bcopy.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 removes specification of bcopy()
|
||||
|
||||
bsd_signal.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sigaction(2) instead of this API
|
||||
|
||||
ctime.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends strftime(3) instead of these functions
|
||||
|
||||
ecvt.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sprintf(3) instead of these functions
|
||||
|
||||
gcvt.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sprintf(3) instead of this function
|
||||
|
||||
getcwd.3
|
||||
Michael Kerrisk
|
||||
Note that getcwd() should be used instead of the obsolete getwd()
|
||||
|
||||
getgrent.3
|
||||
Michael Kerrisk
|
||||
Returned buffer may be statically allocated and overwritten by
|
||||
later calls
|
||||
|
||||
gethostbyname.3
|
||||
Michael Kerrisk
|
||||
POSIX.1-2008 recommends getaddrinfo(3) and getnameinfo(3) instead
|
||||
|
||||
getnetent_r.3
|
||||
Michael Kerrisk
|
||||
Fix function name in text: s/getnetbynumber_r/getnetbyaddr_r/
|
||||
The SYNOPSIS showed the right function name (getnetbyaddr_r),
|
||||
but the text repeatedly used the wrong name (getnetbynumber_r).
|
||||
Probably, this was a cut-and-paste error.
|
||||
|
||||
getpwent.3
|
||||
Michael Kerrisk
|
||||
Returned buffer may be statically allocated and overwritten by
|
||||
later calls
|
||||
|
||||
index.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends strchr(3) and strrchr(3) instead
|
||||
|
||||
isalpha.3
|
||||
Michael Kerrisk
|
||||
Explain why POSIX.1-2008 marks isascii(3) obsolete
|
||||
|
||||
lockf.3
|
||||
Nikanth Karthikesan
|
||||
Update pointer to documentation in kernel source
|
||||
|
||||
makecontext.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends the use of POSIX threads instead
|
||||
|
||||
mq_notify.3
|
||||
Michael Kerrisk
|
||||
Document the POSIX.1-2008 optional EINVAL error
|
||||
POSIX.1-2008 allows an optional EINVAL error if
|
||||
notification==NULL and the caller is not currently
|
||||
registered to receive notifications.
|
||||
|
||||
posix_fallocate.3
|
||||
Michael Kerrisk
|
||||
Clarify that EINVAL also occurs of 'len' *equals* zero
|
||||
See http://bugzilla.kernel.org/show_bug.cgi?id=12919
|
||||
|
||||
posix_fallocate.3
|
||||
Michael Kerrisk
|
||||
Document POSIX.1-2001 and POSIX.1-2008 specifications for EINVAL error
|
||||
See http://bugzilla.kernel.org/show_bug.cgi?id=12919
|
||||
|
||||
posix_memalign.3
|
||||
Michael Kerrisk
|
||||
Document handling of size==0 case for posix_memalign()
|
||||
|
||||
pthread_exit.3
|
||||
Michael Kerrisk
|
||||
Fix error in DESCRIPTION: s/pthread_create/pthread_exit/
|
||||
|
||||
realpath.3
|
||||
Michael Kerrisk
|
||||
Rework resolved_path==NULL discussion w.r.t. POSIX.1-200[18]
|
||||
Although the page already mentioned the resolved_path==NULL
|
||||
feature, and that this feature was added in POSIX.1-2008, there
|
||||
was still some crufty text in BUGS that hadn't been updated to
|
||||
reflect the POSIX.1-2008 changes.
|
||||
|
||||
Also, some other minor wording and grammar fixes.
|
||||
|
||||
scalb.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends scalbln*(3) instead
|
||||
|
||||
seekdir.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix type of 'offset' argument: s/off_t/long/
|
||||
And add a NOTES section pointing out that 'off_t'
|
||||
was indeed used in glibc 2.1.1 and earlier.
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
|
||||
|
||||
sem_post.3
|
||||
Michael Kerrisk
|
||||
Document EOVERFLOW error
|
||||
|
||||
shm_open.3
|
||||
Michael Kerrisk
|
||||
Recast discussion on name length to exclude terminating NULL byte
|
||||
Probably it's clearer to describe the length of the IPC object
|
||||
name as a count that excludes the null terminator.
|
||||
|
||||
siginterrupt.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sigaction() instead
|
||||
|
||||
sigset.3
|
||||
Michael Kerrisk
|
||||
Note APIs that POSIX.1-2008 recommends instead of these obsolete APIs
|
||||
|
||||
strftime.3
|
||||
Michael Kerrisk
|
||||
Small fix to description of %G
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677
|
||||
|
||||
strftime.3
|
||||
Michael Kerrisk
|
||||
Add details on ISO 8601 week-based dates
|
||||
ISO 8602 week-based dates are relevant for %G, %g, and %V,
|
||||
and the existing details on these dates are a little thin.
|
||||
|
||||
strftime.3
|
||||
Michael Kerrisk
|
||||
Remove mention of year from ISO 8601 standard
|
||||
The text mentioned the 1988 8601 standard, but there have
|
||||
already been two revisions of the standard since then, so
|
||||
simply remove mention of the year.
|
||||
|
||||
telldir.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix return type: s/off_t/long/
|
||||
And add a NOTES section pointing out that 'off_t'
|
||||
was indeed used in glibc 2.1.1 and earlier.
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
|
||||
|
||||
timeradd.3
|
||||
Michael Kerrisk
|
||||
Note that on some systems, <=, >=, == don't work for timercmp()
|
||||
|
||||
timeradd.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix return types of timerisset() and timercmp()
|
||||
|
||||
toascii.3
|
||||
Michael Kerrisk
|
||||
Note why POSIX.1-2008 marks this function obsolete
|
||||
|
||||
console_ioctl.4
|
||||
Alan Curry
|
||||
Fix 'argp' type for KDGETLED description
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517485
|
||||
|
||||
group.5
|
||||
Michael Kerrisk
|
||||
Various minor rewordings and improvements
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Document 'ip6-bytestring' option
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Document 'edns0' option
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Document 'ip6-dotint' / 'no-ip6-dotint' option
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Note that maximum value of 'ndots' option is capped to 15
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Note that maximum value of 'timeout' option is capped to 30
|
||||
|
||||
hier.7
|
||||
Michael Kerrisk
|
||||
Add description of /srv
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=520904
|
||||
|
||||
ip.7
|
||||
Michael Kerrisk
|
||||
Fix type used to declare sin6_port
|
||||
The page should use the type specified by POSIX,
|
||||
rather than the (equivalent) type used in the kernel
|
||||
|
||||
ipv6.7
|
||||
Teddy Hogeborn
|
||||
Fix types used to declare sin6_family and sin6_port
|
||||
The page should use the types specified by POSIX,
|
||||
rather than the (equivalent) types used in the kernel.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517074
|
||||
|
||||
mq_overview.7
|
||||
Michael Kerrisk
|
||||
Recast discussion on name length to exclude terminating NULL byte
|
||||
Probably it's clearer to describe the length of the IPC object
|
||||
name as a count that excludes the null terminator.
|
||||
|
||||
rtld-audit.7
|
||||
Michael Kerrisk
|
||||
Note that multiple libraries in LD_AUDIT doesn't work
|
||||
This is reportedly fixed in glibc 2.10.
|
||||
See http://sourceware.org/bugzilla/show_bug.cgi?id=9733
|
||||
|
||||
sem_overview.7
|
||||
Michael Kerrisk
|
||||
Fix discussion of length of semaphore names
|
||||
Because of the "sem." prefix added by glibc to a semaphore
|
||||
name, the limit on the length of the name (excluding the
|
||||
terminating null byte) is 251 characters.
|
||||
|
|
438
Changes.old
438
Changes.old
|
@ -18114,3 +18114,441 @@ sem_overview.7
|
|||
Clarify construction rules for semaphore object names
|
||||
See also http://groups.google.com/group/comp.os.linux.development.apps/browse_thread/thread/b4a67caa765cb65f
|
||||
|
||||
|
||||
|
||||
==================== Changes in man-pages-3.20 ====================
|
||||
|
||||
Released: 2009-03-31, Christchurch
|
||||
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
The following people contributed notes, ideas, or patches that have
|
||||
been incorporated in changes in this release:
|
||||
|
||||
Alan Curry <pacman@kosh.dhis.org>
|
||||
Américo Wang <xiyou.wangcong@gmail.com>
|
||||
Andi Kleen <andi@firstfloor.org>
|
||||
Carlos O'Donell <carlos@systemhalted.org>
|
||||
Chunming Chang <cchang@aerohive.com>
|
||||
Colin Watson <cjwatson@debian.org>
|
||||
Eelco Dolstra <dolstra@tudelft.nl>
|
||||
Jan Engelhardt <jengelh@medozas.de>
|
||||
Jens Thoms Toerring <jt@toerring.de>
|
||||
Johannes Stezenbach <js@sig21.net>
|
||||
Leandro A. F. Pereira <leandro@tia.mat.br>
|
||||
Martin Gebert <martin.gebert@alpha-bit.de>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Miike O'Connor <stew@vireo.org>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Nikanth Karthikesan <knikanth@suse.de>
|
||||
Reuben Thomas <rrt@femur.dyndns.org>
|
||||
Reuben Thomas <rrt@sc3d.org>
|
||||
Roland McGrath <roland@redhat.com>
|
||||
Sam Varshavchik <mrsam@courier-mta.com>
|
||||
Simon Gomizelj <simongmzlg@gmail.com>
|
||||
Tanaka Akira <akr@fsij.org>
|
||||
Teddy Hogeborn <teddy@fukt.bsnet.se>
|
||||
Walter Jontofsohn <wjontofs@atriumberlin.de>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
cpuid.4
|
||||
Andi Kleen
|
||||
New page for cpuid access device
|
||||
|
||||
msr.4
|
||||
Andi Kleen
|
||||
New page documenting x86 CPU MSR access device
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
proc.5
|
||||
Américo Wang
|
||||
Document /proc/sys/vm/swappiness
|
||||
Michael Kerrisk
|
||||
Document /proc/sysrq-trigger
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
timer_create.2
|
||||
timer_delete.2
|
||||
timer_getoverrun.2
|
||||
timer_settime.2
|
||||
numa.7
|
||||
Michael Kerrisk
|
||||
Make source layout of 'Link with' text consistent with other pages
|
||||
No actual change to formatted output, but this makes the
|
||||
page sources more consistent for the purpose of grepping, etc.
|
||||
|
||||
mempcpy.3
|
||||
signbit.3
|
||||
significand.3
|
||||
Michael Kerrisk
|
||||
Global fix: acknowledge FSF in copyright
|
||||
These pages are heavily based on original material in
|
||||
glibc info pages, but the comments in the source of the pages
|
||||
did not acknowledge the FRF copyright on the original material.
|
||||
Fix that.
|
||||
|
||||
accept.2
|
||||
read.2
|
||||
recv.2
|
||||
send.2
|
||||
write.2
|
||||
Michael Kerrisk
|
||||
Fix discussion of EAGAIN/EWOULDBLOCK errors
|
||||
For a non-blocking socket, POSIX.1-2001/2008 allow either
|
||||
EAGAIN or EWOULDBLOCK to be returned in cases where a call
|
||||
would have blocked. Although these constants are defined
|
||||
with the same value on most Linux architectures (PA-RISC
|
||||
is the exception), POSIX.1 does not require them to have
|
||||
the same value. Therefore, a portable application using
|
||||
the sockets API should test for both errors when checking
|
||||
this case.
|
||||
|
||||
(NB POSIX.1 only mentions EWOULDBLOCK in the context of
|
||||
the sockets interfaces.)
|
||||
|
||||
Change made after a note cross-posted on linux-arch@vger,
|
||||
http://thread.gmane.org/gmane.linux.debian.ports.hppa/5615
|
||||
and a suggestion for write(2) from Carlos O'Donell
|
||||
|
||||
basename.3
|
||||
getgrent.3
|
||||
getgrnam.3
|
||||
getpwent.3
|
||||
getpwnam.3
|
||||
readdir.3
|
||||
Michael Kerrisk
|
||||
Note that returned pointer should not be given to free()
|
||||
|
||||
armscii-8.7
|
||||
cp1251.7
|
||||
iso_8859-10.7
|
||||
iso_8859-11.7
|
||||
iso_8859-13.7
|
||||
iso_8859-14.7
|
||||
iso_8859-15.7
|
||||
iso_8859-16.7
|
||||
iso_8859-2.7
|
||||
iso_8859-3.7
|
||||
iso_8859-4.7
|
||||
iso_8859-5.7
|
||||
iso_8859-6.7
|
||||
iso_8859-7.7
|
||||
iso_8859-8.7
|
||||
iso_8859-9.7
|
||||
koi8-r.7
|
||||
koi8-u.7
|
||||
Michael Kerrisk
|
||||
Add explicit character set encoding to first line of source
|
||||
Nowadays mandb has provision to understand a character set
|
||||
encoding that is explicitly indicated in the first line
|
||||
of the source. As pointed out by Colin Watson, including
|
||||
such an explicit indication on pages encoded in anything
|
||||
other than ISO 8859-1 or UTF-8 is useful for man-pages
|
||||
that aren't shipped in UTF-8.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519209
|
||||
and for some other background (responded to by Colin Watson
|
||||
in the above report):
|
||||
http://thread.gmane.org/gmane.comp.internationalization.linux/6040
|
||||
("man page encoding", 5 Jul 2005)
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
fallocate.2
|
||||
Michael Kerrisk
|
||||
VERSIONS: glibc support is provided since version 2.10
|
||||
|
||||
fcntl.2
|
||||
Michael Kerrisk
|
||||
Remove mention of EWOULDBLOCK from discussion of mandatory locking
|
||||
In the kernel, the error on encountering a mandatory lock is
|
||||
EAGAIN. Although EAGAIN and EWOULDBLOCK are the same on
|
||||
most Linux architectures, on some they are not, so don't
|
||||
mention EWOULDBLOCK as it is misleading. (Mea culpa.)
|
||||
|
||||
getcontext.2
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 removes the specification of getcontext()
|
||||
|
||||
getitimer.2
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends POSIX timers API instead of this API
|
||||
|
||||
gettimeofday.2
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends clock_gettime() instead of this API
|
||||
|
||||
ptrace.2
|
||||
Michael Kerrisk
|
||||
Note use of 'data' for PTRACE_SYS{CALL,EMU} and PTRACE_*_SINGLESTEP
|
||||
These operations use the 'data' argument as a signal number,
|
||||
like PTRACE_CONT.
|
||||
|
||||
ptrace.2
|
||||
Mike Frysinger
|
||||
only reference <sys/user.h>
|
||||
The kernel no longer installs linux/user.h, so update
|
||||
references to sys/user.h.
|
||||
|
||||
recv.2
|
||||
Michael Kerrisk
|
||||
Add 'iovec' defn to defn of 'msghdr' structure
|
||||
The 'msghdr' structure includes a field of type 'iovec',
|
||||
so show the definition of that structure in this page.
|
||||
|
||||
rename.2
|
||||
Michael Kerrisk
|
||||
Make ENOENT description consistent with POSIX.1-2008
|
||||
|
||||
timerfd_create.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EINVAL for invalid 'flags' for timer_settime()
|
||||
|
||||
truncate.2
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix description of feature test macro requirements
|
||||
After a report by Arvid Norlander.
|
||||
|
||||
bcopy.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 removes specification of bcopy()
|
||||
|
||||
bsd_signal.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sigaction(2) instead of this API
|
||||
|
||||
ctime.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends strftime(3) instead of these functions
|
||||
|
||||
ecvt.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sprintf(3) instead of these functions
|
||||
|
||||
gcvt.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sprintf(3) instead of this function
|
||||
|
||||
getcwd.3
|
||||
Michael Kerrisk
|
||||
Note that getcwd() should be used instead of the obsolete getwd()
|
||||
|
||||
getgrent.3
|
||||
Michael Kerrisk
|
||||
Returned buffer may be statically allocated and overwritten by
|
||||
later calls
|
||||
|
||||
gethostbyname.3
|
||||
Michael Kerrisk
|
||||
POSIX.1-2008 recommends getaddrinfo(3) and getnameinfo(3) instead
|
||||
|
||||
getnetent_r.3
|
||||
Michael Kerrisk
|
||||
Fix function name in text: s/getnetbynumber_r/getnetbyaddr_r/
|
||||
The SYNOPSIS showed the right function name (getnetbyaddr_r),
|
||||
but the text repeatedly used the wrong name (getnetbynumber_r).
|
||||
Probably, this was a cut-and-paste error.
|
||||
|
||||
getpwent.3
|
||||
Michael Kerrisk
|
||||
Returned buffer may be statically allocated and overwritten by
|
||||
later calls
|
||||
|
||||
index.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends strchr(3) and strrchr(3) instead
|
||||
|
||||
isalpha.3
|
||||
Michael Kerrisk
|
||||
Explain why POSIX.1-2008 marks isascii(3) obsolete
|
||||
|
||||
lockf.3
|
||||
Nikanth Karthikesan
|
||||
Update pointer to documentation in kernel source
|
||||
|
||||
makecontext.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends the use of POSIX threads instead
|
||||
|
||||
mq_notify.3
|
||||
Michael Kerrisk
|
||||
Document the POSIX.1-2008 optional EINVAL error
|
||||
POSIX.1-2008 allows an optional EINVAL error if
|
||||
notification==NULL and the caller is not currently
|
||||
registered to receive notifications.
|
||||
|
||||
posix_fallocate.3
|
||||
Michael Kerrisk
|
||||
Clarify that EINVAL also occurs of 'len' *equals* zero
|
||||
See http://bugzilla.kernel.org/show_bug.cgi?id=12919
|
||||
|
||||
posix_fallocate.3
|
||||
Michael Kerrisk
|
||||
Document POSIX.1-2001 and POSIX.1-2008 specifications for EINVAL error
|
||||
See http://bugzilla.kernel.org/show_bug.cgi?id=12919
|
||||
|
||||
posix_memalign.3
|
||||
Michael Kerrisk
|
||||
Document handling of size==0 case for posix_memalign()
|
||||
|
||||
pthread_exit.3
|
||||
Michael Kerrisk
|
||||
Fix error in DESCRIPTION: s/pthread_create/pthread_exit/
|
||||
|
||||
realpath.3
|
||||
Michael Kerrisk
|
||||
Rework resolved_path==NULL discussion w.r.t. POSIX.1-200[18]
|
||||
Although the page already mentioned the resolved_path==NULL
|
||||
feature, and that this feature was added in POSIX.1-2008, there
|
||||
was still some crufty text in BUGS that hadn't been updated to
|
||||
reflect the POSIX.1-2008 changes.
|
||||
|
||||
Also, some other minor wording and grammar fixes.
|
||||
|
||||
scalb.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends scalbln*(3) instead
|
||||
|
||||
seekdir.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix type of 'offset' argument: s/off_t/long/
|
||||
And add a NOTES section pointing out that 'off_t'
|
||||
was indeed used in glibc 2.1.1 and earlier.
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
|
||||
|
||||
sem_post.3
|
||||
Michael Kerrisk
|
||||
Document EOVERFLOW error
|
||||
|
||||
shm_open.3
|
||||
Michael Kerrisk
|
||||
Recast discussion on name length to exclude terminating NULL byte
|
||||
Probably it's clearer to describe the length of the IPC object
|
||||
name as a count that excludes the null terminator.
|
||||
|
||||
siginterrupt.3
|
||||
Michael Kerrisk
|
||||
Note that POSIX.1-2008 recommends sigaction() instead
|
||||
|
||||
sigset.3
|
||||
Michael Kerrisk
|
||||
Note APIs that POSIX.1-2008 recommends instead of these obsolete APIs
|
||||
|
||||
strftime.3
|
||||
Michael Kerrisk
|
||||
Small fix to description of %G
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677
|
||||
|
||||
strftime.3
|
||||
Michael Kerrisk
|
||||
Add details on ISO 8601 week-based dates
|
||||
ISO 8602 week-based dates are relevant for %G, %g, and %V,
|
||||
and the existing details on these dates are a little thin.
|
||||
|
||||
strftime.3
|
||||
Michael Kerrisk
|
||||
Remove mention of year from ISO 8601 standard
|
||||
The text mentioned the 1988 8601 standard, but there have
|
||||
already been two revisions of the standard since then, so
|
||||
simply remove mention of the year.
|
||||
|
||||
telldir.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix return type: s/off_t/long/
|
||||
And add a NOTES section pointing out that 'off_t'
|
||||
was indeed used in glibc 2.1.1 and earlier.
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
|
||||
|
||||
timeradd.3
|
||||
Michael Kerrisk
|
||||
Note that on some systems, <=, >=, == don't work for timercmp()
|
||||
|
||||
timeradd.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Fix return types of timerisset() and timercmp()
|
||||
|
||||
toascii.3
|
||||
Michael Kerrisk
|
||||
Note why POSIX.1-2008 marks this function obsolete
|
||||
|
||||
console_ioctl.4
|
||||
Alan Curry
|
||||
Fix 'argp' type for KDGETLED description
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517485
|
||||
|
||||
group.5
|
||||
Michael Kerrisk
|
||||
Various minor rewordings and improvements
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Document 'ip6-bytestring' option
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Document 'edns0' option
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Document 'ip6-dotint' / 'no-ip6-dotint' option
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Note that maximum value of 'ndots' option is capped to 15
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Note that maximum value of 'timeout' option is capped to 30
|
||||
|
||||
hier.7
|
||||
Michael Kerrisk
|
||||
Add description of /srv
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=520904
|
||||
|
||||
ip.7
|
||||
Michael Kerrisk
|
||||
Fix type used to declare sin6_port
|
||||
The page should use the type specified by POSIX,
|
||||
rather than the (equivalent) type used in the kernel
|
||||
|
||||
ipv6.7
|
||||
Teddy Hogeborn
|
||||
Fix types used to declare sin6_family and sin6_port
|
||||
The page should use the types specified by POSIX,
|
||||
rather than the (equivalent) types used in the kernel.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517074
|
||||
|
||||
mq_overview.7
|
||||
Michael Kerrisk
|
||||
Recast discussion on name length to exclude terminating NULL byte
|
||||
Probably it's clearer to describe the length of the IPC object
|
||||
name as a count that excludes the null terminator.
|
||||
|
||||
rtld-audit.7
|
||||
Michael Kerrisk
|
||||
Note that multiple libraries in LD_AUDIT doesn't work
|
||||
This is reportedly fixed in glibc 2.10.
|
||||
See http://sourceware.org/bugzilla/show_bug.cgi?id=9733
|
||||
|
||||
sem_overview.7
|
||||
Michael Kerrisk
|
||||
Fix discussion of length of semaphore names
|
||||
Because of the "sem." prefix added by glibc to a semaphore
|
||||
name, the limit on the length of the name (excluding the
|
||||
terminating null byte) is 251 characters.
|
||||
|
|
Loading…
Reference in New Issue