Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id 7C683632EDD for ; Sat, 17 Jul 2010 02:30:19 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia, port 10024) with ESMTP id 00311-08 for ; Sat, 17 Jul 2010 05:30:12 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from exprod7og101.obsmtp.com (exprod7og101.obsmtp.com [64.18.2.155]) by mail.postgresql.org (Postfix) with SMTP id A778D632E59 for ; Sat, 17 Jul 2010 02:30:11 -0300 (ADT) Received: from source ([209.85.215.170]) by exprod7ob101.postini.com ([64.18.6.12]) with SMTP ID DSNKTEE/4ZqEU+BwJ6uNiZFF8WhSSj4C3X0G@postini.com; Fri, 16 Jul 2010 22:30:11 PDT Received: by eyh6 with SMTP id 6so815030eyh.29 for ; Fri, 16 Jul 2010 22:30:08 -0700 (PDT) Received: by 10.213.19.82 with SMTP id z18mr271116eba.88.1279344608038; Fri, 16 Jul 2010 22:30:08 -0700 (PDT) Received: from [192.168.1.117] (dsl-hkibrasgw2-ff7ac300-240.dhcp.inet.fi [88.195.122.240]) by mx.google.com with ESMTPS id a48sm24724489eei.1.2010.07.16.22.30.07 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 16 Jul 2010 22:30:07 -0700 (PDT) Message-ID: <4C413FDE.4040501@enterprisedb.com> Date: Sat, 17 Jul 2010 08:30:06 +0300 From: Heikki Linnakangas User-Agent: Mozilla/5.0 (X11; U; Linux i686; fi-FI; rv:1.9.1.10) Gecko/20100619 Iceowl/1.0b1 Icedove/3.0.5 MIME-Version: 1.0 To: Steve Atkins CC: pgsql-docs Subject: Re: Railroad diagrams, a-la sqlite References: <2AACFC47-C121-4549-B015-AC4FCA9380CE@blighty.com> In-Reply-To: <2AACFC47-C121-4549-B015-AC4FCA9380CE@blighty.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-4.2 tagged_above=-5 required=5 tests=BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3 X-Spam-Level: X-Archive-Number: 201007/112 X-Sequence-Number: 5768 On 17/07/10 07:33, Steve Atkins wrote: > Has everyone seen the "railroad diagrams" sqlite use in their docs? http://www.sqlite.org/lang_createindex.html , as one example. > > Would it be nice to have the same sort of format in the postgresql docs? (Yeah, I'm volunteering, if people think they're a useful thing, 'cos I think they'd add a lot to our documentation.) That would be nice. It would have to be automatically generated from the syntax descriptions we already have, otherwise it'd be unmaintainable. Also, the text representation would have to still be there in an alt tag - I note that the the sqlite docs don't have that. Any idea how those sqlite images are generated? -- Heikki Linnakangas EnterpriseDB http://www.enterprisedb.com