On Tue, Aug 23, 2011 at 11:34 AM, John Peterson <jwpeterson@gmail.com> 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!

Not sure what to do about the .php, but if you just need to look at the docs and don't need it to look pretty, 
switch to html output in Doxygen. Looks like all I did was change

HTML_FILE_EXTENSION    = .php  ---> HTML_FILE_EXTENSION    = .html

in the Doxyfile. This opens up in Safari for me. FWIW.

Paul