From: | Noboru Saito <noborusai(at)gmail(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us> |
Cc: | Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>, Michael Paquier <michael(at)paquier(dot)xyz>, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Peter Geoghegan <pg(at)bowt(dot)ie>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org> |
Subject: | Re: proposal: convert comments in documents to html comments |
Date: | 2022-07-07 01:38:05 |
Message-ID: | CAAM3qnJQsdE_aBzeK-hTdVhPO2dzf7BKDDOXwJV3Z3PgNam_5A@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
> I can add that markup, instead of SGML comments, when I create the
> release notes.
Great! Thank you.
2022年7月6日(水) 4:48 Bruce Momjian <bruce(at)momjian(dot)us>:
>
> On Wed, Jun 29, 2022 at 01:33:08PM +0100, Peter Eisentraut wrote:
> > 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.
>
> I can add that markup, instead of SGML comments, when I create the
> release notes.
>
> --
> Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
> EDB https://enterprisedb.com
>
> Indecision is a decision. Inaction is an action. Mark Batterson
>
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2022-07-08 01:20:55 | Re: How to reference the type of lock in the documentation. |
Previous Message | PG Doc comments form | 2022-07-07 00:27:01 | Typo in examples in "8.14.5. jsonb Subscripting" |