Re: Syntax diagrams in user documentation

2019-03-29 Thread Peter Eisentraut
On 2019-03-28 23:45, Jeremy Schneider wrote: > We're just gearing up for the Google Season of Docs and I think this > would be a great task for a doc writer to help with. Any reason to > expect serious objections to syntax diagram graphics in the docs? It's worth a thought, but I tend to think

Re: Syntax diagrams in user documentation

2019-03-29 Thread Peter Eisentraut
On 2019-03-29 03:53, Corey Huinker wrote: > #3b As long as I live, I will never properly memorize the syntax for > RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW. I will google this > and copy-paste it. I suspect I'm not alone. If it's available only in an > image, then I can't copy paste, and

Re: Syntax diagrams in user documentation

2019-03-28 Thread Tom Lane
Christopher Browne writes: > An especially cool idea if we could automatically dig input directly from > src/backend/parser/gram.y FWIW, I think the odds of getting desirable diagrams that way are nil. There are *way* too many things about our Bison grammar that can be described charitably as

Re: Syntax diagrams in user documentation

2019-03-28 Thread Corey Huinker
On Thu, Mar 28, 2019 at 6:49 PM Peter Geoghegan wrote: > On Thu, Mar 28, 2019 at 3:46 PM Jeremy Schneider > wrote: > > We're just gearing up for the Google Season of Docs and I think this > > would be a great task for a doc writer to help with. Any reason to > > expect serious objections to

Re: Syntax diagrams in user documentation

2019-03-28 Thread Peter Geoghegan
On Thu, Mar 28, 2019 at 3:46 PM Jeremy Schneider wrote: > We're just gearing up for the Google Season of Docs and I think this > would be a great task for a doc writer to help with. Any reason to > expect serious objections to syntax diagram graphics in the docs? It might be hard to come to a

Re: Syntax diagrams in user documentation

2019-03-28 Thread Christopher Browne
On Thu, 28 Mar 2019 at 17:56, Peter Geoghegan wrote: > SQLite has a bubble generator tool that they use to generate syntax > diagrams for their documentation: > > > https://www.sqlite.org/docsrc/doc/tip/art/syntax/bubble-generator.tcl?mimetype=text/plain > > I think that the results are rather

Re: Syntax diagrams in user documentation

2019-03-28 Thread Alvaro Herrera
On 2019-Mar-28, Peter Geoghegan wrote: > SQLite has a bubble generator tool that they use to generate syntax > diagrams for their documentation: > > https://www.sqlite.org/docsrc/doc/tip/art/syntax/bubble-generator.tcl?mimetype=text/plain Interesting. SQLite itself is in the public domain, so

Syntax diagrams in user documentation

2019-03-28 Thread Peter Geoghegan
SQLite has a bubble generator tool that they use to generate syntax diagrams for their documentation: https://www.sqlite.org/docsrc/doc/tip/art/syntax/bubble-generator.tcl?mimetype=text/plain I think that the results are rather good. See, for example, the INSERT documentation: