documentation is now XML

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

Responses

Browse pgsql-hackers by date

  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