Re: blatantly a bug in the documentation - Mailing list pgsql-hackers

From Alvaro Herrera
Subject Re: blatantly a bug in the documentation
Date
Msg-id 20081124133817.GC3861@alvh.no-ip.org
Whole thread Raw
In response to Re: blatantly a bug in the documentation  ("A. Kretschmer" <andreas.kretschmer@schollglas.com>)
Responses Re: blatantly a bug in the documentation
List pgsql-hackers
A. Kretschmer wrote:

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

Perhaps the whole chapter could be improved if all the examples referred
to a set of tables and functions previously defined in the introduction
of the chapter.  It would be good if the user could cut'n paste the code
and try it out directly, instead of having to reverse engineer the
tables/columns used for each example (and they're quite inconsistent).
Also, some examples give the complete code including CREATE FUNCTION and
others don't.

Feel like submitting a patch?

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.


pgsql-hackers by date:

Previous
From: "Pavel Stehule"
Date:
Subject: Re: WIP: default values for function parameters
Next
From: Zdenek Kotala
Date:
Subject: Re: Minor race-condition problem during database startup