Received: from maia.hub.org (maia-5.hub.org [200.46.204.29]) by mail.postgresql.org (Postfix) with ESMTP id 4A40863565B for ; Sat, 11 Sep 2010 18:11:34 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024) with ESMTP id 84225-07-2 for ; Sat, 11 Sep 2010 21:11:26 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from momjian.us (momjian.us [70.90.9.53]) by mail.postgresql.org (Postfix) with ESMTP id CDF9F63481D for ; Sat, 11 Sep 2010 18:11:20 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id o8BLAmX14329; Sat, 11 Sep 2010 17:10:48 -0400 (EDT) From: Bruce Momjian Message-Id: <201009112110.o8BLAmX14329@momjian.us> Subject: Re: [DOCS] Doc fixes and improvements In-Reply-To: To: Robert Haas Date: Sat, 11 Sep 2010 17:10:48 -0400 (EDT) CC: Tom Lane , Thom Brown , Magnus Hagander , PostgreSQL www X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.909 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01, WEIRD_PORT=0.001 X-Spam-Level: X-Archive-Number: 201009/57 X-Sequence-Number: 19144 Robert Haas wrote: > On Fri, Sep 10, 2010 at 4:25 PM, Tom Lane wrote: > > Thom Brown writes: > >> On 10 September 2010 21:05, Tom Lane wrote: > >>> You know, I hate to say it, but this is just way too busy for my taste. > >>> The typography is screaming "look at me" instead of staying out of the > >>> way. ?I can't imagine wanting to read any large amount of docs in this > >>> presentation. > >>> > >>> Maybe I'm in the minority. > > > >> Do you have any specific recommendations? ?What would tone it down? > > > > I still think the colored backgrounds are overused, and there's way too > > much bold text. ?AFAICS all the fixed-width-font text is now bold too, > > to no improvement in readability. > > It's way too much boldface for my taste, too. I am not sure I agree > that the colored backgrounds are overused. I think you should look at Thom's version, which is more current: http://pgweb.darkixion.com:8081/docs/8.4/static/sql-syntax-lexical.html -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. +