Re: get rid of tags in the docs? - Mailing list pgsql-hackers

From Tom Lane
Subject Re: get rid of tags in the docs?
Date
Msg-id 4095779.1612452709@sss.pgh.pa.us
Whole thread Raw
In response to get rid of tags in the docs?  (John Naylor <john.naylor@enterprisedb.com>)
List pgsql-hackers
John Naylor <john.naylor@enterprisedb.com> writes:
> While looking at the proposed removal of the v2 protocol, I noticed that we
> italicize some, but not all, instances of 'per se', 'pro forma', and 'ad
> hoc'. I'd say these are widespread enough in formal registers of English
> that they hardly need to be called out as foreign, so I propose removing
> the tags for those words.

+1, nobody italicizes those in normal usage.

> The other case is 'voilà', found in rules.sgml. The case for italics here
> is stronger, but looking at that file, I actually think a more
> generic-sounding phrase here would be preferable.

Yeah, seeing that we only use that in one place, I think we could do
without it.  Looks like something as pedestrian as "The results are:"
would do fine.

            regards, tom lane



pgsql-hackers by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: Removing support for COPY FROM STDIN in protocol version 2
Next
From: Tom Lane
Date:
Subject: Re: Removing support for COPY FROM STDIN in protocol version 2