(split) Apply minor changes from v3.32 to v3.35 in the upstream.

[linuxjm/LDP_man-pages.git] / draft / man3 / wcrtomb.3

diff --git a/draft/man3/wcrtomb.3 b/draft/man3/wcrtomb.3
index a352310..0b48cf9 100644 (file)
--- a/draft/man3/wcrtomb.3
+++ b/draft/man3/wcrtomb.3
@@ -15,7 +15,7 @@
 .\" Translated Mon Oct 25 22:55:40 JST 1999
 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
 .\"
-.TH WCRTOMB 3 1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH WCRTOMB 3  2011-09-28 "GNU" "Linux Programmer's Manual"
 .\"O .SH NAME
 .SH ̾Á°
 .\"O wcrtomb \- convert a wide character to a multibyte sequence
@@ -30,10 +30,9 @@ wcrtomb \- 
 .\"O .SH DESCRIPTION
 .SH ÀâÌÀ
 .\"O The main case for this function is when \fIs\fP is
-.\"O not NULL and \fIwc\fP is not
-.\"O L\(aq\\0\(aq.
-¤³¤Î´Ø¿ô¤¬¼ç¤Ë»È¤ï¤ì¤ë¤Î¤Ï¡¢\fIs\fP ¤¬ NULL ¤Ç¤Ê¤¯¡¢\fIwc\fP ¤¬ L\(aq\\0\(aq
-¤Ç¤Ê¤¤¾ì¹ç¤Ç¤¢¤ë¡£
+.\"O not NULL and \fIwc\fP is not a null wide character (L\(aq\\0\(aq).
+¤³¤Î´Ø¿ô¤¬¼ç¤Ë»È¤ï¤ì¤ë¤Î¤Ï¡¢\fIs\fP ¤¬ NULL ¤Ç¤Ê¤¯¡¢
+\fIwc\fP ¤¬ NULL ¥ï¥¤¥Éʸ»ú (L\(aq\\0\(aq) ¤Ç¤Ê¤¤¾ì¹ç¤Ç¤¢¤ë¡£
 .\"O In this case, the
 .\"O .BR wcrtomb ()
 .\"O function
@@ -52,7 +51,8 @@ wcrtomb \- 
 ¥·¥Õ¥È¾õÂÖ \fI*ps\fP ¤ò¹¹¿·¤·¡¢½ÐÎϤµ¤ì¤¿¥Þ¥ë¥Á¥Ð¥¤¥Èɽ¸½¤ÎŤµ¡¢¤¹¤Ê
 ¤ï¤Á \fIs\fP ¤Ë½ñ¤­¹þ¤Þ¤ì¤¿¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£
 .PP
-.\"O A different case is when \fIs\fP is not NULL but \fIwc\fP is L\(aq\\0\(aq.
+.\"O A different case is when \fIs\fP is not NULL,
+.\"O but \fIwc\fP is a null wide character (L\(aq\\0\(aq).
 .\"O In this
 .\"O case the
 .\"O .BR wcrtomb ()
@@ -65,8 +65,9 @@ wcrtomb \- 
 .\"O it into the initial state),
 .\"O and returns the length of the shift sequence plus
 .\"O one, that is, the number of bytes written at \fIs\fP.
-Ê̤Υ±¡¼¥¹¤È¤·¤Æ¤Ï¡¢\fIs\fP ¤Ï NULL ¤Ç¤Ê¤¤¤¬ \fIwc\fP ¤¬ L\(aq\\0\(aq ¤Î¤³¤È¤¬
-¤¢¤ë¡£¤³¤Î¾ì¹ç¤Î
+Ê̤Υ±¡¼¥¹¤È¤·¤Æ¤Ï¡¢\fIs\fP ¤Ï NULL ¤Ç¤Ê¤¤¤¬
+\fIwc\fP ¤¬ NULL ¥ï¥¤¥Éʸ»ú (L\(aq\\0\(aq) ¤Î¤³¤È¤¬¤¢¤ë¡£
+¤³¤Î¾ì¹ç¤Î
 .BR wcrtomb ()
 ´Ø¿ô¤Ï¡¢\fI*ps\fP ¤ò½é´ü¾õÂÖ¤ËÌ᤹¤Î¤Ëɬ
 Íפʥ·¥Õ¥È¥·¡¼¥±¥ó¥¹¤ò \fIs\fP ¤¬»Ø¤¹ char ·¿ÇÛÎó¤Ë³ÊǼ¤·¡¢¤½¤Î¸å¤Ë \(aq\\0\(aq
@@ -76,11 +77,21 @@ wcrtomb \- 
 .PP
 .\"O A third case is when \fIs\fP is NULL.
 .\"O In this case \fIwc\fP is ignored,
-.\"O and the function effectively returns wcrtomb(buf,L\(aq\\0\(aq,\fIps\fP) where
-.\"O buf is an internal anonymous buffer.
-»°ÈÖÌܤΥ±¡¼¥¹¤Ï¡¢\fIs\fP ¤¬ NULL ¤Î»þ¤Ç¤¢¤ë¡£¤³¤Î¾ì¹ç¤Ë¤Ï \fIwc\fP ¤Ï
-̵»ë¤µ¤ì¡¢´Ø¿ô¤Î¼ÂºÝ¤Î¸ú²Ì¤È¤·¤Æ¤Ï wcrtomb(buf,L\(aq\\0\(aq,\fIps\fP) ¤ÈƱ¤¸
-Ãͤ¬ÊÖ¤µ¤ì¤ë¡£¤³¤³¤Ç¡¢buf ¤ÏÆâÉôŪ¤Êƿ̾¤Î¥Ð¥Ã¥Õ¥¡¤Ç¤¢¤ë¡£
+.\"O and the function effectively returns
+.\"O 
+.\"O     wcrtomb(buf, L\(aq\\0\(aq, ps)
+.\"O 
+.\"O where
+.\"O .I buf
+.\"O is an internal anonymous buffer.
+»°ÈÖÌܤΥ±¡¼¥¹¤Ï¡¢\fIs\fP ¤¬ NULL ¤Î»þ¤Ç¤¢¤ë¡£
+¤³¤Î¾ì¹ç¤Ë¤Ï \fIwc\fP ¤Ï̵»ë¤µ¤ì¡¢´Ø¿ô¤Î¼ÂºÝ¤ÎÆ°¤­¤È¤·¤Æ¤Ï
+
+    wcrtomb(buf, L\(aq\\0\(aq, ps)
+
+¤¬ÊÖ¤µ¤ì¤ë¡£¤³¤³¤Ç¡¢
+.I buf
+¤ÏÆâÉôŪ¤Ê̵̾¥Ð¥Ã¥Õ¥¡¤Ç¤¢¤ë¡£
 
 .PP
 .\"O In all of the above cases, if \fIps\fP is a NULL pointer, a static anonymous