Skip to content

Conversation

@amoeba
Copy link
Member

@amoeba amoeba commented Nov 14, 2023

Rationale for this change

The PR GH-37360 for issue GH-37212 deprecated three BufferReader constructors and I noticed one of them was missing a \deprecated command.

What changes are included in this PR?

This adds a \deprecated command one of the deprecated constructors with a message. The other two didn't need it because they weren't already documented. i.e., they weren't listed under https://arrow.apache.org/docs/cpp/api/io.html so documenting them at this point just to add \deprecated wouldn't make sense.

Are these changes tested?

No, this is a simple docs change.

Are there any user-facing changes?

Yes, this adds a notice to the docs for this particular method.

@amoeba amoeba requested a review from mapleFU November 14, 2023 23:15
@amoeba amoeba changed the title MINOR: [C++][Docs] Add \deprecated tag to deprecated BufferReader constructors MINOR: [C++][Docs] Add \deprecated tag to deprecated BufferReader constructor Nov 14, 2023
@github-actions github-actions bot added the awaiting review Awaiting review label Nov 14, 2023
Copy link
Member

@kou kou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1

@github-actions github-actions bot added awaiting merge Awaiting merge and removed awaiting review Awaiting review labels Nov 15, 2023
@raulcd raulcd merged commit 65fc1e7 into apache:main Nov 23, 2023
@raulcd raulcd removed the awaiting merge Awaiting merge label Nov 23, 2023
@conbench-apache-arrow
Copy link

After merging your PR, Conbench analyzed the 4 benchmarking runs that have been run so far on merge-commit 65fc1e7.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details. It also includes information about 1 possible false positive for unstable benchmarks that are known to sometimes produce them.

dgreiss pushed a commit to dgreiss/arrow that referenced this pull request Feb 19, 2024
…structor (apache#38721)

### Rationale for this change

The PR [apacheGH-37360](apache#37360) for issue [apacheGH-37212](apache#37212) deprecated three BufferReader constructors and I noticed one of them was missing a `\deprecated` command.

### What changes are included in this PR?

This adds a `\deprecated` command one of the deprecated constructors with a message. The other two didn't need it because they weren't already documented. i.e., they weren't listed under https://arrow.apache.org/docs/cpp/api/io.html so documenting them at this point just to add `\deprecated` wouldn't make sense.

### Are these changes tested?

No, this is a simple docs change.

### Are there any user-facing changes?

Yes, this adds a notice to the docs for this particular method.

Authored-by: Bryce Mecum <petridish@gmail.com>
Signed-off-by: Raúl Cumplido <raulcumplido@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants