Received: from localhost (unknown [200.46.204.183]) by postgresql.org (Postfix) with ESMTP id 9D8CE2E0222 for ; Sun, 16 Dec 2007 11:59:16 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024) with ESMTP id 29037-03 for ; Sun, 16 Dec 2007 11:59:13 -0400 (AST) Received: from lists.commandprompt.com (host-159.commandprompt.net [207.173.203.159]) by postgresql.org (Postfix) with ESMTP id 04A932E305F for ; Sun, 16 Dec 2007 11:59:12 -0400 (AST) Received: from [192.168.1.226] (or-69-34-217-90.sta.embarqhsd.net [69.34.217.90]) (authenticated bits=0) by lists.commandprompt.com (8.13.8/8.13.8) with ESMTP id lBGFwmDf008900 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 16 Dec 2007 07:58:52 -0800 Message-ID: <47654B3A.7030206@commandprompt.com> Date: Sun, 16 Dec 2007 07:58:50 -0800 From: "Joshua D. Drake" Organization: Command Prompt, Inc. User-Agent: Thunderbird 1.5.0.13 (Windows/20070809) MIME-Version: 1.0 To: Bruce Momjian CC: Simon Riggs , pgsql-docs@postgresql.org Subject: Re: Plug in docs References: <200712160812.lBG8C5x15519@momjian.us> In-Reply-To: <200712160812.lBG8C5x15519@momjian.us> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0 (lists.commandprompt.com [207.173.203.159]); Sun, 16 Dec 2007 07:58:52 -0800 (PST) X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200712/52 X-Sequence-Number: 4720 Bruce Momjian wrote: > Simon Riggs wrote: >> Looks like we need some docs on all these new plugin APIs we've >> introduced in this release. >> >> - PL/pgSQL hooks >> - planner hooks >> - join order hooks > > Do we normally document these? I think these are > documented-in-the-source-code type issues. If they are an API they need to be documented. Code is poor (even well documented code) substitute for good old fashioned docs. Sincerely, Joshua D. Drake