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 1jn1vn-000647-N2
	for pgsql-hackers@arkaria.postgresql.org; Sun, 21 Jun 2020 15:30:51 +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 1jn1vl-0004R1-8u
	for pgsql-hackers@arkaria.postgresql.org; Sun, 21 Jun 2020 15:30:49 +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 <alvherre@2ndquadrant.com>)
	id 1jn1vl-0004Qu-1v
	for pgsql-hackers@lists.postgresql.org; Sun, 21 Jun 2020 15:30:49 +0000
Received: from mail-qk1-x736.google.com ([2607:f8b0:4864:20::736])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128)
	(Exim 4.92)
	(envelope-from <alvherre@2ndquadrant.com>)
	id 1jn1ve-000506-C0
	for pgsql-hackers@postgresql.org; Sun, 21 Jun 2020 15:30:47 +0000
Received: by mail-qk1-x736.google.com with SMTP id q8so13390641qkm.12
        for <pgsql-hackers@postgresql.org>;
 Sun, 21 Jun 2020 08:30:42 -0700 (PDT)
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=iPJ6NC35fQGRazGvfgo0I7bVrJ18ml0NtX5S0pdv9JQ=;
        b=HzoW7mr5CDiS+E4jugsCWuRMPm2Pe8sPOGPGYl50f6k74rVY+14eC+zyBto6p+5FA6
         yh36XGXH2Gc0Q5HUEwXwUP7bbTfDKKsccBz9s0+XAMjoQPPbQSyD2a+FX5kqq4Bo5QGC
         ZZZvBJuagGvVyM45WsX5cfcYvn4lFFZ46ooMBe+CFBanhVWgBigIxuyD+sVNc3HZCBq+
         XSMRI5GDMzZYpYYgCshBnoN9uS4B6r4lGgeGE+BFS/+qobAENhauQpgEbgcq5oV07gfG
         1Gbe+dj1h/t9s8sQNObQzdhlCGTr+aLWkY1FXpfZC7B6J8J9DiETqz5OmIEHJTZfqBCv
         IXyQ==
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=iPJ6NC35fQGRazGvfgo0I7bVrJ18ml0NtX5S0pdv9JQ=;
        b=a1acscAt0+8LqudtYFV+St4MSfoEDLRvRDhsRrMuvNFFX4SFx/F9x2Wk+8nRIbdipz
         grpv9XgwNoByAse0pJGuVI9bkt95eFKBzMl7/Npvv92WbeUJtYYuWChdHQZcVzvthzZH
         UIpHFkTz5ogNDcpi9PvDEM+9BVDlUZueSiIW9k/ZLMcvO67LLMSD3/cN5rVlqwwpisOW
         YgLVLSHVRyD4zR83NHcxfwPd6xoIeboNMXPOfPd8UFipRIhieZA+Ea+KVDLpNJ78i9c8
         F2QpM+iGYFdfNxiSJwVZK8jYmT5twgOXZcdAkhF4rlNdEO5wEVHU6ItGc8/8gQwKnD84
         GQ0w==
X-Gm-Message-State: AOAM531xKtaMCtYy0w9Zu2XG76/hUNLko6eW4dkTLMD2MMVczMlzG7Nv
	8ZA5dOwoCF3Bqjeoy5L4Lacxbg==
X-Google-Smtp-Source: 
 ABdhPJxTeBkoFdGg87XlfV5W/bhHSDQw0qAWfG4bRb8amFGPLIHBGsR/IjJb2P//VBvmFTTUByoDaA==
X-Received: by 2002:a05:620a:14b8:: with SMTP id
 x24mr10705807qkj.284.1592753441193;
        Sun, 21 Jun 2020 08:30:41 -0700 (PDT)
Received: from perhan.alvh.no-ip.org ([190.95.18.252])
        by smtp.gmail.com with ESMTPSA id
 k20sm12733138qtu.16.2020.06.21.08.30.40
        (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
        Sun, 21 Jun 2020 08:30:40 -0700 (PDT)
Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000)
	id 962372A3917; Sun, 21 Jun 2020 11:30:38 -0400 (-04)
Date: Sun, 21 Jun 2020 11:30:38 -0400
From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Dagfinn Ilmari =?iso-8859-1?Q?Manns=E5ker?= <ilmari@ilmari.org>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: <xref> vs <command> formatting in the docs
Message-ID: <20200621153038.GA2296@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <87o8pco34z.fsf@wibble.ilmari.org>
User-Agent: Mutt/1.10.1 (2018-07-13)
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-Jun-21, Dagfinn Ilmari Mannsåker wrote:

> 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>.

Ouch.

> 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?

Looking at the ones that use <application>, it looks like manpages are
not damaged, so +1.

-- 
Álvaro Herrera                https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services