From e4badaf02161e989c8bef2cce1cf9ab407180193 Mon Sep 17 00:00:00 2001
From: Yasuo Ohgaki <yohgaki@php.net>
Date: Tue, 30 Apr 2002 07:09:44 +0000
Subject: [PATCH] Discourage use of short tag

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@80563 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/basic-syntax.xml | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/language/basic-syntax.xml b/language/basic-syntax.xml
index 35757f00d7..0571c2161f 100644
--- a/language/basic-syntax.xml
+++ b/language/basic-syntax.xml
@@ -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>
@@ -123,6 +124,16 @@
     </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
     trailing newline if one is present. Also, the closing tag