On 07/11/2013 09:56 PM, Stefan Pendl wrote:
> Am 12.07.2013 03:50, schrieb Alan Robertson:
>> I didn't get any reply to this. This is a serious problem.
>>
>> Doxygen is generating HTML which is unusable by a significant percentage
>> of mobile devices.
>>
>> Do I need to send this email somewhere else?
>>
> If you report it at the bugzilla site of doxygen, it is more likely to 
> not get lost.
OK.   What's the URL for it?
>
> The bug reports are published on this list too, so if someone has a 
> workaround for your problem, he can answer here.
>
> Keep in mind that documentation is not created with mobiles in mind, so 
> this would be a new recommendation.
>
> Because it is HTML and mobiles have a browser installed, doesn't mean it 
> will work on mobiles, else there wouldn't be the need for so many sites 
> to have a mobile compatibility mode.
>
> I think that PDF is suitable for mobiles, since a user of the 
> application I am participating in development requested PDF for his 
> mobile device.
By design, PDF is terrible for mobiles.  It is absolutely awful to
navigate on any screen, and was created for a printing to paper for a
fixed page size (usually very large) in mind and is paginated for
rendering on dead trees - so it has wasted space for margins that relate
to aspects of paper that just don't exist in viewers.

HTML is a better alternative - it is designed from the beginning to
scale to the screen size.  And the HTML navigation in recent versions of
doxygen output is quite reasonable.

My web site is quite readable on my phone - if I use the right browser
and zoom in.  I suspect this of being a browser bug, but I don't know
that for sure.  If it's a browser bug, it exists on the two most common
browsers for Android - which sort of argues against that...

I suppose if doxygen could render to one of the electronic book formats
(like .mobi) , that might be an interesting alternative - and it would
could also work on various platforms...  That would not be as good as
the current web site, but it would be much better than PDF.

-- 
    Alan Robertson <al...@unix.sh> - @OSSAlanR

"Openness is the foundation and preservative of friendship...  Let me claim 
from you at all times your undisguised opinions." - William Wilberforce

------------------------------------------------------------------------------
See everything from the browser to the database with AppDynamics
Get end-to-end visibility with application monitoring from AppDynamics
Isolate bottlenecks and diagnose root cause in seconds.
Start your free trial of AppDynamics Pro today!
http://pubads.g.doubleclick.net/gampad/clk?id=48808831&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to