How to make Doxygen ignore specific PHP functions, when generating documentation from a purely proce
Posted
by Senthil
on Stack Overflow
See other posts from Stack Overflow
or by Senthil
Published on 2010-05-19T13:25:22Z
Indexed on
2010/05/21
15:01 UTC
Read the original article
Hit count: 393
doxygen
I am writing a PHP Library and I am trying out Doxygen to generate the API documentation. My library does not use OOP. All code is procedural.
I use lot of helper functions which have an _ (underscore) prefix in their names. They are not part of the publicly exposed API. They are just used internally. Even though they are commented just like the API functions, I don't want them included when giving out the documentation for the API.
I want Doxygen to ignore these functions.
I can think of two solutions for this, but I am not able to implement either one of them.
First is, I can set some configuration in Doxygen to make it ignore specific function name patterns. I went through Doxygen help documentation and searched the web. There seems to be options to ignore file and folder name patterns. But I am not able to find an option to specify a function name pattern and make it ignore those functions.
Second is, along with all the other content in the comments above functions, I could add some other keyword or something and make Doxygen ignore those functions. I haven't been able to find out how to do that either.
How can I make Doxygen ignore specific PHP functions when generating documentation?
Update
I searched within Stack Overflow and came across this question. It looked similar to my question. I found out about EXCLUDE_SYMBOLS config option in one of the answers.
You can use that to exclude function names too. More importantly, wildcards were supported. So I am able to ignore all my functions with _ as the prefix :)
This ridiculous! I should've done more research :| Someone please delete this question or add this answer as an answer.
© Stack Overflow or respective owner