#5434 closed defect (fixed)

Doc build fails on first run when using Unicode symbol entities

Reported by: mdavis Owned by: robe
Priority: medium Milestone: PostGIS 3.4.0
Component: documentation Version: master
Keywords: Cc:

Description

The goal is to use Unicode symbols (specifically, in `reference_relationship.xml':

ST_Crosses(A, B) ⇔ (dim( I(A) ∩ I(B) ) < max( dim(I(A), I(B) ))) ∧ (a ∩ b ≠ a) ∧ (a ∩ b ≠ b)

On a clean install (running) autogen and then configure) the doc build fails:

make chunked-html

reference_relationship.xml:624: parser error : Entity 'hArr' not defined

If I remove the symbols, make chunked-html again, add the symbols back, and make again - it works.

Change History (5)

comment:1 by strk, 13 months ago

The failing command is:

grep -v '\&postgis_special;' postgis-out.xml | /usr/bin/xsltproc —novalid —path /usr/src/postgis/postgis/doc:/usr/src/postgis/postgis/doc -o list_3d_functions.xsl.xml xsl/list_3d_functions.xml.xsl -

comment:2 by Sandro Santilli <strk@…>, 13 months ago

In 89a5f8f/git:

Properly encode dependencies of $XSL_GENERATED_SOURCES

References #5434

comment:3 by strk, 13 months ago

Using a unicode character (utf8-encoded) like ⇔ instead of the entity seems to work fine for me

comment:4 by mdavis, 13 months ago

This change now causes every run to fail on the Unicode entities.

comment:5 by strk, 13 months ago

Milestone: PostGIS 3.3.4PostGIS 3.4.0
Resolution: fixed
Status: newclosed
Version: 3.3.xmaster

Closing as use of utf8 made it always pass, feel free to reopen otherwise

Note: See TracTickets for help on using tickets.