Thread: LIKE ESCAPE doc fix (was Re: [DOCS] functions-matching correct?)
Tom Lane wrote: > Joe Conway <mail@joeconway.com> writes: > >>7.2.1 docs: >>http://www.postgresql.org/idocs/index.php?functions-matching.html#FUNCTIONS-LIKE > > >>" It's also possible to select no escape character by writing ESCAPE ''. >>In this case there is no way to turn off the special meaning of >>underscore and percent signs in the pattern." > > >>7.3 development docs: >>http://developer.postgresql.org/docs/postgres/functions-matching.html#FUNCTIONS-LIKE > > >>" It's also possible to select no escape character by writing ESCAPE ''. >>This effectively disables the escape mechanism and turns off the special >>meaning of underscore and percent signs in the pattern." > > >>I think the former is still correct, isn't it? > > > Yes, as is easily proven by experiment: > > regression=# select 'foo' LIKE 'f%'; > ?column? > ---------- > t > (1 row) > > regression=# select 'foo' LIKE 'f%' escape ''; > ?column? > ---------- > t > (1 row) > > Who put that change in? Here's a small doc patch to fix this issue. Please apply. Thanks, Joe Index: doc/src/sgml/func.sgml =================================================================== RCS file: /opt/src/cvs/pgsql-server/doc/src/sgml/func.sgml,v retrieving revision 1.114 diff -c -r1.114 func.sgml *** doc/src/sgml/func.sgml 21 Aug 2002 05:25:49 -0000 1.114 --- doc/src/sgml/func.sgml 21 Aug 2002 05:42:49 -0000 *************** *** 2238,2246 **** <para> It's also possible to select no escape character by writing <literal>ESCAPE ''</literal>. This effectively disables the ! escape mechanism and ! turns off the special meaning of underscore and percent signs in ! the pattern. </para> <para> --- 2238,2245 ---- <para> It's also possible to select no escape character by writing <literal>ESCAPE ''</literal>. This effectively disables the ! escape mechanism, which makes it impossible to turn off the ! special meaning of underscore and percent signs in the pattern. </para> <para>
Your patch has been added to the PostgreSQL unapplied patches list at: http://candle.pha.pa.us/cgi-bin/pgpatches I will try to apply it within the next 48 hours. --------------------------------------------------------------------------- Joe Conway wrote: > Tom Lane wrote: > > Joe Conway <mail@joeconway.com> writes: > > > >>7.2.1 docs: > >>http://www.postgresql.org/idocs/index.php?functions-matching.html#FUNCTIONS-LIKE > > > > > >>" It's also possible to select no escape character by writing ESCAPE ''. > >>In this case there is no way to turn off the special meaning of > >>underscore and percent signs in the pattern." > > > > > >>7.3 development docs: > >>http://developer.postgresql.org/docs/postgres/functions-matching.html#FUNCTIONS-LIKE > > > > > >>" It's also possible to select no escape character by writing ESCAPE ''. > >>This effectively disables the escape mechanism and turns off the special > >>meaning of underscore and percent signs in the pattern." > > > > > >>I think the former is still correct, isn't it? > > > > > > Yes, as is easily proven by experiment: > > > > regression=# select 'foo' LIKE 'f%'; > > ?column? > > ---------- > > t > > (1 row) > > > > regression=# select 'foo' LIKE 'f%' escape ''; > > ?column? > > ---------- > > t > > (1 row) > > > > Who put that change in? > > Here's a small doc patch to fix this issue. Please apply. > > Thanks, > > Joe > > Index: doc/src/sgml/func.sgml > =================================================================== > RCS file: /opt/src/cvs/pgsql-server/doc/src/sgml/func.sgml,v > retrieving revision 1.114 > diff -c -r1.114 func.sgml > *** doc/src/sgml/func.sgml 21 Aug 2002 05:25:49 -0000 1.114 > --- doc/src/sgml/func.sgml 21 Aug 2002 05:42:49 -0000 > *************** > *** 2238,2246 **** > <para> > It's also possible to select no escape character by writing > <literal>ESCAPE ''</literal>. This effectively disables the > ! escape mechanism and > ! turns off the special meaning of underscore and percent signs in > ! the pattern. > </para> > > <para> > --- 2238,2245 ---- > <para> > It's also possible to select no escape character by writing > <literal>ESCAPE ''</literal>. This effectively disables the > ! escape mechanism, which makes it impossible to turn off the > ! special meaning of underscore and percent signs in the pattern. > </para> > > <para> > > ---------------------------(end of broadcast)--------------------------- > TIP 2: you can get off all lists at once with the unregister command > (send "unregister YourEmailAddressHere" to majordomo@postgresql.org) -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square, Pennsylvania 19073
Patch applied. Thanks. --------------------------------------------------------------------------- Joe Conway wrote: > Tom Lane wrote: > > Joe Conway <mail@joeconway.com> writes: > > > >>7.2.1 docs: > >>http://www.postgresql.org/idocs/index.php?functions-matching.html#FUNCTIONS-LIKE > > > > > >>" It's also possible to select no escape character by writing ESCAPE ''. > >>In this case there is no way to turn off the special meaning of > >>underscore and percent signs in the pattern." > > > > > >>7.3 development docs: > >>http://developer.postgresql.org/docs/postgres/functions-matching.html#FUNCTIONS-LIKE > > > > > >>" It's also possible to select no escape character by writing ESCAPE ''. > >>This effectively disables the escape mechanism and turns off the special > >>meaning of underscore and percent signs in the pattern." > > > > > >>I think the former is still correct, isn't it? > > > > > > Yes, as is easily proven by experiment: > > > > regression=# select 'foo' LIKE 'f%'; > > ?column? > > ---------- > > t > > (1 row) > > > > regression=# select 'foo' LIKE 'f%' escape ''; > > ?column? > > ---------- > > t > > (1 row) > > > > Who put that change in? > > Here's a small doc patch to fix this issue. Please apply. > > Thanks, > > Joe > > Index: doc/src/sgml/func.sgml > =================================================================== > RCS file: /opt/src/cvs/pgsql-server/doc/src/sgml/func.sgml,v > retrieving revision 1.114 > diff -c -r1.114 func.sgml > *** doc/src/sgml/func.sgml 21 Aug 2002 05:25:49 -0000 1.114 > --- doc/src/sgml/func.sgml 21 Aug 2002 05:42:49 -0000 > *************** > *** 2238,2246 **** > <para> > It's also possible to select no escape character by writing > <literal>ESCAPE ''</literal>. This effectively disables the > ! escape mechanism and > ! turns off the special meaning of underscore and percent signs in > ! the pattern. > </para> > > <para> > --- 2238,2245 ---- > <para> > It's also possible to select no escape character by writing > <literal>ESCAPE ''</literal>. This effectively disables the > ! escape mechanism, which makes it impossible to turn off the > ! special meaning of underscore and percent signs in the pattern. > </para> > > <para> > > ---------------------------(end of broadcast)--------------------------- > TIP 2: you can get off all lists at once with the unregister command > (send "unregister YourEmailAddressHere" to majordomo@postgresql.org) -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square, Pennsylvania 19073