svn: /phpdoc/ja/trunk/reference/curl/functions/ curl-setopt.xml

[email protected] (Yoshinari Takaoka)
Newsgroups php.doc.ja
Message-ID <[email protected]> 
mumumu                                   Sat, 21 Mar 2020 09:16:46 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=349506

Log:
Properly mark up constants as such | Document missing CURLOPT_HTTP_VERSION values

While these constants are supposed to be passed as argument, they are not
parameters per se.  Furthermore, parameters are linked to their declaration
in the PHP rendered version at least, and since there is no declaration,
the links are most useless.

Changed paths:
    U   phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml
svn-diffs-349506.txt (text/x-diff, 9.5 KB) 
Modified: phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml
===================================================================
--- phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml	2020-03-20 15:10:04 UTC (rev 349505)
+++ phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml	2020-03-21 09:16:46 UTC (rev 349506)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 349396 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 349505 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
 <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -202,7 +202,7 @@
            <entry valign="top">
             &true; を設定すると、ドキュメントの更新日時を取得しようと試みます。
             この値を取得するには、<function>curl_getinfo</function> で
-            <parameter>CURLINFO_FILETIME</parameter> オプションを用います。
+            <constant>CURLINFO_FILETIME</constant> オプションを用います。
            </entry>
            <entry valign="top">
            </entry>
@@ -766,10 +766,14 @@
           <row>
            <entry valign="top"><constant>CURLOPT_HTTP_VERSION</constant></entry>
            <entry valign="top">
-            <parameter>CURL_HTTP_VERSION_NONE</parameter> (デフォルト。
+            <constant>CURL_HTTP_VERSION_NONE</constant> (デフォルト。
             使用するバージョンを決めるのは cURL にまかせる)、
-            <parameter>CURL_HTTP_VERSION_1_0</parameter> (HTTP/1.0 を使用する)、
-            あるいは <parameter>CURL_HTTP_VERSION_1_1</parameter> (HTTP/1.1 を使用する)
+            <constant>CURL_HTTP_VERSION_1_0</constant> (HTTP/1.0 を使用する)、
+            あるいは <constant>CURL_HTTP_VERSION_1_1</constant> (HTTP/1.1 を使用する)
+            <constant>CURL_HTTP_VERSION_2_0</constant> (HTTP 2 の使用を試みる),
+            <constant>CURL_HTTP_VERSION_2 </constant> (<constant>CURL_HTTP_VERSION_2_0</constant> のエイリアス),
+            <constant>CURL_HTTP_VERSION_2TLS</constant> (TLS (https) の場合のみ HTTP 2 の使用を試みる) または
+            <constant>CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</constant> (HTTP 1.1 へのアップグレードを行わず、HTTP/2 を使って TLS でないリクエストを発行する)
             のいずれかです。
            </entry>
            <entry valign="top">
@@ -780,12 +784,12 @@
            <entry valign="top">
             <para>
              使用する HTTP 認証方法。以下の中から選びます。
-             <parameter>CURLAUTH_BASIC</parameter>、
-             <parameter>CURLAUTH_DIGEST</parameter>、
-             <parameter>CURLAUTH_GSSNEGOTIATE</parameter>、
-             <parameter>CURLAUTH_NTLM</parameter>、
-             <parameter>CURLAUTH_ANY</parameter> および
-             <parameter>CURLAUTH_ANYSAFE</parameter>。
+             <constant>CURLAUTH_BASIC</constant>、
+             <constant>CURLAUTH_DIGEST</constant>、
+             <constant>CURLAUTH_GSSNEGOTIATE</constant>、
+             <constant>CURLAUTH_NTLM</constant>、
+             <constant>CURLAUTH_ANY</constant> および
+             <constant>CURLAUTH_ANYSAFE</constant>。
             </para>
             <para>
              2 つ以上の方法を組み合わせるには、ビット演算子 <literal>|</literal>（or）
@@ -793,12 +797,12 @@
              問い合わせたうえで最適な方法を選択します。
             </para>
             <para>
-             <parameter>CURLAUTH_ANY</parameter> は
+             <constant>CURLAUTH_ANY</constant> は
              <literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>
              のエイリアスです。
             </para>
             <para>
-              <parameter>CURLAUTH_ANYSAFE</parameter> は
+              <constant>CURLAUTH_ANYSAFE</constant> は
               <literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>
               のエイリアスです。
             </para>
@@ -888,19 +892,19 @@
             </para>
             <para>
              使用できるプロトコルオプションは次のとおりです。
-             <parameter>CURLPROTO_HTTP</parameter>,
-             <parameter>CURLPROTO_HTTPS</parameter>,
-             <parameter>CURLPROTO_FTP</parameter>,
-             <parameter>CURLPROTO_FTPS</parameter>,
-             <parameter>CURLPROTO_SCP</parameter>,
-             <parameter>CURLPROTO_SFTP</parameter>,
-             <parameter>CURLPROTO_TELNET</parameter>,
-             <parameter>CURLPROTO_LDAP</parameter>,
-             <parameter>CURLPROTO_LDAPS</parameter>,
-             <parameter>CURLPROTO_DICT</parameter>,
-             <parameter>CURLPROTO_FILE</parameter>,
-             <parameter>CURLPROTO_TFTP</parameter>,
-             <parameter>CURLPROTO_ALL</parameter>
+             <constant>CURLPROTO_HTTP</constant>,
+             <constant>CURLPROTO_HTTPS</constant>,
+             <constant>CURLPROTO_FTP</constant>,
+             <constant>CURLPROTO_FTPS</constant>,
+             <constant>CURLPROTO_SCP</constant>,
+             <constant>CURLPROTO_SFTP</constant>,
+             <constant>CURLPROTO_TELNET</constant>,
+             <constant>CURLPROTO_LDAP</constant>,
+             <constant>CURLPROTO_LDAPS</constant>,
+             <constant>CURLPROTO_DICT</constant>,
+             <constant>CURLPROTO_FILE</constant>,
+             <constant>CURLPROTO_TFTP</constant>,
+             <constant>CURLPROTO_ALL</constant>
             </para>
            </entry>
            <entry valign="top">
@@ -913,8 +917,8 @@
             プロキシ接続に使用する HTTP 認証の方法。
             <constant>CURLOPT_HTTPAUTH</constant> で説明したのと同じオプションを
             指定可能です。プロキシ認証でサポートされているのは、今のところ
-            <parameter>CURLAUTH_BASIC</parameter> および
-            <parameter>CURLAUTH_NTLM</parameter> のみです。
+            <constant>CURLAUTH_BASIC</constant> および
+            <constant>CURLAUTH_NTLM</constant> のみです。
            </entry>
            <entry valign="top">
             cURL 7.10.7 で追加されました。
@@ -972,9 +976,9 @@
            <entry valign="top">
             <para>
              利用する SOCKS5 認証方法。以下が指定できます:
-             <parameter>CURLAUTH_BASIC</parameter>,
-             <parameter>CURLAUTH_GSSAPI</parameter>,
-             <parameter>CURLAUTH_NONE</parameter>
+             <constant>CURLAUTH_BASIC</constant>,
+             <constant>CURLAUTH_GSSAPI</constant>,
+             <constant>CURLAUTH_NONE</constant>
             </para>
             <para>
              一つ以上の認証方法を組み合わせるために ビット演算子 <literal>|</literal> (or) が使えます。
@@ -981,13 +985,13 @@
              これを使うと、cURL がどの方法をサポートしているかをポーリングし、もっとも良いものを選択します。
             </para>
             <para>
-             <parameter>CURLAUTH_BASIC</parameter> を指定すると、ユーザー名/パスワード による認証ができます。
+             <constant>CURLAUTH_BASIC</constant> を指定すると、ユーザー名/パスワード による認証ができます。
             </para>
             <para>
-             <parameter>CURLAUTH_GSSAPI</parameter> を指定すると、GSS-API 認証ができます。
+             <constant>CURLAUTH_GSSAPI</constant> を指定すると、GSS-API 認証ができます。
             </para>
             <para>
-             <parameter>CURLAUTH_NONE</parameter> を指定すると、認証は行われません。
+             <constant>CURLAUTH_NONE</constant> を指定すると、認証は行われません。
             </para>
             <para>
             デフォルトは <literal>CURLAUTH_BASIC|CURLAUTH_GSSAPI</literal> です。
@@ -1176,12 +1180,12 @@
             <constant>CURLOPT_TIMEVALUE</constant> の扱いを決定します。
             <constant>CURLOPT_TIMEVALUE</constant> で指定した時刻以降に
             変更されたページのみを返す場合は
-            <parameter>CURL_TIMECOND_IFMODSINCE</parameter> を使用します。
+            <constant>CURL_TIMECOND_IFMODSINCE</constant> を使用します。
             <constant>CURLOPT_HEADER</constant> が &true; だと仮定すると、
             ページが変更されていない場合は
             <literal>"304 Not Modified"</literal> ヘッダが返されます。
-            <parameter>CURL_TIMECOND_IFUNMODSINCE</parameter> は反対の意味です。
-            デフォルトは <parameter>CURL_TIMECOND_IFMODSINCE</parameter>
+            <constant>CURL_TIMECOND_IFUNMODSINCE</constant> は反対の意味です。
+            デフォルトは <constant>CURL_TIMECOND_IFMODSINCE</constant>
             です。
            </entry>
            <entry valign="top">
@@ -1212,7 +1216,7 @@
            <entry valign="top">
             1970 年 1 月 1 日からの経過秒数。この値は
             <constant>CURLOPT_TIMECONDITION</constant> で使用されます。デフォルトでは
-            <parameter>CURL_TIMECOND_IFMODSINCE</parameter> が設定されます。
+            <constant>CURL_TIMECOND_IFMODSINCE</constant> が設定されます。
            </entry>
            <entry valign="top">
            </entry>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.