|
1 | | -<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.57 2006/05/02 18:07:51 tgl Exp $ --> |
| 1 | +<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.58 2006/05/11 19:15:35 tgl Exp $ --> |
2 | 2 |
|
3 | 3 | <chapter Id="runtime-config"> |
4 | 4 | <title>Server Configuration</title> |
@@ -3734,32 +3734,15 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' |
3734 | 3734 | <para> |
3735 | 3735 | When on, a warning is issued if a backslash (<literal>\</>) |
3736 | 3736 | appears in an ordinary string literal (<literal>'...'</> |
3737 | | - syntax). The default is <literal>on</>. |
| 3737 | + syntax) and <varname>standard_conforming_strings</varname> is off. |
| 3738 | + The default is <literal>on</>. |
3738 | 3739 | </para> |
3739 | 3740 | <para> |
3740 | | - Escape string syntax (<literal>E'...'</>) should be used for |
3741 | | - backslash escape sequences, because ordinary strings have |
3742 | | - the standard-conforming behavior of treating backslashes |
3743 | | - literally when the <literal>standard-conforming-strings</> |
3744 | | - option is set <literal>on</>. |
3745 | | - </para> |
3746 | | - </listitem> |
3747 | | - </varlistentry> |
3748 | | - |
3749 | | - <varlistentry id="guc-standard-conforming-strings" xreflabel="standard_conforming_strings"> |
3750 | | - <term><varname>standard_conforming_strings</varname> (<type>boolean</type>)</term> |
3751 | | - <indexterm><primary>strings</><secondary>standard conforming</></> |
3752 | | - <indexterm> |
3753 | | - <primary><varname>standard_conforming_strings</> configuration parameter</primary> |
3754 | | - </indexterm> |
3755 | | - <listitem> |
3756 | | - <para> |
3757 | | - Controls whether ordinary string literals |
3758 | | - (<literal>'...'</>) treat backslashes literally, as specified in |
3759 | | - the SQL standard. Applications may check this |
3760 | | - parameter to determine how string literals will be processed. |
3761 | | - The presence of this parameter can also be taken as an indication |
3762 | | - that the escape string syntax (<literal>E'...'</>) is supported. |
| 3741 | + Applications that wish to use backslash as escape should be |
| 3742 | + modified to use escape string syntax (<literal>E'...'</>), |
| 3743 | + because the default behavior of ordinary strings will change |
| 3744 | + in a future release for SQL compatibility. This variable can |
| 3745 | + be enabled to help detect applications that will break. |
3763 | 3746 | </para> |
3764 | 3747 | </listitem> |
3765 | 3748 | </varlistentry> |
@@ -3799,6 +3782,32 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' |
3799 | 3782 | </listitem> |
3800 | 3783 | </varlistentry> |
3801 | 3784 |
|
| 3785 | + <varlistentry id="guc-standard-conforming-strings" xreflabel="standard_conforming_strings"> |
| 3786 | + <term><varname>standard_conforming_strings</varname> (<type>boolean</type>)</term> |
| 3787 | + <indexterm><primary>strings</><secondary>standard conforming</></> |
| 3788 | + <indexterm> |
| 3789 | + <primary><varname>standard_conforming_strings</> configuration parameter</primary> |
| 3790 | + </indexterm> |
| 3791 | + <listitem> |
| 3792 | + <para> |
| 3793 | + This controls whether ordinary string literals |
| 3794 | + (<literal>'...'</>) treat backslashes literally, as specified in |
| 3795 | + the SQL standard. |
| 3796 | + The default is currently <literal>off</>, causing |
| 3797 | + <productname>PostgreSQL</productname> to have its historical |
| 3798 | + behavior of treating backslashes as escape characters. |
| 3799 | + The default will change to <literal>on</> in a future release |
| 3800 | + to improve compatibility with the standard. |
| 3801 | + Applications may check this |
| 3802 | + parameter to determine how string literals will be processed. |
| 3803 | + The presence of this parameter can also be taken as an indication |
| 3804 | + that the escape string syntax (<literal>E'...'</>) is supported. |
| 3805 | + Escape string syntax should be used if an application desires |
| 3806 | + backslashes to be treated as escape characters. |
| 3807 | + </para> |
| 3808 | + </listitem> |
| 3809 | + </varlistentry> |
| 3810 | + |
3802 | 3811 | </variablelist> |
3803 | 3812 | </sect2> |
3804 | 3813 |
|
|