Bug#694901: unblock: manpages/3.44-1
Package: release.debian.org
Severity: normal
User: release.debian.org@packages.debian.org
Usertags: unblock
Please unblock package manpages, it fixes an important issue in the
Debian-specific part of the package (#691414, see motd.5.diff attached).
Since it's a documentation only package, it has also been updated, the
attached diff spares you most of these documentation changes.
unblock manpages/3.44-1
Thanks (a lot) in advance for considering it, and please note that the
French translation is ready too (fixing the important Debian-specific
issue), so I may bug you again if you agree with this unblock:
unblock manpages-fr/3.44d1p1-1
Regards
David
-- System Information:
Debian Release: wheezy/sid
APT prefers unstable
APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (100, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 3.2.0-4-amd64 (SMP w/1 CPU core)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
--- manpages-3.44.orig/man5/motd.5
+++ manpages-3.44/man5/motd.5
@@ -28,17 +28,29 @@
motd \- message of the day
.SH DESCRIPTION
The contents of \fI/etc/motd\fP are displayed by
-.BR login (1)
+.BR pam_motd (8)
after a successful login but just before it executes the login shell.
The abbreviation "motd" stands for "message of the day", and this file
has been traditionally used for exactly that (it requires much less disk
space than mail to all users).
+
+On Debian GNU/Linux, the content of
+.I /run/motd.dynamic
+is also displayed.
+This file is generated by
+.I /etc/init.d/motd
+at boot.
.SH FILES
-/etc/motd
+.I /etc/motd
+.br
+.I /run/motd.dynamic
+.br
+.I /etc/init.d/motd
.SH "SEE ALSO"
.BR login (1),
.BR issue (5)
+.BR pam_motd(8)
.SH COLOPHON
This page is part of release 3.44 of the Linux
.I man-pages
diff -Nru --exclude 'man?' manpages-3.42/Changes manpages-3.44/Changes
--- manpages-3.42/Changes 2012-08-13 18:39:35.000000000 -0400
+++ manpages-3.44/Changes 2012-11-07 09:24:38.000000000 -0400
@@ -1,6 +1,6 @@
-==================== Changes in man-pages-3.42 ====================
+==================== Changes in man-pages-3.44 ====================
-Released: 2012-08-14, Konolfingen
+Released: 2012-11-07, Barcelona
Contributors
@@ -10,431 +10,211 @@
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Aaron Peschel <aaron.peschel@gmail.com>
-Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
-Akihiro MOTOKI <amotoki@gmail.com>
-Alan Curry <pacman@kosh.dhis.org>
-Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
-Christoph Lameter <cl@linux.com>
-Colin McCabe <cmccabe@alumni.cmu.edu>
-Daniel Zingaro <daniel.zingaro@utoronto.ca>
+Bert Hubert <bert.hubert@netherlabs.nl>
David Prévot <taffit@debian.org>
-Denys Vlasenko <vda.linux@gmail.com>
-Henry Hu <henry.hu.sh@gmail.com>
-Herbert Xu <herbert@gondor.apana.org.au>
-Jan Engelhardt <jengelh@medozas.de>
-Jim Hill <gjthill@gmail.com>
-JoonSoo Kim <js1304@gmail.com>
-Kalle Olavi Niemitalo <kon@iki.fi>
-Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
+James Youngman <jay@gnu.org>
+Kees Cook <keescook@chromium.org>
+Lars Wirzenius <liw@iki.fi>
+Lucas De Marchi <lucas.de.marchi@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
-Michael S. Tsirkin <mst@redhat.com>
-Rasmus Villemoes <Rasmus.Villemoes@decode.is>
-Sami Kerola <kerolasa@iki.fi>
-Sam Varshavchik <mrsam@courier-mta.com>
-Shawn Landden <shawnlandden@gmail.com>
+Rusty Russell <rusty@rustcorp.com.au>
Simon Paillard <spaillard@debian.org>
-Tolga Dalman <tolga.dalman@googlemail.com>
-Ulrich Drepper <drepper@gmail.com>
-Марк Коренберг <socketpair@gmail.com>
+Thomas Habets <thomas@habets.se>
Apologies if I missed anyone!
-Global changes
---------------
-
-Various pages
- Sami Kerola
- Global fix: use UR macro where applicable
- The syntax .UR http://example.com paired with .UE will create
- links which one can interact, if the pager allows that. One
- way to see the effect is ask the man(1) command to use browser
- display, e.g.:
+New and rewritten pages
+-----------------------
- man -H man7/uri.7
+delete_module.2
+ Michael Kerrisk
+ Rewrite to Linux 2.6+ reality
+ Michael Kerrisk
+ Change license and copyright
+ There is now nothing left of the original FSF-copyrighted
+ page. So, change the copyright and license.
+ Michael Kerrisk [Lucas De Marchi, Rusty Russell]
+ Substantial reorganization after comments from Rusty Russell
+ Rusty notes that O_NONBLOCK is almost always used in
+ practice. Therefore, it would be better to reorganize
+ the page to consider that "the default".
+
+init_module.2
+ Michael Kerrisk
+ Rewrite to Linux 2.6+ reality
+ Michael Kerrisk
+ Change copyright and license
+ Little of the original page now remains. Change
+ copyright and license
+ Michael Kerrisk [Rusty Russell]
+ Changes after review comments from Rusty Russell
+ Kees Cook
+ Add various pieces describing Linux 2.6+ behavior
+ Pieces take from, or inspired by, a patch sent by Kees.
- ("\:" is optional groff syntax to permit hyphenless line breaks.)
+getauxval.3
+ Michael Kerrisk
+ Document getauxval() function added in glibc 2.16
-Changes to individual pages
----------------------------
+Global changes
+--------------
-ldd.1
+Various pages
Michael Kerrisk
- Add security note on untrusted executables
- See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
- and
- http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
-
-clone.2
- Michael Kerrisk
- Rewrite discussion of sys_clone
-
-futex.2
- Марк Коренберг
- Consolidate error descriptions to ERRORS
- Michael Kerrisk
- Various wording fix-ups
- Michael Kerrisk
- Fix description of EINVAL error
- The current text seems incorrect. Replace with a more general
- description.
-
-getdents.2
-select_tut.2
-atof.3
-atoi.3
-pthread_create.3
-pthread_sigmask.3
-rtime.3
-setbuf.3
-tsearch.3
-netlink.7
- Michael Kerrisk [Jan Engelhardt]
- Remove unneeded casts
-
-get_robust_list.2
-get_thread_area.2
-getcpu.2
-getdents.2
-gettid.2
-io_cancel.2
-io_destroy.2
-io_getevents.2
-io_setup.2
-io_submit.2
-ioprio_set.2
-kexec_load.2
-llseek.2
-modify_ldt.2
-mq_getsetattr.2
-pivot_root.2
-readdir.2
-rt_sigqueueinfo.2
-set_thread_area.2
-sgetmask.2
-spu_create.2
-spu_run.2
-subpage_prot.2
-sysctl.2
-tkill.2
- Michael Kerrisk
- Add note to SYNOPSIS that there is no glibc wrapper for system call
- Reduce the chance that the reader may be misled into thinking
- that there is a wrapper function for this system call by noting
- explicitly in the SYNOPSIS that there is no glibc wrapper and
- pointing the reader to NOTES for further details.
-
-ioprio_set.2
- Colin McCabe
- Clarify the multithreaded behavior of ioprio_set(2)
- Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
- Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
- For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
- For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
- process group.
-
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
-
-migrate_pages.2
- Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
- Fix description of return value
-
-mount.2
- Michael Kerrisk
- For MS_REMOUNT, source is ignored
-
-mprotect.2
- Michael Kerrisk [Rasmus Villemoes]
- 'addr' argument is not const
- As reported by Rasmus:
-
- Both my system's man-pages (3.22) and the latest online
- (3.41) show:
-
- int mprotect(const void *addr, size_t len, int prot);
-
- as the prototype for mprotect(2). However, POSIX [1] and the
- actual sys/mman.h (on all the systems I checked) do not have
- the const qualifier on the first argument.
-
-msgctl.2
-semctl.2
-shmctl.2
-svipc.7
- Michael Kerrisk
- Don't mention that ipc_perm is defined in <sys/ipc.h>
- There's no need to mention that the 'ipc_perm' structure
- is defined in <sys/ipc.h>. That's an implementation detail,
- and furthermore <sys/ipc.h> is itself included by the other
- System V IPC header files. The current text might lead the
- reader to conclude that they must include <sys/ipc.h>, which
- is not the case (it is required neither on Linux, nor by the
- standards).
-
-msgctl.2
-msgget.2
-msgop.2
-semctl.2
-semget.2
-semop.2
-shmctl.2
-shmget.2
- Michael Kerrisk
- NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
- Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
- header files aren't required by Linux or the standards, but may
- be needed for portability to old systems.
-
-ptrace.2
- Denys Vlasenko
- Explain WNOHANG behavior and EINTR bug
- I didn't like ithe "SIGKILL operates similarly, with exceptions"
- phrase (if it's different, then it's not "similar", right?),
- and now I got around to changing it. Now it says simply:
- "SIGKILL does not generate signal-delivery-stop and therefore
- the tracer can't suppress it."
+ Global fix: Use consistent capitalization in NAME section
+ The line(s) in the NAME section should only use capitals
+ where English usage dictates that. Otherwise, use
+ lowercase throughout.
- Replaced "why WNOHANG is not reliable" example with a more
- realistic one (the one which actually inspired to add this
- information to man page in the first place): we got
- ESRCH - process is gone! - but waitpid(WNOHANG) can still
- confusingly return 0 "no processes to wait for".
+Various pages
+ Michael Kerrisk
+ Global fix: "userspace" ==> "user space" or "user-space"
+ Existing pages variously use "userspace or "user space".
+ But, "userspace" is not quite an English word.
+ So change "userspace" to "user space" or, when used
+ attributively, "user-space".
- Replaced "This means that unneeded trailing arguments may
- be omitted" part with a much better recommendation
- to never do that and to supply zero arguments instead.
- (The part about "undocumentedness" of gcc behavior was bogus,
- btw - deleted).
- Expanded BUGS section with the explanation and an example
- of visible strace behavior on the buggy syscalls which
- exit with EINTR on ptrace attach. I hope this will lead
- to people submitting better bug reports to lkml about
- such syscalls.
+Changes to individual pages
+---------------------------
-seteuid.2
+clock_getres.2
+clock_nanosleep.2
Michael Kerrisk
- Note glibc version where setegid() implementation changed
- In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
+ Linking with -lrt is no longer needed from glibc 2.17 onward
-set_tid_address.2
+create_module.2
Michael Kerrisk
- Rename 'ctid' argument for consistency with clone(2) page
- Michael Kerrisk
- Some rewordings and minor clarifications
-
-sigwaitinfo.2
- Michael Kerrisk [Daniel Zingaro]
- Some wording clarifications
- Mainly rewording things like "is delivered" to "becomes pending",
- which is more accurate terminology.
-
-syscall.2
+ Note that this system call is present only in kernels before 2.6
Michael Kerrisk
- Add some more details to the description of syscall(2)
- And add another example of using syscall() to the program example.
+ Note that ENOSYS probably indicates kernel 2.6+
-syscalls.2
+execve.2
Michael Kerrisk
- Add kcmp(2)
+ Document treatment of PR_SET_PDEATHSIG on execve()
Michael Kerrisk
- Move discussion of set_zone_reclaim(2) out of main table
- This system call was never visible to user space, so it makes
- sense to move it out of the main table of system calls into
- the notes below the table.
+ Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
-getifaddrs.3
- Michael Kerrisk [Adrian Dabrowski]
- Note that ifa_addr and ifa_netmask can be NULL
-
-readdir.3
- Michael Kerrisk [Jan Engelhardt]
- Handle -1 error from pathconf() in example code snippet
- Improve the example demonstrating allocation of a buffer
- for readdir_r() to handle -1 error return from pathconf().
- Otherwise, naive readers may think that pathconf() return
- value can be used without checking.
+fork.2
+ Michael Kerrisk
+ Note treatment of default timer slack value on fork()
-realpath.3
- Shawn Landden
- Use past tense with ancient history (libc4, libc5)
+getdomainname.2
+ Simon Paillard [Lars Wirzenius]
+ Point out that these calls relate to NIS, not DNS
+ See http://bugs.debian.org/295635
-regex.3
+get_kernel_syms.2
Michael Kerrisk
- Correct SEE ALSO reference to glibc manual "regex" section
+ Note that this system call is present only in kernels before 2.6
-rtime.3
- Michael Kerrisk [Jan Engelhardt]
- Fix broken pointer cast in example code
-
-sem_close.3
-sem_destroy.3
-sem_getvalue.3
-sem_init.3
-sem_open.3
-sem_post.3
-sem_unlink.3
-sem_wait.3
-sem_overview.7
+ipc.2
Michael Kerrisk
- Note that "cc -pthread" is required; "-lrt" no longer works
- See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
+ Update note on architectures that don't have ipc()
+ Replace mention of ia64 with x86-64 and ARM.
-sigwait.3
+link.2
Michael Kerrisk
- Reword "is delivered" to "becomes pending"
+ Add EPERM error triggered by /proc/sys/fs/protected_hardlink
-strcat.3
+prctl.2
Michael Kerrisk
- Add some text to emphasize the dangers of buffer overruns
+ Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
+ Kees Cook
+ update seccomp sections for mode 2 (BPF)
+ This adds a short summary of the arguments used
+ for "mode 2" (BPF) seccomp.
Michael Kerrisk
- NOTES: Add discussion of strlcat()
-
-strcpy.3
+ Small improvements to PR_SET_SECCOMP discussion
+ Note type of 'arg3' for SECCOMP_MODE_FILTER.
+ Add pointer to Documentation/prctl/seccomp_filter.txt.
Michael Kerrisk
- Note that info is lost when strncpy() doesn't null terminate
+ Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
Michael Kerrisk
- Add some text to emphasize possibility of buffer runs with strcpy()
+ Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
Michael Kerrisk
- NOTES: Add a discussion of strlcpy()
- Inspired by https://lwn.net/Articles/506530/
+ Reword PR_SET_NAME and PR_GET_NAME in terms of threads
+ Plus tfix
+ Kees Cook
+ document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
+ This adds a short description of the no_new_privs bit,
+ as described in Documentation/prctl/no_new_privs.txt.
+
+ptrace.2
Michael Kerrisk
- Fix description of the null-byte padding performed by strncpy()
+ Clarify that some operations are not present on all architectures
+ PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
+ and PTRACE_GETSPREGS are not present on all architectures.
+ PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
+ on x86.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
-tsearch.3
+query_module.2
Michael Kerrisk
- NOTES: remove redundant discussion of unorthodox use of term "postorder"
- This point is already covered at greater length in the main
- text of the page (See the piece "More commonly, ...").
+ Add a few words clarifying reference to /sys/module
Michael Kerrisk
- Clarify use for first argument to the twalk() 'action' function
- There's a number of details in POSIX that are omitted in
- the current version of this page.
+ Note that this system call is present only in kernels before 2.6
Michael Kerrisk
- Some wording fixes
-
-core.5
+ Note that ENOSYS probably indicates kernel 2.6+
Michael Kerrisk
- Note effect of madvise(2) MADV_DONTDUMP flag
-
-capabilities.7
+ SEE ALSO: Add modinfo(8) and lsinfo(8)
Michael Kerrisk
- Document CAP_BLOCK_SUSPEND
-
-glob.7
- Bjarni Ingi Gislason
- Change 8 bit characters to 7 bit representation
- Fixes rendering errors for accented 'a' characters.
- Michael Kerrisk [Aaron Peschel]
- Update bash(1) command used to obtain classical globbing behavior
- The man page formerly noted the bash(1) v1 command to do this.
-
-iso_8859-1.7
- Bjarni Ingi Gislason
- Explanation of SOFT HYPHEN and the code for it
- <groff: iso_8859-2.7>:89: warning: can't find special character `shc'
-
- This is the only "iso_8859-*.7" file that has this (now)
- undefined character. The code in column four in "iso_8859-1.7" is
- "0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
- See Debian bug 156154 (or package "manpages").
-
- There should be an explanation for this graphic character and the
- code should be 0xAD in iso_8859-1.7 (as in all others), even
- though "[gn]roff" does not display a "HYPHEN" in that position of
- the table.
-
- The line with "SOFT HYPHEN" gets a footnote and a short
- explanation.
-
-mdoc.7
- Bjarni Ingi Gislason
- Fixing a warning and a table
- Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
-
- <groff: mdoc.7>:294: warning:
- tab character in unquoted macro argument
-
- In one table the distance between columns is too small in the
- "ps" output. (Bug in the groff "doc.tmac" macro?)
-
-mdoc.samples.7
- Bjarni Ingi Gislason
- Fix warnings from [ng]roff, corrections
- From "man -ww ..." (groff -ww ...):
-
- <standard input>:541: warning:
- tab character in unquoted macro argument
- [+3 similar warnings]
- <standard input>:813: warning: macro `Pu' not defined
- Usage: .Rv -std in sections 2 and 3 only (#1669)
- mdoc warning: A .Bl directive has no matching .El (#1821)
-
- String "Pu" defined as a row of punctuation characters.
- ".Bl" and ".El" fixed.
- Some arguments, that start with a period or are the name of a
- macro, protected with "\&".
- Variable name for macro ".Rv" corrected.
-
-netdevice.7
- Bjarni Ingi Gislason
- Line in table too long
- Fix warning from "man ..." ("nroff -ww ..."):
+ Move some information in NOTES to VERSIONS
- nroff: netdevice.7: warning: around line 98:
- table wider than line width
-
- Fix: No right adjustment in text blocks in tables.
-
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
-
-netlink.7
- Bjarni Ingi Gislason
- Line in table is too long
- Fix warning from "man ..." ("nroff -ww ..."):
-
- nroff: netlink.7: warning: around line 195:
- table wider than line width
-
- Horizontal line incorporated into table.
- No right adjustment of text blocks in tables.
-
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
- Simon Paillard [Herbert Xu]
- Change description of "*_pid" fields to "Port ID"
- As reported by Herbert Xu, these should not be considered as PIDs.
+socketcall.2
+ Michael Kerrisk
+ Update note on architectures that don't have socketcall()
+ Replace mention of ia64 with x86-64 and ARM.
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
+times.2
+ Thomas Habets
+ Recommend clock_gettime(2) as alternative to times(2)
-rtnetlink.7
- Bjarni Ingi Gislason
- Line in table too long
- Fix warning from "man ..." ("nroff -ww ..."):
+clock_getcpuclockid.3
+ Michael Kerrisk
+ Linking with -lrt is no longer needed from glibc 2.17 onward
- nroff: rtnetlink.7: warning: around line 415:
- table wider than line width
+fts.3
+ Simon Paillard [James Youngman]
+ Improve description of physical vs. logical tree walking
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505
- Column gutter reduced to fit line length.
- Right adjustment in text blocks removed in tables.
- Some header made centered in tables.
- One table put on same page.
+getenv.3
+ Michael Kerrisk
+ SEE ALSO: add getauxval(3)
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
+proc.5
+ Michael Kerrisk
+ Document /proc/meminfo
+ Info mostly taken from Documentation/filesystems/proc.txt
+ and Documentation/vm/hugetlbpage.txt.
+ Michael Kerrisk
+ Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
+ The default setting of 1 in/proc/sys/fs/protected_hardlinks
+ and /proc/sys/fs/protected_symlinks caused one too many
+ breakages for Linus's taste, so commit 561ec64ae67e changed
+ the default for both files to 0.
+ Note system call error yielded by /proc/sys/fs/protected_symlinks
+ Note that violating 'protected_symlinks' restrictions
+ causes system calls to fail with the error EACCES.
+ Michael Kerrisk
+ Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
-socket.7
- Martin H
- Document SO_MARK socket option
- Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
- the new SO_MARK socket option.
+ipv6.7
+ Bert Hubert
+ Document IPV6_RECVPKTINFO
- This patch is based on text from the commit message.
+man-pages.7
+ Michael Kerrisk
+ Note rules for capitalization in NAME section
- See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
+time.7
+ Michael Kerrisk
+ Add a subsection on timer slack
-svipc.7
+ld.so.8
Michael Kerrisk
- SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
- Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
- and isn't really relevant for the explanation on this page.
+ SEE ALSO: add getauxval(3)
diff -Nru --exclude 'man?' manpages-3.42/Changes.old manpages-3.44/Changes.old
--- manpages-3.42/Changes.old 2012-08-13 18:39:35.000000000 -0400
+++ manpages-3.44/Changes.old 2012-11-07 09:24:38.000000000 -0400
@@ -24035,3 +24035,699 @@
Remove path prefix from NAME line
Command names shown in NAME are normally just the basename,
not the full pathname of the command.
+
+
+==================== Changes in man-pages-3.42 ====================
+
+Released: 2012-08-14, Konolfingen
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Aaron Peschel <aaron.peschel@gmail.com>
+Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
+Akihiro MOTOKI <amotoki@gmail.com>
+Alan Curry <pacman@kosh.dhis.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christoph Lameter <cl@linux.com>
+Colin McCabe <cmccabe@alumni.cmu.edu>
+Daniel Zingaro <daniel.zingaro@utoronto.ca>
+David Prévot <taffit@debian.org>
+Denys Vlasenko <vda.linux@gmail.com>
+Henry Hu <henry.hu.sh@gmail.com>
+Herbert Xu <herbert@gondor.apana.org.au>
+Jan Engelhardt <jengelh@medozas.de>
+Jim Hill <gjthill@gmail.com>
+JoonSoo Kim <js1304@gmail.com>
+Kalle Olavi Niemitalo <kon@iki.fi>
+Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael S. Tsirkin <mst@redhat.com>
+Rasmus Villemoes <Rasmus.Villemoes@decode.is>
+Sami Kerola <kerolasa@iki.fi>
+Sam Varshavchik <mrsam@courier-mta.com>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Tolga Dalman <tolga.dalman@googlemail.com>
+Ulrich Drepper <drepper@gmail.com>
+Марк Коренберг <socketpair@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+Various pages
+ Sami Kerola
+ Global fix: use UR macro where applicable
+ The syntax .UR http://example.com paired with .UE will create
+ links which one can interact, if the pager allows that. One
+ way to see the effect is ask the man(1) command to use browser
+ display, e.g.:
+
+ man -H man7/uri.7
+
+ ("\:" is optional groff syntax to permit hyphenless line breaks.)
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ Add security note on untrusted executables
+ See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
+ and
+ http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
+
+clone.2
+ Michael Kerrisk
+ Rewrite discussion of sys_clone
+
+futex.2
+ Марк Коренберг
+ Consolidate error descriptions to ERRORS
+ Michael Kerrisk
+ Various wording fix-ups
+ Michael Kerrisk
+ Fix description of EINVAL error
+ The current text seems incorrect. Replace with a more general
+ description.
+
+getdents.2
+select_tut.2
+atof.3
+atoi.3
+pthread_create.3
+pthread_sigmask.3
+rtime.3
+setbuf.3
+tsearch.3
+netlink.7
+ Michael Kerrisk [Jan Engelhardt]
+ Remove unneeded casts
+
+get_robust_list.2
+get_thread_area.2
+getcpu.2
+getdents.2
+gettid.2
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ioprio_set.2
+kexec_load.2
+llseek.2
+modify_ldt.2
+mq_getsetattr.2
+pivot_root.2
+readdir.2
+rt_sigqueueinfo.2
+set_thread_area.2
+sgetmask.2
+spu_create.2
+spu_run.2
+subpage_prot.2
+sysctl.2
+tkill.2
+ Michael Kerrisk
+ Add note to SYNOPSIS that there is no glibc wrapper for system call
+ Reduce the chance that the reader may be misled into thinking
+ that there is a wrapper function for this system call by noting
+ explicitly in the SYNOPSIS that there is no glibc wrapper and
+ pointing the reader to NOTES for further details.
+
+ioprio_set.2
+ Colin McCabe
+ Clarify the multithreaded behavior of ioprio_set(2)
+ Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
+ Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
+ For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
+ For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
+ process group.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
+
+migrate_pages.2
+ Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
+ Fix description of return value
+
+mount.2
+ Michael Kerrisk
+ For MS_REMOUNT, source is ignored
+
+mprotect.2
+ Michael Kerrisk [Rasmus Villemoes]
+ 'addr' argument is not const
+ As reported by Rasmus:
+
+ Both my system's man-pages (3.22) and the latest online
+ (3.41) show:
+
+ int mprotect(const void *addr, size_t len, int prot);
+
+ as the prototype for mprotect(2). However, POSIX [1] and the
+ actual sys/mman.h (on all the systems I checked) do not have
+ the const qualifier on the first argument.
+
+msgctl.2
+semctl.2
+shmctl.2
+svipc.7
+ Michael Kerrisk
+ Don't mention that ipc_perm is defined in <sys/ipc.h>
+ There's no need to mention that the 'ipc_perm' structure
+ is defined in <sys/ipc.h>. That's an implementation detail,
+ and furthermore <sys/ipc.h> is itself included by the other
+ System V IPC header files. The current text might lead the
+ reader to conclude that they must include <sys/ipc.h>, which
+ is not the case (it is required neither on Linux, nor by the
+ standards).
+
+msgctl.2
+msgget.2
+msgop.2
+semctl.2
+semget.2
+semop.2
+shmctl.2
+shmget.2
+ Michael Kerrisk
+ NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
+ Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
+ header files aren't required by Linux or the standards, but may
+ be needed for portability to old systems.
+
+ptrace.2
+ Denys Vlasenko
+ Explain WNOHANG behavior and EINTR bug
+ I didn't like the "SIGKILL operates similarly, with exceptions"
+ phrase (if it's different, then it's not "similar", right?),
+ and now I got around to changing it. Now it says simply:
+ "SIGKILL does not generate signal-delivery-stop and therefore
+ the tracer can't suppress it."
+
+ Replaced "why WNOHANG is not reliable" example with a more
+ realistic one (the one which actually inspired to add this
+ information to man page in the first place): we got
+ ESRCH - process is gone! - but waitpid(WNOHANG) can still
+ confusingly return 0 "no processes to wait for".
+
+ Replaced "This means that unneeded trailing arguments may
+ be omitted" part with a much better recommendation
+ to never do that and to supply zero arguments instead.
+ (The part about "undocumentedness" of gcc behavior was bogus,
+ btw - deleted).
+
+ Expanded BUGS section with the explanation and an example
+ of visible strace behavior on the buggy syscalls which
+ exit with EINTR on ptrace attach. I hope this will lead
+ to people submitting better bug reports to lkml about
+ such syscalls.
+
+seteuid.2
+ Michael Kerrisk
+ Note glibc version where setegid() implementation changed
+ In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
+
+set_tid_address.2
+ Michael Kerrisk
+ Rename 'ctid' argument for consistency with clone(2) page
+ Michael Kerrisk
+ Some rewordings and minor clarifications
+
+sigwaitinfo.2
+ Michael Kerrisk [Daniel Zingaro]
+ Some wording clarifications
+ Mainly rewording things like "is delivered" to "becomes pending",
+ which is more accurate terminology.
+
+syscall.2
+ Michael Kerrisk
+ Add some more details to the description of syscall(2)
+ And add another example of using syscall() to the program example.
+
+syscalls.2
+ Michael Kerrisk
+ Add kcmp(2)
+ Michael Kerrisk
+ Move discussion of set_zone_reclaim(2) out of main table
+ This system call was never visible to user space, so it makes
+ sense to move it out of the main table of system calls into
+ the notes below the table.
+
+getifaddrs.3
+ Michael Kerrisk [Adrian Dabrowski]
+ Note that ifa_addr and ifa_netmask can be NULL
+
+readdir.3
+ Michael Kerrisk [Jan Engelhardt]
+ Handle -1 error from pathconf() in example code snippet
+ Improve the example demonstrating allocation of a buffer
+ for readdir_r() to handle -1 error return from pathconf().
+ Otherwise, naive readers may think that pathconf() return
+ value can be used without checking.
+
+realpath.3
+ Shawn Landden
+ Use past tense with ancient history (libc4, libc5)
+
+regex.3
+ Michael Kerrisk
+ Correct SEE ALSO reference to glibc manual "regex" section
+
+rtime.3
+ Michael Kerrisk [Jan Engelhardt]
+ Fix broken pointer cast in example code
+
+sem_close.3
+sem_destroy.3
+sem_getvalue.3
+sem_init.3
+sem_open.3
+sem_post.3
+sem_unlink.3
+sem_wait.3
+sem_overview.7
+ Michael Kerrisk
+ Note that "cc -pthread" is required; "-lrt" no longer works
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
+
+sigwait.3
+ Michael Kerrisk
+ Reword "is delivered" to "becomes pending"
+
+strcat.3
+ Michael Kerrisk
+ Add some text to emphasize the dangers of buffer overruns
+ Michael Kerrisk
+ NOTES: Add discussion of strlcat()
+
+strcpy.3
+ Michael Kerrisk
+ Note that info is lost when strncpy() doesn't null terminate
+ Michael Kerrisk
+ Add some text to emphasize possibility of buffer runs with strcpy()
+ Michael Kerrisk
+ NOTES: Add a discussion of strlcpy()
+ Inspired by https://lwn.net/Articles/506530/
+ Michael Kerrisk
+ Fix description of the null-byte padding performed by strncpy()
+
+tsearch.3
+ Michael Kerrisk
+ NOTES: remove redundant discussion of unorthodox use of term "postorder"
+ This point is already covered at greater length in the main
+ text of the page (See the piece "More commonly, ...").
+ Michael Kerrisk
+ Clarify use for first argument to the twalk() 'action' function
+ There's a number of details in POSIX that are omitted in
+ the current version of this page.
+ Michael Kerrisk
+ Some wording fixes
+
+core.5
+ Michael Kerrisk
+ Note effect of madvise(2) MADV_DONTDUMP flag
+
+capabilities.7
+ Michael Kerrisk
+ Document CAP_BLOCK_SUSPEND
+
+glob.7
+ Bjarni Ingi Gislason
+ Change 8 bit characters to 7 bit representation
+ Fixes rendering errors for accented 'a' characters.
+ Michael Kerrisk [Aaron Peschel]
+ Update bash(1) command used to obtain classical globbing behavior
+ The man page formerly noted the bash(1) v1 command to do this.
+
+iso_8859-1.7
+ Bjarni Ingi Gislason
+ Explanation of SOFT HYPHEN and the code for it
+ <groff: iso_8859-2.7>:89: warning: can't find special character `shc'
+
+ This is the only "iso_8859-*.7" file that has this (now)
+ undefined character. The code in column four in "iso_8859-1.7" is
+ "0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
+ See Debian bug 156154 (or package "manpages").
+
+ There should be an explanation for this graphic character and the
+ code should be 0xAD in iso_8859-1.7 (as in all others), even
+ though "[gn]roff" does not display a "HYPHEN" in that position of
+ the table.
+
+ The line with "SOFT HYPHEN" gets a footnote and a short
+ explanation.
+
+mdoc.7
+ Bjarni Ingi Gislason
+ Fixing a warning and a table
+ Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
+
+ <groff: mdoc.7>:294: warning:
+ tab character in unquoted macro argument
+
+ In one table the distance between columns is too small in the
+ "ps" output. (Bug in the groff "doc.tmac" macro?)
+
+mdoc.samples.7
+ Bjarni Ingi Gislason
+ Fix warnings from [ng]roff, corrections
+ From "man -ww ..." (groff -ww ...):
+
+ <standard input>:541: warning:
+ tab character in unquoted macro argument
+ [+3 similar warnings]
+ <standard input>:813: warning: macro `Pu' not defined
+ Usage: .Rv -std in sections 2 and 3 only (#1669)
+ mdoc warning: A .Bl directive has no matching .El (#1821)
+
+ String "Pu" defined as a row of punctuation characters.
+ ".Bl" and ".El" fixed.
+ Some arguments, that start with a period or are the name of a
+ macro, protected with "\&".
+ Variable name for macro ".Rv" corrected.
+
+netdevice.7
+ Bjarni Ingi Gislason
+ Line in table too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: netdevice.7: warning: around line 98:
+ table wider than line width
+
+ Fix: No right adjustment in text blocks in tables.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
+
+netlink.7
+ Bjarni Ingi Gislason
+ Line in table is too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: netlink.7: warning: around line 195:
+ table wider than line width
+
+ Horizontal line incorporated into table.
+ No right adjustment of text blocks in tables.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
+ Simon Paillard [Herbert Xu]
+ Change description of "*_pid" fields to "Port ID"
+ As reported by Herbert Xu, these should not be considered as PIDs.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
+
+rtnetlink.7
+ Bjarni Ingi Gislason
+ Line in table too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: rtnetlink.7: warning: around line 415:
+ table wider than line width
+
+ Column gutter reduced to fit line length.
+ Right adjustment in text blocks removed in tables.
+ Some header made centered in tables.
+ One table put on same page.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
+
+socket.7
+ Martin H
+ Document SO_MARK socket option
+ Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
+ the new SO_MARK socket option.
+
+ This patch is based on text from the commit message.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
+
+svipc.7
+ Michael Kerrisk
+ SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
+ Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
+ and isn't really relevant for the explanation on this page.
+
+
+==================== Changes in man-pages-3.43 ====================
+
+Released: 2012-10-05, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adrian Bunk <bunk@kernel.org>
+Anatoli Klassen <anatoli@aksoft.net>
+Andreas Schwab <schwab@linux-m68k.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+David Prévot <taffit@debian.org>
+Eric Dumazet <edumazet@google.com>
+Florian Weimer <fweimer@redhat.com>
+Frédéric Brière <fbriere@fbriere.net>
+Fredrik Arnerup <arnerup@kth.se>
+Guillem Jover <guillem@hadrons.org>
+Jan Engelhardt <jengelh@inai.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Simon Josefsson <simon@josefsson.org>
+Stephane Fillod <fillods@users.sf.net>
+Trevor Woerner <twoerner@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+getenv.3
+ Michael Kerrisk [Florian Weimer, Andreas Schwab]
+ Document secure_getenv(3)
+
+
+New and changed links
+---------------------
+
+phys.2
+ Michael Kerrisk
+ New link to unimplemented.2
+
+secure_getenv.3
+ Michael Kerrisk
+ New link to getenv.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
+
+Various pages
+ David Prévot [Michael Kerrisk]
+ Global fix: Various consistency fixes for SEE ALSO
+
+Various pages
+ Michael Kerrisk
+ Global fix: use "Linux kernel source" consistently
+ Rather than "kernel source".
+
+Various pages
+ Michael Kerrisk
+ Global fix: disable justification and hyphenation in SEE ALSO
+ For a better visual result, disable justification and hyphenation
+ in SEE ALSO where page names are long.
+
+syscalls.2
+uname.2
+boot.7
+ Michael Kerrisk
+ Global fix: s/OS/operating system/
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Fredrik Arnerup]
+ Describe timeout limitation in kernels < 2.6.37
+ As reported by Fredrik (and as far as I can tell the problem
+ went back to 2.6.0):
+
+ The timeout argument has an upper limit. Any values above that
+ limit are treated the same as -1, i.e. to wait indefinitely.
+ The limit is given by:
+
+ #define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
+ (LONG_MAX - 999ULL) / HZ)
+
+ That is, the limit depends on the size of a long and the timer
+ frequency. Assuming the a long is never smaller than 32 bits
+ and HZ never larger than 1000, the worst case is 35 minutes.
+ I think this should be mentioned under "BUGS".
+
+ Although this is likely to be fixed in the future
+ (http://lkml.org/lkml/2010/8/8/144), the problem exists in
+ at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
+ are affected.
+
+ https://bugzilla.kernel.org/show_bug.cgi?id=20762
+ Michael Kerrisk
+ Add pointer to select(2) for discussion of close in another thread
+
+getitimer.2
+ Michael Kerrisk [Trevor Woerner]
+ Note Linux's odd handling of the new_value==NULL case
+ Michael Kerrisk [Trevor Woerner]
+ Fix types used to declare fields in timeval struct
+
+keyctl.2
+ David Prévot
+ Reorder SEE ALSO, without .br
+
+poll.2
+ Michael Kerrisk
+ Add pointer to select(2) for discussion of close in another thread
+
+select.2
+ Michael Kerrisk [Stephane Fillod]
+ Note behavior if monitored file descriptor is closed in another thread
+ Executive summary: a sane application can't rely on any
+ particular behavior if another thread closes a file descriptor
+ being monitored by select().
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=40852
+ Michael Kerrisk
+ Clarify equivalent pselect() code in terms of threads
+ s/sigprogmask/pthread_sigmask/
+
+semop.2
+ Michael Kerrisk
+ Recast discussion of blocking behavior in terms of threads
+ semop() blocks the calling thread, not the process.
+ Michael Kerrisk
+ SEE ALSO: Add clone(2)
+ Give reader a clue about CLONE_SYSVSEM.
+
+shutdown.2
+ Michael Kerrisk [Eric Dumazet]
+ Document EINVAL error (and associated bug)
+ Eric Dumazet noted that EINVAL was not documented. Some further
+ digging shows that it's also not diagnosed consistently.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=47111.
+
+sigaction.2
+ Michael Kerrisk
+ Tweak SA_RESETHAND description
+
+timer_settime.2
+ Michael Kerrisk
+ Small rewording around discussion of pointer arguments
+
+wait4.2
+ Adrian Bunk
+ Note that these functions are nonstandard and recommend alternatives
+ Some edits to Adrian's patch by mtk.
+ Michael Kerrisk
+ CONFORMING TO: Note SUS details for wait3()
+
+gnu_get_libc_version.3
+ Michael Kerrisk
+ Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
+
+pthread_kill.3
+pthread_sigqueue.3
+ Michael Kerrisk
+ Remove wording "another"
+ Writing "another thread" in these pages implies that these
+ functions can't be used to send a signal to the calling thread
+ itself, which is of course untrue.
+
+sigvec.3
+ Michael Kerrisk
+ Add "int" arg to sv_handler definition in sigvec structure
+ Michael Kerrisk
+ Fix small error in discussion of blocking of signals
+ The signal that causes the handler to be invoked is blocked,
+ but saying "by default" implies that this can be changed via
+ the API. It cannot. (One needs sigaction(2) for that.)
+
+syslog.3
+ Simon Josefsson
+ Remove (apparently bogus) text claiming LOG_AUTH is deprecated
+ LOG_AUTH is in POSIX, and widely available. There
+ seems to be no basis to the claim it is deprecated.
+
+ Quoting Simon:
+ I cannot find any other source that claim LOG_AUTH is
+ deprecated in any way. LOG_AUTH is distinct from
+ LOG_AUTHPRIV. The GNU C Library manual only documents
+ LOG_AUTH. The header files contains both without any
+ comment. Common systems like Debian appear to refer to
+ both auth and authpriv facilities in syslog configurations.
+ Popular daemons appear to use both facilities.
+ Both facilities are discussed in several RFCs.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46091
+
+ttyname.3
+ Michael Kerrisk
+ SEE ALSO: Add ctermid(3)
+
+proc.5
+ Michael Kerrisk
+ Clarify header file related to 'flags' field of /proc/PID/stat
+ Michael Kerrisk [Frédéric Brière]
+ Update description of 'starttime' field of /proc/PID/stat
+ The unit of measurement changed from jiffies to clock ticks in
+ Linux 2.6.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891
+ Michael Kerrisk
+ Document /proc/sys/kernel/kptr_restrict
+ Michael Kerrisk [Kees Cook]
+ Document /proc/sys/fs/protected_symlinks
+ Based on text in Documentation/sysctl/fs.txt by Kees Cook
+ Michael Kerrisk [Kees Cook]
+ Document /proc/sys/fs/protected_hardlinks
+ Based on text in Documentation/sysctl/fs.txt by Kees Cook
+
+capabilities.7
+ Michael Kerrisk
+ Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
+
+ip.7
+ Michael Kerrisk
+ SEE ALSO: Add ipv6(7)
+ SEE ALSO: Add icmp(7)
+
+man-pages.7
+ Michael Kerrisk
+ Add some advice about disabling hyphenation in SEE ALSO
+
+ld.so.8
+ Michael Kerrisk
+ Describe interpretation of slashes in dependency strings
+ Michael Kerrisk
+ Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
+ This point is already noted when discussing search order for
+ libraries, but it's worth repeating under the specific discussion
+ of LD_LIBRARY_PATH further down the page.
+ Michael Kerrisk
+ Add some details for LD_PRELOAD
+ Note that LD_PRELOAD list separator can be space or colon
diff -Nru --exclude 'man?' manpages-3.42/debian/changelog manpages-3.44/debian/changelog
--- manpages-3.42/debian/changelog 2012-12-01 18:34:33.000000000 -0400
+++ manpages-3.44/debian/changelog 2012-12-01 18:34:34.000000000 -0400
@@ -1,3 +1,23 @@
+manpages (3.44-1) unstable; urgency=low
+
+ * Imported Upstream version 3.44: (Closes: #692595)
+ . new manpages: getauxval.3 secure_getenv.3
+ . major update to delete_module.2 init_module.2 prctl.2 getauxval.3 proc.5
+ . fts.3: Improve description of physical vs. logical (Closes: #633505)
+ . getdomainname.2: these calls relate to NIS, not DNS (Closes: #295635)
+ . proc.5: fix 'starttime' description of /proc/PID/stat (Closes: #675891)
+ . ptrace.2: Clarify some operations are not present on all
+ architectures (Closes: #122383)
+ * motd.5 updated and motd.tail removed: due to new behaviour of sysvinit
+ 2.88dsf-24 (Closes: #691414)
+ * Add glibc-doc-reference to package description (Closes: #640764)
+ * fputs.3: missing space in putc(c,stdout) (Closes: #693255)
+ * resolv.conf.5: Document IPv6 format for nameserver (Closes: #610036)
+ * stat.2: Clarify description of EOVERFLOW error (Closes: #604928)
+ * Ack my NMUs (Closes: #651476, #670874)
+
+ -- Simon Paillard <spaillard@debian.org> Fri, 16 Nov 2012 19:56:48 +0100
+
manpages (3.42-1) unstable; urgency=low
[ Simon Paillard ]
diff -Nru --exclude 'man?' manpages-3.42/debian/check-conflicts manpages-3.44/debian/check-conflicts
--- manpages-3.42/debian/check-conflicts 1969-12-31 20:00:00.000000000 -0400
+++ manpages-3.44/debian/check-conflicts 2012-12-01 18:34:34.000000000 -0400
@@ -0,0 +1,18 @@
+#!/bin/bash
+
+BASEMAN="/usr/share/man"
+
+which apt-file >/dev/null 2>&1
+if [ $? -ne 0 ] ; then
+ echo "apt-file is required" 1>&2 ;
+ exit 1
+fi
+
+echo -e "WARNING: This tool assumes apt-file has been updated based on sid\n" 1>&2 ;
+
+
+for j in man*/*.* ;
+ do (dpkg -S "$BASEMAN/$j.gz" 2>/dev/null || apt-file search "$BASEMAN/$j.gz") \
+ | grep -v '^manpages:' \
+ | grep -v '^manpages-dev:' ;
+done
diff -Nru --exclude 'man?' manpages-3.42/debian/control manpages-3.44/debian/control
--- manpages-3.42/debian/control 2012-12-01 18:34:33.000000000 -0400
+++ manpages-3.44/debian/control 2012-12-01 18:34:34.000000000 -0400
@@ -5,8 +5,8 @@
Priority: important
Build-Depends: debhelper (>= 7)
Standards-Version: 3.9.3
-Vcs-Browser: http://cvs.infodrom.org/manpages/?cvsroot=debian
-Vcs-CVS: :pserver:anonymous@cvs.infofrom.org:/var/cvs/debian manpages
+Vcs-Browser: http://anonscm.debian.org/gitweb/?p=collab-maint/manpages.git
+Vcs-Git: git://anonscm.debian.org/collab-maint/manpages.git
Homepage: http://www.kernel.org/doc/man-pages/
Package: manpages
@@ -39,4 +39,4 @@
these two sections:
2 = Linux system calls.
3 = Library calls (note that a more comprehensive source of information
- may be found in the glibc-doc package).
+ may be found in the glibc-doc and glibc-doc-reference packages).
diff -Nru --exclude 'man?' manpages-3.42/debian/inst manpages-3.44/debian/inst
--- manpages-3.42/debian/inst 2012-12-01 18:34:33.000000000 -0400
+++ manpages-3.44/debian/inst 2012-12-01 18:34:34.000000000 -0400
@@ -15,13 +15,15 @@
for j in $i/*.*; do
echo -n ${j#*/}
case ${j#*/} in
- time.1|ldd.1|\
+ time.1|\
console.4|fd.4|fstab.5|ftpusers.5|lilo.conf.5|nfs.5|exports.5|ttytype.5|\
- passwd.5|lilo.8|zic.8|zdump.8|ldconfig.8|nscd.conf.5|nscd.8|\
- mdoc.samples.7|environ.5|\
- ld.so.8)
+ passwd.5|lilo.8|zic.8|zdump.8|\
+ mdoc.samples.7|environ.5)
echo -n "(skipped)"
;;
+ ldd.1|ldconfig.8|ld.so.8|nscd.conf.5|nscd.8)
+ echo -n "(skipped, provided by eglibc)"
+ ;;
*)
read Y < $j
case "$Y" in
@@ -63,11 +65,13 @@
case ${j#*/} in
intro.*)
;;
- infnan.3|fgetxattr.2|flistxattr.2|fremovexattr.2|fsetxattr.2|\
+ infnan.3|query_module.2|set_mempolicy.2)
+ echo -n "(skipped)"
+ ;;
+ fgetxattr.2|flistxattr.2|fremovexattr.2|fsetxattr.2|\
getxattr.2|lgetxattr.2|listxattr.2|llistxattr.2|lremovexattr.2|\
- query_module.2|set_mempolicy.2|\
lsetxattr.2|removexattr.2|setxattr.2)
- echo -n "(skipped)"
+ echo -n "(skipped, provided by libattr1-dev)"
;;
*)
read Y < $j
diff -Nru --exclude 'man?' manpages-3.42/Makefile manpages-3.44/Makefile
--- manpages-3.42/Makefile 2012-08-13 18:39:35.000000000 -0400
+++ manpages-3.44/Makefile 2012-11-07 09:24:38.000000000 -0400
@@ -55,5 +55,18 @@
install -m 644 "$$i"/* $(DESTDIR)$(MANDIR)/"$$i" || exit $$?; \
done; \
+# Check if groff reports warnings (may be words of sentances not displayed)
+# from http://lintian.debian.org/tags/manpage-has-errors-from-man.html
+GROFF_LOG := $(shell mktemp /tmp/manpages-checksXXXX)
+check-groff-warnings:
+ for i in man?/*.[1-9]; \
+ do \
+ if grep -q 'SH.*NAME' $$i; then \
+ LC_ALL=en_US.UTF-8 MANWIDTH=80 man --warnings -E UTF-8 -l $$i > /dev/null 2>$(GROFF_LOG); \
+ [ -s $(GROFF_LOG) ] && ( echo "$$i: " ; cat $(GROFF_LOG) ; echo "" ); \
+ rm $(GROFF_LOG) 2>/dev/null; \
+ fi \
+ done
+
# someone might also want to look at /var/catman/cat2 or so ...
# a problem is that the location of cat pages varies a lot
diff -Nru --exclude 'man?' manpages-3.42/man-pages-3.42.Announce manpages-3.44/man-pages-3.42.Announce
--- manpages-3.42/man-pages-3.42.Announce 2012-08-13 18:39:35.000000000 -0400
+++ manpages-3.44/man-pages-3.42.Announce 1969-12-31 20:00:00.000000000 -0400
@@ -1,62 +0,0 @@
-RELEASE
-The Linux man page maintainer proudly announces. . .
-
- man-pages-3.42.tar.gz - man pages for Linux
-
-Differences from the previous manual pages release are listed in
-the file "Changes".
-
-For further information, visit http://www.kernel.org/doc/man-pages/
-
-POSIX PAGES
-This package used to contains a copy of the POSIX 1003.1-2003
-man pages. The POSIX pages are now distributed in the separate
-man-pages-posix package.
-
-THE PAGES
-These pages are most of the section 2, 3, 4, 5, 7 man pages
-for Linux. A few pages are provided in sections 1 and 8 for commands
-that are not documented in other packages, and there are a few pages
-in sections 5 and 8 for the timezone utilities.
-
-[The timezone pages were taken from
-ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.]
-[The section 3 man pages for the db routines have been taken from
-ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.]
-[The rpc man pages were taken from the 4.4BSD-Lite CDROM.]
-
-Here is a breakdown of what this distribution contains:
-
- Section 1 = user commands (intro, plus a few other pages)
- Section 2 = system calls
- Section 3 = libc calls
- Section 4 = devices (e.g., hd, sd)
- Section 5 = file formats and protocols (e.g., wtmp, /etc/passwd, nfs)
- Section 6 = games (intro only)
- Section 7 = overviews, conventions, macro packages, etc.
- Section 8 = system administration (intro, plus a few other pages)
-
- This package contains no, or very few, section 1, 6, and 8 man pages
- because these should be distributed with the binaries they are written
- for. Sometimes Section 9 is used for man pages describing parts of
- the kernel.
-
- Note that only Section 2 is rather complete, but Section 3 contains
- several hundred man pages. If you want to write some man pages,
- or suggest improvments to existing pages, please visit
- http://www.kernel.org/doc/man-pages/ .
-
-
-Copyright information:
-
- These man pages are distributed under a variety of copyright licenses.
- Although these licenses permit free distribution of the nroff sources
- contained in this package, commercial distribution may impose other
- requirements (e.g., acknowledgement of copyright or inclusion of the
- raw nroff sources with the commercial distribution).
- If you distribute these man pages commercially, it is your
- responsibility to figure out your obligations. (For many man pages,
- these obligations require you to distribute nroff sources with any
- pre-formatted man pages that you provide.) Each file that contains
- nroff source for a man page also contains the author(s) name, email
- address, and copyright notice.
diff -Nru --exclude 'man?' manpages-3.42/man-pages-3.42.lsm manpages-3.44/man-pages-3.42.lsm
--- manpages-3.42/man-pages-3.42.lsm 2012-08-13 18:39:35.000000000 -0400
+++ manpages-3.44/man-pages-3.42.lsm 1969-12-31 20:00:00.000000000 -0400
@@ -1,14 +0,0 @@
-Begin3
-Title: Section 2, 3, 4, 5 and 7 man pages for Linux
-Version: 3.42
-Entered-date: 2012-08-14
-Description: Linux manual pages
-Keywords: man pages
-Author: several
-Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com>
-Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages
- 1760k man-pages-3.42.tar.gz
-Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages
-Copying-policy: several; the pages are all freely distributable as long as
- nroff source is provided
-End
diff -Nru --exclude 'man?' manpages-3.42/man-pages-3.44.Announce manpages-3.44/man-pages-3.44.Announce
--- manpages-3.42/man-pages-3.44.Announce 1969-12-31 20:00:00.000000000 -0400
+++ manpages-3.44/man-pages-3.44.Announce 2012-11-07 09:24:38.000000000 -0400
@@ -0,0 +1,62 @@
+RELEASE
+The Linux man page maintainer proudly announces. . .
+
+ man-pages-3.44.tar.gz - man pages for Linux
+
+Differences from the previous manual pages release are listed in
+the file "Changes".
+
+For further information, visit http://www.kernel.org/doc/man-pages/
+
+POSIX PAGES
+This package used to contains a copy of the POSIX 1003.1-2003
+man pages. The POSIX pages are now distributed in the separate
+man-pages-posix package.
+
+THE PAGES
+These pages are most of the section 2, 3, 4, 5, 7 man pages
+for Linux. A few pages are provided in sections 1 and 8 for commands
+that are not documented in other packages, and there are a few pages
+in sections 5 and 8 for the timezone utilities.
+
+[The timezone pages were taken from
+ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.]
+[The section 3 man pages for the db routines have been taken from
+ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.]
+[The rpc man pages were taken from the 4.4BSD-Lite CDROM.]
+
+Here is a breakdown of what this distribution contains:
+
+ Section 1 = user commands (intro, plus a few other pages)
+ Section 2 = system calls
+ Section 3 = libc calls
+ Section 4 = devices (e.g., hd, sd)
+ Section 5 = file formats and protocols (e.g., wtmp, /etc/passwd, nfs)
+ Section 6 = games (intro only)
+ Section 7 = overviews, conventions, macro packages, etc.
+ Section 8 = system administration (intro, plus a few other pages)
+
+ This package contains no, or very few, section 1, 6, and 8 man pages
+ because these should be distributed with the binaries they are written
+ for. Sometimes Section 9 is used for man pages describing parts of
+ the kernel.
+
+ Note that only Section 2 is rather complete, but Section 3 contains
+ several hundred man pages. If you want to write some man pages,
+ or suggest improvments to existing pages, please visit
+ http://www.kernel.org/doc/man-pages/ .
+
+
+Copyright information:
+
+ These man pages are distributed under a variety of copyright licenses.
+ Although these licenses permit free distribution of the nroff sources
+ contained in this package, commercial distribution may impose other
+ requirements (e.g., acknowledgement of copyright or inclusion of the
+ raw nroff sources with the commercial distribution).
+ If you distribute these man pages commercially, it is your
+ responsibility to figure out your obligations. (For many man pages,
+ these obligations require you to distribute nroff sources with any
+ pre-formatted man pages that you provide.) Each file that contains
+ nroff source for a man page also contains the author(s) name, email
+ address, and copyright notice.
diff -Nru --exclude 'man?' manpages-3.42/man-pages-3.44.lsm manpages-3.44/man-pages-3.44.lsm
--- manpages-3.42/man-pages-3.44.lsm 1969-12-31 20:00:00.000000000 -0400
+++ manpages-3.44/man-pages-3.44.lsm 2012-11-07 09:24:38.000000000 -0400
@@ -0,0 +1,14 @@
+Begin3
+Title: Section 2, 3, 4, 5 and 7 man pages for Linux
+Version: 3.44
+Entered-date: 2012-11-07
+Description: Linux manual pages
+Keywords: man pages
+Author: several
+Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com>
+Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages
+ 1773k man-pages-3.44.tar.gz
+Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages
+Copying-policy: several; the pages are all freely distributable as long as
+ nroff source is provided
+End
Reply to: