Thread: Re: pgsql: doc: improve build for non-Latin1 characters

Re: pgsql: doc: improve build for non-Latin1 characters

From
Bruce Momjian
Date:
On Mon, Nov  4, 2024 at 08:02:18AM +0100, Peter Eisentraut wrote:
> I'm surprised this was committed.  I don't think there was consensus that

(thread moved to docs)

Well, I posted the final patch on October 15, and though the thread was
active with comments, no one had any feedback for my patch so I assumed
it was acceptable.

> this is the right direction.  Moreover, this touched a couple of files that
> it shouldn't have:
> 
> doc/src/sgml/images/genetic-algorithm.svg is a generated file that shouldn't
> be changed directly.  In fact, adding the *.svg files to the check-nbsp
> target is therefore also wrong.

Good point.  I have removed the SVG check from the Makefile.  I also
figured out the UTF8 non-Latin1 spaces came from
doc/src/sgml/images/genetic-algorithm.gv:

        a4 -> a5[xlabel="false   ", fontsize=10];
        a4 -> end[xlabel="true  ",  fontsize=10];

Are those spaces before the close quotes expected?  Maybe they are used
to distance the text from an image.

> The chunk in doc/src/sgml/stylesheet-man.xsl was copied from the upstream
> stylesheets, and changing it causes extra differences that would make future
> maintenance harder.  Also, man stylesheets have by definition nothing to do
> with the pdf builds, so why do they need to be touched?

Wow, I had no idea that UTF8 quotes would actually work in XML files. 
If you think they actually work we can put them back but I don't know
how to test if they are working properly or not.  I assume ASCII double
quotes do work.

I am thinking Tatsuo's idea of using iconv to check files with any
non-ASCII characters is a better approach and will reply to that thread.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  When a patient asks the doctor, "Am I going to die?", he means 
  "Am I going to die soon?"