Received: from maia.hub.org (unknown [200.46.208.211]) by mail.postgresql.org (Postfix) with ESMTP id 01B43632820 for ; Sat, 13 Feb 2010 20:56:32 -0400 (AST) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.208.211]) (amavisd-maia, port 10024) with ESMTP id 86488-05 for ; Sun, 14 Feb 2010 00:56:05 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by mail.postgresql.org (Postfix) with ESMTP id 35E8E6326D5 for ; Sat, 13 Feb 2010 20:56:21 -0400 (AST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id o1E0uJhT010727 for ; Sat, 13 Feb 2010 19:56:19 -0500 (EST) To: pgsql-docs@postgresql.org Subject: CREATE FUNCTION reference page's Notes section is getting out of hand Date: Sat, 13 Feb 2010 19:56:19 -0500 Message-ID: <10726.1266108979@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-2.466 tagged_above=-10 required=5 tests=AWL=0.133, BAYES_00=-2.599 X-Spam-Level: X-Archive-Number: 201002/8 X-Sequence-Number: 5324 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? regards, tom lane