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

2024-11-04 Thread Bruce Momjian
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  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?"




Re: (Very minor) Link towards the 'bug-submission' web form

2024-11-04 Thread Bruce Momjian
On Thu, Oct 31, 2024 at 03:24:06PM -0400, Bruce Momjian wrote:
> On Mon, Oct 21, 2024 at 02:01:37AM +, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> > 
> > Page: https://www.postgresql.org/docs/17/bug-reporting.html
> > Description:
> > 
> > This document contains the sentence "Another method is to fill in the bug
> > report web-form available at the project's web site.", where "web site" is a
> > link: https://www.postgresql.org/
> > 
> > Suggestion: it should be a link to the web form (
> > https://www.postgresql.org/account/submitbug/ )
> 
> Good idea, patch attached.

Patch applied.  Thanks for the report.

-- 
  Bruce Momjian  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?"