documentation is now XML - Mailing list pgsql-hackers

From Peter Eisentraut
Subject documentation is now XML
Date
Msg-id a84e378f-d7dd-2be9-fd1b-89a5f78c19df@2ndquadrant.com
Whole thread Raw
Responses Re: documentation is now XML  (Oleg Bartunov <obartunov@gmail.com>)
Re: documentation is now XML  (Tom Lane <tgl@sss.pgh.pa.us>)
List 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


pgsql-hackers by date:

Previous
From: "REIX, Tony"
Date:
Subject: RE:PostgreSLQ v10.1 and xlC compiler on AIX
Next
From: Peter Eisentraut
Date:
Subject: Re: [HACKERS] SQL procedures