Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs][R-package] update docs on C++ interface #4257

Merged
merged 4 commits into from
May 6, 2021

Conversation

jameslamb
Copy link
Collaborator

There have been several changes to the R package's C++ interface recently, in works towards #3016.

As a result of those changes (and other changes before), the documentation comments in R-package/src/lightgbm_R.h contain some inconsistencies, typos, and other small issues. For example, as of #4244 most of the functions there return an R NULL value, but their docs still say they return an integer indicating whether they succeeded or failed.

This PR proposes fixing them.

Notes for Reviewers

I intentionally skipped the four functions modified in #4256, since that PR changes those functions' signatures and docs.

@jameslamb jameslamb added the doc label May 5, 2021
@jameslamb jameslamb requested review from shiyu1994 and StrikerRUS May 5, 2021 15:02
@jameslamb jameslamb requested a review from Laurae2 as a code owner May 5, 2021 15:02
Copy link
Collaborator

@StrikerRUS StrikerRUS left a comment

Choose a reason for hiding this comment

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

Found some places where docs can be improved further within this PR. Please check comments below:

R-package/src/lightgbm_R.h Outdated Show resolved Hide resolved
R-package/src/lightgbm_R.h Show resolved Hide resolved
R-package/src/lightgbm_R.h Show resolved Hide resolved
R-package/src/lightgbm_R.h Outdated Show resolved Hide resolved
R-package/src/lightgbm_R.h Show resolved Hide resolved
R-package/src/lightgbm_R.h Outdated Show resolved Hide resolved
@jameslamb jameslamb requested a review from StrikerRUS May 6, 2021 19:07
Copy link
Collaborator

@StrikerRUS StrikerRUS left a comment

Choose a reason for hiding this comment

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

Thanks for doing this!

@StrikerRUS StrikerRUS changed the title [R-package] update docs on C++ interface [docs][R-package] update docs on C++ interface May 6, 2021
@StrikerRUS StrikerRUS merged commit 0246721 into microsoft:master May 6, 2021
@jameslamb jameslamb deleted the fix/r-docs branch May 7, 2021 01:32
@github-actions
Copy link

This pull request has been automatically locked since there has not been any recent activity since it was closed. To start a new related discussion, open a new issue at https://github.com/microsoft/LightGBM/issues including a reference to this.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 23, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants