Add explicit note that empty-string array element values now have to
authorTom Lane
Mon, 30 Aug 2004 00:33:52 +0000 (00:33 +0000)
committerTom Lane
Mon, 30 Aug 2004 00:33:52 +0000 (00:33 +0000)
be written with quotes.  Minor copy-editing too.

doc/src/sgml/release.sgml

index af1db25543ea75bc80aaa3748f92d7a74a6cfb64..6752443ae3b0998e3166aa39448915fe3c4c46c2 100644 (file)
@@ -1,5 +1,5 @@
 
 
 
@@ -327,11 +327,13 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.292 2004/08/27 02:09:18 momjian
 
      
       
-       Syntax checking of array input processing has been tighened up
+       Syntax checking of array input values has been tightened up
        considerably. Junk that was previously allowed in odd places with
-       odd results now causes an ERROR. Also changed behavior with respect
-       to whitespace surrounding array elements; trailing whitespace is now
-       ignored as well as leading whitespace (which has always been ignored).
+       odd results now causes an ERROR. Empty-string element values must
+       now be written as "", rather than writing nothing.
+       Also changed behavior with respect to whitespace surrounding array
+       elements: trailing whitespace is now ignored, for symmetry with leading
+       whitespace (which has always been ignored).
       
      
     
@@ -1186,7 +1188,7 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.292 2004/08/27 02:09:18 momjian
 
     
      
-      Reject non-rectangular array literals as erroneous (Joe)
+      Reject non-rectangular array values as erroneous (Joe)
      
      
       Formerly, array_in would silently build a
@@ -1196,11 +1198,25 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.292 2004/08/27 02:09:18 momjian
 
     
       
-       Syntax checking of array input processing considerably tighened up (Joe)
+       Syntax checking of array input values considerably tightened up (Joe)
       
      
        Junk that was previously allowed in odd places with odd results now
-       causes an ERROR.
+       causes an ERROR: for example, non-whitespace after the closing
+       right brace.
+      
+    
+
+    
+      
+       Empty-string array element values must now be written as
+       "", rather than writing nothing (Joe)
+      
+     
+       Formerly, both ways of writing an empty-string element value were
+       allowed, but now a quoted empty string is required.  The case where
+       nothing at all appears will probably be taken over to mean a NULL
+       element value in some future release.
       
     
 
@@ -1210,14 +1226,14 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.292 2004/08/27 02:09:18 momjian
       
      
        Formerly leading whitespace was ignored, but trailing whitespace
-       between an element and the delimiter or right brace was significant.
-       Now trailing whitespace is also ignored.
+       between an element value and the delimiter or right brace was
+       significant.  Now trailing whitespace is also ignored.
       
     
 
     
      
-      Emit array literals with explicit array bounds when lower bound is not one
+      Emit array values with explicit array bounds when lower bound is not one
       (Joe)