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 ) id 1gldtJ-0000Tb-ST for pgsql-hackers@arkaria.postgresql.org; Mon, 21 Jan 2019 18:01:46 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1gldtI-00072h-0t for pgsql-hackers@arkaria.postgresql.org; Mon, 21 Jan 2019 18:01:44 +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 ) id 1gldtH-00072a-QJ for pgsql-hackers@lists.postgresql.org; Mon, 21 Jan 2019 18:01:43 +0000 Received: from mail-qt1-x843.google.com ([2607:f8b0:4864:20::843]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gldtE-0007dq-Tj for pgsql-hackers@postgresql.org; Mon, 21 Jan 2019 18:01:43 +0000 Received: by mail-qt1-x843.google.com with SMTP id p17so24522086qtl.5 for ; Mon, 21 Jan 2019 10:01:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=2ndquadrant-com.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:mime-version:content-disposition :content-transfer-encoding:in-reply-to:user-agent; bh=WjZx8WYHrmZlABxzxla0juWfIFMznC7WVW0Vz6pACOM=; b=rppGOgxY//kgPBddVgbPAluuT3FedR2wrqkd8iqKyp7u18nfB2n0KdseerNFvMk8F3 0h86U95kcvO551CkURMYV7R2jn3A+hWF3obIDu2Y4EKkQRaSkDV6s9GUFfZI0Lwqh5sB 1pNUnXbF3EimjEZEtXb3nkXYWqXDpqPWk2kipYpTfdhzWRU8+swhaWcqIZqBw5xpsvAg bK+rgVxAFT0Hna6HMB7Z9b2YG7O0B9Q9l7ibdQOyd3Dlu4ZLgKjHL42xJ67/QMbHlFpx s0/Q31npbntexa1qGk58xN+8k0sq/6SKt9IUgIJfVuTkxgCnkIW484hzmzhh0l2obp3X qMzQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:mime-version :content-disposition:content-transfer-encoding:in-reply-to :user-agent; bh=WjZx8WYHrmZlABxzxla0juWfIFMznC7WVW0Vz6pACOM=; b=mONSum9vz7Vj5ZQvHO9oIcD5i+hjJKKN2+58iVs76zhcVIMXgNWbqYcsjDYzE9LF6Y RFDEVwN11O/Ub37ZVRzK0cUlSeBKJ+cQdCsOzK8DN3ET7JDT3TaKltBQZVQrzW13N2RT hiPw+uh/u8UoXkTgn5D1UvXEn0RHbSXxidgCMQMk9Gz0nIlEAMg/IrsyBPYmlntj4RcU a/6y0rYeEsMkN1+OQ+1iIaPLoiIv5dCN1muIsDTdwO9l2eqNrpMuPH9aYrhmY2NWqEU+ 5sbQFCCoaYQ53/onKjkWE+YSpn2idEG/caIji+8W+8aVJWV2k13mapWc6yCLceUFBTiV b59A== X-Gm-Message-State: AJcUukf2ZJPo1Qao3PxYNHjVw3TYRArrZpe8rm+mZd2IBy3CcXulhjXY 2M6Wlmn2e+0I1ch3msBj5+b0Ng== X-Google-Smtp-Source: ALg8bN4EEXsaV1oDidShhkBvnLVqEKKntJF1wcVkLeAICHQDyxyZvs5IwUTEY1TSVvsBqbQnEfHyLA== X-Received: by 2002:a0c:ade7:: with SMTP id x36mr25761290qvc.66.1548093699024; Mon, 21 Jan 2019 10:01:39 -0800 (PST) Received: from alvin.alvh.no-ip.org ([190.121.29.3]) by smtp.gmail.com with ESMTPSA id c17sm85812949qtb.14.2019.01.21.10.01.38 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 21 Jan 2019 10:01:38 -0800 (PST) Received: by alvin.alvh.no-ip.org (Postfix, from userid 1000) id E64FDA74; Mon, 21 Jan 2019 15:01:36 -0300 (-03) Date: Mon, 21 Jan 2019 15:01:36 -0300 From: Alvaro Herrera To: Chapman Flack Cc: Pavel Stehule , Markus Winand , Tom Lane , PostgreSQL Hackers Subject: Re: House style for DocBook documentation? Message-ID: <201901211801.sqxe6hoejajg@alvherre.pgsql> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <5C45F74D.9040908@anastigmatix.net> User-Agent: NeoMutt/20180716-1013-2c1e88 List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk 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 > that has link text with a 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. > I wouldn't think it important to apply the same treatment when making HTML. Right, only PDF. -- Álvaro Herrera https://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services