Re: documentation structure - Mailing list pgsql-hackers

From Robert Haas
Subject Re: documentation structure
Date
Msg-id CA+TgmoZy8uLf5UJS6mCnsiLkVEdw-6qSkRVc6TXLvJ7=ULvh6g@mail.gmail.com
Whole thread Raw
In response to Re: documentation structure  (Laurenz Albe <laurenz.albe@cybertec.at>)
List pgsql-hackers
On Mon, Mar 18, 2024 at 5:40 PM Laurenz Albe <laurenz.albe@cybertec.at> wrote:
> I also disagree that chapters 4 to 6 are a continuation of the tutorial.
> Or at least, they shouldn't be.
> When I am looking for a documentation reference on something like
> security considerations of SECURITY DEFINER functions, my first
> impulse is to look in chapter 5 (Data Definition) or in chapter 38
> (Extending SQL), and I am surprised to find it discussed in the
> SQL reference of CREATE FUNCTION.

I looked at this a bit more closely. There's actually a lot of
detailed technical information in chapters 4 and 5, but chapter 6 is
extremely short and mostly recapitulates chapter 2.

--
Robert Haas
EDB: http://www.enterprisedb.com



pgsql-hackers by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: minor tweak to catalogs.sgml pg_class.reltablespace
Next
From: Daniel Gustafsson
Date:
Subject: Re: sslinfo extension - add notbefore and notafter timestamps