[hibernate-issues] [Hibernate-JIRA] Commented: (HHH-5059) callouts and programlistings with highlighting
[
http://opensource.atlassian.com/projects/hibernate/browse/HHH-5059?page=c...
]
Steve Ebersole commented on HHH-5059:
-------------------------------------
Not sure what to tell you:
{noformat}
[steve@apollo manual]$ pwd
/home/steve/projects/hibernate/core/trunk/documentation/manual
[steve@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@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....
-
For more information on JIRA, see: http://www.atlassian.com/software/jira