Re: [Rd] Is ALTREP "non-API"?

2024-04-24 Thread Simon Urbanek
> On Apr 25, 2024, at 12:55 AM, Hadley Wickham wrote: > > > > >>> That is not true at all - the presence of header does not constitute > >> declaration of something as the R API. There are cases where internal > >> functions are in the headers for historical or other reasons since the > >>

Re: [Rd] Is ALTREP "non-API"?

2024-04-24 Thread Hadley Wickham
A few more thoughts based on a simple question: how do you determine the length of a vector? Rf_length() is used in example code in R-exts, but I don't think it's formally documented anywhere (although it's possible I missed it). Is using in an example sufficient to consider a function to be part

Re: [Rd] Is ALTREP "non-API"?

2024-04-24 Thread Hiroaki Yutani
> And in general, I'd urge R Core to make an explicit list of functions that you consider to be part of the exported API While I believe R Core is in the process of such clarification, I'd also vote for this. Now that WRE has "experimental" category, and if we take the current definition of

Re: [Rd] Is ALTREP "non-API"?

2024-04-24 Thread Hadley Wickham
> > > > >>> That is not true at all - the presence of header does not constitute > >> declaration of something as the R API. There are cases where internal > >> functions are in the headers for historical or other reasons since the > >> headers are used both for the internal implementation and

Re: [Rd] Is ALTREP "non-API"?

2024-04-23 Thread Simon Urbanek
> On Apr 24, 2024, at 12:52 AM, Hadley Wickham wrote: > >> >> >> ALTREP is part of the official R api, as illustrated by the presence of src/include/R_ext/Altrep.h. Everything declared in the header files in >> that directory is official API AFAIK (and I believe that is more

Re: [Rd] Is ALTREP "non-API"?

2024-04-23 Thread Hadley Wickham
> > > > > > ALTREP is part of the official R api, as illustrated by the presence of > > > src/include/R_ext/Altrep.h. Everything declared in the header files in > that > > > directory is official API AFAIK (and I believe that is more definitive > than > > > the manuals). > > > > > > > That is not

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Hiroaki Yutani
I just saw the recent commits about the "experimental" entry points. So, my original question about the current status of ALTREP is now resolved. I'm glad that ALTREP is confirmed usable on CRAN (with care). Thank you for all your help! I think other "non-API"s still need clarification. For

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Simon Urbanek
> On Apr 23, 2024, at 10:29 AM, Hadley Wickham wrote: > > > > On Mon, Apr 22, 2024 at 5:14 PM Simon Urbanek > wrote: > > > > On Apr 22, 2024, at 7:37 PM, Gabriel Becker wrote: > > > > Hi Yutani, > > > > ALTREP is part of the official R api, as illustrated by the presence of > >

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Hadley Wickham
On Mon, Apr 22, 2024 at 5:14 PM Simon Urbanek wrote: > > > > On Apr 22, 2024, at 7:37 PM, Gabriel Becker > wrote: > > > > Hi Yutani, > > > > ALTREP is part of the official R api, as illustrated by the presence of > > src/include/R_ext/Altrep.h. Everything declared in the header files in > that

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Simon Urbanek
> On Apr 22, 2024, at 7:37 PM, Gabriel Becker wrote: > > Hi Yutani, > > ALTREP is part of the official R api, as illustrated by the presence of > src/include/R_ext/Altrep.h. Everything declared in the header files in that > directory is official API AFAIK (and I believe that is more

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Gabriel Becker
Hi Yutani, The headers have been updated by Luke Tierney: ALTREP is an *experimental* API, in that it is an official API that is legal for packages to use, but may it change with short notice as the framework is further developed. Hope that helps, ~G On Mon, Apr 22, 2024 at 4:46 AM Hiroaki

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Hiroaki Yutani
Thanks for your convincing comment, but it seems the R core team has a different opinion... A few hours ago, src/include/R_ext/Altrep.h got this comment: /* Not part of the API, subject to change at any time. */ commit:

Re: [Rd] Is ALTREP "non-API"?

2024-04-22 Thread Gabriel Becker
Hi Yutani, ALTREP is part of the official R api, as illustrated by the presence of src/include/R_ext/Altrep.h. Everything declared in the header files in that directory is official API AFAIK (and I believe that is more definitive than the manuals). The documentation of ALTREP has lagged behind

Re: [Rd] Is ALTREP "non-API"?

2024-04-21 Thread Hiroaki Yutani
Thanks, Hernando, Sorry, "API" is a bit confusing term in this context, but what I want to discuss is the "API" that Writing R Extension defines as quoted in my previous email. It's probably different from an ordinary sense when we casually say "R C API". You might wonder why I care about such a

Re: [Rd] Is ALTREP "non-API"?

2024-04-21 Thread hcortina71
Hello, I don't believe it is illegal, as ALTREP "implements an abstraction underneath the C API". And is "compatible with all code which uses the API". Please see slide deck by Gabriel Becker, with L Tierney, M Lawrence and T Kalibera.