-
Notifications
You must be signed in to change notification settings - Fork 2.1k
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
Fix Doxygen errors #13255
Fix Doxygen errors #13255
Conversation
PR #13255: Size comparison from 17520c3 to b158a92 Full report (11 builds for k32w, linux, p6, qpg, telink)
|
b158a92
to
87558ae
Compare
PR #13255: Size comparison from 17520c3 to 87558ae Full report (31 builds for efr32, esp32, k32w, linux, mbed, nrfconnect, p6, qpg, telink)
|
87558ae
to
75c4c42
Compare
PR #13255: Size comparison from a04c6d9 to 75c4c42 Full report (29 builds for efr32, k32w, linux, mbed, nrfconnect, p6, qpg, telink)
|
Re-enabling the "Doxygen workflow" for all PRs should prevent such issues from being introduced. Unless there's a different reason for disabling the Doxygen workflow that I am not aware of... :-) |
75c4c42
to
59d14aa
Compare
PR #13255: Size comparison from 99c1985 to 59d14aa Full report (31 builds for efr32, esp32, k32w, linux, mbed, nrfconnect, p6, qpg, telink)
|
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.
@woody-apple @andy31415 The size of this image has been reduced so maybe after merging this we can re-enable this workflow
@electrocucaracha - I believe the 'deploy doxygen' workflow was disabled because it created very large commits (maybe due to images? I am not sure) and there was no evidence that the doxygen output was actually used by anyone. |
I would propose to enable the doxygen run to validate generation (i.e. make sure our comments are reasonably formatted) however without actually deploying just yet. There may be value in having one single 'doxygen' periodically, however one per merged PR seems not as useful. |
Another option is just run when a supported doxygen files are modified using GH paths |
Problem
Fixed Doxygen errors
Re-enabling the "Doxygen workflow" for all PRs should prevent such issues from being introduced. Unless there's a different reason for disabling the Doxygen workflow that I am not aware of... :-)
Change overview
Updated comments that were causing Doxygen generation from succeeding.
Testing
Tested by successfully generating Doxygen HTML docs on my local machine, i.e. the following commands now work.