Bug 706475

Summary:	FOP: Some Issues With Callouts
Product:	[openSUSE] openSUSE 11.4	Reporter:	Tanja Roth <taroth>
Component:	Documentation	Assignee:	Thomas Schraitle <thomas.schraitle>
Status:	RESOLVED FIXED	QA Contact:	Karl Eichwalder <ke>
Severity:	Major
Priority:	P5 - None
Version:	Factory
Target Milestone:	---
Hardware:	Other
OS:	Other
Whiteboard:
Found By:	Documentation	Services Priority:
Business Priority:		Blocker:	---
Marketing QA Status:	---	IT Deployment:	---
Bug Depends on:
Bug Blocks:	702276

Description Tanja Roth 2011-07-18 14:45:15 UTC

When checking the PDF generated by FOP, I found the following issues that are related to callouts:

1) The current callout font only provides numbers for up to 10 callout items. If a screen has more than 10 callout items, any callout item > 10 does not show a number but a scissors symbol instead. 

2) The line spacing _within_ one callout item is bigger than the distance _between several_ items (which makes it hard to distinguish what contents belongs together and where the contents of the next item starts). 

3) The following issue might be unique for Example 10.1: The first line of the screen and the last line of the text are overlapping and thus unreadable.    

For examples, see https://bugzilla.novell.com/attachment.cgi?id=438018, p. 143, Example 10.1.

Comment 1 Thomas Schraitle 2012-02-24 16:10:58 UTC

(In reply to comment #0)
> When checking the PDF generated by FOP, I found the following issues that are
> related to callouts:
> 
> 1) The current callout font only provides numbers for up to 10 callout items.
> If a screen has more than 10 callout items, any callout item > 10 does not show
> a number but a scissors symbol instead. 

daps contains now callout numbers up to 30. For readability reasons, it is recommended to use up to 10. So I think, this can be considered as FIXED. :)


For the following two issues, I guess, it's this file:
https://bugzillafiles.novell.org/attachment.cgi?id=437718

 
> 2) The line spacing _within_ one callout item is bigger than the distance
> _between several_ items (which makes it hard to distinguish what contents
> belongs together and where the contents of the next item starts). 

This seems to be gone now when building the FO file with the latest version.

 
> 3) The following issue might be unique for Example 10.1: The first line of the
> screen and the last line of the text are overlapping and thus unreadable.    
> 
> For examples, see https://bugzilla.novell.com/attachment.cgi?id=438018, p. 143,
> Example 10.1.

Also for this, I cannot see any problems. Either the pagebreak is a bit different or it is a real progress here. :)

However, for both (1) and (2), FOP is really picky about the callout formats. It seems, FOP does not like PDF. As our callout format is PDF currently, callouts in PDF won't appear. Changing the format to PNG they appear again, but with low quality. This is a bit strange. However, this is an issue it has nothing to do with your described issues before.


Leave it open to discuss this topic further with Tanja.

Comment 2 Thomas Schraitle 2012-04-13 14:08:47 UTC

(In reply to comment #1)

> 
> However, for both (1) and (2), FOP is really picky about the callout formats.
> It seems, FOP does not like PDF. As our callout format is PDF currently,
> callouts in PDF won't appear. Changing the format to PNG they appear again, but
> with low quality. This is a bit strange. However, this is an issue it has
> nothing to do with your described issues before.

There is now a parameter callout.fop.graphics.extension (default .svg) which solves all the problems. Fixed in revision 1113.

Comment 3 Swamp Workflow Management 2012-06-25 15:09:11 UTC

openSUSE-RU-2012:0788-1: An update that has 8 recommended fixes can now be installed.

Category: recommended (low)
Bug References: 703489,706459,706464,706475,706479,708637,758401,763268
CVE References: 
Sources used:
openSUSE 12.1 (src):    daps-1.0.2-5.9, opensuse-manuals_ru-12.1.8762-3.6.1, suse-xsl-stylesheets-1.9.6.2-2.3