From: | Oleg Bartunov <obartunov(at)gmail(dot)com> |
---|---|
To: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> |
Cc: | pgsql-hackers <pgsql-hackers(at)postgresql(dot)org> |
Subject: | Re: documentation is now XML |
Date: | 2017-11-23 15:21:33 |
Message-ID: | CAF4Au4wx2=7QgStm+dt7AndcFAEpr1r1y4ThDZJFhNVg1LjBwg@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Thu, Nov 23, 2017 at 6:01 PM, Peter Eisentraut
<peter(dot)eisentraut(at)2ndquadrant(dot)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
>
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2017-11-23 16:50:37 | Re: How is the PostgreSQL debuginfo file generated |
Previous Message | Peter Eisentraut | 2017-11-23 15:16:35 | Re: has_sequence_privilege() never got the memo |