From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Dagfinn Ilmari Mannsåker <ilmari@ilmari.org>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: <xref> vs <command> formatting in the docs
Date: Sun, 21 Jun 2020 11:30:38 -0400
Message-ID: <20200621153038.GA2296@alvherre.pgsql> (raw)
In-Reply-To: <87o8pco34z.fsf@wibble.ilmari.org>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-hackers@postgresql.org
Cc: alvherre@2ndquadrant.com, ilmari@ilmari.org
Subject: Re: <xref> vs <command> formatting in the docs
In-Reply-To: <20200621153038.GA2296@alvherre.pgsql>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox