[hibernate-issues] [Hibernate-JIRA] Closed: (HHH-5059) callouts and programlistings with highlighting

callouts and programlistings with highlighting ---------------------------------------------- Key: HHH-5059 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5059 Project: Hibernate Core Issue Type: Bug Components: documentation Reporter: Steve Ebersole Assignee: Steve Ebersole Priority: Blocker Fix For: 3.5.1 Attachments: HHH-5059.patch Time Spent: 0h 40m Remaining Estimate: 0h Attempting to use callouts with programlistings that apply highlighting break horrifically :( Actually it seems to be ok for pdf; still need to investigate more. However it for certain goes horribly wrong on html formats. We need to fix this and push a 3.5.1 asap to have proper 3.5 documentation available. The problem is that this is an issue with the "JBoss.org jDocBook styles". And the fix is not yet known nor expected to be trivial. So how long so we wait? Because the work around is to remove the highlighting when using callouts; in other words, for all <programlistingco> tags, we need to make sure the nested <programlisting> tags do not specify the role attribute. Then when (if ever) the "JBoss.org jDocBook styles" is fixed we will need to go and add back the highlighting.