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 1h26kY-0001VS-3A for pgsql-hackers@arkaria.postgresql.org; Fri, 08 Mar 2019 04:04: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 1h26kW-00015i-HI for pgsql-hackers@arkaria.postgresql.org; Fri, 08 Mar 2019 04:04: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 1h26kV-00015b-Ui for pgsql-hackers@lists.postgresql.org; Fri, 08 Mar 2019 04:04:44 +0000 Received: from anastigmatix.net ([68.171.219.55]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1h26kS-00032z-Ee for pgsql-hackers@postgresql.org; Fri, 08 Mar 2019 04:04:42 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=anastigmatix.net; s=default; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:MIME-Version:Date:Message-ID:From:Cc:References:To:Subject:Sender :Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=pVQFAMQr0riU9BGk7ZP1R3TTRiagvPBN8U8FdeO68o4=; b=DqMXDwQ5S8MEN9MTz8rpk0BXLq bcv6lEvJztj9mNHVYYcYpF7Z4dF+gdUsXu4LyeJYE+Q0TSfGdRyu5Rysp+9xiKZlQz0dQ+BgcIO/P hdxiGnMUr3e2wSgXqA3MeLyVzreIBl6z0yb8jIsWTPe2WeC7+PCFL7LlDgFT3xW0prOuwU1yQytFJ DDEJLyAAvPwcZi7xqrVwBbQjnjJ2UfyogxKGjnxg8ldLAfg4qPRin28ZalHRaQxMkbs0SG/zHZjc7 dZUZgIOnKAysmfD2XgDxq5w5f3Yp8RApUP/CVf13Jf2rQsoYqvQdvUBiYxy4cWy0fLODQfqjzMKB7 FU6VDlEQ==; Received: from [184.19.63.78] (port=41127) by bay.acenet.us with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.91) (envelope-from ) id 1h26kK-00EFFP-Dp; Thu, 07 Mar 2019 23:04:37 -0500 Subject: Re: House style for DocBook documentation? To: Peter Eisentraut , Alvaro Herrera References: <201901191335.kbjzsoefmkoa@alvherre.pgsql> <5C438776.9080103@anastigmatix.net> <7c345302-ade1-eedf-dc33-47cc40da4943@2ndquadrant.com> <5C4B1F2F.2000106@anastigmatix.net> <8c02f9b5-965e-ce51-2b20-e70c0d46a6a0@2ndquadrant.com> Cc: Pavel Stehule , Markus Winand , Tom Lane , PostgreSQL Hackers From: Chapman Flack Message-ID: <5C81E9B7.1050909@anastigmatix.net> Date: Thu, 7 Mar 2019 23:04:07 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.7.0 MIME-Version: 1.0 In-Reply-To: <8c02f9b5-965e-ce51-2b20-e70c0d46a6a0@2ndquadrant.com> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit X-OutGoing-Spam-Status: No, score=-99.5 X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - bay.acenet.us X-AntiAbuse: Original Domain - postgresql.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - anastigmatix.net X-Get-Message-Sender-Via: bay.acenet.us: authenticated_id: chap@anastigmatix.net X-Authenticated-Sender: bay.acenet.us: chap@anastigmatix.net X-Source: X-Source-Args: X-Source-Dir: X-From-Rewrite: unmodified, already matched List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk On 02/15/19 11:31, Peter Eisentraut wrote: >> On 25/01/2019 15:37, Chapman Flack wrote: >>> If they are already processed that way, does that mean the >>> >>> o Do not use text with 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 without >>> hesitation? > > Committed that change. I only now noticed that probably this should also have been changed: -o If you want to supply text, use , else +o If you want to supply text, use or , else Regards, -Chap