[DOCS] [PATCH] Advise devs to prefer server_version_num over parsing the version

2015-02-17 Thread Craig Ringer
We've had server_version_num since 8.2. This patch advises devs to prefer to use it instead of parsing version() or server_version unless using libpq, in which case PQserverVersion should be used. -- Craig Ringer http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Suppor

Re: [DOCS] xref labels: "Chapter 33", "Section 33.2"

2015-02-17 Thread Craig Ringer
On 17 February 2015 at 15:27, Tom Lane wrote: > Bruce Momjian writes: > > On Mon, Feb 16, 2015 at 05:05:39PM +1300, Craig Ringer wrote: > >> I can't seem to make an render the > ... > >> element text. The DocBook documentation implies that this should be the > >> default; e.g. if you have: > >

[DOCS] bgworker / SPI docs patches

2015-02-17 Thread Craig Ringer
Hi all After spending a while working on the BDR extension I've found that the current documentation on the SPI and bgworkers could use some more detail. In the process I've put cross reference labels in for most chapter headings, as I got sick of seeing "Chapter 33" (or whatever) everywhere in t