The Code of Conduct (CoC) was not included in the documentation generated by Doxyfile.
With this patch, the CoC is included, the link in the index exists and this warning is fixed:
[...]README.md:160: warning: unable to resolve reference to '/home/stephane/src/pspsdk/CODE_OF_CONDUCT.md' for \ref command
The documentation generated by Doxygen moves from doc/ to doc/build/.
There is a problem with using doc/ directory because when Doxygen produces the documentation, the doc/ directory is replaced so its content (style.css file) disappears.
When Doxygen generates the documentation (via `make doxygen-run`), it displays warnings such as:
warning: Tag 'OUTPUT_TEXT_DIRECTION' at line 102 of file 'Doxyfile' has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
The patch contains only the modifications done by `doxygen -u`.
This patch fixes the search for function like __mcount() or gprof_start().
The issue existed for functions with function attribute (__attribute__()): Doxygen didn't parsed it properly. It fixes such warnings:
warning: documented symbol '__mcount' was not declared or defined.
After changing Doxygen configuration to fix it, new warnings appears. For example:
warning: explicit link request to 'PSP_VAUDIO_FORMAT_' could not be resolved
It's fixed by using the full name of the constants. By the way, it also fixes the link to the constants in the documentation.
Initial patch based on:
https://stackoverflow.com/questions/75410662/doxygen-does-not-parse-attribute-correctly
