Commit Graph

11247 Commits

Author SHA1 Message Date
Michael Kerrisk 5fc5fff38a locale.5: Minor fix in CONFORMING TO
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 12:36:45 +02:00
Michael Kerrisk ee2d3ed6d4 locale.5: tfix
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 12:34:11 +02:00
Michael Kerrisk 84f36a95c6 locale.5: Add brief descriptions of collating-element and collating-symbol
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 12:29:12 +02:00
Michael Kerrisk a99f5c82a0 locale.5: Remove crufty reference to /usr/lib/nls/src
That file is nowhere to be found

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 12:18:37 +02:00
Michael Kerrisk 99a2c32928 newlocale.3: Add LC_ALL_MASK description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 12:05:04 +02:00
Marko Myllynen 4de4d201a3 newlocale.3: List all available category masks
Patch edited slightly by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 12:02:58 +02:00
Marko Myllynen 0eb0bdd201 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:50:04 +02:00
Michael Kerrisk 60d02efc1d charsets.7: Remove ancient paragraph on charsets supported in glibc 2.3.2
That test is rather ancient, and probably of little use.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:43:12 +02:00
Michael Kerrisk 5b3318fbc9 charsets.7: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:42:47 +02:00
Michael Kerrisk 37aef8b24f charsets.7: Remove crufty statement that Romanian may be switching to ISO 8859-16
It certainly seems like that change happened some time ago.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 10:35:26 +02:00
Michael Kerrisk 11e751cbec charsets.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 10:03:43 +02:00
Michael Kerrisk 56a4e1ad7e cpuset.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:43:56 +02:00
Michael Kerrisk 39728c234e charsets.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:42:46 +02:00
Michael Kerrisk d5b2adc3b2 locale.5: srcfix: Add/update FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:38:26 +02:00
Michael Kerrisk f2efbf2f56 localedef.1: srcfix: Clean up trailing white space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-27 10:15:13 +02:00
Michael Kerrisk 3e4895edaa localedef.1: Minor fixes to new page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-27 10:15:09 +02:00
Michael Kerrisk 74183758ff localedef.1: Replace reference to locale(7) with names of a few relevant functions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-27 09:41:04 +02:00
Marko Myllynen 869f1c65d5 localedef.1: New page for localedef(1)
Add new page based on Debian localedef(1) page.

Cowritten-by: Richard Braakman <richard.braakman@jollamobile.com>
Cowritten-by: Alastair McKinstry <mckinstry@computer.org>
Cowritten-by: Lars Wirzenius <liw@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-27 09:35:57 +02:00
Marko Myllynen f4b0ab8b2a locale.1: 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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 17:24:21 +02:00
Marko Myllynen 0cc4caa91e locale.1: Provide a step-by-step example of how to use a custom locale
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:28:34 +02:00
Michael Kerrisk b331e0d0b7 locale.7: Clarify that LOCPATH is used by setlocale(3) and newlocale(3)
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Marko Myllynen 859476f7a9 locale.7: further details of LOCPATH
Helpful for three purposes, 1) shows the expected naming scheme,
2) shows where to point LOCPATH to, and 3) gives an idea to the
attentive how to use a more generic, location independent
directory with location dependent, more specific ones.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Michael Kerrisk 244b504c73 locale.5: Minor tweaks to 's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Marko Myllynen 6699fab510 locale.5: Document mon_grouping and grouping properly
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Heinrich Schuchardt 780b72d47b README: Explain usage of prefix when installing
Installing the man pages to /usr may not be the preferred option
when working on a system with a packaging system like apt or yum,
where /usr is reserved for packages and /usr/local or /opt is used
for user addons.

README should explain how to install to a path different to /usr.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Heinrich Schuchardt 7a8110f6af inotify.7: munmap() does not generate inotify events
mmap() and msync() were already described as not leading to
inotify events. This patch adds munmap(). I created and executed
a test to verify this.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:05 +02:00
Michael Kerrisk 2483209a9c inotify.7: Minor changes to Heinrich Schuechardt's example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 23:07:08 +02:00
Heinrich Schuchardt ecd96f7c0e inotify.7: 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.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 22:42:29 +02:00
Michael Kerrisk 9fb49a3a80 locale.7: Tweaks to Marko Myllynen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:42:20 +02:00
Marko Myllynen cd2b4f6efd locale.7: Document LOCPATH
Example from https://sourceware.org/glibc/wiki/Locales

