Re: Formatting of warning about using ident

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Formatting of warning about using ident
Date: 2019-07-24 08:28:07
Message-ID: 2895B548-0F29-4920-9ABA-701E09D07B47@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 22 Jul 2019, at 14:23, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> wrote:

> Being a quote and being a warning are two orthogonal properties. So in
> that sense, wrapping the quote in a warning element is more correct.
> But the problem is now that a warning box is meant to be formatted out
> of line, so writing something like
>
> <para>This feature does this and that and the other, but
> <warning>
> You can really make a mess with this.
> </warning>
> </para>
>
> is not correct. (I'm surprised the schema even allows this.)

According to the schema it’s legal, warning can be in a para and can itself
contain a para.

> I don't think that would be an improvement though.

I’m not a fan of the status quo, but I don’t feel it’s worth pursuing much
further so I’m withdrawing for now. Thanks for reviewing!

cheers ./daniel

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Andrew Dunstan 2019-07-24 13:55:05 Re: initdb recommendations
Previous Message Peter Eisentraut 2019-07-23 06:12:12 Re: initdb recommendations