On 08/23/2011 11:34 AM, John Peterson wrote:
On Tue, Aug 23, 2011 at 10:06 AM, Truman Ellis <truman@ices.utexas.edu> wrote:
I think there is something wrong with the generated documentation, probably
a doxygen setting or something. Running "make doc" generates a lot of docs,
but trying to open doc/html/index.php or any of the other generated docs
opens a download dialog in whatever browser I try it in. I also had someone
else check this with the same results.

I know this is not very high priority, but I just thought it was a very odd
bug that probably has a simple solution.
I think this behavior depends on how your browser is set up (via MIME
types) to handle PHP files accessed via the file:// protocol.

On my machine, Chrome simply "downloads" the PHP file as you say, on
Safari it displays the file directly in the browser as plain text.
Neither is particularly useful!

Basically you'd need a script or something that would pass the file
through /usr/bin/php before attempting to display it within the
browser...  (And even then, it might not look exactly right if there
is no true web server running on your machine.)

I've googled this in the past, but haven't come across a simple,
effective solution yet.  Please let us know if you do!

That is very odd. The online version of the docs are also very ugly. I know the default for doxygen is just to write plain html, and the output is a lot cleaner. Would it be better to start over with the Doxyfile and just let doxygen figure out how it wants to do things? I feel like this would produce more useful output.

Thanks,
-- 
Truman Ellis