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

Scaffolding for C++ docs #185

Merged
merged 3 commits into from
Sep 4, 2019
Merged

Scaffolding for C++ docs #185

merged 3 commits into from
Sep 4, 2019

Conversation

mosra
Copy link
Collaborator

@mosra mosra commented Sep 3, 2019

Motivation and Context

Building on top of #71, this adds initial setup for C++ documentation generation 🎉

  • Doxygen setup
  • Crosslinking to Magnum docs, STL documentation
  • Crosslinking from Python docs to the C++ docs
  • Some minimal main page as with Python docs
  • The build_docs.sh now builds both C++ and Python docs (although the C++ docs produce a ton of warning about undocumented / misdocumented things -- lots of work to do there)

How Has This Been Tested

Sample is at https://tmp.mosra.cz/habitat-cpp/. For example, this is how the newly added esp::gfx::RenderTarget from @erikwijmans in #114 looks like:

image

As usual, feedback is very appreciated -- and if you could try to pull this branch and run ./build_docs.sh locally, that'd be great.

@facebook-github-bot facebook-github-bot added the CLA Signed Do not delete this pull request or issue due to inactivity. label Sep 3, 2019
@mosra mosra merged commit 591400f into docs Sep 4, 2019
@mosra mosra deleted the cpp-docs branch September 4, 2019 15:15
mosra added a commit that referenced this pull request Sep 4, 2019
* Initial setup for C++ docs.

* Set up crosslinking of Python and C++ docs.

* Add at least some mainpage for C++ docs.
@mosra
Copy link
Collaborator Author

mosra commented Sep 4, 2019

Forgot to switch the target branch to master before merging 😅 ... cherry-picked the merge as 9077105.

eundersander pushed a commit to eundersander/habitat-sim that referenced this pull request Aug 6, 2020
Explicitly call close for vector env to avoid issues with file writer prematurely close buffer when tensorboard enabled. See facebookresearch#184 for more info.
Ram81 pushed a commit to Ram81/habitat-web-sim that referenced this pull request Dec 10, 2020
* Initial setup for C++ docs.

* Set up crosslinking of Python and C++ docs.

* Add at least some mainpage for C++ docs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed Do not delete this pull request or issue due to inactivity.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants