Update README

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

diff --git a/original/man3/mbsinit.3 b/original/man3/mbsinit.3
index 7533cf6..7b9b996 100644 (file)
--- a/original/man3/mbsinit.3
+++ b/original/man3/mbsinit.3
@@ -1,17 +1,19 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
 .\"   Dinkumware C library reference http://www.dinkumware.com/
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
+.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
-.TH MBSINIT 3  2000-11-20 "GNU" "Linux Programmer's Manual"
+.TH MBSINIT 3  2014-03-18 "GNU" "Linux Programmer's Manual"
 .SH NAME
 mbsinit \- test for initial shift state
 .SH SYNOPSIS
@@ -22,7 +24,8 @@ mbsinit \- test for initial shift state
 .fi
 .SH DESCRIPTION
 Character conversion between the multibyte representation and the wide
-character representation uses conversion state, of type \fImbstate_t\fP.
+character representation uses conversion state, of type
+.IR mbstate_t .
 Conversion of a string uses a finite-state machine; when it is interrupted
 after the complete conversion of a number of characters, it may need to
 save a state for processing the remaining characters.
@@ -36,7 +39,9 @@ conversion functions, such as
 and the one used by wide
 character to multibyte conversion functions, such as
 .BR wcsrtombs (3),
-but they both fit in a \fImbstate_t\fP, and they both have the same
+but they both fit in a
+.IR mbstate_t ,
+and they both have the same
 representation for an initial state.
 .PP
 For 8-bit encodings, all states are equivalent to the initial state.
@@ -64,14 +69,24 @@ On Linux, the following works as well, but might generate compiler warnings:
 .PP
 The function
 .BR mbsinit ()
-tests whether \fI*ps\fP corresponds to an
+tests whether
+.I *ps
+corresponds to an
 initial state.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 .BR mbsinit ()
-returns nonzero if \fI*ps\fP is an initial state, or if
-\fIps\fP is a null pointer.
-Otherwise it returns 0.
-.SH "CONFORMING TO"
+returns nonzero if
+.I *ps
+is an initial state, or if
+.I ps
+is NULL.
+Otherwise, it returns 0.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR mbsinit ()
+function is thread-safe.
+.SH CONFORMING TO
 C99.
 .SH NOTES
 The behavior of
@@ -80,6 +95,18 @@ depends on the
 .B LC_CTYPE
 category of the
 current locale.
-.SH "SEE ALSO"
+.SH SEE ALSO
+.BR mbrlen (3),
+.BR mbrtowc (3),
+.BR wcrtomb (3),
 .BR mbsrtowcs (3),
 .BR wcsrtombs (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/.