From: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> |
---|---|
To: | pgsql-hackers <pgsql-hackers(at)postgresql(dot)org> |
Subject: | documentation is now XML |
Date: | 2017-11-23 15:01:32 |
Message-ID: | a84e378f-d7dd-2be9-fd1b-89a5f78c19df@2ndquadrant.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
The documentation sources are now DocBook XML, not SGML. (The files are
still named *.sgml. That's something to think about separately.)
Besides the recent change to require full end tags, which is compatible
between SGML and XML, being XML now requires empty-element tags to use
the XML syntax like <xref linkend="foo"/>. When backpatching
documentation changes, the extra slash needs to be removed, however.
(The documentation build in backbranches will error if that is not done.)
For the required tools, there are no new requirements, but you can drop
docbook-sgml and opensp. The instructions at
<https://www.postgresql.org/docs/devel/static/docguide-toolsets.html>
will be up-to-date once built.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Eisentraut | 2017-11-23 15:06:56 | Re: [HACKERS] SQL procedures |
Previous Message | Dmitry Shalashov | 2017-11-23 14:58:23 | Re: Query became very slow after 9.6 -> 10 upgrade |