Re: blatantly a bug in the documentation

From: "A(dot) Kretschmer" <andreas(dot)kretschmer(at)schollglas(dot)com>
To: pgsql-hackers(at)postgresql(dot)org
Subject: Re: blatantly a bug in the documentation
Date: 2008-11-24 13:22:30
Message-ID: 20081124132230.GG23801@a-kretschmer.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

am Mon, dem 24.11.2008, um 7:24:47 -0500 mailte Merlin Moncure folgendes:
> On Mon, Nov 24, 2008 at 6:02 AM, A. Kretschmer
> <andreas(dot)kretschmer(at)schollglas(dot)com> wrote:
> > I hope this is the right place to report a bug/issue in the official
> > documentation...
> >
> > In
> > http://www.postgresql.org/docs/current/interactive/plpgsql-control-structures.html
> > there is an example for a function, cs_refresh_mviews(), chapter 38.6.4.
> > Within this function there are a "PERFORM cs_log('Refreshing
> > materialized views...');", but such a function cs_log() are not in the
> > core distibution.
>
> The example in the docs is pseudo-code. None of the tables referenced
> exist either...the purpose of the example was to demonstrate the
> syntax of for loops.

Okay, it is an argument. On the other side, it was a question today in
the irc-channel (#postgresql) today, someone asked, why his funktion
don't work. I think, such examples should not contain such code. It is
not apparent that this function are not available.

Again, thx to all people behind PostgreSQL, it is a great thing and it
has a really informatively documentation. My post was only a hint to
make it better.

Andreas
--
Andreas Kretschmer
Kontakt: Heynitz: 035242/47150, D1: 0160/7141639 (mehr: -> Header)
GnuPG-ID: 0x3FFF606C, privat 0x7F4584DA http://wwwkeys.de.pgp.net

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2008-11-24 13:25:13 Re: WIP: default values for function parameters
Previous Message KaiGai Kohei 2008-11-24 13:18:22 Re: Updates of SE-PostgreSQL 8.4devel patches (r1197)