After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 638733 - SVG appears twice in documentation
SVG appears twice in documentation
Status: VERIFIED FIXED
Product: doxygen
Classification: Other
Component: documentation
1.7.3
Other All
: Normal minor
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2011-01-05 10:38 UTC by Helder Magalhães
Modified: 2011-06-06 20:00 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Helder Magalhães 2011-01-05 10:38:15 UTC
After upgrading a Doxygen configuration to 1.7.3 (release), I noticed "svg" appears twice in the updated file:

# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
# generated by dot. Possible values are png, svg, gif or svg.
# If left blank png will be used.

Suggestion would be reworking the sentence to "Possible values are SVG, PNG or GIF.", SVG appearing first as it is a vector format which will (theoretically) make it more suitable for this kind of simple shapes. (Disclaimer: I'm a big SVG fan!)

Nit: the online documentation doesn't reflect any of this yet. ;-)

This issue is dependent on bug 499544, although I wasn't able to set any dependencies during the report (even when showing advanced fields, probably I have no permissions on this Bugzilla instance).

[1] http://www.stack.nl/~dimitri/doxygen/config.html#cfg_dot_image_format
Comment 1 Dimitri van Heesch 2011-01-05 10:56:07 UTC
Confirmed. Should be fixed in the next subversion update / web update.

Note that I still have a nice addition for SVG in the pipeline: when an image is too big to fit in the browser window, it can be scaled down to fit and then one can navigate (pan+zoom) with the mouse; this can all be implemented inside the SVG using javascript. I haven't managed to get it working on IE unfortunately.
Comment 2 Helder Magalhães 2011-01-05 11:06:57 UTC
(In reply to comment #1)
> Confirmed. Should be fixed in the next subversion update / web update.

Great! :-)


> Note that I still have a nice addition for SVG in the pipeline: when an image
> is too big to fit in the browser window, it can be scaled down to fit and then
> one can navigate (pan+zoom) with the mouse; this can all be implemented inside
> the SVG using javascript. I haven't managed to get it working on IE
> unfortunately.

One of the cool things about SVG is that shapes can hold links. I'm not sure if dot supports that (I'm pretty sure it will) so, when clicking a shape, one could navigate to that class/file/method. A much more powerful mechanism that HTML image maps allowed but, still, somehow equivalent in these simple cases (used shapes are mostly circles and rectangles, as far as I recall). ;-)


[1] http://en.wikipedia.org/wiki/Image_map
Comment 3 Dimitri van Heesch 2011-03-28 14:19:12 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.4. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.
Comment 4 Helder Magalhães 2011-06-03 20:55:12 UTC
Issue originally reported confirmed as fixed in the online documentation.


(In reply to comment #1)
> Note that I still have a nice addition for SVG in the pipeline: when an image
> is too big to fit in the browser window, it can be scaled down to fit and then
> one can navigate (pan+zoom) with the mouse; this can all be implemented inside
> the SVG using javascript. I haven't managed to get it working on IE
> unfortunately.

Some time ago I've developed a prototype which was compatible with IE with ASV (Adobe SVG Viewer plug-in) installed. I haven't tested with IE9 yet, but I'd say it will work out-of-the-box.

I'd be interested to take a look at the current implementation. Is it available? Where?

[1] http://heldermagalhaes.com/stuff/svg/demos/SVGObject-HTMLCanvasInteractors/
Comment 5 Dimitri van Heesch 2011-06-06 20:00:28 UTC
I just committed it to SVN. You need to enable the new INTERACTIVE_SVG option and have a sufficiently large graph. The javascript code is based on http://code.google.com/p/svgpan/ and is embedded in the SVG produced by dot as a post-processing step (see DotFilePatcher::run() in src/dot.cpp)