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: 376

Filed under:

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

Related posts about doxygen