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.
>
> <![CDATA[
>
> 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