path: root/Changes

==================== Changes in man-pages-3.63 ====================

Released: 2014-03-18, 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:

Carlos O'Donell <carlos@redhat.com>
Christoph Hellwig <hch@infradead.org>
Corrado Zoccolo <czoccolo@gmail.com>
Gregory P. Smith <gps@google.com>
Joseph S. Myers <joseph@codesourcery.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Peng Haitao <penght@cn.fujitsu.com>
Phillip Susi <psusi@ubuntu.com>
Robert P. J. Day <rpjday@crashcourse.ca>
Stefan Puiu <stefan.puiu@gmail.com>
Zhu Yanhai <zhu.yanhai@gmail.com>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

duplocale.3
    Michael Kerrisk
        New page documenting duplocale(3)

newlocale.3
    Michael Kerrisk  [Mike Frysinger]
        New page documenting newlocale(3) and freelocale(3)

towlower.3
    Michael Kerrisk
        Largely rewrite description of towlower() to be simpler and clearer

towupper.3
    Michael Kerrisk
        Largely rewrite description of towupper() to be simpler and clearer

uselocale.3
    Michael Kerrisk
        New page documenting uselocale(3)


Newly documented interfaces in existing pages
---------------------------------------------

open.2
    Michael Kerrisk
        Document O_DSYNC and rewrite discussion of O_SYNC

isalpha.3
    Michael Kerrisk
        Document the "_l" locale APIs
            The GNU C library v2.3 added some locale APIs, most of which
            were later specified in POSIX.1-2008, namely:

                   isalnum_l()
                   isalpha_l()
                   isblank_l()
                   iscntrl_l()
                   isdigit_l()
                   isgraph_l()
                   islower_l()
                   isprint_l()
                   ispunct_l()
                   isspace_l()
                   isupper_l()
                   isxdigit_l()
                   isascii_l()

            Also update and correct various pieces in CONFORMING TO
            (and remove a few crufty old pieces there).

strerror.3
    Michael Kerrisk
        Document strerror_l()

toupper.3
    Michael Kerrisk
        Document toupper_l() and tolower_l()

towlower.3
    Michael Kerrisk
        Document towlower_l()

towupper.3
    Michael Kerrisk
        Document towupper_l()

proc.5
    Michael Kerrisk
        Document /proc/sys/kernel/random/uuid

locale.7
    Michael Kerrisk
        Document LC_ADDRESS
    Michael Kerrisk
        Document LC_IDENTIFICATION
    Michael Kerrisk
        Document LC_MEASUREMENT
    Michael Kerrisk
        Document LC_NAME
    Michael Kerrisk
        Document LC_PAPER
    Michael Kerrisk
        Document LC_TELEPHONE


New and changed links
---------------------

freelocale.3
    Michael Kerrisk
        New link to new newlocale.3 page

isalnum_l.3
isascii_l.3
isblank_l.3
iscntrl_l.3
isdigit_l.3
isgraph_l.3
islower_l.3
isprint_l.3
ispunct_l.3
isspace_l.3
isupper_l.3
isxdigit_l.3
    Michael Kerrisk
        New links to isalpha.3

tolower_l.3
toupper_l.3
    Michael Kerrisk
        New links to toupper.3

towlower_l.3
    Michael Kerrisk
        New link to towlower.3

towupper_l.3
    Michael Kerrisk
        New link to towupper.3


Global changes
--------------

Various pages
    Michael Kerrisk
        Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"


Changes to individual pages
---------------------------

mount.2
    Michael Kerrisk
        SEE ALSO: add blkid(1)

msgop.2
    Michael Kerrisk
        Document two MSG_COPY failure modes
            Since Linux 3.14, the kernel now diagnoses two errors
            when using msgrcv() MSG_COPY:
            * MSG_COPY must be specified with IPC_NOWAIT
            * MSG_COPY can't be specified with MSG_EXCEPT

open.2
    Michael Kerrisk
        Organize some material under additional subheadings in NOTES
            There's an amorphous mass of material under NOTES.  Structure
            it with some subheadings, and do a little reorganizing.
    Michael Kerrisk
        Add other system calls and functions that are like openat()
            fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
            directory file descriptor argument for the same reason as openat().
            Also: reword the rationale for the *at() functions somewhat.
    Michael Kerrisk
        Clarify ELOOP error interaction with O_PATH

readahead.2
    Phillip Susi  [Corrado Zoccolo, Gregory P. Smith, Zhu Yanhai, Michael Kerrisk, Christoph Hellwig]
        Don't claim the call blocks until all data has been read
            The readahead(2) man page was claiming that the call blocks until
            all data has been read into the cache.  This is incorrect.

            See https://bugzilla.kernel.org/show_bug.cgi?id=54271

stat.2
    Michael Kerrisk
        SEE ALSO: add ls(1) and stat(1)

fts.3
    Christoph Hellwig  [Michael Kerrisk]
        The fts(3) API does not work with LFS builds
            As pointed out during a recent discussion on libc-hacker the
            fts(3) APIs can't be used with large file offsets:

                https://sourceware.org/bugzilla/show_bug.cgi?id=15838

mbrtowc.3
mbsnrtowcs.3
mbsrtowcs.3
mbtowc.3
    Michael Kerrisk
        Add entries in SEE ALSO
            Mainly inspired by the POSIX pages.

mbsinit.3
    Michael Kerrisk
        SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3)

mbsrtowcs.3
wcsrtombs.3
    Michael Kerrisk
        SEE ALSO: add mbsinit(3)

mbstowcs.3
    Michael Kerrisk  [Stefan Puiu]
        Add example program
            And add some SEE ALSO entries

memcmp.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function memcmp() is thread safe.

memcpy.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function memcpy() is thread safe.

memfrob.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function memfrob() is thread safe.

memmem.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function memmem() is thread safe.

memmove.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function memmove() is thread safe.

mempcpy.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions mempcpy() and wmempcpy() are thread safe.

memset.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function memset() is thread safe.

strerror.3
    Michael Kerrisk
        CONFORMING TO: strerror() and strerror_r() are in POSIX.1-2008
    Michael Kerrisk
        Add SS heading for strerror_r()

toupper.3
    Michael Kerrisk
        Rewrite to more explicitly bring locales into the discussion
    Michael Kerrisk
        Retitle BUGS section to NOTES
            These are not really bugs, just background info.

wcrtomb.3
wcsnrtombs.3
wcsrtombs.3
wcstombs.3
wctomb.3
    Michael Kerrisk
        SEE ALSO: add various entries
            Mainly inspired by POSIX

core.5
    Mike Frysinger  [Michael Kerrisk]
        Document core_pattern %d specifier
        Document %P core_pattern specifier
    Michael Kerrisk
        Rearrange core_pattern specifiers alphabetically

locale.5
    Michael Kerrisk
        SEE ALSO: add newlocale(3) + duplocale(3)

feature_test_macros.7
    Michael Kerrisk  [Joseph S. Myers]
        Remove mention of bogus _ISOC95_SOURCE macro
            The _ISOC95_SOURCE macro is defined in <features.h>, but it
            does nothing. So remove discussion of it, and move some of
            the discussion of C95 under the ISOC99_SOURCE subhead.
    Michael Kerrisk  [Carlos O'Donell]
        Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
            To compile warning-free across glibc < 2.20 and glibc >= 2.20
            code may been to define both _DEFAULT_SOURCE and either
            _BSD_SOURCE or _SVID_SOURCE.
    Michael Kerrisk
        Reword description of C90

locale.7
    Michael Kerrisk
        Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
    Michael Kerrisk
        Remove reference to LI18NUX2000
            LI18NUX2000 is difficult to even find these days, and in any case
            this page does not document gettext(), so notes about gettext()
            in the CONFORMING TO section here make no sense.
    Michael Kerrisk
        SEE ALSO: add mbstowcs(3) and wcstombs(3)
        SEE ALSO: add newlocale(3) + duplocale(3)

man-pages.7
    Michael Kerrisk
        Add preferred term "superblock"
    Michael Kerrisk
        Add preferred terms "uppercase" and "lowercase"