public inbox for [email protected]  

help / color / mirror / Atom feed

From: Kevin Grittner <[email protected]>
To: Daniele Varrazzo <[email protected]>
To: [email protected]
Subject: Re: Proposal: syntax highlight in html manual
Date: Wed, 13 Apr 2011 11:14:49 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

Daniele Varrazzo <[email protected]> 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

view thread (7+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: Proposal: syntax highlight in html manual
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox