*** pgsql/doc/src/sgml/syntax.sgml	2008/12/31 23:42:56	1.129
--- pgsql/doc/src/sgml/syntax.sgml	2009/02/04 21:30:41	1.130
***************
*** 1,4 ****
! <!-- $PostgreSQL: pgsql/doc/src/sgml/syntax.sgml,v 1.128 2008/12/31 00:08:35 tgl Exp $ -->
  
  <chapter id="sql-syntax">
   <title>SQL Syntax</title>
--- 1,4 ----
! <!-- $PostgreSQL: pgsql/doc/src/sgml/syntax.sgml,v 1.129 2008/12/31 23:42:56 tgl Exp $ -->
  
  <chapter id="sql-syntax">
   <title>SQL Syntax</title>
*************** UPDATE "my_table" SET "a" = 5;
*** 194,204 ****
      identifiers</secondary></indexterm> A variant of quoted
      identifiers allows including escaped Unicode characters identified
      by their code points.  This variant starts
!     with <literal>U&</literal> (upper or lower case U followed by
      ampersand) immediately before the opening double quote, without
!     any spaces in between, for example <literal>U&"foo"</literal>.
      (Note that this creates an ambiguity with the
!     operator <literal>&</literal>.  Use spaces around the operator to
      avoid this problem.)  Inside the quotes, Unicode characters can be
      specified in escaped form by writing a backslash followed by the
      four-digit hexadecimal code point number or alternatively a
--- 194,204 ----
      identifiers</secondary></indexterm> A variant of quoted
      identifiers allows including escaped Unicode characters identified
      by their code points.  This variant starts
!     with <literal>U&amp;</literal> (upper or lower case U followed by
      ampersand) immediately before the opening double quote, without
!     any spaces in between, for example <literal>U&amp;"foo"</literal>.
      (Note that this creates an ambiguity with the
!     operator <literal>&amp;</literal>.  Use spaces around the operator to
      avoid this problem.)  Inside the quotes, Unicode characters can be
      specified in escaped form by writing a backslash followed by the
      four-digit hexadecimal code point number or alternatively a
*************** UPDATE "my_table" SET "a" = 5;
*** 206,217 ****
      hexadecimal code point number.  For example, the
      identifier <literal>"data"</literal> could be written as
  <programlisting>
! U&"d\0061t\+000061"
  </programlisting>
      The following less trivial example writes the Russian
      word <quote>slon</quote> (elephant) in Cyrillic letters:
  <programlisting>
! U&"\0441\043B\043E\043D"
  </programlisting>
     </para>
  
--- 206,217 ----
      hexadecimal code point number.  For example, the
      identifier <literal>"data"</literal> could be written as
  <programlisting>
! U&amp;"d\0061t\+000061"
  </programlisting>
      The following less trivial example writes the Russian
      word <quote>slon</quote> (elephant) in Cyrillic letters:
  <programlisting>
! U&amp;"\0441\043B\043E\043D"
  </programlisting>
     </para>
  
*************** U&"\0441\043B\043E\043D"
*** 221,227 ****
      the <literal>UESCAPE</literal><indexterm><primary>UESCAPE</primary></indexterm>
      clause after the string, for example:
  <programlisting>
! U&"d!0061t!+000061" UESCAPE '!'
  </programlisting>
      The escape character can be any single character other than a
      hexadecimal digit, the plus sign, a single quote, a double quote,
--- 221,227 ----
      the <literal>UESCAPE</literal><indexterm><primary>UESCAPE</primary></indexterm>
      clause after the string, for example:
  <programlisting>
! U&amp;"d!0061t!+000061" UESCAPE '!'
  </programlisting>
      The escape character can be any single character other than a
      hexadecimal digit, the plus sign, a single quote, a double quote,
*************** SELECT 'foo'      'bar';
*** 458,468 ****
       <productname>PostgreSQL</productname> also supports another type
       of escape syntax for strings that allows specifying arbitrary
       Unicode characters by code point.  A Unicode escape string
!      constant starts with <literal>U&</literal> (upper or lower case
       letter U followed by ampersand) immediately before the opening
       quote, without any spaces in between, for
!      example <literal>U&'foo'</literal>.  (Note that this creates an
!      ambiguity with the operator <literal>&</literal>.  Use spaces
       around the operator to avoid this problem.)  Inside the quotes,
       Unicode characters can be specified in escaped form by writing a
       backslash followed by the four-digit hexadecimal code point
--- 458,468 ----
       <productname>PostgreSQL</productname> also supports another type
       of escape syntax for strings that allows specifying arbitrary
       Unicode characters by code point.  A Unicode escape string
!      constant starts with <literal>U&amp;</literal> (upper or lower case
       letter U followed by ampersand) immediately before the opening
       quote, without any spaces in between, for
!      example <literal>U&amp;'foo'</literal>.  (Note that this creates an
!      ambiguity with the operator <literal>&amp;</literal>.  Use spaces
       around the operator to avoid this problem.)  Inside the quotes,
       Unicode characters can be specified in escaped form by writing a
       backslash followed by the four-digit hexadecimal code point
*************** SELECT 'foo'      'bar';
*** 470,481 ****
       followed by a six-digit hexadecimal code point number.  For
       example, the string <literal>'data'</literal> could be written as
  <programlisting>
! U&'d\0061t\+000061'
  </programlisting>
       The following less trivial example writes the Russian
       word <quote>slon</quote> (elephant) in Cyrillic letters:
  <programlisting>
! U&'\0441\043B\043E\043D'
  </programlisting>
      </para>
  
--- 470,481 ----
       followed by a six-digit hexadecimal code point number.  For
       example, the string <literal>'data'</literal> could be written as
  <programlisting>
! U&amp;'d\0061t\+000061'
  </programlisting>
       The following less trivial example writes the Russian
       word <quote>slon</quote> (elephant) in Cyrillic letters:
  <programlisting>
! U&amp;'\0441\043B\043E\043D'
  </programlisting>
      </para>
  
*************** U&'\0441\043B\043E\043D'
*** 485,491 ****
       the <literal>UESCAPE</literal><indexterm><primary>UESCAPE</primary></indexterm>
       clause after the string, for example:
  <programlisting>
! U&'d!0061t!+000061' UESCAPE '!'
  </programlisting>
       The escape character can be any single character other than a
       hexadecimal digit, the plus sign, a single quote, a double quote,
--- 485,491 ----
       the <literal>UESCAPE</literal><indexterm><primary>UESCAPE</primary></indexterm>
       clause after the string, for example:
  <programlisting>
! U&amp;'d!0061t!+000061' UESCAPE '!'
  </programlisting>
       The escape character can be any single character other than a
       hexadecimal digit, the plus sign, a single quote, a double quote,