cvs: phpdoc-tw / bookinfo.xml language-snippets.ent /appendices about.xml /language variables.xml

coldocean Thu Jun 5 10:17:34 2008 UTC Modified files: /phpdoc-tw bookinfo.xml language-snippets.ent /phpdoc-tw/appendices about.xml /phpdoc-tw/language variables.xml Log: fix build

http://cvs.php.net/viewvc.cgi/phpdoc-tw/bookinfo.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-tw/bookinfo.xml diff -u phpdoc-tw/bookinfo.xml:1.11 phpdoc-tw/bookinfo.xml:1.12 --- phpdoc-tw/bookinfo.xml:1.11 Thu Jun 5 09:34:04 2008 +++ phpdoc-tw/bookinfo.xml Thu Jun 5 10:17:33 2008 @@ -26,14 +26,14 @@ </authorgroup> <copyright> - <year>1997-2007</year> + <year>1997-2008</year> <holder>PHP 文件小組</holder> </copyright> <legalnotice xml:id="copyright" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>版權</title> <simpara> - 版權所有 &copy; Copyright 1997 - 2007 PHP 文件小組。此手冊的發佈須遵守 Open Publication License v1.0 或其後版本提出的條款和條件的限制。<link linkend="opl.license">Open Publication + 版權所有 &copy; Copyright 1997 - 2008 PHP 文件小組。此手冊的發佈須遵守 Open Publication License v1.0 或其後版本提出的條款和條件的限制。<link linkend="opl.license">Open Publication License</link>的拷貝版本內含在此手冊中發行，最新的版本可以在 <link xlink:href="&url.opl;">&url.opl;</link> 取得。 </simpara> <simpara> @@ -47,7 +47,7 @@ <link xlink:href="mailto:&email.php.doc.license;">&email.php.doc.license;</link>。注意這個地址映射到一個公開存檔的郵件列表。 </simpara> <simpara> - 本手冊 <link linkend="zend">Zend API</link> 一章是根據 Zend Technologies 最初提供的內容而來。 + 本手冊 <xref linkend="internals2.ze1"/> 一章是根據 Zend Technologies 最初提供的內容而來。 </simpara> </legalnotice> </info> http://cvs.php.net/viewvc.cgi/phpdoc-tw/language-snippets.ent?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-tw/language-snippets.ent diff -u phpdoc-tw/language-snippets.ent:1.14 phpdoc-tw/language-snippets.ent:1.15 --- phpdoc-tw/language-snippets.ent:1.14 Thu Jun 5 09:34:04 2008 +++ phpdoc-tw/language-snippets.ent Thu Jun 5 10:17:33 2008 @@ -229,7 +229,7 @@ <!-- Dom Notes --> <!ENTITY dom.node.inserted '本節點不會出現在文件中，除非是用例如 -<link linkend="function.dom-domnode-appendchild">DOMNode->appendChild()</link> 函式來將其插入。'> +<link linkend="domnode.appendchild">DOMNode->appendChild()</link> 函式來將其插入。'> <!-- FileSystem entities --> @@ -641,7 +641,7 @@ <!ENTITY returns.http.false.orexits 'Returns &false; or <emphasis>exits</emphasis> on success'> <!ENTITY http.request.affects 'Affects the following request method(s) only:'> <!ENTITY http.request.affects.any 'Affects any request method.'> -<!ENTITY http.response.class.php51 'the <link linkend="http.HttpResponse"><classname +<!ENTITY http.response.class.php51 'the <link linkend="class.httpresponse"><classname >HttpResponse</classname></link> class if you are using PHP-5.1 and above'> <!ENTITY http.maynotwork.SAPI 'This may not work as expected with the following SAPI(s):'> <!ENTITY http.content.disposition 'The <literal>Content-Disposition</literal> header is very useful http://cvs.php.net/viewvc.cgi/phpdoc-tw/appendices/about.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-tw/appendices/about.xml diff -u phpdoc-tw/appendices/about.xml:1.10 phpdoc-tw/appendices/about.xml:1.11 --- phpdoc-tw/appendices/about.xml:1.10 Thu Jun 5 09:34:04 2008 +++ phpdoc-tw/appendices/about.xml Thu Jun 5 10:17:34 2008 @@ -68,7 +68,7 @@ </note> </sect1> - <sect1 xml:id="tutorial.prototypes"> + <sect1 xml:id="about.prototypes"> <title>如何閱讀函式的定義（函式原型）</title> <para> 文件中的每個函式都有快速參考，學會如何閱讀和理解文件將使得使用 PHP 更加簡單。和依賴把範例複製/貼上比起來，您一定更希望知道如何閱讀函式的定義（函式原型）： http://cvs.php.net/viewvc.cgi/phpdoc-tw/language/variables.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-tw/language/variables.xml diff -u phpdoc-tw/language/variables.xml:1.7 phpdoc-tw/language/variables.xml:1.8 --- phpdoc-tw/language/variables.xml:1.7 Thu Jun 5 09:34:04 2008 +++ phpdoc-tw/language/variables.xml Thu Jun 5 10:17:34 2008 @@ -110,7 +110,7 @@ <para> 依賴未初始化變數的默認值在某些情況下會有問題，例如把一個文件包含到另一個之中時碰上相同的變數名。另外把 <link linkend="ini.register-globals">register_globals</link> 打開是一個主要的<link - linkend="security.globals">安全隱患</link>。<link linkend="e-notice">E_NOTICE</link> + linkend="security.globals">安全隱患</link>。<link linkend="errorfunc.constants.errorlevels.e-notice">E_NOTICE</link> 級別的錯誤會在碰上未初始化的變數時發出，但是在向一個未初始化的數組附加單元時不會。<function>isset</function> 語言結構可以用來檢測一個變數是否已被初始化。 </para> @@ -167,6 +167,7 @@ 超級全局變數不能被用作<link linkend="language.variables.variable">可變變數</link>。 </para> </note> + <note> <para> 儘管超全局變數和 HTTP_*_VARS @@ -178,109 +179,6 @@ 如果某些 <link linkend="ini.variables-order">variables_order</link> 中的變數沒有設定，它們的對應的 PHP 預定義數組也是空的。 </para> - - <variablelist xml:id="language.variables.superglobals"> - <title>PHP 超全局變數</title> - <varlistentry> - <term><link linkend="reserved.variables.globals">$GLOBALS</link></term> - <listitem> - <simpara> - 包含一個引用指向每個當前腳本的全局範圍內有效的變數。該數組的鍵名為全局變數的名稱。從 - PHP 3 開始存在 <varname>$GLOBALS</varname> 數組。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.server">$_SERVER</link></term> - <listitem> - <simpara> - 變數由 web 服務器設定或者直接與當前腳本的執行環境相關聯。類似於舊數組 <varname>$HTTP_SERVER_VARS</varname> - 數組（依然有效，但反對使用）。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.get">$_GET</link></term> - <listitem> - <simpara> - 經由 URL 請求提交至腳本的變數。類似於舊數組 <varname>$HTTP_GET_VARS</varname> - 數組（依然有效，但反對使用）。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.post">$_POST</link></term> - <listitem> - <simpara> - 經由 HTTP POST 方法提交至腳本的變數。類似於舊數組 <varname>$HTTP_POST_VARS</varname> - 數組（依然有效，但反對使用）。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.cookies">$_COOKIE</link></term> - <listitem> - <simpara> - 經由 HTTP Cookies 方法提交至腳本的變數。類似於舊數組 <varname>$HTTP_COOKIE_VARS</varname> - 數組（依然有效，但反對使用）。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.files">$_FILES</link></term> - <listitem> - <simpara> - 經由 HTTP POST 文件上傳而提交至腳本的變數。類似於舊數組 <varname>$HTTP_POST_FILES</varname> - 數組（依然有效，但反對使用）。詳細資訊請參閱 <link linkend="features.file-upload.post-method">POST 方法上傳</link>。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.environment">$_ENV</link></term> - <listitem> - <simpara> - 執行環境提交至腳本的變數。類似於舊數組 <varname>$HTTP_ENV_VARS</varname> - 數組（依然有效，但反對使用）。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.request">$_REQUEST</link></term> - <listitem> - <simpara> - 經由 GET，POST 和 COOKIE - 機制提交至腳本的變數，因此該數組並不值得信任。所有包含在該數組中的變數的存在與否以及變數的順序均按照 - &php.ini; 中的 <link linkend="ini.variables-order">variables_order</link> - 配置指示來定義。此數組在 PHP 4.1.0 之前沒有直接對應的版本。參見 - <function>import_request_variables</function>。 - </simpara> - <caution> - <simpara> - 自 PHP 4.3.0 起，<varname>$_FILES</varname> 中的文件資訊不再存在於 - <varname>$_REQUEST</varname> 中。 - </simpara> - </caution> - <note> - <simpara> - 當運行於<link linkend="features.commandline">命令行</link>模式時，此數組將<emphasis>不會</emphasis>包含 - <varname>argv</varname> 和 <varname>argc</varname> 條目；它們已經存在於數組 - <varname>$_SERVER</varname> 中。 - </simpara> - </note> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.session">$_SESSION</link></term> - <listitem> - <simpara> - 當前註冊給腳本會話的變數。類似於舊數組 - <varname>$HTTP_SESSION_VARS</varname> 數組（依然有效，但反對使用）。詳細資訊，請參照 - <link linkend="ref.session">Session 處理函式</link>章節。 - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect1>