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 1jn1nc-0005gg-1Y
	for pgsql-hackers@arkaria.postgresql.org; Sun, 21 Jun 2020 15:22:24 +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 1jn1na-0001BE-T5
	for pgsql-hackers@arkaria.postgresql.org; Sun, 21 Jun 2020 15:22:22 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <ilmari@ilmari.org>)
	id 1jn1nZ-0001B7-FP
	for pgsql-hackers@lists.postgresql.org; Sun, 21 Jun 2020 15:22:22 +0000
Received: from [66.111.4.27] (helo=out3-smtp.messagingengine.com)
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <ilmari@ilmari.org>)
	id 1jn1nV-0005Dv-OQ
	for pgsql-hackers@postgresql.org; Sun, 21 Jun 2020 15:22:21 +0000
Received: from compute2.internal (compute2.nyi.internal [10.202.2.42])
	by mailout.nyi.internal (Postfix) with ESMTP id 4510D5C0515
	for <pgsql-hackers@postgresql.org>; Sun, 21 Jun 2020 11:22:06 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163])
  by compute2.internal (MEProxy); Sun, 21 Jun 2020 11:22:06 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ilmari.org; h=
	from:to:subject:date:message-id:mime-version:content-type; s=
	fm2; bh=FynSSeZ2E9+yG3WUzMPMO4n/Vp6CwywAnUcNgRN9ql0=; b=GCZxsjN3
	LNvgQ0NuIuqPVswGxFa9NK98F87/2njDp8pEqEQ084cVPhPWF/pHCyau0RBNfEUC
	Y1dg6m5ZAdEVOQptweoJs9PGz8EiB4ZwsHzWS58FPpQ92kAem7m3dy4b7PWv/96K
	JyoeT0CIKZdBLsB6urXc3jnQwyPRVaWYHAyF+7WIs3pRN5/Cyzy33Z9nB3PrDl9f
	UfWKdZfREogKQeGBEfQqGi9iZNYzS2cFHUB3PHQMQgAkMsSugQ9Rh3yuVTO6Hz2Q
	I6XOZS8y5UY0WabBfg5YvKwuBtbQcE26TJX1+heAs2A+803fs7+U8D8knLdG/uOi
	xqWu9DISGB+ySA==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
	messagingengine.com; h=content-type:date:from:message-id
	:mime-version:subject:to:x-me-proxy:x-me-proxy:x-me-sender
	:x-me-sender:x-sasl-enc; s=fm3; bh=FynSSeZ2E9+yG3WUzMPMO4n/Vp6Cw
	ywAnUcNgRN9ql0=; b=dpInBHbzzKCxrsnyKekHyL5TSEZjbtHDSkt9O8uvhVww6
	CEiZ2O1SqhntY9tdfHoAYEhk1KWKj83VpofQNxw51aTdt8GsTISKXbsGrdfqFYQJ
	zIcA2wh6Ftr2I0dVoaCtJoVkjIXWwI1q1TJFGgdFfZZQOxZI6c1mNexa5PI5QOTc
	hZM33roGRzTS6ryPMG00YiYBedm7iMbAAVoE7ViH4xKjI3g5s5poEdjbx8h7CeuN
	G5k38UShWS6OSkTbZ9erWGWWPE6xbQ5+7Ol0gPvS+YuhSwPDlQjTNRjMX486hUvL
	0HirwKHPR8XUTA3jnih/Cni70X3GjaiRsA1DtXslQ==
X-ME-Sender: <xms:HXvvXp64ZTV6Gx1j3Sq6-dgRqszwWk23pCk7W7vuLz09T8-0M9kRiQ>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeduhedrudektddgkeelucetufdoteggodetrfdotf
    fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen
    uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne
    cujfgurhephffvufffkfgfgggtsehttdertddtreejnecuhfhrohhmpehilhhmrghrihes
    ihhlmhgrrhhirdhorhhgucdlffgrghhfihhnnhcukfhlmhgrrhhiucforghnnhhsnohkvg
    hrmdenucggtffrrghtthgvrhhnpeehffdvudejtdfggfdujeffkeeghfehveegjeekkeeu
    uddugffguefhueefvddvkeenucfkphepgeeirdegfedrudehrddvhedvnecuvehluhhsth
    gvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepihhlmhgrrhhisehilhhm
    rghrihdrohhrgh
X-ME-Proxy: <xmx:HXvvXm6ry50JDwcJ6G9B8w_hzuGYHyGvD4sJg8id2qTAMPpVsI_d_g>
    <xmx:HXvvXgcqhZAhreWHgP5veWCvF_ZWLxLZD5gGZLHrLEWc-uhnDpFOTQ>
    <xmx:HXvvXiKbzEFMSkNNQpIhKcgV9KFyeMwhzEHkG2P8CbeBjRktLHJeBA>
    <xmx:HnvvXgaWLM81xlyfjz7AtImDWcV1q1fw1GJIn1OYpNU0HVUPkK2H9A>
Received: from wibble.ilmari.org (wibble.ilmari.org [46.43.15.252])
	by mail.messagingengine.com (Postfix) with ESMTPA id 854ED3066DD2
	for <pgsql-hackers@postgresql.org>; Sun, 21 Jun 2020 11:22:05 -0400 (EDT)
From: ilmari@ilmari.org (Dagfinn Ilmari =?utf-8?Q?Manns=C3=A5ker?=)
To: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: <xref> vs <command> formatting in the docs
Date: Sun, 21 Jun 2020 16:22:04 +0100
Message-ID: <87o8pco34z.fsf@wibble.ilmari.org>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Host-Lookup-Failed: Reverse DNS lookup failed for 66.111.4.27 (deferred)
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

Hi Hackers,

While looking at making more <command>SQL</command> into links, I
noticed that <xref> loses the monospace formatting of <command>, and
can't itself be wrapped in <command>.  This becomes particularly
apparent when you have one link that can be an <xref/> next to another
that's <link><command>...</command></link> because it's actually
referring to a specific variant of the command.

By some trial and error I found that putting <command> inside the
<refentrytitle> tag propagates the formatting to the <xref> contents.
We already do this with <application> for (most of) the client and
server applications.  Is this something we want to do consistently for
both?

- ilmari
-- 
"The surreality of the universe tends towards a maximum" -- Skud's Law
"Never formulate a law or axiom that you're not prepared to live with
 the consequences of."                              -- Skud's Meta-Law