X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 93F1B9DCE18 for ; Thu, 12 Jan 2006 17:58:08 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 38752-03 for ; Thu, 12 Jan 2006 17:58:08 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from noel.decibel.org (noel.decibel.org [67.100.216.10]) by postgresql.org (Postfix) with ESMTP id DB05F9DCDEE for ; Thu, 12 Jan 2006 17:58:04 -0400 (AST) Received: by noel.decibel.org (Postfix, from userid 1001) id C393B39849; Thu, 12 Jan 2006 15:58:06 -0600 (CST) Date: Thu, 12 Jan 2006 15:58:06 -0600 From: "Jim C. Nasby" To: Peter Eisentraut Cc: Mark Kirkwood , pgsql-docs@postgresql.org Subject: Re: [PATCHES] Summary table trigger example race condition Message-ID: <20060112215806.GI63175@pervasive.com> References: <20060105213645.GY43311@pervasive.com> <43BDC132.90007@paradise.net.nz> <20060106030415.GL43311@pervasive.com> <200601122158.54636.peter_e@gmx.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200601122158.54636.peter_e@gmx.net> X-Operating-System: FreeBSD 6.0-RELEASE amd64 X-Distributed: Join the Effort! http://www.distributed.net User-Agent: Mutt/1.5.11 X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.089 required=5 tests=[AWL=0.089] X-Spam-Score: 0.089 X-Spam-Level: X-Archive-Number: 200601/20 X-Sequence-Number: 3410 On Thu, Jan 12, 2006 at 09:58:54PM +0100, Peter Eisentraut wrote: > Jim C. Nasby wrote: > > DOH! It would be good if doc/src had a better mechanism for handling > > code; one that would allow for writing the code natively (so you > > don't have to worry about translating < into < and > into >) > > and for unit testing the different pieces of code. > > > weird stuff > > ]]> While that certainly takes care of < and >, it doesn't do anything for allowing testing of code examples. If instead we put code snippets into seperate files that could actually be run via psql, we could actually test the code examples that we're including in the docs. We could also easily capture the output from that code to include in the docs. If things go well, I'll soon be working on a database book, and my plan is to use this technique to (hopefully) speed up production. If that happens I'll post the code here for folks to look at. -- Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com Pervasive Software http://pervasive.com work: 512-231-6117 vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461