[postgis-devel] postgis_comments.sql

[Sandro Santilli]

On Mon, Mar 02, 2020 at 02:34:02PM -0800, Paul Ramsey wrote:
> I have long had an animus for the comments.sql file, because it results in a couple bad couplings:
> 
> extension depends on comments depends on docbook, so you cannot build extension without having docbook/xslt tools installed
> extension depends on commetns depends on docbook, so you cannot change documentation format
> 
> All this maybe would be worth choking down if the SQL comments provided any great value, but it’s not at all clear to me that they do. People lookup functions on postgis.net, on the google, but not in their SQL terminal monitors or object browsers.
> 
> If we can find it without ourselves to not have SQL comments anymore, we can back out some of these weird dependencies.
> 
> Taking the temperature, who would set themselves on fire to save SQL comments?

You know I'm a fan of modularity...
How about a postgis_comments extension ?

Making another split will be fun.
Especially knowing PostgreSQL 13 will force us to use another
strategy for re-packaging...

--strk;