Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1gle6U-000156-O3
	for pgsql-hackers@arkaria.postgresql.org; Mon, 21 Jan 2019 18:15:22 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.89)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1gle5V-0000DT-GK
	for pgsql-hackers@arkaria.postgresql.org; Mon, 21 Jan 2019 18:14:21 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <jd@commandprompt.com>)
	id 1gle5V-0000DK-8X
	for pgsql-hackers@lists.postgresql.org; Mon, 21 Jan 2019 18:14:21 +0000
Received: from lists.commandprompt.com ([2604:da00:2:2:5054:ff:fe07:7618])
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <jd@commandprompt.com>)
	id 1gle5Q-0007tH-Vx
	for pgsql-hackers@postgresql.org; Mon, 21 Jan 2019 18:14:20 +0000
Received: from [192.168.50.9] (spinlock.commandprompt.com [69.168.55.30])
	by lists.commandprompt.com (Postfix) with ESMTPA id A89EA462;
	Mon, 21 Jan 2019 10:14:11 -0800 (PST)
Received: from c-73-97-49-9.hsd1.wa.comcast.net ([73.97.49.9]
	helo=[192.168.50.9]) by assp.commandprompt.com with SMTPSA(TLSv1_2
 ECDHE-RSA-AES128-GCM-SHA256) (2.5.1);
	21 Jan 2019 10:14:11 -0800
Subject: Re: House style for DocBook documentation?
To: Alvaro Herrera <alvherre@2ndquadrant.com>,
 Chapman Flack <chap@anastigmatix.net>
Cc: Pavel Stehule <pavel.stehule@gmail.com>,
 Markus Winand <markus.winand@winand.at>, Tom Lane <tgl@sss.pgh.pa.us>,
 PostgreSQL Hackers <pgsql-hackers@postgresql.org>
References: <201901211801.sqxe6hoejajg@alvherre.pgsql>
From: "Joshua D. Drake" <jd@commandprompt.com>
Organization: Command Prompt, Inc.
Message-ID: <4ad8c028-5bd8-8837-9662-98cfa9568e15@commandprompt.com>
Date: Mon, 21 Jan 2019 10:14:11 -0800
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101
 Thunderbird/60.2.1
MIME-Version: 1.0
In-Reply-To: <201901211801.sqxe6hoejajg@alvherre.pgsql>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Content-Language: en-US
X-Assp-Version: 2.5.1(16177) on assp.commandprompt.com
X-Assp-ID: assp.commandprompt.com m1-94451-09728
X-Assp-Session: 7F522C43CBA8 (mail 1)
X-Assp-Original-Subject: Re: House style for DocBook documentation?
X-Assp-Client-SSL: yes
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Precedence: bulk

On 1/21/19 10:01 AM, Alvaro Herrera wrote:
> On 2019-Jan-21, Chapman Flack wrote:
>
>> But the point's well taken that in /printed output/, that's of no use.
>> Which is, in a sense, an inconsistency: in one format, you can follow the
>> links, while in another, you're out of luck.
>>
>> Maybe a simpler transform for printed output, rather than collecting
>> all URLs into one section at the back, would just be to follow any
>> <ulink> that has link text with a <footnote> containing the same ulink
>> without the link text, so it shows the URL, and that would be right at
>> the bottom of the same 'page'.
> Of course, the text would also be clickable, right?  I think putting the
> URL in a footnote is good in that case; it works both on screen and on
> paper, which should alleviate JD's concerns.

Yeah I could see that. I thought about that but was wondering if it was 
possible to auto cite?

JD


>
>> I wouldn't think it important to apply the same treatment when making HTML.
> Right, only PDF.
>

-- 
Command Prompt, Inc. || http://the.postgres.company/ || @cmdpromptinc
PostgreSQL centered full stack support, consulting and development.
Advocate: @amplifypostgres || Learn and Network: https://postgresconf.org
***  A fault and talent of mine is to tell it exactly how it is.  ***