-
Notifications
You must be signed in to change notification settings - Fork 4.8k
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
Add comprehensive documentation to Python via sphinx #3993
Conversation
… python code edits too
Note: Generating the documentation generates a lot of warnings and creates the folder wrappers/python/docs/_generated in the main tree (NOT the build tree). |
…s starting with _
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I stopped reviewing python.cpp once I realized the comments were generated from the c/c++ headers
@@ -407,7 +407,7 @@ namespace rs2 | |||
void keep() { rs2_keep_frame(frame_ref); } | |||
|
|||
/** | |||
* Parenthesis operator check internal frame handle is valid. | |||
* Parenthesis operator check if internal frame handle is valid. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The parenthesis operator checks if the
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@lramati , LGTM.
This PR will definitely facilitate Python development without the need for constant cross-referencing.
@bfulkers-i , thank you for the rigorous review 👍
Inline help is now much more comprehensive. Additionally, useful HTML docs can be generated with sphinx