Re: DocBook 5.2 - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: DocBook 5.2
Date
Msg-id 8ee6b50c-8241-a98f-fd5a-8a3de34ebbc2@enterprisedb.com
Whole thread Raw
In response to Re: DocBook 5.2  (Jürgen Purtz <juergen@purtz.de>)
Responses Re: DocBook 5.2  (Jürgen Purtz <juergen@purtz.de>)
List pgsql-docs
On 05.09.22 11:50, Jürgen Purtz wrote:
> Therefore, we should consider to introduce another validator. During the migration phase,
> we have used **jing**. It's Java, it's fast, the error messages are very precise. But there
> are many others:https://relaxng.org/#validators. Should we possibly provide multiple
> validators in doc/src/sgml/Makefile?

If you follow the links on that page, it appears that all the projects 
other than jing are abandoned.  Even jing has a very sporadic release 
history (2015 -> 2018 -> 2022).  Last year at FOSDEM I gave a talk about 
the state of the DocBook toolchain [0], where I found that there is 
pretty much no tooling available for Relax-NG.  So it's great that there 
is a 2022 release of jing, but before we can consider relying on that, 
it might be nice to see a bit more of a track record.  (And we should 
also wait a little to make it trickle in stable packages for common 
operating systems.)

[0]: https://ftp.fau.de/fosdem/2021/D.docs/ttdpostgresdocbook.webm



pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: pg_dump: regular expression notation for tables
Next
From: Daniel Gustafsson
Date:
Subject: Re: PL/pgSQL casing