Re: [DISCUSS][C++] C++ API as a user-facing API

2022-09-30 Thread Antoine Pitrou
On Thu, 29 Sep 2022 11:19:44 -0700 Will Jones wrote: > In a discussion about new additions to C++ docs, someone had a question: > Should we even be documenting this? > > Long-time contributors to Arrow C++ noted that many parts were written > without the intention that those APIs would not be use

Re: [DISCUSS][C++] C++ API as a user-facing API

2022-09-29 Thread Micah Kornfield
I think the convention we have been using is that headers included directly in the "api.h" headers were considered public, those that aren't were considered a gray area. On Thu, Sep 29, 2022 at 11:51 AM Aldrin wrote: > > many parts were written without the intention that those APIs would not > b

Re: [DISCUSS][C++] C++ API as a user-facing API

2022-09-29 Thread Aldrin
> many parts were written without the intention that those APIs would not be used directly >From the proceeding sentence, I assume you mean that many parts were not intended for direct use? I think my personal take is that I consider all parts of the C++ libraries to be public. Otherwise, I have

[DISCUSS][C++] C++ API as a user-facing API

2022-09-29 Thread Will Jones
In a discussion about new additions to C++ docs, someone had a question: Should we even be documenting this? Long-time contributors to Arrow C++ noted that many parts were written without the intention that those APIs would not be used directly. Instead, they were intended as an implementation det