[PHP-doc 340] phpdoc/ja差分(2)(Re: phpdoc/ja差分(1))

[Jun Kuwamura]

桑村です。

ありがとうございます。
再び、続きを少しばかりです。

On Thu, 14 Oct 2004, Rui Hirokawa wrote:

> 廣川です。
> 
> commitしておきました。
> ありがとうございます。
> 
> On Wed, 13 Oct 2004 10:16:36 +0900 (JST)
> Jun Kuwamura <juk ＠ rccm.co.jp> wrote:
> 
> > 桑村です。
> > 
> > phpdoc/ja で、気がついたところを直して差分にしてみました。
> > また時間ができたときに見てみます。
> > 
> > --
> >   Jun Kuwamura
> >  rC Cm
> >    ^
> >    ~
> > 
> 
> -- 
> Rui Hirokawa <rui_hirokawa ＠ ybb.ne.jp>
> 
--
  Jun Kuwamura
 rC Cm
   ^
   ~
-------------- next part --------------
diff -ru phpdoc-ja/reference/math/functions/mt-rand.xml ja/reference/math/functions/mt-rand.xml
--- phpdoc-ja/reference/math/functions/mt-rand.xml	2003-07-04 09:06:42.000000000 +0900
+++ ja/reference/math/functions/mt-rand.xml	2004-10-24 17:11:26.000000000 +0900
@@ -10,12 +10,8 @@
     <title>説明</title>
      <methodsynopsis>
       <type>int</type><methodname>mt_rand</methodname>
-      <methodparam><type>int</type><parameter>
-	<replaceable><optional>min</optional></replaceable>
-       </parameter></methodparam>
-      <methodparam><type>int</type><parameter>
-	<replaceable><optional>max</optional></replaceable>
-       </parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam>
+      <methodparam><type>int</type><parameter>max</parameter></methodparam>
      </methodsynopsis>
     <simpara>
      古いlibcの多くの乱数発生器は、怪しげであるか特性が不明であったり
diff -ru phpdoc-ja/reference/math/functions/mt-srand.xml ja/reference/math/functions/mt-srand.xml
--- phpdoc-ja/reference/math/functions/mt-srand.xml	2003-07-04 09:06:42.000000000 +0900
+++ ja/reference/math/functions/mt-srand.xml	2004-10-24 17:13:16.000000000 +0900
@@ -10,7 +10,7 @@
     <title>説明</title>
      <methodsynopsis>
       <type>void</type><methodname>mt_srand</methodname>
-      <methodparam><type>int</type><parameter>seed</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam>
      </methodsynopsis>
     <para>
      <parameter>seed</parameter> で乱数生成器にシードを与えます。
diff -ru phpdoc-ja/reference/network/functions/fsockopen.xml ja/reference/network/functions/fsockopen.xml
--- phpdoc-ja/reference/network/functions/fsockopen.xml	2002-09-11 02:45:41.000000000 +0900
+++ ja/reference/network/functions/fsockopen.xml	2004-10-24 22:04:36.000000000 +0900
@@ -11,29 +11,24 @@
   <title>説明</title>
   <methodsynopsis>
    <type>int</type><methodname>fsockopen</methodname>
-   <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
+   <methodparam><type>string</type><parameter>target</parameter></methodparam>
    <methodparam><type>int</type><parameter>port</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>errno</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>errstr</parameter></methodparam>
    <methodparam choice="opt"><type>float</type><parameter>timeout</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Internetドメイン(AF_INET)または Unixドメイン(AF_UNIX、TCPまたは
-   UDPを使用)にてストリーム接続を初期化します。Internetãƒ‰ãƒ¡ã‚¤ãƒ³ã®å ´åˆã€
-   <parameter>hostname</parameter>のポート<parameter>port</parameter>
-   へのTCPソケット接続がオープンされます。
-   UDP接続を行う際には、<parameter>udp://hostname</parameter>のよう
-   に明示的にプロトコルを指定するå¿
要があります。Unixãƒ‰ãƒ¡ã‚¤ãƒ³ã®å ´åˆã€
-   <parameter>hostname</parameter>はソケットへのパスとして使用され、
-   <parameter>port</parameter> ã¯ã“ã®å ´åˆ0とするå¿
要があります。
-   オプションの<parameter>timeout</parameter>により接続システムコール
-   がタイムアウトするまでの秒数を指定することが可能です。
-  </para>
+   <parameter>target</parameter>に指定されたリソースへの接続を開始します。
+   PHPは<xref linkend="transports"/>に記述されているように、
+   Internetドメインまたは Unixドメインの中のターゲットをサポートします。
+   サポートしているトランスポートのリストは<function>stream_get_transports</function>
+   を使って取り出すこともできます。
+   </para>
   <note>
    <simpara>
     ソケット経由でデータを読み書きする際のタイムアウトを設定するå¿
è¦ãŒã‚ã‚‹å ´åˆã€
     <function>fsockopen</function> の <parameter>timeout</parameter> パラメータは、
-    ソケットに接続する間のみ適用されるため、
+    ソケットに接続する間にだけ適用されるため、
     <function>socket_set_timeout</function>を使用してください。
    </simpara>
   </note>
@@ -76,15 +71,19 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$fp = fsockopen ("www.php.net", 80, $errno, $errstr, 30);
+$fp = fsockopen("www.example.com", 80, $errno, $errstr, 30);
 if (!$fp) {
-    echo "$errstr ($errno)<br>\n";
+    echo "$errstr ($errno)<br />\n";
 } else {
-    fputs ($fp, "GET / HTTP/1.0\r\nHost: www.php.net\r\n\r\n");
+    $out = "GET / HTTP/1.1\r\n";
+    $out .= "Host: www.example.com\r\n";
+    $out .= "Connection: Close\r\n\r\n";
+
+    fwrite($fp, $out);
     while (!feof($fp)) {
-        echo fgets ($fp,128);
+        echo fgets($fp, 128);
     }
-    fclose ($fp);
+    fclose($fp);
 }
 ?>
 ]]>