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: https://www.sqlite.org/lang_insert.html Now that we have infrastructure that can add images to our documentation, we may want to consider something like this. Note that Bison has an option that outputs a grammar as a Graphviz dot file: https://www.gnu.org/software/bison/manual/html_node/Graphviz.html It's probably not possible to create a useful visualization/syntax diagram with Bison's --graph option, but it might at least be an interesting starting point. I don't think that it's necessary to discuss this now. This can be a placeholder thread that we may come back to when we're all less busy. -- Peter Geoghegan
