Skip to content

Resolve all Doxygen warnings & docs cleanup#8361

Open
rubiefawn wants to merge 4 commits into
LMMS:masterfrom
rubiefawn:fix/docs
Open

Resolve all Doxygen warnings & docs cleanup#8361
rubiefawn wants to merge 4 commits into
LMMS:masterfrom
rubiefawn:fix/docs

Conversation

@rubiefawn

@rubiefawn rubiefawn commented Apr 22, 2026

Copy link
Copy Markdown
Contributor
  • Updates Doxyfile for Doxygen 1.16.1 and minifies Doxyfile
  • Move documentation comments in first-party code from source files to their corresponding headers, where applicable
  • Resolves all Doxygen warnings in first-party code
  • Bumps portsmf submodule in order to resolve Doxygen warnings fixed upstream

@rubiefawn rubiefawn self-assigned this Apr 22, 2026
@rubiefawn
rubiefawn marked this pull request as ready for review April 22, 2026 05:39
@rubiefawn
rubiefawn force-pushed the fix/docs branch 3 times, most recently from 2287fbf to 926f938 Compare May 18, 2026 08:31
@rubiefawn
rubiefawn force-pushed the fix/docs branch 4 times, most recently from e8b5333 to 1d49e1b Compare June 4, 2026 21:23
Comment thread src/gui/instrument/PianoView.cpp
@rubiefawn rubiefawn added the needs code review A functional code review is currently required for this PR label Jun 4, 2026
@yohannd1

Copy link
Copy Markdown
Contributor

From reading this, I think I'm now convinced that using //! for multi-line docs is also good lol

Comment thread include/AutomationNode.h Outdated
Comment thread include/DataFile.h
Comment thread include/DeprecationHelper.h Outdated
Comment thread include/DeprecationHelper.h Outdated
Comment thread include/Editor.h Outdated
Comment thread include/Plugin.h
Comment thread include/SubWindow.h Outdated
Comment thread include/TrackContentWidget.h Outdated
Comment thread src/gui/clips/ClipView.cpp Outdated
Comment thread src/gui/instrument/PianoView.cpp
Comment thread include/TrackContentWidget.h
@yohannd1

Copy link
Copy Markdown
Contributor

Read everything, hopefully I didn't miss anything. Looks alright imo, have my (weak) approval.

- Updates Doxyfile for Doxygen 1.16.1 and minifies Doxyfile
- Use PROJECT_LOGO & PROJECT_ICON in Doxyfile
- Add custom Doxygen CSS to make the SVG logo behave
- Add custom Doxygen CSS to make fonts more consistent
- Move documentation comments in first-party code from source files to
  their corresponding headers, where applicable
- Resolves several (but not all) Doxygen warnings in first-party code
- Remove unused INPUTDIRS from doc/CMakeLists.txt
- Use CMake's DOXYGEN_ADD_DOCS() instead of a custom doc target
@rubiefawn
rubiefawn force-pushed the fix/docs branch 4 times, most recently from d656b08 to 3a888fc Compare July 15, 2026 01:52
They are not required as long as there are no other trailing doc
comments (see https://www.doxygen.nl/manual/docblocks.html#memberdoc)
@rubiefawn
rubiefawn force-pushed the fix/docs branch 2 times, most recently from 6df9388 to 2ef1ea2 Compare July 16, 2026 17:07
This contains only bugfixes except for one commit, which removes
unnecessary typedefs. Importantly, it fixes the Doxygen warnings.

MidiImport.cpp is modified to account for the removal of the typedefs.
I missed these earlier since they're not a git submodule lol
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs code review A functional code review is currently required for this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants