Update phar/random/readline/sockets

Author: mowangjuanzi

reference/curl/constants_curl_setopt.xml

@@ -3269,9 +3269,7 @@
    </term>
    <listitem>
     <para>
-     Set to the filename of the <filename>known_host</filename> file to use
-     which should use the OpenSSH file format as supported by libssh2.
-     Available as of cURL 7.19.6.
+     设置为要使用的 <filename>known_host</filename> 文件的文件名，该文件应使用 libssh2 支持的 OpenSSH 文件格式。自 cURL 7.19.6 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3282,12 +3280,9 @@
    </term>
    <listitem>
     <para>
-     The file name for a private key. If not used, cURL defaults to
-     <filename>$HOME/.ssh/id_dsa</filename> if the HOME environment variable is set,
-     and just <literal>id_dsa</literal> in the current directory if HOME is not set.
-     If the file is password-protected, set the password with
-     <constant>CURLOPT_KEYPASSWD</constant>.
-     Available as of cURL 7.16.1.
+     私钥的文件名。如果未指定，cURL 会默认使用 <filename>$HOME/.ssh/id_dsa</filename>（如果设置了 HOME
+     环境变量的话），或者在 HOME 未设置的情况下，默认使用当前目录下的 <literal>id_dsa</literal>
+     文件。如果文件受密码保护，则需要使用 <constant>CURLOPT_KEYPASSWD</constant> 设置密码，自 cURL 7.16.1 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3298,10 +3293,9 @@
    </term>
    <listitem>
     <para>
-     The file name for a public key. If not used, cURL defaults to
-     <filename>$HOME/.ssh/id_dsa.pub</filename> if the HOME environment variable is set,
-     and just <literal>id_dsa.pub</literal> in the current directory if HOME is not set.
-     Available as of cURL 7.16.1.
+     公钥的文件名。如果未指定，cURL 会默认使用 <filename>$HOME/.ssh/id_dsa.pub</filename>（如果设置了 HOME
+     环境变量的话），或者在 HOME 未设置的情况下，默认使用当前目录下的 <literal>id_dsa.pub</literal>
+     文件。自 cURL 7.16.1 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3312,8 +3306,7 @@
    </term>
    <listitem>
     <para>
-     The name of a file containing a PEM formatted certificate.
-     Available as of cURL 7.1.0.
+     包含 PEM 格式证书的文件名称。自 cURL 7.1.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3324,9 +3317,7 @@
    </term>
    <listitem>
     <para>
-     The password required to use the
-     <constant>CURLOPT_SSLCERT</constant> certificate.
-     Available as of cURL 7.1.0 and deprecated as of cURL 7.17.0.
+     使用 <constant>CURLOPT_SSLCERT</constant> 证书所需的密码。自 cURL 7.1.0 起可用，自 cURL 7.17.0 起已弃用。
     </para>
    </listitem>
   </varlistentry>
@@ -3337,16 +3328,15 @@
    </term>
    <listitem>
     <para>
-     A <type>string</type> with the format of the certificate. Supported formats are:
+     <type>string</type> 的证书格式。支持的格式有：
      <simplelist type="inline">
       <member><literal>PEM</literal></member>
       <member><literal>DER</literal></member>
       <member><literal>ENG</literal></member>
       <member><literal>P12</literal></member>
-     </simplelist>.
-     <literal>P12</literal> (for PKCS#12-encoded files) is available as of OpenSSL 0.9.3.
-     Defaults to <literal>PEM</literal>.
-     Available as of cURL 7.9.3.
+     </simplelist>。
+     <literal>P12</literal>（用于 PKCS#12 编码文件）自 OpenSSL 0.9.3
+     起可用。默认 <literal>PEM</literal>。自 cURL 7.9.3 起可用。
     </para>
    </listitem>
   </varlistentry>

reference/phar/Phar/delete.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: MiniMee Status: ready -->
+<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: MiniMee Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="phar.delete" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="Phar">
-   <modifier>public</modifier> <type>bool</type><methodname>Phar::delete</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>Phar::delete</methodname>
    <methodparam><type>string</type><parameter>localName</parameter></methodparam>
   </methodsynopsis>
   &phar.write;
@@ -40,7 +40,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   成功时返回 &true;，但是最好还是检查一下是否抛出了异常，如果没有抛出，可以认定操作成功。
+   &return.true.always;
   </para>
  </refsect1>
 

reference/random/book.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 550b9c3c31a66c18c9303794c12260bf5c684fed Maintainer: mowangjuanzi Status: ready -->
 <!-- CREDITS: Luffy -->
 <book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="core" ?>
@@ -18,6 +18,7 @@
  &reference.random.reference;
 
  &reference.random.random.randomizer;
+ &reference.random.random.intervalboundary;
 
  &reference.random.random.engine;
  &reference.random.random.cryptosafeengine;

reference/readline/functions/readline-add-history.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: cef062f45e1ba5691158b591381a9a9efc1e346d Maintainer: Szopen Xiao Status: ready -->
+<!-- EN-Revision: 2ab6e3ff1677d26786a443fa370719bfb4eba9cb Maintainer: Szopen Xiao Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.readline-add-history" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>readline_add_history</methodname>
+   <type>true</type><methodname>readline_add_history</methodname>
    <methodparam><type>string</type><parameter>prompt</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -38,7 +38,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 </refentry>

reference/readline/functions/readline-callback-handler-install.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5106807f258ed4b465f89b9faf4375f628e02b98 Maintainer: Szopen Xiao Status: ready -->
+<!-- EN-Revision: 2ab6e3ff1677d26786a443fa370719bfb4eba9cb Maintainer: Szopen Xiao Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.readline-callback-handler-install" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>readline_callback_handler_install</methodname>
+   <type>true</type><methodname>readline_callback_handler_install</methodname>
    <methodparam><type>string</type><parameter>prompt</parameter></methodparam>
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
   </methodsynopsis>
@@ -51,7 +51,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
@@ -113,7 +113,6 @@ echo "Prompting disabled. All done.\n";
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

reference/readline/functions/readline-clear-history.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5106807f258ed4b465f89b9faf4375f628e02b98 Maintainer: Szopen Xiao Status: ready -->
+<!-- EN-Revision: 2ab6e3ff1677d26786a443fa370719bfb4eba9cb Maintainer: Szopen Xiao Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.readline-clear-history" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>readline_clear_history</methodname>
+   <type>true</type><methodname>readline_clear_history</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -27,11 +27,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml