Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1jtuaP-0001OQ-V9
	for pgsql-hackers@arkaria.postgresql.org; Fri, 10 Jul 2020 15:05:13 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1jtuaO-00024u-UJ
	for pgsql-hackers@arkaria.postgresql.org; Fri, 10 Jul 2020 15:05:12 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <peter.eisentraut@2ndquadrant.com>)
	id 1jtuaO-00024d-Mz
	for pgsql-hackers@lists.postgresql.org; Fri, 10 Jul 2020 15:05:12 +0000
Received: from wforward5-smtp.messagingengine.com ([64.147.123.35])
	by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <peter.eisentraut@2ndquadrant.com>)
	id 1jtuaM-0000QT-AF
	for pgsql-hackers@postgresql.org; Fri, 10 Jul 2020 15:05:11 +0000
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41])
	by mailforward.west.internal (Postfix) with ESMTP id 9EE8B848;
	Fri, 10 Jul 2020 11:05:07 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163])
  by compute1.internal (MEProxy); Fri, 10 Jul 2020 11:05:07 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
	messagingengine.com; h=cc:content-transfer-encoding:content-type
	:date:from:in-reply-to:message-id:mime-version:references
	:subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender
	:x-sasl-enc; s=fm3; bh=Zv9pgxfWSdZ8N/yI/yDV/jYhEjnByx1D/mWhdYJ8j
	uo=; b=F+bmcalxCO0hfpus8EX/NiQ+N8fx4Iy7lOSY6E1DxowXIlsmSGCpnDSHN
	DtUmEwDb03+D5EjFqJ/7iOawTCHbEzWVpWe2AmQKy9yHH+Eoq4PxZbZ2f1gF0h6p
	+4iWO/l7gsEp8Q1l86tonHw7EqKNxyXg0/SJnCEIsBT/Pc2JiPO2mhRGzAVEjrI6
	ekYylEdKh7JhZCaUrKC3j3FUBp+BpqRV2ETbXiTEqD4qoLLHvWOSTgBK1wbFIkC6
	sGwmlwT+IWyGjg1bN7PrWYI/+UeYe8mlMS/zwlZj0dElaTgm80xVtj+4IHyETwkZ
	b/hB1b9yMxbqkwluq+rs1PTWNbh2w==
X-ME-Sender: <xms:ooMIX-rInNLSS3sfM1GgSOYGdyMuX8mY6PIPUXts8v7Scea2R0QzeQ>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeduiedrvddugdekkecutefuodetggdotefrodftvf
    curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu
    uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc
    fjughrpefuvfhfhfhokffffgggjggtgfesthekredttdefjeenucfhrhhomheprfgvthgv
    rhcugfhishgvnhhtrhgruhhtuceophgvthgvrhdrvghishgvnhhtrhgruhhtsedvnhguqh
    hurggurhgrnhhtrdgtohhmqeenucggtffrrghtthgvrhhnpeelffffteffjeefhfehffev
    keeiteeikedufeffhfehveeilefhtefhgeefudehtdenucffohhmrghinhepvdhnughquh
    grughrrghnthdrtghomhenucfkphepleefrddvgeefrdduledurddvfeeknecuvehluhhs
    thgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepphgvthgvrhdrvghish
    gvnhhtrhgruhhtsedvnhguqhhurggurhgrnhhtrdgtohhm
X-ME-Proxy: <xmx:ooMIX8rj8fQWLc0Nx9m9sBRbMlCwU2sNUyIhiMj5EE0mhnMpEqgDgA>
    <xmx:ooMIXzPRPb-tt_9xgFEcBCFGng30AGXjDiLFmZcYtAWGU6pDYxm-Uw>
    <xmx:ooMIX95QLVHy-KJrZc1I4XrpyYgcRptg7Og7CxHp4r83F7tsNDC9bw>
    <xmx:o4MIX7RLiJUKZicXAlfQfnccnrvpwaPdArsu7KuE3Z69YAa9IpncZLIrSZ0>
Received: from april.pezone.net (p5df3bfee.dip0.t-ipconnect.de
 [93.243.191.238])
	by mail.messagingengine.com (Postfix) with ESMTPA id A43FD306005F;
	Fri, 10 Jul 2020 11:05:05 -0400 (EDT)
Subject: Re: <xref> vs <command> formatting in the docs
To: =?UTF-8?Q?Dagfinn_Ilmari_Manns=c3=a5ker?= <ilmari@ilmari.org>,
 Alvaro Herrera <alvherre@2ndquadrant.com>
References: <20200621153038.GA2296@alvherre.pgsql>
 <87lfkgnypi.fsf@wibble.ilmari.org>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <631ac57a-e4aa-a3a7-2b0d-0a84974c2205@2ndquadrant.com>
Date: Fri, 10 Jul 2020 17:05:04 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:52.0)
 Gecko/20100101 Thunderbird/52.9.1
MIME-Version: 1.0
In-Reply-To: <87lfkgnypi.fsf@wibble.ilmari.org>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 8bit
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 2020-06-21 18:57, Dagfinn Ilmari Mannsåker wrote:
> Attached are two patches: the first adds the missing <application> tags,
> the second adds <command> to all the SQL commands (specifically anything
> with <manvolnum>7</manvolnum>).

I have committed the first one.

I have some concerns about the second one.  If you look at the diff of 
the source of the man pages before and after, it creates a bit of a 
mess, even though the man pages look okay when rendered.  I'll need to 
think about this a bit more.

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