Re: Ambiguous usage of 'any' in explanation

From: KES <kes-kes(at)yandex(dot)ru>
To: David G(dot) Johnston <david(dot)g(dot)johnston(at)gmail(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>
Cc: "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Ambiguous usage of 'any' in explanation
Date: 2018-10-12 10:25:26
Message-ID: 8049941539339926@iva5-84bc572481fe.qloud-c.yandex.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

<div xmlns="http://www.w3.org/1999/xhtml">either it is hard to understand.</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">I will rephrase one part to show how it is easy to understand from my side:</div><div xmlns="http://www.w3.org/1999/xhtml">&gt;ALL</div><div xmlns="http://www.w3.org/1999/xhtml">&gt; The result is <span>“<span>false</span>”</span> if any false result is found.</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">The result of ALL is "false" even if *at least one*  row yield false</div><div xmlns="http://www.w3.org/1999/xhtml">(we can use 'some' word here, but it is not such clear as *at least one*)</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">This sentence is easyly can be compared to:</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">&gt;The result of <code>ALL</code> is <span>“<span>true</span>”</span> if all rows yield true</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">We can notice difference with first statement so can understand when result is different:</div><div xmlns="http://www.w3.org/1999/xhtml">(I got next picture in my mind in this case:)</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">   all true -&gt; true</div><div xmlns="http://www.w3.org/1999/xhtml">   at least one false -&gt; false</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">Thus if other parts of DOC would be constructed in same manner, it would be cool</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">PS. When DOC not just document behavior but also allow eaisly detect difference when/why behavior of a command is changed.</div><div xmlns="http://www.w3.org/1999/xhtml"> </div><div xmlns="http://www.w3.org/1999/xhtml">Thank you.</div><div><br /></div><div><br /></div><div>12.10.2018, 00:20, "David G. Johnston" &lt;david(dot)g(dot)johnston(at)gmail(dot)com&gt;:</div><blockquote type="cite">On Thursday, October 11, 2018, Bruce Momjian &lt;<a href="mailto:bruce(at)momjian(dot)us">bruce(at)momjian(dot)us</a>&gt; wrote:<blockquote style="margin:0 0 0 0.8ex;border-left:1px #ccc solid;padding-left:1ex;">
        The result is NULL if no comparison with a subquery row returns<br />
        false, and it returns NULL for at least one row.<br />
<br />
I can make similar adjustments in other places, and have attached a doc<br />
patch.  Does that help?<br />
</blockquote><div><br /></div><div>+1</div><div><br /></div><div>David J. </div>
</blockquote>

Attachment Content-Type Size
unknown_filename text/html 2.7 KB

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message KES 2018-10-12 10:42:03 Re: Ambiguous usage of 'any' in explanation
Previous Message Jonathan S. Katz 2018-10-12 02:03:34 Re: Proposed HTML Documentation Styles