Skip site navigation (1) Skip section navigation (2)

Re: CREATE FUNCTION reference page's Notes section is getting out of hand

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: CREATE FUNCTION reference page's Notes section is getting out of hand
Date: 2010-02-27 00:01:12
Message-ID: 201002270001.o1R01C027987@momjian.us (view raw or flat)
Thread:
Lists: pgsql-docs
Tom Lane wrote:
> I observe that the Notes section here
> http://developer.postgresql.org/pgdocs/postgres/sql-createfunction.html
> has turned into a disorganized laundry list of unrelated items,
> ranging from quite-subtle issues to barely-useful-even-to-novices
> advice (do we really need "Use DROP FUNCTION to remove user-defined
> functions" here?  Especially given the See Also link later on?).
> 
> I don't have an immediate proposal what to do about it, but it seems
> like it could use some effort.  Any thoughts?

Yea, it is hard to read.  What I did was to move some items up into
their proper sections, and add an "Overloading" heading.  You can see
the results here:

	http://momjian.us/tmp/pgsql/sql-createfunction.html

and a patch is attached.

-- 
  Bruce Momjian  <bruce(at)momjian(dot)us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com
  PG East:  http://www.enterprisedb.com/community/nav-pg-east-2010.do
  + If your life is a hard drive, Christ can be your backup. +

Attachment: /pgpatches/func
Description: text/x-diff (7.1 KB)

In response to

Responses

pgsql-docs by date

Next:From: Bruce MomjianDate: 2010-02-27 03:41:36
Subject: Re: libpq-example.html needs to use <> includes
Previous:From: gabrielleDate: 2010-02-25 19:27:37
Subject: Re: [PATCH] log_statement docs

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group