Start of man-pages-3.69: updating Changes and Changes.old

1 files changed, 451 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 2b3ae642b..7c96f6aad 100644
--- a/Changes.old
+++ b/Changes.old
@@ -31934,3 +31934,454 @@ sched.7
             should have been trimmed from this page.
     Michael Kerrisk
         SEE ALSO: Mention more files in Documentation/scheduler/ directory
+
+
+==================== Changes in man-pages-3.68 ====================
+
+Released: 2014-05-28, Munich
+
+Alastair McKinstry <mckinstry@computer.org>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Colin Williams <colinwilliams1968@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Lars Wirzenius <liw@iki.fi>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Braakman <richard.braakman@jollamobile.com>
+Simon Paillard <spaillard@debian.org>
+
+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:
+
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+localedef.1
+    Marko Myllynen  [Richard Braakman, Alastair McKinstry, Lars Wirzenius]
+        New page for localedef(1)
+            Add new page based on Debian localedef(1) page.
+
+
+New and changed links
+---------------------
+
+procfs.5
+    New link to proc.5
+        Since the term "procfs" is widely used, it seems reasonable to have
+        a link from that name to proc(5).
+
+
+Changes to individual pages
+---------------------------
+
+locale.1
+    Marko Myllynen
+        Provide a step-by-step example of how to use a custom locale
+    Marko Myllynen
+        Use LC_TELEPHONE instead of LC_MESSAGES in the example
+            yesstr/nostr in LC_MESSAGES are planned to be changed at some
+            point [1], so it's better to provide an example which won't
+            be obsoleted by that change.
+
+            [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
+
+adjtimex.2
+    Michael Kerrisk
+        Add featute test macro requirements
+
+clone.2
+    Michael Kerrisk
+        ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
+
+fork.2
+    Michael Kerrisk
+        ERRORS: add pid_max and threads-max to EAGAIN
+            And rewrite text to be the same as pthread_create(3).
+
+getrlimit.2
+    Michael Kerrisk
+        RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
+
+remap_file_pages.2
+    Rasmus Villemoes
+        Fix prototype
+            The pgoff argument has type size_t, not ssize_t (and in the
+            kernel it is unsigned long).
+
+set_mempolicy.2
+    Rasmus Villemoes
+        Fix prototype for set_mempolicy(2)
+            The nodemask argument is const. The return type in numaif.h is long.
+
+swapon.2
+    Rasmus Villemoes
+        Remove header from synopsis
+            The <asm/page.h> header is not readily available, and the comment
+            seems to indicate that it is for getting PAGE_SIZE. But it is
+            never mentioned why one would need to know that, and it is in any
+            case better obtained using sysconf(), provided by <unistd.h>.
+
+a64l.3
+    Rasmus Villemoes
+        Fix prototype for a64l()
+            The argument is const, both according to POSIX and the
+            glibc headers.
+
+adjtime.3
+    Rasmus Villemoes
+        Add required header
+            The prototype for adjtime(3) is declared in <sys/time.h>.
+
+argz_add.3
+    Rasmus Villemoes
+        Fix prototypes
+            Update the prototypes of argz_{delete,extract,next} to agree with
+            glibc headers and manual.
+
+bstring.3
+    Rasmus Villemoes
+        Fix prototypes
+            The length parameter n has type size_t in bcmp(), bcopy() and
+            bzero().
+
+envz_add.3
+    Rasmus Villemoes
+        Fix prototypes
+            The envz_len parameters for envz_entry() and envz_get() are not
+            passed by reference.
+
+fpathconf.3
+    Rasmus Villemoes
+        Fix prototype
+            The path argument to pathconf() is const.
+
+fseek.3
+    Rasmus Villemoes
+        Fix prototype
+            The pos argument to fsetpos() is const.
+
+gcvt.3
+    Rasmus Villemoes
+        Fix prototype
+            The ndigit paramenter to gcvt() has type int.
+
+getaddrinfo_a.3
+    Rasmus Villemoes
+        Fix prototype
+            The pointer arguments to gai_suspend() are const.
+
+getauxval.3
+    Rasmus Villemoes
+        Fix permissions
+            There doesn't seem to be any reason for getauxval.3 to be
+            executable...
+
+getnameinfo.3
+    Rasmus Villemoes
+        Fix prototype
+            The hostlen and servlen parameters have type socklet_t.
+            (The types changed in glibc 2.2)
+    Michael Kerrisk
+        Note types of 'hostlen'; and 'servlen' in glibc < 2.2
+
+getrpcent.3
+    Rasmus Villemoes
+        Fix prototype
+            The argument to getrpcbyname() is const.
+
+getrpcport.3
+    Rasmus Villemoes
+        Add #include and fix prototype
+            The prototype for getrpcport() is obtained by #include'ing
+            <rpc/rpc.h>. Also, update its prototype.
+
+getspnam.3
+    Rasmus Villemoes
+        Fix prototype
+            The struct spwd argument to putspent() is const.
+
+getutent.3
+    Rasmus Villemoes
+        Fix prototypes
+            The arguments to getutid(), getutline(), and pututline()
+            are const.
+
+inet.3
+    Rasmus Villemoes
+        Fix prototype
+            The parameters to inet_makeaddr have type in_addr_t.
+
+inet_net_pton.3
+    Rasmus Villemoes
+        srcfix, cfix
+            Use a consistent style throughout the man-pages.
+
+key_setsecret.3
+    Rasmus Villemoes
+        Fix prototypes
+            Remove const qualifiers from arguments to key_decryptsession,
+            key_encryptsession, and key_setsecret.
+
+makecontext.3
+    Rasmus Villemoes
+        Fix prototype
+            The second argument to swapcontext() is const.
+
+makedev.3
+    Rasmus Villemoes
+        Fix prototype
+            gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
+            two unsigned int parameters; this is consistent with it being the
+            inverse of (gnu_dev_)major/minor, which return unsigned int.
+
+malloc_trim.3
+    Rasmus Villemoes
+        Fix prototype
+            As mentioned further down, malloc_trim returns an integer.
+
+mq_getattr.3
+    Rasmus Villemoes
+        Fix prototype
+            The newattr parameter to mq_setattr is const.
+
+newlocale.3
+    Marko Myllynen
+        List all available category masks
+    Michael Kerrisk
+        Add LC_ALL_MASK description
+
+nl_langinfo.3
+    Marko Myllynen
+        Expand the example code a bit
+            Better illustrate querying elements from different categories.
+
+perror.3
+    Rasmus Villemoes
+        Fix declaration
+            The elements of the array sys_errlist are also const.
+
+pthread_attr_setaffinity_np.3
+pthread_attr_setdetachstate.3
+pthread_attr_setguardsize.3
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_attr_setscope.3
+pthread_attr_setstack.3
+pthread_attr_setstackaddr.3
+pthread_attr_setstacksize.3
+    Rasmus Villemoes
+        Constify parameters
+            Each of the pthread_attr_get* functions extract some piece of
+            information from a pthread_attr_t, which is passed by const
+            reference. Add the const keyword to the prototypes of these
+            functions.
+
+pthread_cleanup_push_defer_np.3
+    Michael Kerrisk  [Rasmus Villemoes]
+        Add feature test macro requirements
+
+pthread_create.3
+    Michael Kerrisk  [Carsten Grohmann]
+        Add pid_max limit to EAGAIN error cases
+
+pthread_equal.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_equal() is thread safe.
+
+pthread_exit.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_exit() is thread safe.
+
+pthread_getcpuclockid.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_getcpuclockid() is thread safe.
+
+pthread_setaffinity_np.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions pthread_setaffinity_np() and
+            pthread_getaffinity_np() are thread safe.
+
+pthread_setconcurrency.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions pthread_setconcurrency() and
+            pthread_getconcurrency() are thread safe.
+
+pthread_setname_np.3
+    Rasmus Villemoes
+        Fix prototype
+            The name parameter of pthread_getname_np is an output parameter and
+            hence not const.
+
+pthread_setschedparam.3
+    Rasmus Villemoes
+        Fix prototypes
+            Add return type for pthread_{s,g}etschedparam.
+
+pthread_setschedprio.3
+    Rasmus Villemoes
+        Fix prototype
+            Add return type for pthread_setschedprio.
+
+pthread_sigqueue.3
+    Rasmus Villemoes
+        Add missing #include <signal.h>
+
+rcmd.3
+    Rasmus Villemoes
+        Fix prototypes
+            Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
+            type unsigned short.
+            The first argument of iruserok_af() has type const void*.
+
+re_comp.3
+    Rasmus Villemoes
+        Fix prototypes
+            re_comp and re_exec take const char* arguments.
+
+resolver.3
+    Rasmus Villemoes
+        Fix prototypes and extern-declaration
+            Fix const- and signedness of various char* parameters.
+
+            Also, there is no "struct state", but _res is a struct
+            __res_state. (Actually, _res is errno-like in that it is really a
+            macro expanding to (*__res_state()).)
+
+rexec.3
+    Rasmus Villemoes
+        Fix prototypes
+            The user, passwd and cmd arguments to rexec and rexec_af are all
+            const.
+
+rtime.3
+    Rasmus Villemoes
+        Replace header
+            The header <rpc/des_crypt.h> does not provide rtime();
+            <rpc/auth_des.h> does, as is also implied in both the NOTES and
+            EXAMPLE sections.
+
+scandir.3
+    Rasmus Villemoes
+        Fix prototypes
+            The alphasort and versionsort functions take arguments of type
+            const struct dirent **, not const void *.
+
+setlocale.3
+    Michael Kerrisk  [Marko Myllynen]
+        Simplify locale category listing and add GNU-specific locale categories
+            Some information that was here will move to locale(7).
+    Marko Myllynen
+        Remove now obsolete NOTES section
+
+setnetgrent.3
+    Rasmus Villemoes
+        Fix prototype
+            The buflen argument to getnetgrent_r has type size_t.
+
+sigvec.3
+    Rasmus Villemoes
+        Fix prototype
+            The vec argument to sigvec is const.
+
+tsearch.3
+    Rasmus Villemoes
+        Fix prototype
+            The rootp argument to tfind is "void * const *",
+            not "const void **".
+
+core.5
+    Michael Kerrisk
+        Core dump files are nowadays core.pid by default
+
+locale.5
+    Marko Myllynen
+        Document mon_grouping and grouping properly
+    Michael Kerrisk
+        Note default value for 'first_workday'
+    Michael Kerrisk  [Marko Myllynen]
+        Add brief descriptions of collating-element and collating-symbol
+    Marko Myllynen
+        t_fmt_ampm is needed only for locales that employ AM/PM convention
+    Michael Kerrisk  [Marko Myllynen]
+        Remove crufty reference to /usr/lib/nls/src
+            That file is nowhere to be found
+    Marko Myllynen
+        Clarify LC_TIME/am_pm and LC_NAME keywords usage
+            am_pm should be defined only if AM/PM convention is used to signal
+            applications they should not try to print them when using them in
+            unwanted.
+
+            Same for all LC_NAME keywords expect for name_fmt which should be
+            always defined.
+    Marko Myllynen
+        Clarify lang_term / lang_lib
+            As noted by Keld Simonsen in the lib-locales@sourceware mailing
+            list:
+
+                https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
+                From: Keld Simonsen <keld at rap dot rap dot dk>
+                To: Marko Myllynen <myllynen at redhat dot com>
+                Date: Tue, 29 Apr 2014 17:02:09 +0200
+
+                lang_term reflects ISO 639-2/T (terminology) codes, while
+                lang_lib reflects ISO 639-2/B (bibliographic) codes.
+                lang_term is preferred over lang_lib codes for locale names.
+                There are 20 specific ISO 639-2/B codes.
+    Marko Myllynen
+        Correct the FILES section
+
+proc.5
+    Michael Kerrisk
+        'pid_max' is a system-wide limit on number of threads and processes
+            Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
+            file thus also imposes a system-wide limit on the number of
+            threads and processes.
+
+capabilities.7
+    Michael Kerrisk
+        CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
+    Michael Kerrisk
+        CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
+
+charsets.7
+    Michael Kerrisk  [Marko Myllynen]
+        Remove crufty statement that Romanian may be switching to ISO 8859-16
+    Michael Kerrisk
+        Remove ancient paragraph on charsets supported in glibc 2.3.2
+            That test is rather ancient, and probably of little use.
+
+fanotify.7
+    Heinrich Schuchardt
+        Fix to example program: fanotifyi read() should use aligned buffer
+
+inotify.7
+    Heinrich Schuchardt
+        Add example program
+            This example of the usage of the inotify API shows the
+            usage of inotify_init1(2) and inotify_add_watch(2) as well
+            as polling and reading from the inotify file descriptor.
+    Heinrich Schuchardt
+        munmap() does not generate inotify events
+
+locale.7
+    Marko Myllynen [Michael Kerrisk]
+        Document the LOCPATH environment variable
+    Michael Kerrisk
+        Add further details on various categories
+