[DOCS] Code examples

2007-09-03 Thread Decibel!
Moving to -docs On Sun, Sep 02, 2007 at 06:46:11PM -0400, Tom Lane wrote: > > Another problem I see are broken examples of dictionary and parser in > > documentation: > > http://momjian.us/main/writings/pgsql/sgml/textsearch-rule-dictionary-example.html > > http://momjian.us/main/writings/pgsql/s

Re: [DOCS] Code examples

2007-09-03 Thread Peter Eisentraut
Decibel! wrote: > Couldn't we come up with some method of specifying code examples in > the docs and then having the doc build process actually run those > examples and put that into the doc build? While that seems very tempting, I think you need manual review to check whether the examples make d

Re: [DOCS] Code examples

2007-09-03 Thread Tom Lane
Peter Eisentraut <[EMAIL PROTECTED]> writes: > Decibel! wrote: >> Couldn't we come up with some method of specifying code examples in >> the docs and then having the doc build process actually run those >> examples and put that into the doc build? > While that seems very tempting, I think you need