Re: Dollar quoting docs, round 1

David Fetter wrote:
> On Wed, Apr 28, 2004 at 08:28:58AM +0200, Peter Eisentraut wrote:
> > David Fetter wrote:
> > > Kind people,
> > >
> > > Please find attached a diff to the SGML docs that attempts to go
> > > over the new dollar quoting feature.
> >
> > I think we should just use $$ in each case.  Otherwise it might look
> > more complicated than before.
>
> Peter,
>
> I'd be delighted to simplify some of the quotes.  They can't all be $$
> because of the nesting, so that's out.  Also, I believe it is a good
> idea to give some idea of what is going on with the tags, as I do with
> similar structures in other languages.  For example, when I am writing
> up a piece of SQL in perl or php, the tag looks like this:
>
> $sql = <<SQL
> ...
> SQL
>
> $sql = <<<SQL
> ...
> SQL;

Interesting, but I think most people like to use a tag that identifies
what is happening, rather than the content.  I think that's why <<END is
used frequently, so END appears as the end.  Seeing SQL alone on a line
seems strange.

--
  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