Skip to content

Add Doxygen comments to opentime#1866

Merged
darbyjohnston merged 4 commits intoAcademySoftwareFoundation:mainfrom
darbyjohnston:otime_doxygen
Apr 3, 2025
Merged

Add Doxygen comments to opentime#1866
darbyjohnston merged 4 commits intoAcademySoftwareFoundation:mainfrom
darbyjohnston:otime_doxygen

Conversation

@darbyjohnston
Copy link
Contributor

This change completes adding Doxygen style comments to the opentime API. The changes are just comments, there are no functional changes to the API.

Most of the comments were straightforward, but any feedback to help improve them is welcome.

I added a Doxygen group for the TimeRange "relations" and <pre> tags to keep the ASCII diagrams intact in the Doxygen HTML.

I also made a couple of tweaks to the Doxygen configuration to remove non-public info and keep the sorting order the same as the header files.

Signed-off-by: Darby Johnston <darbyjohnston@yahoo.com>
Signed-off-by: Darby Johnston <darbyjohnston@yahoo.com>
@codecov-commenter
Copy link

codecov-commenter commented Apr 1, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 84.72%. Comparing base (c0e97b0) to head (846609c).
Report is 49 commits behind head on main.

❌ Your changes status has failed because you have indirect coverage changes. Learn more about Unexpected Coverage Changes and reasons for indirect coverage changes.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #1866      +/-   ##
==========================================
+ Coverage   84.11%   84.72%   +0.61%     
==========================================
  Files         198      177      -21     
  Lines       22241    12809    -9432     
  Branches     4687     1191    -3496     
==========================================
- Hits        18709    10853    -7856     
+ Misses       2610     1773     -837     
+ Partials      922      183     -739     
Flag Coverage Δ
py-unittests 84.72% <ø> (+0.61%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
src/opentime/errorStatus.h 100.00% <ø> (ø)
src/opentime/rationalTime.h 95.83% <ø> (+1.15%) ⬆️
src/opentime/stringPrintf.h 50.00% <ø> (+7.14%) ⬆️
src/opentime/timeRange.h 98.30% <ø> (-0.79%) ⬇️
src/opentime/timeTransform.h 100.00% <ø> (+8.33%) ⬆️

... and 127 files with indirect coverage changes


Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 43de3e5...846609c. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Signed-off-by: Darby Johnston <darbyjohnston@yahoo.com>
@ssteinbach ssteinbach added this to the Public Beta 18 milestone Apr 2, 2025
@darbyjohnston darbyjohnston merged commit d876062 into AcademySoftwareFoundation:main Apr 3, 2025
62 checks passed
@darbyjohnston darbyjohnston deleted the otime_doxygen branch April 27, 2025 23:47
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