After modifying a locale, make sure it compiles, and install it to a
temporary directory for testing:

  unset LC_ALL
  LOCALE=fi_FI
  export I18NPATH=$HOME/locale-test/
  export LOCPATH=$HOME/locale-test/
  mkdir -p $LOCPATH
  localedef --no-archive -f localedata/charmaps/UTF-8 -i localedata/locales/$LOCALE $I18NPATH/$LOCALE.UTF-8
  LC_TIME=$LOCALE.UTF-8 locale -ck LC_TIME
  LC_TIME=$LOCALE.UTF-8 locale -ck date_fmt
  LC_TIME=$LOCALE.UTF-8 date
  LC_CTYPE=$LOCALE.UTF-8 iconv -f UTF-8 -t ASCII//TRANSLIT < translit-test-input.txt
  LC_COLLATE=$LOCALE.UTF-8 sort < sorting-test-input.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:36:13 +02:00
Marko Myllynen dbe0246bed nl_langinfo.3: expand the example code a bit
Better illustrate querying elements from different categories.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Michael Kerrisk 2f41dcabf1 locale.5: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Michael Kerrisk c33a849443 locale.5: Tweaks to Marko Myllynen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Marko Myllynen b5d4168adf locale.5: 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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Michael Kerrisk d099bdc501 locale.7: Add further details on various categories
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Michael Kerrisk 348aab3724 setlocale.3: Simply locale category listing and add GNU-specific locale categories
Some information that was here will move to locale(7).

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Michael Kerrisk e0396d76b2 setlocale.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Marko Myllynen e6812b0dfd locale.5: 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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Marko Myllynen 261ce50b66 setlocale.3: Remove now obsolete NOTES section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Simon Paillard 11bae399cf shmget.2: wfix
The section is about failures, no need to recall this for that
specific error code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-23 15:50:53 +02:00
Peng Haitao 13b792dcc2 pthread_setaffinity_np.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_setaffinity_np() and
pthread_getaffinity_np() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-23 10:32:15 +02:00
Peng Haitao cb63c0fcd3 pthread_exit.3: ATTRIBUTES: Note function that is thread-safe
The function pthread_exit() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-23 08:49:42 +02:00
Peng Haitao 6b0949f0f1 pthread_equal.3: ATTRIBUTES: Note function that is thread-safe
The function pthread_equal() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-23 07:10:22 +02:00
Peng Haitao 949fea39cb pthread_getcpuclockid.3: ATTRIBUTES: Note function that is thread-safe
The function pthread_getcpuclockid() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-23 05:59:16 +02:00
Peng Haitao 3ef3728c9f pthread_setconcurrency.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_setconcurrency() and
pthread_getconcurrency() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-23 05:58:35 +02:00
Heinrich Schuchardt 864eccb901 fanotify.7: fanotify_read should use aligned buffer
Michael Kerrisk pointed me to alignment issues which may
arise when reading misaligned integers.

On some systems integer values can only be read if they are
correctly aligned. Other system have a lower performance when
reading from or writing to misaligned memory positions.

Therefore, the buffer used to call read(2) for a fanotify
file descriptor should have the same alignment as
struct fanotify_event_metadata.

Due to the casting to char* inside the macros
FAN_EVENT_OK and FAN_EVENT_NEXT we can use any
data structure for the buffer.

With the patch an array of struct fanotify_event_metadata is
used as buffer which seems a natural choice to ensure proper
alignment.

It should be remembered that the offset between events is given
by field event_len and iterating over the array may not be
allowable in future. Instead the macros should be used.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:49:30 +02:00
Rasmus Villemoes da9a495eaa tsearch.3: Fix prototype
The rootp argument to tfind is "void * const *",
not "const void **".

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:28 +02:00
Rasmus Villemoes ecf9e5f83e scandir.3: Fix prototypes
The alphasort and versionsort functions take arguments of type const
struct dirent **, not const void *.

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:28 +02:00
Rasmus Villemoes 0c5e1f653a resolver.3: 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()).)

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:28 +02:00
Rasmus Villemoes bc572b8fb3 key_setsecret.3: Fix prototypes
Remove const qualifiers from arguments to key_decryptsession,
key_encryptsession, and key_setsecret.

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:28 +02:00