mirror of https://github.com/mkerrisk/man-pages
Clean up
This commit is contained in:
parent
0e1ad98ccf
commit
2b82fac62b
78
Changes.old
78
Changes.old
|
@ -3474,7 +3474,7 @@ sem_overview.7
|
|||
mtk
|
||||
New pages describing the POSIX semaphores API.
|
||||
|
||||
These pages supercede and provide a superset of the information
|
||||
These pages supersede and provide a superset of the information
|
||||
in the glibc (3thr) "semaphores(3)" manual page.
|
||||
|
||||
|
||||
|
@ -3852,7 +3852,7 @@ getitimer.2
|
|||
that the default jiffy is now 4 milliseconds.
|
||||
|
||||
Added text to note that current incorrect behavior of
|
||||
normalising tv_usec >= 1000000 will be repaired in a future
|
||||
normalizing tv_usec >= 1000000 will be repaired in a future
|
||||
kernel; applications should be fixed now.
|
||||
|
||||
gettimeofday.2
|
||||
|
@ -4772,7 +4772,7 @@ Global changes
|
|||
Thomas Huriaux / mtk
|
||||
|
||||
Various formatting problems found as a result of reviewing the
|
||||
following command were fixed.
|
||||
following command were fixed.
|
||||
|
||||
for a in $(wc man?/*.?| awk '$1 > 2 ' | grep -v total); do
|
||||
echo $a; groff -Tascii -wmac -mman $a > /dev/null;
|
||||
|
@ -5499,7 +5499,7 @@ Global changes
|
|||
--------------
|
||||
|
||||
mtk
|
||||
JustinPyzby / mtk
|
||||
Justin Pryzby / mtk
|
||||
Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
|
||||
faccessat.2
|
||||
fchmodat.2
|
||||
|
@ -5954,7 +5954,7 @@ sched_rr_get_interval.2
|
|||
Remove crufty statement that this system call is not implemented.
|
||||
The nice interval can be used to control the size of
|
||||
the round-robin quantum.
|
||||
Corrected .TH line.
|
||||
Corrected .TH line.
|
||||
|
||||
ip.7
|
||||
John Heffner / mtk
|
||||
|
@ -6189,13 +6189,13 @@ Most Section 1 man pages are removed
|
|||
Once upon time Andries added a number of Section 1 manual pages
|
||||
to man-pages. However, since that time, those pages have not
|
||||
seen much maintenance, and are not in fact distributed in most
|
||||
distributions. Instead most distributions supply the
|
||||
distributions. Instead most distributions supply the
|
||||
coreutils versions of these pages, which are currently
|
||||
maintained. In addition, man-pages provides the 1p pages,
|
||||
which document the portable subset of functionality of these
|
||||
commands. Since the man1 pages are mostly unneeded, and
|
||||
out of date, I'm removing them. The following pages disappear:
|
||||
|
||||
|
||||
chgrp.1
|
||||
chmod.1
|
||||
chown.1
|
||||
|
@ -6233,12 +6233,12 @@ Global changes
|
|||
--------------
|
||||
|
||||
mtk
|
||||
(Hopefully) all cross references outside a page now include a
|
||||
section number. This should permit better resulting output from a
|
||||
(Hopefully) all cross references outside a page now include a
|
||||
section number. This should permit better resulting output from a
|
||||
man2html-type conversion.
|
||||
|
||||
mtk
|
||||
Convert function formatting of the form "\fBname\fP()" to
|
||||
Convert function formatting of the form "\fBname\fP()" to
|
||||
".BR name ()".
|
||||
|
||||
|
||||
|
@ -6278,7 +6278,7 @@ stdarg.3
|
|||
|
||||
Released: 2007-05-29
|
||||
|
||||
"A foolish consistency is the hobgoblin of little minds, adored by
|
||||
"A foolish consistency is the hobgoblin of little minds, adored by
|
||||
little statesmen and philosophers and divines"
|
||||
|
||||
Ralph Waldo Emerson (1803-1882)
|
||||
|
@ -6290,7 +6290,7 @@ Global changes
|
|||
--------------
|
||||
|
||||
Most of the changes below are about bringing greater consistency
|
||||
to manual pages, including reducing the side wange of .SH
|
||||
to manual pages, including reducing the side wange of .SH
|
||||
Section headings.
|
||||
|
||||
Typographical or grammatical errors have been corrected in several
|
||||
|
@ -6319,15 +6319,15 @@ Various pages
|
|||
|
||||
Various pages
|
||||
mtk
|
||||
Commented out .SH AUTHOR sections; the right place for
|
||||
documentation authoriship sections is usually comments at the
|
||||
Commented out .SH AUTHOR sections; the right place for
|
||||
documentation authorship sections is usually comments at the
|
||||
top of the page source.
|
||||
|
||||
Various pages
|
||||
mtk
|
||||
Changed .SH HISTORY to .SH VERSIONS.
|
||||
Reason: in many cases, HISTORY was being used to describe
|
||||
Linux/glibc version information, as was already done for
|
||||
Reason: in many cases, HISTORY was being used to describe
|
||||
Linux/glibc version information, as was already done for
|
||||
VERSIONS sections in other pages.
|
||||
|
||||
Various pages
|
||||
|
@ -6335,7 +6335,7 @@ Various pages
|
|||
Removed HISTORY section, or moved it as a subsection or paragraphs
|
||||
under another section e.g., NOTES.
|
||||
Reason: there are too many arbitrary section (.SH) names, and
|
||||
a HISTORY section never was consistently used across Linux
|
||||
a HISTORY section never was consistently used across Linux
|
||||
manual pages.
|
||||
|
||||
Various pages
|
||||
|
@ -6355,7 +6355,7 @@ Various pages
|
|||
|
||||
Various pages
|
||||
mtk
|
||||
Renamed some "AVAILABILIY" sections to "VERSIONS".
|
||||
Renamed some "AVAILABILITY" sections to "VERSIONS".
|
||||
Reason: consistency.
|
||||
|
||||
Various pages
|
||||
|
@ -6387,7 +6387,7 @@ tsearch.3
|
|||
vcs.4
|
||||
wordexp.3
|
||||
mtk
|
||||
s/return 0/exit(EXIT_FAILURE)/ in main() of function example
|
||||
s/return 0/exit(EXIT_FAILURE)/ in main() of function example
|
||||
program.
|
||||
Reason: consistency.
|
||||
|
||||
|
@ -6401,7 +6401,7 @@ hsearch.3
|
|||
select_tut.2
|
||||
tsearch.3
|
||||
mtk
|
||||
Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
|
||||
Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
|
||||
to exit().
|
||||
Reason: consistency.
|
||||
|
||||
|
@ -6412,7 +6412,7 @@ open.2
|
|||
read.2
|
||||
utmp.5
|
||||
mtk
|
||||
Renamed RESTRICTIONS section to NOTES, or moved text in a
|
||||
Renamed RESTRICTIONS section to NOTES, or moved text in a
|
||||
RESTRICTIONS section under existing NOTES section.
|
||||
Reason: consistency, and reduce number of arbitrary section (.SH)
|
||||
names.
|
||||
|
@ -6430,7 +6430,7 @@ dup.2
|
|||
s/\.SH WARNING/.SH NOTES/
|
||||
|
||||
kill.2
|
||||
Renamed LINUX HISTORY section to LINUX NOTES, and relocated
|
||||
Renamed LINUX HISTORY section to LINUX NOTES, and relocated
|
||||
within page.
|
||||
|
||||
select_tut.2
|
||||
|
@ -6451,7 +6451,7 @@ setuid.2
|
|||
|
||||
shmget.2
|
||||
mtk
|
||||
Remove section about effect of fork()/exec()/exit(); shmop.2
|
||||
Remove section about effect of fork()/exec()/exit(); shmop.2
|
||||
contains the same text, and it only needs to be said once.
|
||||
|
||||
shmop.2
|
||||
|
@ -6481,7 +6481,7 @@ man.7
|
|||
mtk
|
||||
Substantial rewrite, revising and extending the discussion
|
||||
about desired conventions for writing pages.
|
||||
There will be further updates to this page in the next few
|
||||
There will be further updates to this page in the next few
|
||||
man-pages releases.
|
||||
|
||||
|
||||
|
@ -6489,7 +6489,7 @@ man.7
|
|||
|
||||
Released: 2007-05-30
|
||||
|
||||
"A foolish consistency is the hobgoblin of little minds, adored by
|
||||
"A foolish consistency is the hobgoblin of little minds, adored by
|
||||
little statesmen and philosophers and divines"
|
||||
|
||||
Ralph Waldo Emerson (1803-1882)
|
||||
|
@ -6507,7 +6507,7 @@ Many many pages
|
|||
|
||||
man7/*
|
||||
mtk
|
||||
In various pages in this section, .SH headings were
|
||||
In various pages in this section, .SH headings were
|
||||
converted to .SS.
|
||||
|
||||
|
||||
|
@ -6532,7 +6532,7 @@ Global changes
|
|||
|
||||
Various pages
|
||||
mtk
|
||||
Where there is an instruction in the SYNOPSIS about linking
|
||||
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").
|
||||
|
||||
|
@ -6553,7 +6553,7 @@ New pages
|
|||
|
||||
man-pages.7
|
||||
mtk
|
||||
A description of the conventions that should be followed
|
||||
A description of the conventions that should be followed
|
||||
when writing pages for the man-pages package.
|
||||
|
||||
Removed pages
|
||||
|
@ -6566,7 +6566,7 @@ man1/README
|
|||
|
||||
LDP.7
|
||||
mtk
|
||||
Removed this page since it is out of date, and the proper place
|
||||
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
|
||||
|
@ -6595,18 +6595,18 @@ epoll_pwait.2
|
|||
|
||||
fcntl.2
|
||||
mtk
|
||||
Remove misleading text about setting O_ASYNC when calling
|
||||
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
|
||||
Converted outdated BUGS note about fdatasync() being
|
||||
equivalent to fsync() on Linux 2.2 into a NOTES note
|
||||
about this historical behavior.
|
||||
|
||||
futex.2
|
||||
mtk
|
||||
Small rewording to fix "fails with the error EWOULDBLOCK"
|
||||
Small rewording to fix "fails with the error EWOULDBLOCK"
|
||||
rather than "returns EWOULDBLOCK".
|
||||
See Red Hat bug 172828.
|
||||
|
||||
|
@ -6930,8 +6930,8 @@ regex.3
|
|||
|
||||
sigpause.3
|
||||
mtk after a note from Ulrich Drepper
|
||||
Clarify discussion of feature test macros that are needed to
|
||||
expose Sysem V and BSD versions of this function in glibc.
|
||||
Clarify discussion of feature test macros that are needed to
|
||||
expose System V and BSD versions of this function in glibc.
|
||||
|
||||
undocumented.3
|
||||
mtk
|
||||
|
@ -6993,8 +6993,8 @@ Global changes
|
|||
Many pages
|
||||
mtk
|
||||
Removed version numbers in .TH lines.
|
||||
Reason: these were only arbitrarily updated, and so impart no
|
||||
useful information. Version information goes into a
|
||||
Reason: these were only arbitrarily updated, and so impart no
|
||||
useful information. Version information goes into a
|
||||
VERSIONS section nowadays, and the date in the .TH line should
|
||||
be updated to reflect the date of the last (significant)
|
||||
change to the page.
|
||||
|
@ -7224,7 +7224,7 @@ printf.3
|
|||
mtk after a suggestion by Mike Frysinger
|
||||
Add text to the introductory part of DESCRIPTION, about the
|
||||
'size' argument of snprintf() and vsnprintf().
|
||||
|
||||
|
||||
shm_unlink.3
|
||||
mtk
|
||||
Added VERSIONS section; rewrote info about linking with -lrt.
|
||||
|
@ -7253,7 +7253,7 @@ Manual pages are now standardized on American spelling. See
|
|||
http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences
|
||||
for more information on the differences. Formerly, different pages (and
|
||||
sometimes even a single page!) employed American and British spelling
|
||||
conventions; best to stnadarize on one spelling, and American English
|
||||
conventions; best to standarize on one spelling, and American English
|
||||
is the standard in Computer Science.
|
||||
|
||||
Changes to individual pages
|
||||
|
|
Loading…
Reference in New Issue