public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: [email protected]
Subject: Obsolete advocacy for E-style strings in regexp documentation
Date: Fri, 30 Oct 2015 23:40:23 -0400
Message-ID: <[email protected]> (raw)
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>

func.sgml has this bit near line 4660:

   <note>
    <para>
     Keep in mind that an escape's leading <literal>\</> will need to be
     doubled when entering the pattern as an SQL string constant.  For example:
<programlisting>
'123' ~ E'^\\d{3}' <lineannotation>true</lineannotation>
</programlisting>
    </para>
   </note>

This advice was surely helpful when it was written, but nowadays it's just
advocating use of gratuitously non-SQL-standard string literal syntax.
I propose just deleting the whole <note> in HEAD, and maybe 9.5 too.

A more aggressive approach would be to get rid of use of E-style literals
in all/most of the documentation examples.  I'm *not* advocating that,
at least not yet.  But this particular bit seems to be going out of its
way to give obsolete advice.

Thoughts?

			regards, tom lane


-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected]
  Subject: Re: Obsolete advocacy for E-style strings in regexp documentation
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox