From: Daniel Gustafsson <daniel@yesql.se>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Formatting of warning about using ident
Date: Wed, 24 Jul 2019 10:28:07 +0200
Message-ID: <2895B548-0F29-4920-9ABA-701E09D07B47@yesql.se> (raw)
In-Reply-To: <05d9e235-118f-2dbc-95c3-e1a51c19dad1@2ndquadrant.com>
References: <B20006D2-AE84-40CE-97DE-A607A0027EE0@yesql.se>
<bc0f78d9-c7e5-1804-9cc1-2fe30f16d2a2@2ndquadrant.com>
<D7DCADB0-D7E7-4C1B-ACFD-7C1AD466EFE5@yesql.se>
<05d9e235-118f-2dbc-95c3-e1a51c19dad1@2ndquadrant.com>
> 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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: daniel@yesql.se, peter.eisentraut@2ndquadrant.com, pgsql-docs@lists.postgresql.org
Subject: Re: Formatting of warning about using ident
In-Reply-To: <2895B548-0F29-4920-9ABA-701E09D07B47@yesql.se>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox