Add a Doxygen filter for .h files

[caguero]

🦟 Bug fix

Summary

Doxygen can not parse the GZ_DEPRECATED() macro in a .h file because the existing filter pattern was only applied to *.hh files, not *.h files.

Here's an example without this patch:

And with this patch:

Checklist

• Signed all commits for DCO
• Added tests
• Updated documentation (as needed)
• Updated migration guide (as needed)
• Consider updating Python bindings (if the library has them)
• codecheck passed (See contributing)
• All tests passed (See test coverage)
• While waiting for a review on your PR, please help review another open pull request to support the maintainers
• Was GenAI used to generate this PR? If so, make sure to add "Generated-by" to your commits. (See this policy for more info.)

Generated-by: Remove this if GenAI was not used.

Note to maintainers: Remember to use Squash-Merge and edit the commit message to match the pull request summary while retaining Signed-off-by and Generated-by messages.

[scpeters]

https://github.com/Mergifyio backport gz-cmake5 gz-cmake4 gz-cmake3 ign-cmake2

[mergify]

backport gz-cmake5 gz-cmake4 gz-cmake3 ign-cmake2

✅ Backports have been created

Details

• #524 Add a Doxygen filter for .h files (backport #523) has been created for branch gz-cmake5
• #525 Add a Doxygen filter for .h files (backport #523) has been created for branch gz-cmake4
• #526 Add a Doxygen filter for .h files (backport #523) has been created for branch gz-cmake3
• #527 Add a Doxygen filter for .h files (backport #523) has been created for branch ign-cmake2 but encountered conflicts

Cherry-pick of 8e87733 has failed:

On branch mergify/bp/ign-cmake2/pr-523
Your branch is up to date with 'origin/ign-cmake2'.

You are currently cherry-picking commit 8e87733.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   doc/doxygen/api.in

no changes added to commit (use "git add" and/or "git commit -a")

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally