From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
To: Noboru Saito <noborusai@gmail.com>
To: Michael Paquier <michael@paquier.xyz>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Peter Geoghegan <pg@bowt.ie>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: proposal: convert comments in documents to html comments
Date: Wed, 29 Jun 2022 13:33:08 +0100
Message-ID: <6f9cc655-04a7-6d95-4cfe-46c1ec8ca70e@enterprisedb.com> (raw)
In-Reply-To: <CAAM3qnK+GT=7g8dRvPPZcn_GbAYfQg47K+0FC2kfid7cEG8F-w@mail.gmail.com>
References: <CAAM3qnJDsT6y6t7KY=0VCtrG=uQtNuBdhiUk3vor530WbpPsFA@mail.gmail.com>
<20220627084839.5fuankjxgt6m62vv@alvherre.pgsql>
<CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com>
<Yrp7zoI2aKpUxqu8@paquier.xyz>
<CAAM3qnK+GT=7g8dRvPPZcn_GbAYfQg47K+0FC2kfid7cEG8F-w@mail.gmail.com>
On 29.06.22 09:29, Noboru Saito wrote:
> Comments aren't really associated with anything, so it's difficult to
> associate them correctly.
>
> I think it is better to stop commenting xml (sgml) and format it as
> follows (tags are tentative).
Yeah, with the exception of the release notes, XML comments were written
with the understanding that they are source-level comments, not
something that gets forwarded to the output. So let's leave comments be
comments, and if there is anything we want to include in the output,
let's mark it up properly.
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-docs@postgresql.org
Cc: peter.eisentraut@enterprisedb.com, noborusai@gmail.com, michael@paquier.xyz, alvherre@alvh.no-ip.org, pg@bowt.ie, tgl@sss.pgh.pa.us, pgsql-docs@lists.postgresql.org
Subject: Re: proposal: convert comments in documents to html comments
In-Reply-To: <6f9cc655-04a7-6d95-4cfe-46c1ec8ca70e@enterprisedb.com>
* 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