Re: make libpq documentation navigable between functions - Mailing list pgsql-hackers

From Fabien COELHO
Subject Re: make libpq documentation navigable between functions
Date
Msg-id alpine.DEB.2.21.1907222047050.31866@lancre
Whole thread Raw
In response to Re: make libpq documentation navigable between functions  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
Responses Re: make libpq documentation navigable between functions  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
List pgsql-hackers
Hello Peter,

> What I really meant was that you determine the best link target in each
> case.  If there already is an id on a <varlistentry>, then use that.  If
> not, then make an id on something else, most likely the <function> element.

Ok, sorry I misunderstood.

>> This step is (well) beyond my current XSLT proficiency, which is null
>> beyond knowing that it transforms XML into whatever. Also I'm unsure into
>> which of the 11 xsl file the definition should be included and what should
>> be written precisely.
>
> See attached patch.

Thanks!

Attached script does, hopefully, the expected transformation. It adds ids 
to <function> occurrences when the id is not defined elsewhere.

Attached v3 is the result of applying your kindly provided xslt patch plus
the script on "libpq.sgml".

Three functions are ignored because no documentation is found: 
PQerrorField (does not exist anywhere in the sources), 
PQsetResultInstanceData (idem) and PQregisterThreadLock (it exists).

Doc build works for me and looks ok.

-- 
Fabien.
Attachment

pgsql-hackers by date:

Previous
From: Manuel Rigger
Date:
Subject: Re: Broken defenses against dropping a partitioning column
Next
From: Tom Lane
Date:
Subject: Re: Broken defenses against dropping a partitioning column