Re: proposal: convert comments in documents to html comments

Поиск
Список
Период
Сортировка
От Noboru Saito
Тема Re: proposal: convert comments in documents to html comments
Дата
Msg-id CAAM3qnJQsdE_aBzeK-hTdVhPO2dzf7BKDDOXwJV3Z3PgNam_5A@mail.gmail.com
обсуждение исходный текст
Ответ на Re: proposal: convert comments in documents to html comments  (Bruce Momjian <bruce@momjian.us>)
Список 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@momjian.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@momjian.us>        https://momjian.us
>   EDB                                      https://enterprisedb.com
>
>   Indecision is a decision.  Inaction is an action.  Mark Batterson
>



В списке pgsql-docs по дате отправления:

Предыдущее
От: PG Doc comments form
Дата:
Сообщение: Typo in examples in "8.14.5. jsonb Subscripting"
Следующее
От: Bruce Momjian
Дата:
Сообщение: Re: How to reference the type of lock in the documentation.