[Fedora-packaging] doxygen and copied font files

[Nicolas Mailhot]

Le Sam 13 avril 2013 14:53, Richard W.M. Jones a écrit :
>
> https://bugzilla.redhat.com/show_bug.cgi?id=905255
> (long bug -- comment 43 onwards is probably the place to start)
>
> This package (open-vm-tools) uses doxygen to generate API
> documentation.  doxygen copies a font file from
> '/usr/share/fonts/gnu-free/FreeSans.ttf' into the API docs directory,
> and as a result [assuming you don't do anything else] the font file
> gets copied into the final RPM as part of the %doc.
>
> I don't quite understand how precisely this font file is used.  The
> CSS (doxygen.css) contains a reference to "FreeSans" as a font choice,
> but I didn't know that browsers would use this reference to start
> downloading *.ttf files from the same directory.

You can instruct a browser to download a font yes
http://www.w3.org/TR/css3-fonts/#font-face-rule

That works with raw ttf/otf files in every browser except ie (old ie
versions only understand fonts in processed web font formats for drm
reasons, IIRC there were announcements they were going to add raw otf/tf
support in new versions)

It must be used carefully so the download is only used as fallback if the
font is not already available on the system.

Either way doxygen should use the fonts in their canonical location if
Fedora (not a copy) and provide the appropriate apache rules to source
them from this location if necessary

Otherwise you end up with multiple font copies on disk and the user's
browsers end up downloading multiple copies of the files too. Remember
that for a browser each different URL is a different object, so if each
doxygen run copies the same files in different places the browser will
treat them as different things.

Regards,

-- 
Nicolas Mailhot