2017-11-30 13:26 GMT+01:00 Suzen, Mehmet <mehmet.suzen at gmail.com>:> On 30 November 2017 at 11:37, I?aki ?car <i.ucar86 at gmail.com> wrote: >> 2017-11-30 3:14 GMT+01:00 Suzen, Mehmet <mehmet.suzen at gmail.com>: >>> My understanding is that there is no inconsistency. `is` does what it >>> claims, from the documentation: >>> >>> ?is?: With two arguments, tests whether ?object? can be treated as >>> from ?class2?. >>> >>> With one argument, returns all the super-classes of this >>> object's class. >> >> Note that this is not in the documentation since a year ago. >> > > As far as I understood and gather, starting from methods v3.3.2, the following > new reference is added: > > * Chambers, John M. (2016) Extending R, Chapman & Hall. (Chapters 9 and 10.) > > Pushing that details there, I assume.Am I supposed to read every reference on a man page just to know what to expect from a function? I?aki
On 30 November 2017 at 14:04, I?aki ?car <i.ucar86 at gmail.com> wrote:> > Am I supposed to read every reference on a man page just to know what > to expect from a function? >If the reference is from John Chamber, you are supposed to read it. It is not always possible for maintainers to document everything on a man page.
2017-11-30 14:13 GMT+01:00 Suzen, Mehmet <mehmet.suzen at gmail.com>:> On 30 November 2017 at 14:04, I?aki ?car <i.ucar86 at gmail.com> wrote: >> >> Am I supposed to read every reference on a man page just to know what >> to expect from a function? >> > > If the reference is from John Chamber, you are supposed to read it.As a joke, it's funny.> It is not always possible for maintainers to document everything on a man page.My only point is that Herv?'s concern is perfectly legitimate given the output of "?is". Whether the inconsistency is in the behaviour of the function or in the documentation, that I don't know. Personally, I think that having two functions (is, extends) with exactly the same output wouldn't be very practical. But it's a fact that the difference is not currently addressed in the man page. I?aki