yohgaki Tue Apr 30 03:09:45 2002 EDT
Modified files:
/phpdoc/en/language basic-syntax.xml
Log:
Discourage use of short tag
Index: phpdoc/en/language/basic-syntax.xml
diff -u phpdoc/en/language/basic-syntax.xml:1.29
phpdoc/en/language/basic-syntax.xml:1.30
--- phpdoc/en/language/basic-syntax.xml:1.29 Mon Apr 29 07:33:21 2002
+++ phpdoc/en/language/basic-syntax.xml Tue Apr 30 03:09:44 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.29 $ -->
+<!-- $Revision: 1.30 $ -->
<chapter id="language.basic-syntax">
<title>Basic syntax</title>
@@ -110,7 +110,8 @@
function (PHP 3 only), by enabling the <link
linkend="ini.short-open-tag">short_open_tag</link> configuration
setting in the PHP config file, or by compiling PHP with the
- --enable-short-tags option to <command>configure</command>.
+ --enable-short-tags option to <command>configure</command>. Even
+ if it is enabled by default, use of short tags are discouraged.
</para>
<para>
@@ -122,6 +123,16 @@
<para>Support for ASP-style tags was added in 3.0.4.</para>
</note>
</para>
+
+ <note>
+ <para>
+ Using short tags should be avoided when developing applications
+ or libraries that are meant for redistribution, or deployment on
+ PHP servers which are not under your control, because short tags
+ may not be supported on the target server. For portable,
+ redistributable code, be sure not to use short tags.
+ </para>
+ </note>
<para>
The closing tag for the block will include the immediately
