From 71604c689d899c9c34d5449bc31ee42dcd010255 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <abies@php.net>
Date: Tue, 16 Sep 2003 09:55:02 +0000
Subject: [PATCH] Add note about max VARCHAR length on Win32

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@140415 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../mssql/functions/mssql-field-length.xml     | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/reference/mssql/functions/mssql-field-length.xml b/reference/mssql/functions/mssql-field-length.xml
index a878c42fd8..4da3951a70 100644
--- a/reference/mssql/functions/mssql-field-length.xml
+++ b/reference/mssql/functions/mssql-field-length.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/mssql.xml, last change in rev 1.3 -->
   <refentry id="function.mssql-field-length">
    <refnamediv>
@@ -13,9 +13,19 @@
       <methodparam><type>resource</type><parameter>result</parameter></methodparam>
       <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
      </methodsynopsis>
-
-     &warn.undocumented.func;
-
+	 <para>
+	   This function returns the length of field no. <parameter>offset</parameter> in 
+	   result <parameter>result</parameter>. If <parameter>offset</parameter> is omitted,
+	   the current field is used.
+	 </para>
+     <note>
+       <title>Note to Win32 Users</title>
+       <simpara>
+         Due to a limitation in the underlying API used by PHP (MS DbLib C API), 
+         the length of VARCHAR fields is limited to <emphasis>255</emphasis>. If 
+         you need to store more data, use a TEXT field instead.
+       </simpara>
+     </note>
    </refsect1>
   </refentry>