This commit is contained in:
Michael Kerrisk 2007-05-26 13:02:33 +00:00
parent bd0a01ce48
commit 9e54f9ab01
2 changed files with 252 additions and 172 deletions

204
Changes
View File

@ -1,4 +1,4 @@
==================== Changes in man-pages-2.54 ====================
==================== Changes in man-pages-2.55 ====================
Released: 2007-06-07
@ -8,8 +8,7 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Emmanuel Mogenet <emogenet@google.com>
Michael Berg <michaeljberg@gmail.com>
John Reiser <jreiser@bitwagoin.com>
Apologies if I missed anyone!
@ -17,203 +16,64 @@ Apologies if I missed anyone!
Global changes
--------------
Various pages
Several pages
mtk
Where there is an instruction in the SYNOPSIS about linking
or compiling with a certain option, the option is now
marked up in italics (e.g., "\fI-lm\fP").
Various pages
mtk
Added page numbers to page cross references.
A few pages
mtk
s/manpage/man page/, for consistency.
Change reference to path_resolution.2 to path_resolutiion.7.
Typographical or grammatical errors have been corrected in several
places.
New pages
---------
Moved pages
-----------
man-pages.7
path_resolution.2 has been moved to section 7, thus path_resolution.2
mtk
A description of the conventions that should be followed
when writing pages for the man-pages package.
Removed pages
-------------
man1/README
mtk
Already deleted most of the man1 pages previously, so
this doesn't need to stay.
LDP.7
mtk
Removed this page since it is out of date, and the proper place
to go for up-to-date information is http://www.tldp.org/.
ksoftirq.9
mtk
Reason: this was the only Section 9 page, and it is old
(Linux 2.4). The man9 section never took off as an idea, and
I see little point in keeping a Section 9 with just a single
old page.
Reason: this is an overview page, not a one describing as
a specific system call.
Changes to individual pages
---------------------------
HOWTOHELP
arch_prctl.2
mtk
Moved some material out of here into new man-pages.7.
Added RETURN VALUE section.
alloc_hugepages.2
cacheflush.2
mtk
Minor rewrites, eliminating some duplication, and removing
some outdated text.
Convert NOTES section to CONFORMING TO and note that
this call is Linux-specific.
Other minor rewordings.
epoll_pwait.2
Michael Berg
Fix broken link path; Debian bug 425570.
fcntl.2
get_kernel_syms.2
mtk
Remove misleading text about setting O_ASYNC when calling
open(); one must use fcntl() F_SETFL for this task.
Added ERRORS heading
fdatasync.2
getdtablesize.2
mtk
Converted outdated BUGS note about fdatasync() being
equivalent to fsync() on Linux 2.2 into a NOTES note
about this historical behaviour.
Added an ERRORS section.
futex.2
getsid.2
mtk
Small rewording to fix "fails with the error EWOULDBLOCK"
rather than "returns EWOULDBLOCK".
See Red Hat bug 172828.
Added a RETURN VALUE section.
mprotect.2
mtk, after an observation by Emmanuel Mogenet
A much improved example program.
getpid.2
mtk
Significant rewrites and additions to description.
Added an ERRORS section (stating that the calls are
always successful).
mremap.2
ioctl_list.2
mtk
Remove text about the non-existent BSD mremap() -- too
much information, in my opinion.
sched_yield.2
mtk
Added ERRORS section.
set_mempolicy.2
mtk
Moved text for "Versions and Library Support".
Add SEE ALSO reference to ioctl.2.
set_tid_address.2
mtk
Small rewording in RETURN VALUE section.
Added an ERRORS section (stating that the call is
always successful).
sigaction.2
ld.so.8
mtk
Add EXAMPLE section with a pointer to example in mprotect.2.
sync_file_range.2
mtk
Fix return type in SYNOPSIS. Add RETURN VALUE section.
atexit.3
mtk
Small rearrangement of text under NOTES.
bindresvport.3
mtk
Rewrite and substantial additional text.
exec.3
mtk
Minor clarifications for text on execlp() and execvp(). Removed
FILES section, since it provides no useful additional info.
fenv.3
mtk
Moved link instructions from NOTES to SYNOPSIS.
Added feenableexcept, fedisableexcept, fegetexcept
to .SH NAME list.
fputwc.3
mtk
Added 'putwc' to .SH NAME list.
gethostbyname.3
mtk
s/int/socklen_t/ for type of gethostbyaddr() 'len' argument,
and add a few more words in NOTES about the type used here.
login.3
mtk
Removed remark from NOTES about linking with -lutil; add
text on that point to SYNOPSIS.
openpty.3
mtk
Removed redundant remark from NOTES about linking with -lutil
since there is text on that point under SYNOPSIS.
sysconf.3
mtk
Added SEE ALSO referring to getconf(1).
unlocked_stdio.3
mtk
Revised .SH NAME section.
ascii.7
mtk
Minor rearrangement of order of text.
capability.7
mtk
s/exec()/execve(2)/ in various places.
complex.7
mtk
Changed "atan(1)" to "atan(1.0)" to prevent some versions of
man2html(1) from mistaking that string as a page cross reference.
rtnetlink.7
mtk
Small restructuring to avoid 'cannot adjust line' from man(1).
ldconfig.8
mtk
Removed now very out-of-date sentence about need to link shared
libraries with -lc.
man.7
mtk
Various text was moved out of this page into the new man-pages.7.
mdoc.7
mtk
Added SEE ALSO referring to new man-pages.7.
mdoc.samples.7
mtk
A few changes, hopefully done right, to eliminate some
errors to stderr when rendering with man(1).
rtnetlink.7
mtk
Shorten a line in table so it fits in 80 columns.
Minor rewording under BUGS.
tzselect.8
mtk
Moved EXIT STATUS section.
Simplify text describing --inhibit-rpath.
mtk, after a note by John Reiser
Describe use of $ORIGIN in rpath.

