[Buddy-developers] documentation changes

[Haim C. <hai...@us...>]

Hello Nikos,

Few comments regarding the changes you made:

Overall, I think moving to doxygen is great and was much needed for a long time.
I noticed you created a pseudo soruce file called mainpage.h to put
olny doxygen comments in.
Is there a way in doxygen to add additional file, which is not source code ?
Not a big deal if not possible, but I don't want to confuse people
with the ".h" extension making them think there is some code there,
checking that file looking for code...

Another thing is, that when I run "make" in doc/, it says there is
nothing to build.
Shouldn't the documentation be built by default ? ("all" target )

That brings me to the next question:
Should we distribute the released version with the html files, or let
the documentation be part of the normal build ?
Problem is that no everyone has doxygen installed. I found I don't
have it installed on my mac, and configure didn't warn me about it.

I recall we also have space for a project website. We can build the
HTML and deploy it there as well !

Please let me know what do you think.

Thanks,
Haim

ps:I am updating the AUTHORS file to add *YOU* ! :-)
Would you like me to put there your sf Email, or your other Email which I have ?