[postgis-devel] postgis_comments.sql

Paul Ramsey pramsey at cleverelephant.ca
Mon Mar 2 14:34:02 PST 2020


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?

P


More information about the postgis-devel mailing list