View File

@ -6510,3 +6510,223 @@ man7/*
In various pages in this section, .SH headings were
converted to .SS.
==================== Changes in man-pages-2.54 ====================
Released: 2007-06-07
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Emmanuel Mogenet <emogenet@google.com>
Michael Berg <michaeljberg@gmail.com>
Apologies if I missed anyone!
Global changes
--------------
Various pages
mtk
Where there is an instruction in the SYNOPSIS about linking
or compiling with a certain option, the option is now
marked up in italics (e.g., "\fI-lm\fP").
Various pages
mtk
Added page numbers to page cross references.
A few pages
mtk
s/manpage/man page/, for consistency.
Typographical or grammatical errors have been corrected in several
places.
New pages
---------
man-pages.7
mtk
A description of the conventions that should be followed
when writing pages for the man-pages package.
Removed pages
-------------
man1/README
mtk
Already deleted most of the man1 pages previously, so
this doesn't need to stay.
LDP.7
mtk
Removed this page since it is out of date, and the proper place
to go for up-to-date information is http://www.tldp.org/.
ksoftirq.9
mtk
Reason: this was the only Section 9 page, and it is old
(Linux 2.4). The man9 section never took off as an idea, and
I see little point in keeping a Section 9 with just a single
old page.
Changes to individual pages
---------------------------
HOWTOHELP
mtk
Moved some material out of here into new man-pages.7.
alloc_hugepages.2
mtk
Minor rewrites, eliminating some duplication, and removing
some outdated text.
epoll_pwait.2
Michael Berg
Fix broken link path; Debian bug 425570.
fcntl.2
mtk
Remove misleading text about setting O_ASYNC when calling
open(); one must use fcntl() F_SETFL for this task.
fdatasync.2
mtk
Converted outdated BUGS note about fdatasync() being
equivalent to fsync() on Linux 2.2 into a NOTES note
about this historical behaviour.
futex.2
mtk
Small rewording to fix "fails with the error EWOULDBLOCK"
rather than "returns EWOULDBLOCK".
See Red Hat bug 172828.
mprotect.2
mtk, after an observation by Emmanuel Mogenet
A much improved example program.
mtk
Significant rewrites and additions to description.
mremap.2
mtk
Remove text about the non-existent BSD mremap() -- too
much information, in my opinion.
sched_yield.2
mtk
Added ERRORS section.
set_mempolicy.2
mtk
Moved text for "Versions and Library Support".
set_tid_address.2
mtk
Small rewording in RETURN VALUE section.
sigaction.2
mtk
Add EXAMPLE section with a pointer to example in mprotect.2.
sync_file_range.2
mtk
Fix return type in SYNOPSIS. Add RETURN VALUE section.
atexit.3
mtk
Small rearrangement of text under NOTES.
bindresvport.3
mtk
Rewrite and substantial additional text.
exec.3
mtk
Minor clarifications for text on execlp() and execvp(). Removed
FILES section, since it provides no useful additional info.
fenv.3
mtk
Moved link instructions from NOTES to SYNOPSIS.
Added feenableexcept, fedisableexcept, fegetexcept
to .SH NAME list.
fputwc.3
mtk
Added 'putwc' to .SH NAME list.
gethostbyname.3
mtk
s/int/socklen_t/ for type of gethostbyaddr() 'len' argument,
and add a few more words in NOTES about the type used here.
login.3
mtk
Removed remark from NOTES about linking with -lutil; add
text on that point to SYNOPSIS.
openpty.3
mtk
Removed redundant remark from NOTES about linking with -lutil
since there is text on that point under SYNOPSIS.
sysconf.3
mtk
Added SEE ALSO referring to getconf(1).
unlocked_stdio.3
mtk
Revised .SH NAME section.
ascii.7
mtk
Minor rearrangement of order of text.
capability.7
mtk
s/exec()/execve(2)/ in various places.
complex.7
mtk
Changed "atan(1)" to "atan(1.0)" to prevent some versions of
man2html(1) from mistaking that string as a page cross reference.
rtnetlink.7
mtk
Small restructuring to avoid 'cannot adjust line' from man(1).
ldconfig.8
mtk
Removed now very out-of-date sentence about need to link shared
libraries with -lc.
man.7
mtk
Various text was moved out of this page into the new man-pages.7.
mdoc.7
mtk
Added SEE ALSO referring to new man-pages.7.
mdoc.samples.7
mtk
A few changes, hopefully done right, to eliminate some
errors to stderr when rendering with man(1).
rtnetlink.7
mtk
Shorten a line in table so it fits in 80 columns.
Minor rewording under BUGS.
tzselect.8
mtk
Moved EXIT STATUS section.