Re: vs formatting in the docs - Mailing list pgsql-hackers

From Alvaro Herrera
Subject Re: vs formatting in the docs
Date
Msg-id 20200621153038.GA2296@alvherre.pgsql
Whole thread Raw
In response to vs formatting in the docs  (ilmari@ilmari.org (Dagfinn Ilmari Mannsåker))
Responses Re: vs formatting in the docs  (ilmari@ilmari.org (Dagfinn Ilmari Mannsåker))
List pgsql-hackers
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



pgsql-hackers by date:

Previous
From: ilmari@ilmari.org (Dagfinn Ilmari Mannsåker)
Date:
Subject: vs formatting in the docs
Next
From: Chapman Flack
Date:
Subject: Re: vs for command line tools in the docs