Re: documentation is now XML - Mailing list pgsql-hackers

From Oleg Bartunov
Subject Re: documentation is now XML
Date
Msg-id CAF4Au4wx2=7QgStm+dt7AndcFAEpr1r1y4ThDZJFhNVg1LjBwg@mail.gmail.com
Whole thread Raw
In response to documentation is now XML  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
Responses Re: documentation is now XML  (Michael Paquier <michael.paquier@gmail.com>)
List pgsql-hackers
On Thu, Nov 23, 2017 at 6:01 PM, Peter Eisentraut
<peter.eisentraut@2ndquadrant.com> wrote:
> The documentation sources are now DocBook XML, not SGML.  (The files are
> still named *.sgml.  That's something to think about separately.)

Congratulations to you and Alexander ! That is what I waited for a long time.
Now we could think about diagrams :)

>
> 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: Peter Eisentraut
Date:
Subject: Re: has_sequence_privilege() never got the memo
Next
From: Tom Lane
Date:
Subject: Re: How is the PostgreSQL debuginfo file generated