Re: [Doxygen-users] Getting started with Doxygen

[Daniel <dan...@zm...>]

Hi Philipp,

Your suggestion to use the wizard "solved" the problem. I'll reply to 
all your suggestions anyways:

Philipp Marek wrote:
> Yes, it does. I guess that you have <?php in that file? Else doxygen won't 
> find your php code.

I had "<?". Changing it to <?php made no difference.

> I'd guess that your doxygen configuration file does not say to read *.php 
> (or .php4, or whatever),

It's set to read *.php yes.

> or that your input directory(ies) are wrong - 
> possibly you did not say to recurse?

I checked those, and yes I have recurse. Doxygen was doing exactly what 
I would expect if I didn't have any documentation at all on the files. 
That is, it reads and parses the file but produces no documentation.

> Does doxygen on running say that it reads these files?

Yes.

> Have a look at doxywizard 
> (http://www.stack.nl/~dimitri/doxygen/doxywizard_usage.html).

Thanks! With the wizard I found a workable solution. This is what I did:

1. I went to Wizard > Mode
2. Under "Select the desired extraction mode" I changed "Documented 
entities only" to "All entities".

Then I ran Doxygen again. This time it created all the documentation, 
95% blank as I would expect, but in particular, it did find the one 
documentation bit I wrote and I see that function successfully 
documented in the HTML output.

I don't understand why changing that setting would make the difference 
of whether Doxygen notices the one function that *is* documented, but 
clearly it did something and I'm happy with the result.

Thanks for the help!

Cheers,
Daniel.