Re: proposal: convert comments in documents to html comments

Поиск
Список
Период
Сортировка
От Bruce Momjian
Тема Re: proposal: convert comments in documents to html comments
Дата
Msg-id YsSVnIx5N5QU+/I+@momjian.us
обсуждение исходный текст
Ответ на Re: proposal: convert comments in documents to html comments  (Peter Eisentraut <peter.eisentraut@enterprisedb.com>)
Ответы Re: proposal: convert comments in documents to html comments  (Noboru Saito <noborusai@gmail.com>)
Список pgsql-docs
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
Дата:
Сообщение: Query planner documentation should mention xxx_collapse_limit parameters
Следующее
От: PG Doc comments form
Дата:
Сообщение: Typo in examples in "8.14.5. jsonb Subscripting"