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

[Steve Ebersole (JIRA)]

    [ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=36436#action_36436 ] 

Steve Ebersole commented on HHH-5059:
-------------------------------------

Not sure what to tell you:

{noformat}
[steve at apollo manual]$ pwd
/home/steve/projects/hibernate/core/trunk/documentation/manual                            
[steve at apollo manual]$ mvn jdocbook:update-pot
[INFO] Scanning for projects...                                                           
[INFO] ------------------------------------------------------------------------           
[INFO] Building Hibernate Manual                                                          
[INFO]    task-segment: [jdocbook:update-pot]                                             
[INFO] ------------------------------------------------------------------------           
[INFO] [jdocbook:update-pot {execution: default-cli}]                                     
[INFO] ------------------------------------------------------------------------           
[INFO] BUILD SUCCESSFUL                                                                   
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 18 seconds
[INFO] Finished at: Wed Apr 14 09:27:39 CDT 2010
[INFO] Final Memory: 15M/554M
[INFO] ------------------------------------------------------------------------
{noformat}

Even render which you said you had problems with works fine:
{noformat}
[steve at apollo manual]$ mvn jdocbook:generate -Djdocbook.lang=en-US -Djdocbook.format=html_single
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Hibernate Manual
[INFO]    task-segment: [jdocbook:generate]
[INFO] ------------------------------------------------------------------------
[INFO] [jdocbook:generate {execution: default-cli}]
[INFO] applying DocBook profiling [/home/steve/projects/hibernate/core/trunk/documentation/manual/target/docbook/work/profile/en-US/HIBERNATE_-_Relational_Persistence_for_Idiomatic_Java.xml]
[INFO] Processing en-US -> html_single
redirecting output to file [/home/steve/projects/hibernate/core/trunk/documentation/manual/target/docbook/work/log/console-en-US-html_single.log]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 37 seconds
[INFO] Finished at: Wed Apr 14 09:26:32 CDT 2010
[INFO] Final Memory: 48M/565M
[INFO] ------------------------------------------------------------------------
{noformat}

> 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
>
>
> 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.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira