Received: from maia.hub.org (maia-5.hub.org [200.46.204.29]) by mail.postgresql.org (Postfix) with ESMTP id 956931337BCC for ; Wed, 13 Apr 2011 13:15:55 -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 02520-03 for ; Wed, 13 Apr 2011 16:14:57 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from gw.wicourts.gov (gwmta.wicourts.gov [165.219.244.99]) by mail.postgresql.org (Postfix) with ESMTP id 802441337B2F for ; Wed, 13 Apr 2011 13:14:55 -0300 (ADT) Received: from Courts-MTA by gw.wicourts.gov with Novell_GroupWise; Wed, 13 Apr 2011 11:14:54 -0500 Message-Id: <4DA585A9020000250003C794@gw.wicourts.gov> X-Mailer: Novell GroupWise Internet Agent 8.0.1 Date: Wed, 13 Apr 2011 11:14:49 -0500 From: "Kevin Grittner" To: "Daniele Varrazzo" , Subject: Re: Proposal: syntax highlight in html manual References: In-Reply-To: Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201104/70 X-Sequence-Number: 6641 Daniele Varrazzo wrote: > - http://pgmp.projects.postgresql.org/highlight/psql.html > - http://pgmp.projects.postgresql.org/highlight/postgres.html > > Is there any interest in applying highlighted syntax to the html > rendering of the manual? When using an editor I like some color highlighting, as long as I can control the colors. Documentation is very different, especially since the user probably wouldn't have any control over the colors. The examples in the links above are very hard for me to read, and definitely *not* something I would want in the documentation. There might be room to do something limited and subtle, like maybe making comments a dark gray while other text is black or possibly making computer-generated output very dark blue versus black for user input. It should be subtle enough not to draw attention to it, but rather to give subtle cues. If the display screams "HEY! LOOK HERE!" about anything, it's just wrong. Overall, I'm dubious about whether it would be worth the effort, even if you can come up with a scheme which people like. -Kevin