diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-06-13 21:53:10 +0000 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-06-13 21:53:10 +0000 |
commit | 2b82fac62b1981595cbf964000ced74500c6fbeb (patch) | |
tree | fc68e7281d53b687a6a29962dbb697547d82e194 /Changes.old | |
parent | 0e1ad98ccf6b5d481e592652635b171946a5705f (diff) |
Clean up
Diffstat (limited to 'Changes.old')
-rw-r--r-- | Changes.old | 78 |
1 files changed, 39 insertions, 39 deletions
diff --git a/Changes.old b/Changes.old index 2a91af46c..ec330a9dc 100644 --- a/Changes.old +++ b/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 |