Re: Formatting of warning about using ident - Mailing list pgsql-docs

From Daniel Gustafsson
Subject Re: Formatting of warning about using ident
Date
Msg-id 2895B548-0F29-4920-9ABA-701E09D07B47@yesql.se
Whole thread Raw
In response to Re: Formatting of warning about using ident  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
List pgsql-docs
> On 22 Jul 2019, at 14:23, Peter Eisentraut <peter.eisentraut@2ndquadrant.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


pgsql-docs by date:

Previous
From: "Jonathan S. Katz"
Date:
Subject: Re: Formatting of warning about using ident
Next
From: Awad Mackie
Date:
Subject: Re: REFRESH MATERIALIZED VIEW CONCURRENTLY interaction with ORDER BY