Re: Docbook 5.x

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: pgsql-docs(at)postgresql(dot)org, Alexander Law <exclusion(at)gmail(dot)com>
Subject: Re: Docbook 5.x
Date: 2017-09-18 13:57:02
Message-ID: 0c740bd4-14dc-c6ca-304b-a70e9da09d9c@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 9/15/17 14:54, Jürgen Purtz wrote:
> My suggestion is to keep the source code in one file in the same manner
> as with the SGML standalone-include/standalone-ignore mechanism. A
> *generic* xsl file shall create the extended output similar to
> 'standalone-profile.xsl'.
>
>
> installation.xml:
>
> support for authentication and connection parameter lookup (see
> <phrase condition="standalone">the documentation about client
> authentication and libpq</phrase>
> <phrase condition="default"><xref linkend="libpq-ldap"/> and<xref
> linkend="auth-ldap"/></phrase>
> for more information). On Unix,
> ...

That is what the standard DocBook profiling system does. But that has
the disadvantage of imposing a performance penalty on building the
documentation. Unless you have a way around that that I'm not seeing.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Alexander Lakhin 2017-09-18 14:38:27 Re: Docbook 5.x
Previous Message Tom Lane 2017-09-18 13:41:58 Re: Creating variable argument user defined functions in C