Re: House style for DocBook documentation?

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Chapman Flack <chap(at)anastigmatix(dot)net>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
Cc: Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com>, Markus Winand <markus(dot)winand(at)winand(dot)at>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: House style for DocBook documentation?
Date: 2019-01-26 08:31:13
Message-ID: ae85fa30-5aea-ef56-6506-b8af2d3507ba@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 25/01/2019 15:37, Chapman Flack wrote:
>> External links already create footnotes in the PDF output. Is that
>> different from what you are saying?
> That might, only, indicate that I was just thinking aloud in email and
> had not gone and checked in PDF output to see how the links were handled.
>
> Yes, it could very possibly indicate that.
>
> If they are already processed that way, does that mean the
>
> o Do not use text with <ulink> so the URL appears in printed output
>
> in README.links should be considered obsolete, and removed even, and
> doc authors should feel free to put link text in <ulink> without
> hesitation?

I think it's obsolete, yes.

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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Lætitia Avrot 2019-01-26 09:50:15 [Patch] Log10 and hyperbolic functions for SQL:2016 compliance
Previous Message Peter Eisentraut 2019-01-26 08:25:17 Re: using expression syntax for partition bounds