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

Update Doxygen doxyfile #903

Merged
merged 10 commits into from
Jul 5, 2024
Merged

Update Doxygen doxyfile #903

merged 10 commits into from
Jul 5, 2024

Conversation

ulmus-scott
Copy link
Contributor

This should help to make the docs more useful.

@linuxdude42 I'm not sure how to test the cmake changes, but I followed what you did.

Checklist

Since 93e7287, it has been excluded by
EXCLUDE_PATTERNS.
This makes it easier to see where a file is included.

STRIP_FROM_PATH        = ../../
makes all paths referenced to the root of the Git repository
(assuming doxygen is run in mythtv/docs/)
This makes the recommended include line more useful on class documentation
pages.  Instead of listing just the filename, it gives a usable path for the
libraries and tells you which library, program, or plugin the class is in.
All moc_*.(h|cpp) files are in a moc folder.
All obj folders are generated during build.
The i18n folders in mythplugins only contain generated files.

I considered adding:
*/external/*
but I'm leaving it for mythtranscode/external/replex

*/scripts/*
I don't think any of these are useful to doxygen, but I'm not sure.
402: warning: end of comment block while expecting command </em>
401: warning: found </em> tag without matching <em>

Also removed extraneous character preventing line break from working correctly.
@linuxdude42
Copy link
Contributor

After building with cmake, use the following command:

cmake --build <build-dir> -t MythTV-docs

I tried to document everything in README.CMake.md. If you can't find something there, let me know.

@linuxdude42 linuxdude42 merged commit 2b07fe4 into MythTV:master Jul 5, 2024
7 of 12 checks passed
@ulmus-scott ulmus-scott deleted the docs2 branch July 11, 2024 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants