From m@rc_@chw@rtz @end|ng |rom me@com  Fri Mar  6 15:52:29 2020
From: m@rc_@chw@rtz @end|ng |rom me@com (Marc Schwartz)
Date: Fri, 6 Mar 2020 09:52:29 -0500
Subject: [Rd] findInterval Documentation Suggestion
In-Reply-To: <1206418066.5458182.1583504257233@mail.yahoo.com>
References: <1675788134.5157075.1583446713973.ref@mail.yahoo.com>
 <1675788134.5157075.1583446713973@mail.yahoo.com>
 <24162.22179.40324.212614@stat.math.ethz.ch>
 <1206418066.5458182.1583504257233@mail.yahoo.com>
Message-ID: <2BA47922-7178-4869-A494-B709CB97C3CF@me.com>


> On Mar 6, 2020, at 9:17 AM, brodie gaslam via R-devel <r-devel at r-project.org> wrote:
> 
>> On Friday, March 6, 2020, 8:56:54 AM EST, Martin Maechler <maechler at stat.math.ethz.ch> wrote: 
> 
>> Note that the  * -> LaTex -> PDF rendered version looks a bitnicer.
> 
> Ah yes, that does indeed look quite a bit nicer.
> 
>> I wrote the function and that help page originally.
> 
> And thank you for doing so. It is a wonderful function.
> (0 sarcasm here).
> 
>> For that reason, replacing the well defined precise
>> inequality-based definition by *much* less precise English prosa
>> is out of the question.
> 
> I figured that might be an issue.  Would you be open to 
> providing a prose translation, but putting that in the 
> details? If so, it would be useful to get feedback on 
> what parts of the prose I proposed are imprecise enough 
> to be incorrect/incomplete for some corner case.
> 
> Finally, would it make sense to move this discussion to
> bugzilla?
> 
> Best,
> 
> Brodie.


Hi,

Just to put forth an alternative to modifying the existing, precise content that Martin wrote, in many cases, that content can be reasonably supplemented by the addition of specific examples and perhaps concise comments, that demonstrate what, otherwise, may be surprising behavior.

If Brodie can construct one or more such examples that might provide additional insights, then perhaps they can be considered for inclusion in the help file, such that meeting both goals of not compromising the language that Martin has contributed, while expanding comprehension, can be achieved.

Regards,

Marc Schwartz



[Rd] findInterval Documentation Suggestion
Marc Schwartz