LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / catgets.3

diff --git a/original/man3/catgets.3 b/original/man3/catgets.3
index 047dd9a..08450d8 100644 (file)
--- a/original/man3/catgets.3
+++ b/original/man3/catgets.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 Mitchum DSouza <m.dsouza@mrc-applied-psychology.cambridge.ac.uk>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,9 +20,10 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Updated, aeb, 980809
-.TH CATGETS 3 1998-08-09 "" "Linux Programmer's Manual"
+.TH CATGETS 3 2014-06-13 "" "Linux Programmer's Manual"
 .SH NAME
 catgets \- get message from a message catalog
 .SH SYNOPSIS
@@ -44,8 +46,8 @@ where
 .I catalog
 is a catalog descriptor returned from an earlier call to
 .BR catopen (3).
-The fourth argument
-.I message
+The fourth argument,
+.IR message ,
 points to a default message string which will be returned by
 .BR catgets ()
 if the identified message catalog is not currently available.
@@ -53,8 +55,8 @@ The
 message-text is contained in an internal buffer area and should be copied by
 the application if it is to be saved or modified.
 The return string is
-always terminated with a null byte.
-.SH "RETURN VALUE"
+always terminated with a null byte (\(aq\\0\(aq).
+.SH RETURN VALUE
 .LP
 On success,
 .BR catgets ()
@@ -64,10 +66,17 @@ On failure,
 .BR catgets ()
 returns the value
 .IR message .
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR catgets ()
+function is thread-safe.
+.SH CONFORMING TO
 POSIX.1-2001.
 .SH NOTES
-These functions are only available in libc.so.4.4.4c and above.
+The
+.BR catgets ()
+function is available only in libc.so.4.4.4c and above.
 The Jan 1987 X/Open Portability Guide specifies a more subtle
 error return:
 .I message
@@ -79,6 +88,15 @@ the specified message.
 These two possible error returns seem to be discarded in SUSv2
 in favor of always returning
 .IR message .
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR catopen (3),
 .BR setlocale (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.