From 1421a19297acfa36e5e2e1fb5b57b11d51faddee Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 11 May 2007 21:19:06 +0000 Subject: Ready for 2.50. --- Changes | 195 ++++++++++++------------------------------------ Changes.old | 161 +++++++++++++++++++++++++++++++++++++++ man-pages-2.50.Announce | 2 +- man-pages-2.50.lsm | 6 +- 4 files changed, 212 insertions(+), 152 deletions(-) diff --git a/Changes b/Changes index c95462a8b..94c569287 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-2.49 ==================== +==================== Changes in man-pages-2.50 ==================== -Released: 2007-05-20 +Released: 2007-05-21 Contributors ------------ @@ -8,152 +8,51 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: -Akihiro MOTOKI -Bruno Haible -Justin Pryzby +Andreas Halter +Laird Shaw +Mike Frysinger Apologies if I missed anyone! - -New pages ---------- - -bsd_signal.3 - mtk - Documentation of bsd_signal(). - -euidaccess.3 - mtk - Manual page for euidaccess() and eaccess(). - -getsubopt.3 - mtk / Justin Pryzby - Documentation of getsubopt(). - -sysv_signal.3 - mtk - Documentation of sysv_signal(). - - -New links ---------- - -epoll_pwait.2 - mtk - New link to epoll_wait.2. - -eaccess.3 - mtk - New link to new euidaccess.3, - -sem_timedwait.3 - mtk - New link to sem_wait.3. - -sem_trywait.3 - mtk - New link to sem_wait.3. - - -Global changes --------------- - -Typographical or grammatical errors have been corrected in several -places. - - -Changes to individual pages ---------------------------- - -access.3 - mtk - Added SEE ALSO ref to new euidaccess.3 page. - -epoll_pwait.2 - mtk - Added description of epoll_pwait(), new in kernel 2.6.19. - -execve.2 - mtk - Add text noting that Linux allows 'argv' and 'envp' to be - NULL, but warning that this is non-standard and non-portable, - and should be avoided in portable programs. - Bug filed (http://bugzilla.kernel.org/show_bug.cgi?id=8408) - to get this changed, but maybe that won't be done because it - is an ABI change. - mtk - Added an example program. - mtk - Expanded the discussion of interpreter scripts and the - 'optional-arg' argument of an interpreter script. - For further info, see - http://homepages.cwi.nl/~aeb/std/hashexclam-1.html - http://www.in-ulm.de/~mascheck/various/shebang/ - mtk - Added text noting that FD_CLOEXEC causes record locks to be - released. - mtk - Mention effect of MS_NOSUID mount(2) flag for set-user-ID - programs. - mtk - Expanded description of handling of file descriptors during - execve(), adding text to note that descriptors 0, 1, and 2 - may be treated specially. - -faccessat.3 - mtk - Added SEE ALSO ref to new euidaccess.3 page. - -mmap.2 - mtk - Place MAP_* flags list in alphabetical order. - -readv.2 - mtk - A fairly substantial rewrite, which among other things - fixes the problem reported by Kyle Sluder in - http://bugzilla.kernel.org/show_bug.cgi?id=8399 - And added some example code. - -sigaction.2 - mtk - Added text referring to the discussion of async-signal-safe - functions in signal(7). - A few other minor formatting and wording changes. - -signal.2 - mtk - Moved the discussion of async-signal-safe functions to signal(7). - Added text referring to the discussion of async-signal-safe - functions in signal(7). - Added SEE ALSO entries referring to new bsd_signal.3 and - sysv_signal.3 pages. - -copysign.3 - Bruno Haible - Clarify discussion of negative zero. - -iconv_open.3 - Bruno Haible - Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions - for 'tocode'. - -iswblank.3 - Bruno Haible - Update CONFORMING TO; iswblank() is in POSIX.1-2001. - -subopt.3 - mtk - Add SEE ALSO ref to new getsubopt.3. - -inotify.7 - mtk - Defintions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR - were added to glibc in version 2.5. - -signal.7 - mtk - Incorporated (and slightly modified) the text on - async-signal-safe functions that was formerly in signal(2). - Added SEE ALSO entries referring to new bsd_signal.3 and - sysv_signal.3 pages. +Removed pages (!) +----------------- + +Most Section 1 man pages are removed + mtk (with help from Mike Frysinger, Laird Shaw, Andreas Halter) + 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 + 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 + cp.1 + dd.1 + df.1 + diff.1 + dir.1 + dircolors.1 + du.1 + install.1 + ln.1 + ls.1 + mkdir.1 + mkfifo.1 + mknod.1 + mv.1 + rm.1 + rmdir.1 + touch.1 + vdir.1 + + The following Section 1 pages will be kept: + + intro.1 + ldd.1 + time.1 diff --git a/Changes.old b/Changes.old index ccb4ec221..146b86d5b 100644 --- a/Changes.old +++ b/Changes.old @@ -6000,3 +6000,164 @@ man.7 Justin Pryzby / Colin Watson / mtk .SH doesn't require quotes. See Debian bug 411303. + + +==================== Changes in man-pages-2.49 ==================== + +Released: 2007-05-20 + +Contributors +------------ + +The following people contributed notes, ideas, or patches that have +been incorporated in changes in this release: + +Akihiro MOTOKI +Bruno Haible +Justin Pryzby + +Apologies if I missed anyone! + + +New pages +--------- + +bsd_signal.3 + mtk + Documentation of bsd_signal(). + +euidaccess.3 + mtk + Manual page for euidaccess() and eaccess(). + +getsubopt.3 + mtk / Justin Pryzby + Documentation of getsubopt(). + +sysv_signal.3 + mtk + Documentation of sysv_signal(). + + +New links +--------- + +epoll_pwait.2 + mtk + New link to epoll_wait.2. + +eaccess.3 + mtk + New link to new euidaccess.3, + +sem_timedwait.3 + mtk + New link to sem_wait.3. + +sem_trywait.3 + mtk + New link to sem_wait.3. + + +Global changes +-------------- + +Typographical or grammatical errors have been corrected in several +places. + + +Changes to individual pages +--------------------------- + +access.3 + mtk + Added SEE ALSO ref to new euidaccess.3 page. + +epoll_pwait.2 + mtk + Added description of epoll_pwait(), new in kernel 2.6.19. + +execve.2 + mtk + Add text noting that Linux allows 'argv' and 'envp' to be + NULL, but warning that this is non-standard and non-portable, + and should be avoided in portable programs. + Bug filed (http://bugzilla.kernel.org/show_bug.cgi?id=8408) + to get this changed, but maybe that won't be done because it + is an ABI change. + mtk + Added an example program. + mtk + Expanded the discussion of interpreter scripts and the + 'optional-arg' argument of an interpreter script. + For further info, see + http://homepages.cwi.nl/~aeb/std/hashexclam-1.html + http://www.in-ulm.de/~mascheck/various/shebang/ + mtk + Added text noting that FD_CLOEXEC causes record locks to be + released. + mtk + Mention effect of MS_NOSUID mount(2) flag for set-user-ID + programs. + mtk + Expanded description of handling of file descriptors during + execve(), adding text to note that descriptors 0, 1, and 2 + may be treated specially. + +faccessat.3 + mtk + Added SEE ALSO ref to new euidaccess.3 page. + +mmap.2 + mtk + Place MAP_* flags list in alphabetical order. + +readv.2 + mtk + A fairly substantial rewrite, which among other things + fixes the problem reported by Kyle Sluder in + http://bugzilla.kernel.org/show_bug.cgi?id=8399 + And added some example code. + +sigaction.2 + mtk + Added text referring to the discussion of async-signal-safe + functions in signal(7). + A few other minor formatting and wording changes. + +signal.2 + mtk + Moved the discussion of async-signal-safe functions to signal(7). + Added text referring to the discussion of async-signal-safe + functions in signal(7). + Added SEE ALSO entries referring to new bsd_signal.3 and + sysv_signal.3 pages. + +copysign.3 + Bruno Haible + Clarify discussion of negative zero. + +iconv_open.3 + Bruno Haible + Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions + for 'tocode'. + +iswblank.3 + Bruno Haible + Update CONFORMING TO; iswblank() is in POSIX.1-2001. + +subopt.3 + mtk + Add SEE ALSO ref to new getsubopt.3. + +inotify.7 + mtk + Defintions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR + were added to glibc in version 2.5. + +signal.7 + mtk + Incorporated (and slightly modified) the text on + async-signal-safe functions that was formerly in signal(2). + Added SEE ALSO entries referring to new bsd_signal.3 and + sysv_signal.3 pages. diff --git a/man-pages-2.50.Announce b/man-pages-2.50.Announce index c1fa2cc94..86934f762 100644 --- a/man-pages-2.50.Announce +++ b/man-pages-2.50.Announce @@ -1,7 +1,7 @@ RELEASE The Linux man page maintainer proudly announces. . . - man-pages-2.49.tar.gz - man pages for Linux + man-pages-2.50.tar.gz - man pages for Linux Differences from the previous manual pages release are listed in the file "Changes". diff --git a/man-pages-2.50.lsm b/man-pages-2.50.lsm index 4b1e7e6c0..b4096e33e 100644 --- a/man-pages-2.50.lsm +++ b/man-pages-2.50.lsm @@ -1,13 +1,13 @@ Begin3 Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 2.49 -Entered-date: 2007-05-20 +Version: 2.50 +Entered-date: 2007-05-21 Description: Linux and POSIX manual pages Keywords: man pages Author: several Maintained-by: Michael Kerrisk Primary-site: ftp://ftp.kernel.org/pub/linux/docs/manpages - 2625k man-pages-2.49.tar.gz + 2597k man-pages-2.50.tar.gz Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages Copying-policy: several; for the POSIX pages, see the file POSIX-COPYRIGHT; the other pages are all freely distributable as long as -- cgit v1.2.3