Re: [Libmesh-devel] Generated Documentation

[Truman E. <tr...@ic...>]

On 08/23/2011 11:34 AM, John Peterson wrote:
> On Tue, Aug 23, 2011 at 10:06 AM, Truman Ellis <tr...@ic...> 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