public inbox for [email protected]  

help / color / mirror / Atom feed

From: Peter Eisentraut <[email protected]>
To: [email protected]
Subject: non-ASCII characters in SGML documentation (and elsewhere)
Date: Fri, 20 May 2011 00:49:00 +0300
Message-ID: <[email protected]> (raw)

There are a few literal non-ASCII characters in the SGML documentation,
namely in

isn.sgml
release-7.4.sgml
release-8.4.sgml

Also, there are some encoded (&foo;) non-ASCII characters in

release-8.0.sgml
release-8.1.sgml
release-8.2.sgml
unaccent.sgml

These all work fine, because they are all LATIN1, and DocBook SGML uses
LATIN1.

But I notice that the contributor names in the 9.1 release notes have
been carefully ASCII-fied, presumably from the Git UTF-8 commit
messages.

For additional amusement, when creating the HISTORY file, lynx recodes
the HTML into the encoding specified by your LC_CTYPE environment
setting.

Also, the following source files contain non-ASCII characters in
comments:

src/backend/port/dynloader/darwin.c (LATIN1)
src/backend/storage/lmgr/predicate.c (UTF8)
src/backend/storage/lmgr/README-SSI (UTF8)

The last two are new in 9.1.

So, some questions:

      * Should we consistently use entities for encoding non-ASCII
        characters in SGML?  Or use LATIN1 freely?
      * Should we allow/use non-ASCII characters in the release notes?
      * What encoding should the HISTORY file have?
      * Should we allow non-ASCII characters in general source files?
      * If so, what should the encoding be?

view thread (10+ 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]
  Subject: Re: non-ASCII characters in SGML documentation (and elsewhere)
  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