cvs: phpdoc-hk / language-snippets.ent

Index: phpdoc-hk/language-snippets.ent
diff -u phpdoc-hk/language-snippets.ent:1.6 phpdoc-hk/language-snippets.ent:1.7
--- phpdoc-hk/language-snippets.ent:1.6	Tue Nov 26 01:49:57 2002
+++ phpdoc-hk/language-snippets.ent	Sun Jun 15 11:03:34 2003
@@ -1,42 +1,115 @@
-<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.6 2002/11/26 06:49:57 derick Exp $ -->
+<!-- $Revision: 1.7 $ -->
 
+<!ENTITY warn.experimental '<warning><simpara>³o­Ó©µ¦ù¬O<emphasis>¹êÅç©Ê½è</emphasis>ªº¡C³o­Ó©µ¦ùªº¦æ¬° -- ¥]¬A¨ç¦¡¦WºÙ©M¥]§t¦¹©µ¦ùªº¥ô¦ó¨ä¥¦¤å¥ó -- ¦b¥¼¨ÓPHPªºµo¦æ¤¤¥i¯à·|¦b¤£³qª¾ªº±¡ªp§ïÅÜ¡C¨Ï¥Î¦¹©µ¦ù»Ý¦Û¦æ©Ó¾á­·ÀI¡C</simpara></warning>'>
 
+<!ENTITY warn.experimental.func '<warning><simpara>³o­Ó¨ç¦¡¬O<emphasis>¹êÅç©Ê½è</emphasis>ªº¡C³o­Ó¨ç¦¡ªº¦æ¬°¡B¦WºÙ¡B©MÃö©ó¦¹¨ç¦¡ªº¥ô¦ó¨ä¥L¤å¥ó¦b¥¼¨ÓPHPªºµo¦æ¤¤¥i¯à·|¦b¤£³qª¾ªº±¡ªp¤U§ïÅÜ¡C ¨Ï¥Î¦¹©µ¦ù»Ý¦Û¦æ©Ó¾á­·ÀI¡C</simpara></warning>'>
 
-<!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'>
-<!ENTITY warn.experimental.func '<warning><simpara>This function is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this function at your own risk.</simpara></warning>'>
+<!ENTITY warn.undocumented.func '<warning><simpara>¦¹¨ç¦¡¥Ø«e¨S¦³°Ñ¦Ò¤å¥ó¡F¥u¦³¤Þ¼Æ¦Cªí¡C</simpara></warning>'>
 
-<!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'>
+<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>PHP 4.3.0 ¤§«eªº Windows <literal>PHP</literal>ª©¥»¤£¤ä´©¥Ñ¦¹¨ç¦¡¦s¨ú»·ºÝÀɮסA§Y¨Ï±Ò°Ê<link linkend="ini.allow-url-fopen">allow_url_fopen</link>¿ï¶µ¡C</para></warning>'>
 
-<!ENTITY return.success 'Returns <constant>TRUE</constant> on succes, <constant>FALSE</constant> on failure.'>
+<!ENTITY note.no-remote '<note><simpara>¦¹¨ç¦¡¤£¯à¨Ï¥Î©ó<link linkend="features.remote-files">»·ºÝÀÉ®×</link> ¡M¦]³QÀˬdªºÀÉ®×¥²¶·³q¹L¦øªA¾¹ªºÀɮרt²Î¦s¨ú¡C</simpara></note>'>
 
-<!ENTITY note.not-bin-safe '<warning><simpara>This function is not (yet) binary safe!</simpara></warning>'>
+<!ENTITY tip.ob-capture '<tip><simpara>¥ô¦óª½±µ§â¿é¥X¨ìÂsÄý¾¹ªºµ²ªG¡A¥i¨Ï¥Î<link linkend="ref.outcontrol">¿é¥X±±¨î¨ç¦¡</link>¨ÓÂ^¨ú¦¹¨ç¦¡ªº¿é¥X¡A¦A±N¤§¦s¤J¤@­Ó<type>¦r¦ê</type>(Á|¨Ò»¡©ú)¡C</simpara></tip>'>
 
-<!ENTITY note.bin-safe '<note><simpara>This function is binary-safe</simpara></note>'>
+<!ENTITY tip.fopen-wrapper '<tip><simpara>¦pªG <link linkend="ini.allow-url-fopen">fopen wrappers</link> ¤w±Ò°Ê¡A«h¥iÂǦ¹¨ç¦¡§âÀɦW·í¦¨URL¨Ï¥Î¡C°Ñ¦Ò <function>fopen</function> ¦³§ó¦hÃö©ó¦p¦ó«ü©wÀɦWªº²Ó¸`©M<xref linkend="wrappers"/>¤ä´©URL¨ó©wªº¦Cªí¡C</simpara></tip>'>
 
-<!ENTITY note.no-windows '<note><simpara>This function is not implemented on Windows-platforms</simpara></note>'>
+<!ENTITY return.success '¦¨¥\¦^¶Ç&true;¥¢±Ñ¦^¶Ç&false;¡C'>
 
-<!ENTITY note.no-windows.extension '<note><simpara>This extension is not
-available on Windows platforms.</simpara></note>'>
+<!ENTITY array.resetspointer '<note><simpara>©I¥s¦¹¨ç¦¡«á¡M<type>°}¦C</type>ªº«ü¼Ð·|³Q<function>­«³]</function>¡C</simpara></note>'>
+
+<!ENTITY note.clearstatcache '<note><simpara>¦¹¨ç¦¡ªºµ²ªG·|³Q§Ö¨ú¡C¸Ô²Ó¸ê°T½Ð°Ñ¦Ò <function>clearstatcache</function>¡C</simpara></note>'>
+
+<!ENTITY return.falseproblem '<warning><simpara>³o­Ó¨ç¦¡¥i¯à¦^¶Ç¥¬ªL­È &false;¡A¦ý¤]¥i¯à¦^¶Ç¤@­Ó¦P©ó &false; ªº«D¥¬ªL­È¡A¹³¬O<literal>0</literal>©Î &quot;&quot;½Ð°Ñ¦Ò<link linkend="language.types.boolean">Booleans</link>¦¹¸`¦³§ó¦h¸ê°T¡C¨Ï¥Î <link linkend="language.operators.comparison"> === ¹Bºâ¤l</link>¨Ó´ú¸Õ³o­Ó¨ç¦¡ªº¦^¶Ç­È¡C</simpara></warning>'>
+
+<!ENTITY warn.imaprecodeyaz '<warning><simpara>¥Ñ©ó©Ò¨Ï¥Îªº¤º³¡²Å¸¹¬Û¦P¡M<link linkend="ref.imap">IMAP</link> ¨ç¦¡¤£¯à»P <link linkend="ref.recode">recode</link> ©Î <link linkend="ref.yaz">YAZ</link> ©µ¦ù¦P®É¨Ï¥Î¡M</simpara></warning>'>
+
+<!ENTITY note.registerglobals '<note><title>register_globals: ª`·N</title><para>¦Û PHP 4.2.0 ª©°_¡A<link linkend="ini.register-globals">register_globals</link>ªº«ü¥O¤w¹w³]¬° <emphasis>off</emphasis>¡CPHP ªÀ¸s¹ªÀy©Ò¦³¨Ï¥ÎªÌ¤£­n¨Ì¿à¦¹«ü¥O¡AÂà¦Ó¨Ï¥Î¨ä¥L¤èªk¡A¦p &link.superglobals;¡C</para></note>'>
+	
+<!ENTITY note.superglobals '<note><title>Superglobals: ¥i¥Î©Ê»¡©ú</title><para>¦Û PHP 4.1.0 ª©°_¡Asuperglobal °}¦C¦p <varname>$_GET</varname>¡A<varname>$_POST</varname> ©M <varname>$_SERVER</varname> µ¥¤w¥i¨Ï¥Î¡C¸Ô±¡½Ð°Ñ¾\¨Ï¥Î¤â¥U¤¤ªº &link.superglobals; ³¡¥÷¡C</para></note>'>
+
+<!ENTITY avail.register-long-arrays '¥Ñ PHP 5.0.0 ¶}©l¡A¸ûªøªº PHP <link linkend="language.variables.predefined">¥ý«e©w¸qªºÅܼÆ</link>³¯¦C¥i¥H³q¹L³]©w <link linkend="ini.register-long-arrays">register_long_arrays</link> ¨ÓÃö³¬¡C'>
+
+<!ENTITY note.magicquotes.gpc '<note><title>magic_quotes_gpc «ü¥O¨Ï¥Îª`·N</title><para>PHP ªº <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> «ü¥O¤w¹w³]¬° <literal>on</literal>¡A¨ä§@¥Î´N¦n¤ñ¹ï GET¡APOST¡ACOOKIE ªº¸ê®Æ¨Ï¥Î <function>addslashes</function> ¨ç¦¡¡C±z¥i¥H¨Ï¥Î <function>stripslashes</function> ¨ç¦¡¨ÓÁÙ­ì¸ê®Æ¡C</para></note>'>
+
+<!-- Various notes -->
+<!ENTITY note.randomseed '<note><simpara>¥ÑPHP 4.2.0 ©l¡A±z¤£»Ý­n¦A¨Ï¥Î <function>srand</function> ©Î <function>mt_srand</function> ¬°¶Ã¼Æ²£¥Í¾¹´£¨ÑºØ¤l¡A¦]¬°³o¤w¦Û°Êªº´£¨Ñ¤F¡C</simpara></note>'>
+
+<!ENTITY note.not-bin-safe '<warning><simpara>³o­Ó¨ç¦¡¼È®ÉÁÙ¤£¯à¦w¥þªº¨Ï¥Î©ó¤G¶i¦ì¡C</simpara></warning>'>
+
+<!ENTITY note.bin-safe '<note><simpara>³o­Ó¨ç¦¡¥i¦w¥þªº¨Ï¥Î©ó¤G¶i¦ì¡C</simpara></note>'>
+
+<!ENTITY note.line-endings '<note><simpara>¦pªG¹J¨ì<literal>PHP</literal>Ū¨ú³Áª÷¶ð¹q¸£®æ¦¡Àɮ׮ɵLªk¿ëÃѦ浲§ôªº°ÝÃD¡A¥i¯à¥i¥H¸ÕµÛ°_°Ê°õ¦æ®É´Á²ÕºA¿ï¶µªº<link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link>¡C</simpara></note>'>
+
+<!ENTITY note.no-windows '<note><simpara>¦¹¨ç¦¡¤£¾A¥Î©ó Windows ¥­¥x¡C</simpara></note>'>
+
+<!ENTITY note.no-windows.extension '<note><simpara>¦¹©µ¦ù¤£¾A¥Î©ó Windows ¥­¥x¡C</simpara></note>'>
+
+<!ENTITY note.func-callback '<note><simpara>°£¤F¨ç¦¡¦WºÙ¡A¤]´£¨Ñ¤@­Ó¥]§tª«¥ó°Ñ¦Òªº°}¦C©M¤@­Ó¤èªk¦WºÙ¡C</simpara></note>'>
 
 <!-- Notes for safe-mode limited functions: -->
-<!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'>
-<!ENTITY note.sm.uidcheck '<note><simpara>When <link 
-linkend="features.safe-mode">safe-mode</link> is enabled, PHP checks whether 
-the file(s)/directories you are about to operate on, have the same UID as the 
-script that is being executed.</simpara></note>'>
-<!ENTITY note.sm.uidcheck.dir '<note><simpara>When <link 
-linkend="features.safe-mode">safe-mode</link> is enabled, PHP checks whether 
-the directory in which you are about to operate, have the same UID as the 
-script that is being executed.</simpara></note>'>
+<!ENTITY note.sm.disabled '<note><simpara>&sm.°±¥Î;</simpara></note>'>
+
+<!ENTITY note.sm.uidcheck '<note><simpara>·í<link linkend="features.safe-mode">¦w¥þ¼Ò¦¡</link>¶}±Ò¡APHP·|Àˬd°õ¦æªº¸}¥»©M­n¾Þ§@ªºÀɮשΥؿý¬O§_¦³¬Û¦PªºUID(¾Ö¦³ªÌ)¡C</simpara></note>'>
+
+<!ENTITY note.sm.uidcheck.dir '<note><simpara>·í<link linkend="features.safe-mode">¦w¥þ¼Ò¦¡</link>¶}±Ò¡APHP·|Àˬd°õ¦æªº¸}¥»©M­n¾Þ§@ªºÀɮשΥؿý¬O§_¦³¬Û¦PªºUID(¾Ö¦³ªÌ)</simpara></note>'>
+
+<!ENTITY note.language-construct '<note><simpara>¥Ñ©ó³o¬O¤@­Ó»y¨¥µ²ºc¡B¦Ó¤£¬O¨ç¦¡¡A©Ò¥H¤£¯à¥H<link linkend="functions.variable-functions">Åܼƨ禡</link>ªº¤è¦¡¨Ó©I¥s¡C</simpara></note>'>
 
 <!-- Common pieces in features/safe-mode.xml 
      Jade doesn't allow in-line entities, so I put them here... Though they 
      should have been inline in safe-mode.xml -->
-<!ENTITY sm.uidcheck 'Checks whether the file(s)/directories you are 
-about to operate on, have the same UID as the script that is being
-executed.'>
-<!ENTITY sm.uidcheck.dir 'Checks whether the directory in which
-you are about to operate, has the same UID as the script that is being
-executed.'>
-<!ENTITY sm.disabled 'This functions is disabled in <link 
-linkend="features.safe-mode">safe-mode</link>'>
+<!ENTITY sm.uidcheck 'Àˬd°õ¦æªº¸}¥»©M­n¾Þ§@ªº¥Ø¿ý©ÎÀɮ׬O§_¦³¬Û¦PªºUID(¾Ö¦³ªÌ)¡C'>
+
+<!ENTITY sm.uidcheck.dir 'Àˬd°õ¦æªº¸}ª©©M­n¾Þ§@ªº¥Ø¿ý¬O§_¦³¬Û¦PªºUID(¾Ö¦³ªÌ)¡C'>
+
+<!ENTITY sm.disabled '³o­Ó¨ç¦¡¦b<link linkend="features.safe-mode">¦w¥þ¼Ò¦¡</link>¨S¦³§@¥Î¡C'>
+
+<!-- Common pieces in partintro-sections -->
+<!ENTITY no.config '<para>&php.ini;¤¤¨S¦³©w¸q¦¹©µ¦ùªº²ÕºA«ü¥O¡C</para>'>
+<!ENTITY no.resource '<para>³o­Ó©µ¦ù¨S¦³©w¸q¥ô¦ó¸ê·½¡C</para>'>
+<!ENTITY no.constants '<para>³o­Ó©µ¦ù¨S¦³©w¸q¥ô¦ó±`¼Æ¡C</para>'>
+<!ENTITY no.requirement '<para>«Ø¥ß³o­Ó©µ¦ù¤£»Ý­n¥ô¦ó¥~³¡µ{¦¡®w¡C</para>'>
+<!ENTITY no.install '<para>³o¨Ç¨ç¦¡¬OPHP®Ö¤ßªº¤@³¡¤À¡A¤£»Ý­n¦w¸Ë´N¥i¨Ï¥Î¡C</para>'>
+
+<!-- Used in every chapter that has directive descriptions -->
+<!ENTITY ini.descriptions.title '<para>³o¸Ì¬°Â²µuªºµ²ºc«ü¥O»¡©ú¡C</para>'>
+
+
+<!-- Used in reference/$extname/ini.xml -->
+<!ENTITY extension.runtime '<simpara>&php.ini;¤¤ªº³]©w·|¼vÅT³o¨Ç¨ç¦¡ªº¦æ¬°¡C</simpara>'>
+
+<!-- Used in reference/$extname/constants.xml -->
+<!ENTITY extension.constants '<simpara>¥H¤Uªº±`¼Æ¥Ñ¦¹©µ¦ù©w¸q¡A¥u¦b³o­Ó©µ¦ù³Q½sĶ¦¨PHP©Î¹ê¦æ®É´Á³Q°ÊºA¸ü¤J®É¦³®Ä¡C</simpara>'>
+
+<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
+<!ENTITY extension.constants.core '<simpara>¥H¤U¸g±`¦³®Ä±`¼Æ¬°PHP®Ö¤ßªº¤@³¡¤À¡C</simpara>'>
+
+<!-- Used in reference/$extname/classes.xml -->
+<!ENTITY extension.classes '<simpara>¥H¤UªºÃþ§O¬O¥Ñ³o­Ó©µ¦ù©w¸qªº¡A¥u¦b³o­Ó©µ¦ù³Q½sĶ¦¨PHP©Î¹ê¦æ®É´Á³Q°ÊºA¸ü¤J®É¦³®Ä¡C</simpara>'>
+
+<!ENTITY windows.builtin '<simpara>Windows ª©¥»ªº <literal>PHP</literal> ¤w¤º«Ø¦¹©µ¦ùªº¤ä´©¡M©Ò¥H§A¤ð¶·¦A¸ü¤Jªþ¥[ªº©µ¦ù¨Ó¨Ï¥Î³o¨Ç¥\¯à¡C</simpara>'>
+
+<!-- These are here as helpers for manual consistency and brievety-->
+<!ENTITY php '<literal>PHP</literal>'>
+
+<!ENTITY safemode '<link linkend="ini.safe-mode">¦w¥þ¼Ò¦¡</link>'>
+
+<!-- Some MySQL Notes -->
+<!ENTITY mysql.field-case '<note><simpara>¦¹¨ç¦¡ªð¦^ªºÄæ¦ì¦WºÙ¬O<emphasis>¦³¤j¤p¼g¤§¤Àªº</emphasis></simpara></note>'>
+
+<!-- These are using in reference/$extname/reference.xml and other supplemental files to mark section titles -->
+<!ENTITY reftitle.intro     '<title>¤¶²Ð</title>'>
+<!ENTITY reftitle.required  '<title>»Ý¨D</title>'>
+<!ENTITY reftitle.install   '<title>¦w¸Ë</title>'>
+<!ENTITY reftitle.runtime   '<title>°õ¦æ®É´Á²ÕºA</title>'>
+<!ENTITY reftitle.resources '<title>¸ê·½Ãþ«¬</title>'>
+<!ENTITY reftitle.constants '<title>¹w¥ý©w¸q±`¼Æ</title>'>
+<!ENTITY reftitle.classes '<title>¹w¥ý©w¸qÃþ§O</title>'>
+<!ENTITY reftitle.examples  '<title>½d¨Ò</title>'>
+<!ENTITY reftitle.seealso   '<title>°Ñ¦Ò</title>'>
+
+<!-- Notes for IPv6 -->
+<!ENTITY ipv6.brackets '<note><simpara>·í«ü©w¤@­Ó¥H¼Æ¦rªí¥Üªº IPv6 ¦ì§} (¨Ò¦p fe80::1)®É¡A±z¥²¶·±N IP ¥H¤è¬A¸¹³ò¦í¡C¨Ò¦p <literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>
+
+<!ENTITY ipv6.php5 '<note><simpara><literal>PHP 5.0</literal> °_¥[¤J¤F IPv6 ªº¤ä´©</simpara></note>'>
\ No newline at end of file